twitter-photos 0.1.0

Command-line tool to get photos from Twitter accounts.

Twitter Photos is a command-line tool to get photos from Twitter accounts.

Requirements

• python-twitter

• requests

• urllib3

Installation

You can install the package with pip:

$ pip install twitter-photos

Or, you can download a source distribution and install with these commands:

$ python setup.py install

Setup

Create a config file at ~/.twphotos specifying your Twitter credentials:

[credentials]
consumer_key = your_consumer_key
consumer_secret = your_consumer_secret
access_token_key = your_access_token_key
access_token_secret = your_access_token_secret

Usage

The simplest usage is to run “twphotos” from command-line without any options. This will download all photos from the current authenticated user (you):

$ twphotos

Download all photos from an existing user other yourself with -u option followed by username:

$ twphotos -u wired

Download n most recent photos from a user using -n followed by number:

$ twphotos -u wired -n 20

Download photos to a directory other than the current one:

$ twphotos -u wired -o /path/to/dir

Enable “incremental download” to download new photos since the last downloads with -i:

$ twphotos -u wired -i

Enable “parallel download” to speedup the downloads using the -r switch:

$ twphotos -u wired -r

Print username, tweet ids, and URLs instead of downloading them with -p switch:

$ twphotos -u wired -p

You can retrieve URLs only with cut command:

$ twphotos -u wired -p | cut -d ' ' -f3

Command-line Options

The “soundmeter” command accepts the following options:

-u USER, --user USER

user account

-l LIST_SLUG, --list LIST_SLUG

list slug with –user as list owner

-o OUTDIR, --outdir OUTDIR

output directory

-p, --print

print media urls and tweet ids instead of download

-r, --parallel

enable parallel download

-n NUM, --num NUM

number of most recent photos to download

-i, --increment

download only new photos since last download