Skip to main content

Clean-up inactive accounts and bots from your Twitter

Project description

Twitter Clean-up GitHub Actions: Black workflow GitHub Actions: Tests 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, write and run tests locally, and format your code with Black:

$ python test
$ 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.7
Filename, size File type Python version Upload date Hashes
Filename, size twitter-cleanup-0.0.7.tar.gz (8.0 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page