This is a tool that downloads twitter user information and tweets to a SQLite database.

You need to have Python (it was developed with 3.x, but it should run on 2.x too), pip and virutalenv installed. You can follow this blog post (osx), (windows).

When you're ready with the requirements, go to the the repository root and create a new virtualenv:

virtualenv env/ -p /usr/local/bin/python3

/usr/local/bin/python3 is the path to your python 3 executable. It should be this one if you followed the instructions from the blog post.

When you have created your virutalenv, you have to activate it. This is done by running:

source env/bin/activate

You will notice that you will have (env) in front of your prompt. This means the virutalenv is activated successfully. You need to do this every time you need to install/run something related to the script.

Then you need to install packages dependencies:

pip install -r requirements.txt

Copy config.py.example to config.py and fill in application keys. You can obtain them from here.

It requires a CSV file with 2 columns and a header. Example:

source,user
source1,twitter_user1
source2,twitter_user2
source3,twitter_user3

Make sure you've activated your virtualenv (you will see (env) in front of you command prompt) and then run:

python twitter-digger.py path-to-csv-file.csv