Skip to main content
Join the official 2019 Python Developers SurveyStart the survey!

Image downloader based on subreddit.

Project description



The script will pull the top posts from the subreddit you give it.

It will look through the posts to find images and then download them to /images.

You will need a bot login for Reddit. See:

For praw config information see:

Required praw.ini entries are:
- [download_bot]
- client_id=
- client_secret=
- user_agent='Python:reddit_image_downloader:0.0.2 (by /u/merchantjeff)'


usage: [-h] [-l LIMIT] [-a] [-s {new,hot,top,rising}] [-v]
               sub [sub ...]

Tool allowing the downloading of images and gifs from listed subreddit.

positional arguments:
  sub                   Input subreddit for downloading.

optional arguments:
  -h, --help            show this help message and exit
  -l LIMIT, --limit LIMIT
                        Number of submissions to be downloaded.
  -a, --album           Allow Imgur albums
  -s {new,hot,top,rising}, --sort {new,hot,top,rising}
                        Change default sort.
  -v, --verbose         More verbose logging.


as per requirements.txt

pip install -r requirements.txt


Logging is on at debug as default, it creates a main.log file on run.

Project details

Release history Release notifications

This version


Download files

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

Files for reddit-downloader, version 0.0.2
Filename, size File type Python version Upload date Hashes
Filename, size reddit_downloader-0.0.2-py3-none-any.whl (5.8 kB) File type Wheel Python version py3 Upload date Hashes View hashes
Filename, size reddit_downloader-0.0.2.tar.gz (4.4 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 SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page