Skip to main content

Twitter image downloader

Project description


What it does

Download all images uploaded by a specified Twitter user.

What you need

  • Python 3


First, you need to install twitter-image-dl:

$ pip install twitter-image-dl

Next, you need to generate your api key and api secret key. If you don't have them, go to Twitter Developers and create your application. After you get your api key and api secret key, create a json file like this:

  "api_key": "your api key",
  "api_secret": "your api secret key"


To download the images the user of id "foo" has uploaded, enter the command like the following on the command line:

$ twt_img foo -c confidentials.json

where confidentials.json is the json file containing your api keys. This command creates a directory called foo and save images to that directory.

If you want to save images to a directory other than foo, use -d or --dest argument to specify the destination.

You can specify which size of images to download using the optional argument -s (or --size). There are five values you can specify:

  • large
  • medium
  • small
  • orig
  • thumb

If you don't specify this value, images of large size will be downloaded by default.

Using the --rts flag, you can also download images contained in retweets.

Provide a number to the -l or --limit argument (e.g. -l 25) to limit how many tweets are inspected for images (starting with the most recent). Note that if you're using --limit without --rts, the number of tweets inspected can be smaller than the specified limit.


Install dependencies for testing and enter pytest command like this:

$ gi clone
$ cd twitter-image-downloader
$ pipenv install --dev
$ pipenv run test

Notice that you have to set KEY and SECRET environment variables for testing to work.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for twitter-image-dl, version 0.2.0
Filename, size File type Python version Upload date Hashes
Filename, size twitter_image_dl-0.2.0-py3-none-any.whl (6.5 kB) File type Wheel Python version py3 Upload date Hashes View hashes
Filename, size twitter-image-dl-0.2.0.tar.gz (4.9 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page