Note: This project is no longer supported. As of 2023 Twitter charges for their API and I don't expect there to be any future releases. I hope this project has been beneficial to your mental health and thank you for the kudos over the years.

A cli / command-line / terminal program to mute everyone you follow on Twitter.

Developed with Python. Supports Windows, OS X, and Linux.

Pre-compiled binaries for Windows and OS X are available under releases.

Before you run this application you'll need to set environment variables for CONSUMER_KEY, CONSUMER_SECRET, ACCESS_TOKEN_KEY and ACCESS_TOKEN_SECRET.

A walkthrough on how to setup this environment follows.

To run this program you will first need a Twitter developer account. As of late 2019 these accounts are free and easy to register for.

Go to https://developer.twitter.com/ and sign up for a personal / hobbyist account from the Twitter account you will use to run this program.

Next, you'll need to get four account codes from twitter and set them in your environment. To get these four codes, you'll need to create a personal (private) twitter application. Note you won't be making a real app, it's just something Twitter requires.

Here's how to do it:

1. From a desktop browser sign into twitter, then go to https://developer.twitter.com/en/apps and click on the 'Create a new app' button in the upper right corner of the screen.

2. Next, fill out the create an application form as follows:

• Enter any name. Note the name of the application must be unique across all of twitter. If you get an error, try using: - Mute them all

• Description can be anything.

• The website can be any site starting with https:// ex: https://www.google.com

• Leave the Callback URL field blank.

• Check the checkbox for the developer agreement and submit the form.

3. You should now be in a settings area for the application. Under Application Settings, click "manage keys and access tokens"

4. Next, click on "Keys and Tokens" in the tabs area directly under the top heading.

5. Note your Consumer Key and Consumer Secret codes from the top table under Consumer API Keys. These are the first two keys.

6. Now scroll down to the very bottom of the page and click on the 'Create my access token' button. Note your access token key and access token secret codes.

Next, set your environment with these values.

On OS X and Linux open a terminal and enter:

export CONSUMER_KEY=consumer_key_from_above
export CONSUMER_SECRET=consumer_secret_from_above
export ACCESS_TOKEN_KEY=access_key_from_above
export ACCESS_TOKEN_SECRET=access_secret_from_above

On Windows open a cmd prompt and enter:

set CONSUMER_KEY=consumer_key_from_above
set CONSUMER_SECRET=consumer_secret_from_above
set ACCESS_TOKEN_KEY=access_key_from_above
set ACCESS_TOKEN_SECRET=access_secret_from_above

Now you are ready to run the program.

You can download binary releases for Windows and Mac here. Be sure to run the binary in the same terminal/cmd prompt you set the environment for.

pip install -r requirements.txt
python main.py

Contributions are welcome! Please create or locate a related issue and reference it your pull request.

Created by Kate Kligman. Inspired by go-twitter-mute-them-all by ledyba.

GPL v2.0