🐦 Archive and delete your tweets & likes like a boss

  • Users starred: 13
  • Users forked: 2
  • Users watching: 3
  • Updated at: 2019-03-17 02:41:41

Shut Up Bird

Archive and delete your Twitter posts.

You'd like to get rid of your old tweets or likes but still have them nicely organized somewhere? Or maybe you want to setup a cron to regularly clean up your timeline?

This tool creates an ePub e-book from a range of Twitter posts or likes and then (optionally) deletes them from your timeline.


Requires Python 2.7 or 3.x.


To install on ArchLinux from AUR run:

yaourt -S shut-up-bird


Run make or pip install -r requirements.txt.


Create a new Twitter application. The name shouldn't matter.

Open the new Twitter app's Permissions page and make sure Read, Write and Access direct messages is selected, otherwise the tool will not be able to delete any tweets.

Run without any parameters to initialize the tool:

$ python2
Please provide your Twitter app access keys

Enter the consumer API key:

Consumer API Key: <25-chars>

Enter the consumer API secret:

Consumer API Secret: <50-chars>

A Twitter authentication request page should automatically open in your browser. If not, or if you're running this on a server somewhere, open the url generated below in a browser yourself.

Authenticating ...please wait
Opening url -<token>

Accept the Twitter authorization request and enter the verification code back to the console:

Verification PIN code: 7654321

All authorization parameters will now be saved to your home directory, i.e., ~/.shut-up-bird.conf.

That's it. You're ready to go. 👌


Show help 👀

python2 -h 

Archive all tweets posted before the tweet with id 123456789012345678. Tweets will be saved in descending date order. No tweets will be deleted.

python2 -v -id 123456789012345678

The same as above but skips all replies and retweets.

python2 -v -id 123456789012345678 -rt -re

Archive all tweets until Dec 31, 2014 and then delete them from your Twitter timeline. Tweets will be saved in ascending date order. Verbose logs will be displayed.

python2 -v --max-date "2014-12-31" --asc --remove 

Archive all likes until Dec 31, 2014 and then delete them from Twitter. Likes will be saved in ascending date order. Verbose logs will be displayed.

python2 -v --likes --max-date "2014-12-31" --asc --remove

Generated ePub files can be found in the sub folder ./shut-up-bird.arch, e.g., ./shut-up-bird.arch/2017-03-05_1000/tweets.epub.

Note that you must explicitly specify the --remove option in order to delete tweets or likes. Tweets or likes will be deleted only after an ePub file was successfully created first.


MIT License


Please note that I SHALL NOT be held liable in case you lose your data using this script!