Skip to main content
Join the official 2020 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

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
Filename, size reddit_downloader-0.0.2.tar.gz (4.4 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page