Skip to main content

Clean-up inactive accounts and bots from your Twitter

Project description

Twitter Clean-up GitHub Actions: Black workflow

🇧🇷 Versão em português do Brasil

Tiny script to clean-up your Twitter account:

  • Removing users that have not been tweeting for a while
  • Soft-blocking bots (blocks and immediately unblocks the account, so it stops following you)


  • Python 3.6+
  • Set environment variables with your Twitter API keys and with Botometer API key:


Install the package with:

$ pip install twitter-cleanup


Run the CLI with twitter-cleanup --help and follow the on screen instructions.

For example, unfollow everyone that hasn't tweeted in the last 30 days with:

$ twitter-cleanup inactive 30

Or soft-block every bot with:

$ twitter-cleanup bots


Please, format your code with Black.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for twitter-cleanup, version 0.0.6
Filename, size File type Python version Upload date Hashes
Filename, size twitter_cleanup-0.0.6-py3-none-any.whl (19.8 kB) File type Wheel Python version py3 Upload date Hashes View hashes
Filename, size twitter-cleanup-0.0.6.tar.gz (5.7 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page