Downloads all videos and images from a Twitter account.
Supports downloading an user's tweets, retweets, and likes.
twitter_media_downloader.py [-h] [-o DIR] [-f FORMAT] [-s IMAGE_SIZE] [-r] [-u] [-q] userid [...]
On first run, the program will ask you for your OAuth consumer key and consumer secret. It will then be stored in a .oauth.json
file so that you don't need to enter them every single time.
It will also ask your access token and access token secret. Those are only required if you are planning to access protected accounts.
userid
: the account name or ID (1 or more), if it starts with a @
it will be opened as a file (one account per line)-h
, --help
: show the help and exit-o DIR
, --output DIR
: set the output directory where medias will be downloaded-f FORMAT
, --format FORMAT
: the filename format, see below for the available tokens to use-s IMAGE_SIZE
, --image-size IMAGE_SIZE
: the preferred image size to download, will fallback to the default size if not available--since DATE
: the start date of the search, accepted formats: YYYY-mm-dd HH:MM
and YYYY-mm-dd
(defaults to 00:00)--since-id ID
: the start ID of the search (exclusive)--until DATE
: the end date of the search, accepted formats: YYYY-mm-dd HH:MM
and YYYY-mm-dd
(defaults to 00:00)--until-id ID
: the end ID of the search (inclusive)-r
, --retweets
: also download medias from retweets-l
, --likes
: download an user's likes instead of its tweets-u
, --userid
: append the userid to the output directory-q
, --quiet
: disable outputpython twitter_media_downloader.py -o out -f "[%date%] %filename%.%ext%" -s large -u Twitter
Will download all of the Twitter
account media files into the out/Twitter/
directory, each file named like [2017-01-11 05-56-33] C13U6d-VQAAVKeY.jpg
.
tweet_id
: the tweet identifier (original_tweet_id
for retweets)date
: the tweet post date (original_date
for retweets)user_id
: the tweet author ID (original_user_id
for retweets)user_name
: the tweet author name (original_user_name
for retweets)user_screen_name
: the tweet author screen name / username (original_user_screen_name
for retweets)filename
: the file filename on the serverext
: the file extensiontype
: "tweet" or "retweet"The program is licensed under the Apache License 2.0.