{"id":15731838,"url":"https://github.com/tsarjak/DownloadRedditImages","last_synced_at":"2025-10-14T22:30:31.639Z","repository":{"id":48297628,"uuid":"82666919","full_name":"tsarjak/DownloadRedditImages","owner":"tsarjak","description":"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)!","archived":false,"fork":false,"pushed_at":"2024-06-14T20:27:55.000Z","size":96,"stargazers_count":94,"open_issues_count":5,"forks_count":23,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-08-15T06:40:58.810Z","etag":null,"topics":["download-photos","downloader","earthporn","easy","gnome","image-downloader","linux","linux-desktop","linux-mint","reddit","reddit-crawler","run","ubuntu","wallpaper","wallpaper-changer"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/tsarjak.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2017-02-21T10:26:46.000Z","updated_at":"2025-08-10T05:43:46.000Z","dependencies_parsed_at":"2024-07-11T14:09:53.433Z","dependency_job_id":null,"html_url":"https://github.com/tsarjak/DownloadRedditImages","commit_stats":null,"previous_names":["tsarjak/wallpapersfromreddit"],"tags_count":5,"template":false,"template_full_name":null,"purl":"pkg:github/tsarjak/DownloadRedditImages","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tsarjak%2FDownloadRedditImages","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tsarjak%2FDownloadRedditImages/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tsarjak%2FDownloadRedditImages/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tsarjak%2FDownloadRedditImages/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tsarjak","download_url":"https://codeload.github.com/tsarjak/DownloadRedditImages/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tsarjak%2FDownloadRedditImages/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279021785,"owners_count":26087056,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-14T02:00:06.444Z","response_time":60,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["download-photos","downloader","earthporn","easy","gnome","image-downloader","linux","linux-desktop","linux-mint","reddit","reddit-crawler","run","ubuntu","wallpaper","wallpaper-changer"],"created_at":"2024-10-04T00:06:13.266Z","updated_at":"2025-10-14T22:30:31.300Z","avatar_url":"https://github.com/tsarjak.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Download Images/Media from your choice of Subreddit!\n\nUsing this script:\n* **No Setup Needed!**\n* **Download any number of images** from **Any Subreddit!** Tested by downloading 500 images.\n* Select your sort type **(Top, Hot, New, Controversial)**\n* Select your sort time **(All, Year, Month, Week, Day)**\n* Extremely **Reliable Downloading.** With **progress bar showing ETA.**\n* Download using **ParallelProcessing**\n* Specify your **custom save location**\n* Major reddit media servers supported **(i.redd.it, imgur, gfycat, redgif)**\n* **If media server is unsupported, Download raw previews**\n* (Optional) Install tqdm to see tqdm progress and time estimates. Without tqdm, native progress bar is printed to terminal output.\n\n\n#### 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.\n\n### No Dependencies! Just Download and Run!\nJust download the files and run the file - no need to setup anything at all!\n\nTo download via Terminal:\n```shell\ngit clone https://github.com/tsarjak/WallpapersFromReddit.git\n\n# 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.\npip install tqdm\n```\n\n### To run the code\n\nIn terminal:\n```shell\n# In the Home Directory or the Directory in which you cloned/downloaded the script\ncd ~/DownloadRedditImages\npython download.py \n  --subreddit \u003cyour choice of subreddit\u003e \n  --sort_type \u003chot|new|rising|top\u003e \n  --sort_time \u003call|year|month|week|day\u003e\n  --download_dir \u003cDirectory where you want to store the images. For Max/Linux, the script can identify home directory and sets a RedditMedia folder there. For Windows, a path MUST be provided\u003e\n  --max_post_downloads \u003cMaximum number of posts media to download. Default=10\u003e\n  --max_simultaneous_downloads \u003cMaximum number of simultaneous downloads to run using multiple CPU cores. Default=16.\u003e\n  --max_trials \u003cMaximum number of trials to fetch subreddit data. Sometimes the response is slow and multiple attempts are needed. Default=20.\u003e\n```\n\n## Example: \n```shell\npython download.py --subreddit pics --sort_type top --sort_time all --max_post_downloads 40 --download_dir /Users/user_me/Pictures/RedditMedia/\n# This will download top 50 posts of all time from earthporn subreddit to /Users/user_me/Pictures/RedditMedia folder.\n```\n* Without tqdm installed:\n\u003cimg width=\"741\" alt=\"Screen Shot 2022-12-11 at 2 31 50 AM\" src=\"https://user-images.githubusercontent.com/9898343/206898666-d9f95e4f-3bd1-4f37-9372-32f4009a434c.png\"\u003e\n\n* With tqdm installed (optional):\n\u003cimg width=\"944\" alt=\"Screen Shot 2022-12-11 at 2 20 41 AM\" src=\"https://user-images.githubusercontent.com/9898343/206898223-3872e046-a8d3-4199-b4da-00ed9a429005.png\"\u003e\n\n\n### Changelogs:\n\n#### v2.1.1 - Dec 11, 2022:\n* Code cleanup and minor bug fixes.\n\n#### v2.1.0 - Dec 10, 2022:\n* Added support for mp4 and gif downloads.\n* Added support to download directly from media servers (imgur, i.redd.it, gfycat, redgifs) instead of reddit post previews.\n* For other media servers, fallback to reddit post preview download.\n* Added native progress bar. As well as tqdm progress bar for those who already have it installed on their systems.\n* Removed support for automatic wallpaper changing for Linux and Mac. Support will be added back in v2.1.2.\n* Removed support for python v2.x. Some requests/url libraries are difficult to maintain for python v2.x now.\n\n\n#### v2.0.0 - April 1, 2021:\n* 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.\n* Add support to select the sort_type for downloading images. Previously, only ```hot``` was supported, but now ```hot, top, new, controversial``` are supported.\n* Add support to select the sort_time for downloading images. Previously, only ```day``` was supported, but now ```day, week, month, year, all``` are supported.\n* A major overhaul of the entire codebase. The previous code has been refactored for clarity, optimization and to avoid some unwanted and unexpected behavior.\n\n#### Grab the previous release here! For wallpaper and python v2.x support.\nDownloadRedditImages v2.0.0 - https://github.com/tsarjak/WallpapersFromReddit/releases/tag/v2.0.0\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftsarjak%2FDownloadRedditImages","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftsarjak%2FDownloadRedditImages","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftsarjak%2FDownloadRedditImages/lists"}