mirror of
https://github.com/KevinMidboe/bulk-downloader-for-reddit.git
synced 2026-01-24 18:15:40 +00:00
Compare commits
3 Commits
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
82dcd2f63d | ||
|
|
08de21a364 | ||
|
|
af7d3d9151 |
34
README.md
34
README.md
@@ -1,7 +1,7 @@
|
|||||||
# Bulk Downloader for Reddit
|
# Bulk Downloader for Reddit
|
||||||
Downloads media from reddit posts.
|
Downloads media from reddit posts.
|
||||||
|
|
||||||
## [Download the latest release](https://github.com/aliparlakci/bulk-downloader-for-reddit/releases/latest)
|
## [Download the latest release here](https://github.com/aliparlakci/bulk-downloader-for-reddit/releases/latest)
|
||||||
|
|
||||||
## What it can do
|
## 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
|
- Can get posts from: frontpage, subreddits, multireddits, redditor's submissions, upvoted and saved posts; search results or just plain reddit links
|
||||||
@@ -13,8 +13,8 @@ Downloads media from reddit posts.
|
|||||||
- Saves a reusable copy of posts' details that are found so that they can be re-downloaded again
|
- 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
|
- Logs failed ones in a file to so that you can try to download them later
|
||||||
|
|
||||||
## **[Compiling it from source code](docs/COMPILE_FROM_SOURCE.md)**
|
## **Compiling it from source code**
|
||||||
*\* MacOS users have to use this option.*
|
MacOS users have to use this option. See *[here](docs/COMPILE_FROM_SOURCE.md)*
|
||||||
|
|
||||||
## Additional options
|
## Additional options
|
||||||
Script also accepts additional options via command-line arguments. Get further information from **[`--help`](docs/COMMAND_LINE_ARGUMENTS.md)**
|
Script also accepts additional options via command-line arguments. Get further information from **[`--help`](docs/COMMAND_LINE_ARGUMENTS.md)**
|
||||||
@@ -24,6 +24,30 @@ You need to create an imgur developer app in order API to work. Go to https://ap
|
|||||||
|
|
||||||
It should redirect you to a page where it shows your **imgur_client_id** and **imgur_client_secret**.
|
It should redirect you to a page where it shows your **imgur_client_id** and **imgur_client_secret**.
|
||||||
|
|
||||||
## [FAQ](docs/FAQ.md)
|
## FAQ
|
||||||
|
### How can I change my credentials?
|
||||||
|
- All of the user data is held in **config.json** file which is in a folder named "Bulk Downloader for Reddit" in your **Home** directory. You can edit
|
||||||
|
them, there.
|
||||||
|
|
||||||
## [Changes on *master*](docs/CHANGELOG.md)
|
### What do the dots resemble when getting posts?
|
||||||
|
- Each dot means that 100 posts are scanned.
|
||||||
|
|
||||||
|
### Getting posts takes too long.
|
||||||
|
- You can press *Ctrl+C* to interrupt it and start downloading.
|
||||||
|
|
||||||
|
### How are the filenames formatted?
|
||||||
|
- **Self posts** and **images** that do not belong to an album and **album folders** are formatted as:
|
||||||
|
`[SUBMITTER NAME]_[POST TITLE]_[REDDIT ID]`
|
||||||
|
You can use *reddit id* to go to post's reddit page by going to link reddit.com/[REDDIT ID]
|
||||||
|
|
||||||
|
- An **image in an album** is formatted as:
|
||||||
|
`[ITEM NUMBER]_[IMAGE TITLE]_[IMGUR ID]`
|
||||||
|
Similarly, you can use *imgur id* to go to image's imgur page by going to link imgur.com/[IMGUR ID].
|
||||||
|
|
||||||
|
### How do I open 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](https://chrome.google.com/webstore/detail/markdown-viewer/ckkdlimhmcjmikdlpkmbgfkaikojcbjk) for viewing Markdown files with its styling. Install it and open the files with [Chrome](https://www.google.com/intl/tr/chrome/).
|
||||||
|
|
||||||
|
However, they are basically text files. You can also view them with any text editor such as Notepad on Windows, gedit on Linux or Text Editor on MacOS
|
||||||
|
|
||||||
|
## [See the changes on *master* here](docs/CHANGELOG.md)
|
||||||
@@ -1,9 +1,9 @@
|
|||||||
# Compiling from source code
|
# Compiling from source code
|
||||||
## Requirements
|
## Requirements
|
||||||
### Python 3 Interpreter
|
### Python 3 Interpreter
|
||||||
Latest* version of **Python 3** is needed. See if it is already installed [here](#finding-the-correct-keyword-for-python). If not, download the matching release for your platform [here](https://www.python.org/downloads/) and install it. If you are a *Windows* user, selecting **Add Python 3 to PATH** option when installing the software is mandatory.
|
- This program is designed to work best on **Python 3.6.5** and this version of Python 3 is suggested. See if it is already installed, [here](#finding-the-correct-keyword-for-python).
|
||||||
|
- If not, download the matching release for your platform [here](https://www.python.org/downloads/) and install it. If you are a *Windows* user, selecting **Add Python 3 to PATH** option when installing the software is mandatory.
|
||||||
\* *Use Python 3.6.5 if you encounter an issue*
|
|
||||||
## Using terminal
|
## Using terminal
|
||||||
### To open it...
|
### To open it...
|
||||||
- **On Windows**: Press **Shift+Right Click**, select **Open Powershell window here** or **Open Command Prompt window here**
|
- **On Windows**: Press **Shift+Right Click**, select **Open Powershell window here** or **Open Command Prompt window here**
|
||||||
|
|||||||
23
docs/FAQ.md
23
docs/FAQ.md
@@ -1,23 +0,0 @@
|
|||||||
# FAQ
|
|
||||||
## What do the dots resemble when getting posts?
|
|
||||||
- Each dot means that 100 posts are scanned.
|
|
||||||
|
|
||||||
## Getting posts is taking too long.
|
|
||||||
- You can press Ctrl+C to interrupt it and start downloading.
|
|
||||||
|
|
||||||
## How are filenames formatted?
|
|
||||||
- Self posts and images that are not belong to an album are formatted as **`[SUBMITTER NAME]_[POST TITLE]_[REDDIT ID]`**.
|
|
||||||
You can use *reddit id* to go to post's reddit page by going to link **reddit.com/[REDDIT ID]**
|
|
||||||
|
|
||||||
- An image in an imgur album is formatted as **`[ITEM NUMBER]_[IMAGE TITLE]_[IMGUR ID]`**
|
|
||||||
Similarly, you can use *imgur id* to go to image's imgur page by going to link **imgur.com/[IMGUR ID]**.
|
|
||||||
|
|
||||||
## How do I open 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](https://chrome.google.com/webstore/detail/markdown-viewer/ckkdlimhmcjmikdlpkmbgfkaikojcbjk) for viewing Markdown files with its styling. Install it and open the files with [Chrome](https://www.google.com/intl/tr/chrome/).
|
|
||||||
|
|
||||||
However, they are basically text files. You can also view them with any text editor such as Notepad on Windows, gedit on Linux or Text Editor on MacOS
|
|
||||||
|
|
||||||
## How can I change my credentials?
|
|
||||||
- All of the user data is held in **config.json** file which is in a folder named "Bulk Downloader for Reddit" in your **Home** directory. You can edit
|
|
||||||
them, there.
|
|
||||||
@@ -279,7 +279,8 @@ class PromptUser:
|
|||||||
GLOBAL.arguments.subreddit = "+".join(GLOBAL.arguments.subreddit.split())
|
GLOBAL.arguments.subreddit = "+".join(GLOBAL.arguments.subreddit.split())
|
||||||
|
|
||||||
# DELETE THE PLUS (+) AT THE END
|
# DELETE THE PLUS (+) AT THE END
|
||||||
if not subredditInput.lower() == "frontpage":
|
if not subredditInput.lower() == "frontpage" \
|
||||||
|
and GLOBAL.arguments.subreddit[-1] == "+":
|
||||||
GLOBAL.arguments.subreddit = GLOBAL.arguments.subreddit[:-1]
|
GLOBAL.arguments.subreddit = GLOBAL.arguments.subreddit[:-1]
|
||||||
|
|
||||||
print("\nselect sort type:")
|
print("\nselect sort type:")
|
||||||
|
|||||||
Reference in New Issue
Block a user