Bulk Downloader for Reddit

This program downloads imgur, gfycat and direct image and video links of saved posts from a reddit account. It is written in Python 3.

PLEASE post any issue you have with the script to Issues tab. Since I don't have any testers or contributers I need your feedback.

What it can do

• Can get posts from: frontpage, subreddits, multireddits, redditor's submissions, upvoted and saved posts; search results or just plain reddit links
• Sorts posts by hot, top, new and so on
• Downloads imgur albums, gfycat links, self posts and any link to a direct image
• Skips the existing ones
• Puts post titles to file's name
• Puts every post to its subreddit's folder
• Saves a reusable copy of posts' details that are found so that they can be re-downloaded again
• Logs failed ones in a file to so that you can try to download them later
• Can run with double-clicking on Windows

Download the latest release

How it works

• For Windows and Linux users, there are executable files to run easily without installing a third party program. But if you are a paranoid like me, you can compile it from source code.

  • In Windows, double click on script.exe file
  • In Linux, extract files to a folder and open terminal inside it. Type ./script

• MacOS users have to compile it from source code.

Script also accepts command-line arguments, get further information from python script.py --help

Setting up the script

Because this is not a commercial app, you need to create an imgur developer app in order API to work.

Creating an imgur app

• Go to https://api.imgur.com/oauth2/addclient
• Enter a name into the Application Name field.
• Pick Anonymous usage without user authorization as an Authorization type*
• Enter your email into the Email field.
• Correct CHAPTCHA
• Click submit button

It should redirect to a page which shows your imgur_client_id and imgur_client_secret

* Select OAuth 2 authorization without a callback URL first then select Anonymous usage without user authorization if it says Authorization callback URL: required

FAQ

I can't open the self post files.

• Self posts are held at reddit as styled with markdown. So, the script downloads them as they are in order not to lose their stylings. However, there is a great Chrome extension for viewing Markdown files with its styling. Install it and open the files with Chrome.

Changelog

12/07/2018

• Added binaries for Windows and Linux
• Wait on KeyboardInterrupt
• Fixed the bug that prevents choosing "[0] exit" with typing "exit"

11/07/2018

• Improvements on UX and UI
• Added logging errors to CONSOLE_LOG.txt
• Using current directory if directory has not been given yet.

10/07/2018

• Added support for self post
• Now getting posts is quicker