Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/tsarjak/downloadredditimages
Easily download all the images from any subreddit (also select sort_type if you want hot/top/new/controversial, and also sort_time day/week/month/year/all). Randomly select downloaded images and set as wallpaper, updating every 30 mins (or whenever you want duh)!
https://github.com/tsarjak/downloadredditimages
download-photos downloader earthporn easy gnome image-downloader linux linux-desktop linux-mint reddit reddit-crawler run ubuntu wallpaper wallpaper-changer
Last synced: 3 days ago
JSON representation
Easily download all the images from any subreddit (also select sort_type if you want hot/top/new/controversial, and also sort_time day/week/month/year/all). Randomly select downloaded images and set as wallpaper, updating every 30 mins (or whenever you want duh)!
- Host: GitHub
- URL: https://github.com/tsarjak/downloadredditimages
- Owner: tsarjak
- License: mit
- Created: 2017-02-21T10:26:46.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2024-06-14T20:27:55.000Z (4 months ago)
- Last Synced: 2024-09-24T19:09:36.382Z (3 days ago)
- Topics: download-photos, downloader, earthporn, easy, gnome, image-downloader, linux, linux-desktop, linux-mint, reddit, reddit-crawler, run, ubuntu, wallpaper, wallpaper-changer
- Language: Python
- Homepage:
- Size: 93.8 KB
- Stars: 87
- Watchers: 5
- Forks: 22
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Download Images/Media from your choice of Subreddit!
Using this script:
* **No Setup Needed!**
* **Download any number of images** from **Any Subreddit!** Tested by downloading 500 images.
* Select your sort type **(Top, Hot, New, Controversial)**
* Select your sort time **(All, Year, Month, Week, Day)**
* Extremely **Reliable Downloading.** With **progress bar showing ETA.**
* Download using **ParallelProcessing**
* Specify your **custom save location**
* Major reddit media servers supported **(i.redd.it, imgur, gfycat, redgif)**
* **If media server is unsupported, Download raw previews**
* (Optional) Install tqdm to see tqdm progress and time estimates. Without tqdm, native progress bar is printed to terminal output.
#### PS: Automatic wallpaper setting from downloaded images and support for python v2.x has been removed in latest update. Feature will be added back soon(~1 week). Please use the old version if you absolutely need that feature.
### No Dependencies! Just Download and Run!
Just download the files and run the file - no need to setup anything at all!
To download via Terminal:
```shell
git clone https://github.com/tsarjak/WallpapersFromReddit.git
# Next step is Fully Optional - to use tqdm progress bar. Without this, native progress bar will show up with exact same features, just a little less pretty.
pip install tqdm
```
### To run the code
In terminal:
```shell
# In the Home Directory or the Directory in which you cloned/downloaded the script
cd ~/DownloadRedditImages
python download.py
--subreddit
--sort_type
--sort_time
--download_dir
--max_post_downloads
--max_simultaneous_downloads
--max_trials
```
## Example:
```shell
python download.py --subreddit pics --sort_type top --sort_time all --max_post_downloads 40 --download_dir /Users/user_me/Pictures/RedditMedia/
# This will download top 50 posts of all time from earthporn subreddit to /Users/user_me/Pictures/RedditMedia folder.
```
* Without tqdm installed:
* With tqdm installed (optional):
### Changelogs:
#### v2.1.1 - Dec 11, 2022:
* Code cleanup and minor bug fixes.
#### v2.1.0 - Dec 10, 2022:
* Added support for mp4 and gif downloads.
* Added support to download directly from media servers (imgur, i.redd.it, gfycat, redgifs) instead of reddit post previews.
* For other media servers, fallback to reddit post preview download.
* Added native progress bar. As well as tqdm progress bar for those who already have it installed on their systems.
* Removed support for automatic wallpaper changing for Linux and Mac. Support will be added back in v2.1.2.
* Removed support for python v2.x. Some requests/url libraries are difficult to maintain for python v2.x now.
#### v2.0.0 - April 1, 2021:
* With this release, WallpapersFromReddit is a **No Setup Needed** script. This release **gets rid of all the requirements**, essentially making this a download and run program.
* Add support to select the sort_type for downloading images. Previously, only ```hot``` was supported, but now ```hot, top, new, controversial``` are supported.
* Add support to select the sort_time for downloading images. Previously, only ```day``` was supported, but now ```day, week, month, year, all``` are supported.
* A major overhaul of the entire codebase. The previous code has been refactored for clarity, optimization and to avoid some unwanted and unexpected behavior.
#### Grab the previous release here! For wallpaper and python v2.x support.
DownloadRedditImages v2.0.0 - https://github.com/tsarjak/WallpapersFromReddit/releases/tag/v2.0.0