Skip to content
Reddit daily image grabber
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.


Reddit daily image grabber script. It can be used to download images from subreddits, specific redditor's submissions, your saved submissions, etc.


  • Latest version of Python
  • Required packages: praw (Reddit API Wrapper for Python)
  • Registering the script on Reddit (see below for instruction)


  1. Download the script.
  2. Install PRAW. One way to do this is python -m pip install praw. This should also automatically install the requests package which is required. For more details, see
  3. Register the script on Set the app type to 'script'. 'Name' and 'description' can be anything you want. About url can be blank. Redirect url should be http://localhost:8080
  4. Run Python -i to automatically create praw.ini file but you must fill out the values yourself (use the values generated from registering on Reddit). The client_id is the code underneath the script name in Reddit. Make sure your client_secret is kept private. The user_agent can be a short description of your script. Below is an example praw.ini (use your own values and not the one in the example).
user_agent=image grab script by boohen

#complete below section if extraction fails due to authorization error

Usage guide

This script is designed as a daily image grab script because the script terminates when a duplicate filename is found.

Minimum argument needed for the extraction to work succesfully is only the subreddit name or username (--redditor flag needed).

python [OPTIONS] subreddit

Example usage:

  • python cozyplaces --limit 100
  • To download from your saved submissions: python myredditusername --redditor --sort saved Warning: this requires you to specify your username and password in plaintext on praw.ini. Proceed at your own discretion.


  -h, --help            show this help message and exit
  --force, -f           Overwrite existing files and continue extraction
                        (default: False)
  -i                    Create praw.ini (default: False)
  --limit LIMIT, -l LIMIT
                        Set the limit for maximum number of posts that will be
                        requested (default: 1000)
  --no-nsfw             Do not download images that are marked nsfw (default:
  --path PATH, -p PATH  Specify the download directory path (default: None)
  --sort SORT, -s SORT  Set frontpage sort type. For example: 'hot',
                        'controversial' (default: new)
  --redditor, -r        Extract from redditor instead of subreddit. (default:


Thank you youtube-dl for inspiration.

You can’t perform that action at this time.