Skip to content
This repository has been archived by the owner. It is now read-only.
Command line utility to manage twitter accounts following a large amount of users.
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.

Twitter Anew

If you follow so many people on twitter that your feed becomes an endless 24/7 deluge of depressing hot takes about why everything sucks, then Twitter Anew may just be for you.

Useful tools for your fresh start include:

  • Creating a Twitter list that stores everyone you're following.
  • Generating a backup file that stores all users you currently follow.
  • Unfollowing everyone!

And God forbid you want to follow them all again, you can do that too.

Table of Contents


Twitter Anew is made in Python3, so you'll need that first.

The following Python packages are required: docopt, tweepy & requests_oauthlib. You can use pip to install them all.

pip install docopt tweepy requests_oauthlib

We can't forget to download this repository.

git clone

Enter the new directory created by the clone.

cd twitter-anew

And install the program like so.

python install --user

Now you can't quite run the tanew program yet—you'll need to register a Twitter application first!


So Twitter requires all API requests, such as those used in Twitter Anew, to be handled by a "registered application". For security reasons and such I haven't distributed my own application's keys, but fortunately it's a really simple process.

Being signed in on twitter, go to and press the 'Create New App' button. Fill out the necessary details in the form presented and proceed. who

Presented with the following window, first go to the 'Permissions' tab. reads

Change the permissions from 'Read only' to 'Read and Write'. these

Now go to 'Key and Acces tokens' tab and take note of the subsequent strings after the 'Consumer Key' and 'Consumer Secret' rows. things

This is the information you'll need to provide to the Twitter Anew client before it can be used. We're using a json file to store this (learn about how it works here). Create a file called app.json in the directory you installed this program (i.e. the same folder this is in), and attribute the two strings mentioned above key and secret respectively. For the above example, app.json would read as follows:

  "key": "ZyNhLthaYl7giOSEvr3k4tXZc",
  "secret": "J06jGiee9fYPQdeau9hlNXcnSypKJAs3us9R4f1EMuhtWQeqaE"

You would just replace the weird looking strings with the ones from your own application.

And now you're ready to run the tanew client! Test the application is linked properly with the tanew status command.


  tanew status
  tanew linkaccount
  tanew createlist [<file>] [-v] [--list-name=<name>] [--list-mode=<mode>]
  tanew addtolist <slug> [-v] [<file>]
  tanew backup [-v] [<file>] [--user-id=<id>]
  tanew unfollowall [-v]
  tanew followall <file> [-v]
  tanew -h | --help  
  tanew --version


Check what account is linked to the application, if any.


Generates an authorization request link for you to open. Upon accepting the request, gives you a link which you can enter in the command line interface to register your account with the tanew application.


Create a twitter list of all users followed by your linked account, or the users listed in the optional file parameter. The --list-name parameter dictates the list's name (default "Old"), and the --list-mode parameter determines whether the list generate is private or public (default private).


Add to an existing list (identified by the required slug parameter) all users followed by your linked account, or the users listed in the optional file parameter.

The slug is the shorthand name for the list that shows up in your browser, typically the full-name of the list (i.e. if my list "Old" has the url, then the slug is old).


Store all users followed by your linked account or the user specified in --user-id parameter to a backup file. By default this is backup.txt, but a different file to store the list can be specified in the file parameter.


Unfollow every user your linked account follows.


Follow every user specified in the required file parameter.

What is [-v]?

The optional v parameter stands for 'verbose'. When this option is used, detailed information on the current operations being executed by the application are displayed on the terminal.


  • Code review is probably necessary 'coz I imagine it's all a bit messy.
  • Document code that does weird specific things.
  • Have addtolist generate new lists if the LIST_MAX is exceeded.
  • Have a more detailed
  • Use proper versioning.
  • Better handling of Twitter's silent throttling? Need to think how'd that work

The above would all be nice, but I'm probably done with this unless folk would ever want to use this heh. The utility was important for my own personal use, but really this whole project was a learning experience.


Twitter Anew is licensed under MIT :)

You can’t perform that action at this time.