Python utilities for twitter bots
Project description
# Tweetcal
Tweetcal converts a Twitter feed into .ics (calendar) format.
## Install
Install with `pip install tweetcal`
## How to
Tweetcal has two commands. The first converts a Twitter archive to `ics`, the second saves recent tweets to `ics`.
### Reading an archive
Download your [Twitter archive](https://support.twitter.com/articles/20170160-downloading-your-twitter-archive) and unzip it. Let's say it's in `~/Downloads/archive/`. Run this command:
````sh
$ tweetcal read-archive ~/Downloads/archive calendar-file.ics
````
This will create `calendar-file.ics`. Test it by opening in your favorite calendaring program.
### Saving recent tweets
For this section, you'll need [Twitter OAuth credentials](https://dev.twitter.com/oauth/overview/application-owner-access-tokens).
Save those tokens to a yaml or json file. Use the [sample format in the repo](sample-config.yaml) as a guide. Let's say you've saved the file to `~/tweetcal.yaml` and your username is 'screen_name1'. Once that's set up, run:
```` sh
$ tweetcal stream --config ~/tweetcal.yaml --user screen_name1
````
Tweetcal leaves a note in ics files it creates to tell it where in an account's stream to start downloading. Because of this, you should only use a file created by Tweetcal with tweetcal-stream.
Tweetcal converts a Twitter feed into .ics (calendar) format.
## Install
Install with `pip install tweetcal`
## How to
Tweetcal has two commands. The first converts a Twitter archive to `ics`, the second saves recent tweets to `ics`.
### Reading an archive
Download your [Twitter archive](https://support.twitter.com/articles/20170160-downloading-your-twitter-archive) and unzip it. Let's say it's in `~/Downloads/archive/`. Run this command:
````sh
$ tweetcal read-archive ~/Downloads/archive calendar-file.ics
````
This will create `calendar-file.ics`. Test it by opening in your favorite calendaring program.
### Saving recent tweets
For this section, you'll need [Twitter OAuth credentials](https://dev.twitter.com/oauth/overview/application-owner-access-tokens).
Save those tokens to a yaml or json file. Use the [sample format in the repo](sample-config.yaml) as a guide. Let's say you've saved the file to `~/tweetcal.yaml` and your username is 'screen_name1'. Once that's set up, run:
```` sh
$ tweetcal stream --config ~/tweetcal.yaml --user screen_name1
````
Tweetcal leaves a note in ics files it creates to tell it where in an account's stream to start downloading. Because of this, you should only use a file created by Tweetcal with tweetcal-stream.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
tweetcal-0.4.tar.gz
(4.8 kB
view hashes)