Import tweets into a calendar file
Python JavaScript Makefile
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
tests
tweetcal
.gitignore
.travis.yml
LICENSE
MANIFEST.in
Makefile
readme.md
sample-config.yaml
setup.py
tox.ini

readme.md

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 and unzip it. Let's say it's in ~/Downloads/archive/. Run this command:

$ 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.

Save those tokens to a yaml or json file. Use the sample format in the repo 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:

$ 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.