README.md

Twitty-Lister

This program is a simple tool to import users from a file into a Twitter list.

There is an online version at https://twittylister.herokuapp.com/

Installation (if you hate online versions)

1. Download twitty-lister.py
2. pip install -r requirements.txt

Usage

To run twitty-lister you will need two files. The first is a config.json which will contain your app keys.

{
  "consumer": {
    "secret": "YOUR-CONSUMER-SECRET-HERE",
    "key": "YOUR-CONSUMER-KEY-HERE"
  },
  "access": {
    "secret": "YOUR-ACCESS-SECRET-HERE",
    "key": "YOUR-ACCESS-KEY-HERE"
  }
}

You will also need a list file with all of your screen names to import. This can be fairly dirty as twitty-lister will clean them up for you.

@jmhobbs
whatcheer
    @alexpgates
@iliveinomaha
bnispel  
  @iloveinomaha
johnhenrymuller  

Next, you will need to run twitty-lister.py and authorize the account through the PIN mechanism. After you authorize, it will add the users in blocks of 100.

(venv)jmhobbs@Cordelia~/twitty-lister$ python twitty-lister.py "What Cheer" screen_names 
==> Loading 7 users into "What Cheer"
==> Please authorize: http://api.twitter.com/oauth/authorize?oauth_token=xzKc2CHt22Xf3yqP3R0e9D3ACCIoPbNmOxfbLZaPWE
==> PIN: 9546060
==> List doesn't exist, creating it
==> Sending #0 through #100
==> Done!

That's it!