https://github.com/cuducos/twitter-cleanup

🛁 Clean-up inactive accounts and bots from your Twitter
https://github.com/cuducos/twitter-cleanup

bots maintenance social-media social-network twitter

Last synced: 4 days ago
JSON representation

🛁 Clean-up inactive accounts and bots from your Twitter

• Host: GitHub
• URL: https://github.com/cuducos/twitter-cleanup
• Owner: cuducos
• License: gpl-3.0
• Archived: true
• Created: 2018-07-21T01:38:30.000Z (over 6 years ago)
• Default Branch: master
• Last Pushed: 2021-01-02T17:05:48.000Z (almost 4 years ago)
• Last Synced: 2024-09-06T05:51:48.444Z (about 2 months ago)
• Topics: bots, maintenance, social-media, social-network, twitter
• Language: Python
• Homepage: https://pypi.org/project/twitter-cleanup/
• Size: 67.4 KB
• Stars: 288
• Watchers: 12
• Forks: 24
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG
  • Funding: .github/FUNDING.yml
  • License: LICENSE

Awesome Lists containing this project

README

        
# Twitter Clean-up [![GitHub Actions: Black workflow](https://github.com/cuducos/twitter-cleanup/workflows/Black/badge.svg)]() [![GitHub Actions: Tests workflow](https://github.com/cuducos/twitter-cleanup/workflows/Tests/badge.svg)]()

> [🇧🇷 Versão em português do Brasil](docs/README.pt-BR.md)

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)

## Requirements

* Python 3.6+

* Set environment variables with your [Twitter API keys](https://apps.twitter.com/) and with [Botometer API key](https://rapidapi.com/OSoMe/api/botometer):

    * `TWITTER_CONSUMER_KEY`

    * `TWITTER_CONSUMER_SECRET`

    * `TWITTER_ACCESS_TOKEN_KEY`

    * `TWITTER_ACCESS_TOKEN_SECRET`

    * `BOTOMETER_MASHAPE_KEY`

## Installing

Install the package with:

```console

$ pip install twitter-cleanup

```

Usage

-----

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:

```console

$ twitter-cleanup inactive 30

```

Or soft-block every bot with:

```

$ twitter-cleanup bots

```

Contributing

------------

Please, write and run tests locally, and format your code with [Black](https://github.com/ambv/black>):

```console

$ python setup.py test

$ black .

```