Twitter timeline cleaner

Clean your Twitter timeline

Prerequisites

Before running, remember to set these environment variables:

export TWITTER_ACCESS_TOKEN='' 
export TWITTER_ACCESS_TOKEN_SECRET='' 
export TWITTER_CONSUMER_KEY='' 
export TWITTER_CONSUMER_SECRET='' 
export TWITTER_NAME='@your_twitter_name' 

and follow the instructions to claim a Twitter developers account and to create an app, needed to fetch your Twitter timeline's tokens and keys.

Usage

usage: twitter-timeline-cleaner.py [-h] --until UNTIL_DATE [--dry-run] [--save] [--limit LIMIT]

Maintain clean your Twitter timeline

optional arguments:
  -h, --help          show this help message and exit
  --until UNTIL_DATE  delete tweets until this date (YYYY-MM-DD)
  --dry-run           simulate (don't delete anything)
  --save              save deleted tweets in JSON
  --limit LIMIT       define how many tweets to delete (default: all)

Article in italian talking about this project: Ripulire la propria Twitter timeline

Work inspired by delete-tweets by Koen Rouwhorst