docs | ||
src | ||
_config.yml | ||
.gitignore | ||
LICENSE | ||
README.md | ||
requirements.txt | ||
script.py |
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 can it do?
It...
- 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 be run with double-clicking on Windows (but I don't recommend it)
Download the latest release
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
Running the script
For Windows users, there is an EXE file to run easily.
Linux and MacOS users have to install Python 3 and run it from the source code through terminal.
To get further information about that and using command-line arguments to run the script, see python script.py --help
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 here for viewing Markdown files with its styling. Install it and open the files with Chrome.
Changelog
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