{"id":19365311,"url":"https://github.com/coredev-uk/reddit-background-changer","last_synced_at":"2025-08-20T02:10:48.669Z","repository":{"id":53491071,"uuid":"341605897","full_name":"coredev-uk/reddit-background-changer","owner":"coredev-uk","description":"A simple python script that fetches the top image from a chosen subreddit and sets it to your background.","archived":false,"fork":false,"pushed_at":"2021-06-14T12:17:16.000Z","size":2059,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-08-15T23:57:33.248Z","etag":null,"topics":["python-script","reddit-background-changer"],"latest_commit_sha":null,"homepage":"https://c0r3.uk","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/coredev-uk.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2021-02-23T15:49:24.000Z","updated_at":"2021-06-17T19:30:15.000Z","dependencies_parsed_at":"2022-08-19T05:50:45.753Z","dependency_job_id":null,"html_url":"https://github.com/coredev-uk/reddit-background-changer","commit_stats":null,"previous_names":[],"tags_count":7,"template":false,"template_full_name":null,"purl":"pkg:github/coredev-uk/reddit-background-changer","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/coredev-uk%2Freddit-background-changer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/coredev-uk%2Freddit-background-changer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/coredev-uk%2Freddit-background-changer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/coredev-uk%2Freddit-background-changer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/coredev-uk","download_url":"https://codeload.github.com/coredev-uk/reddit-background-changer/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/coredev-uk%2Freddit-background-changer/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":271252993,"owners_count":24726918,"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-08-20T02:00:09.606Z","response_time":69,"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":["python-script","reddit-background-changer"],"created_at":"2024-11-10T07:39:43.206Z","updated_at":"2025-08-20T02:10:48.629Z","avatar_url":"https://github.com/coredev-uk.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Reddit Background Changer\nA simple python script that fetches an image from your desired subreddit and sets it to your background.\n\n## Features\n- Pick your favourite subreddits\n- Custom background to use at night (Either from an image on the internet or from your PC)\n- Notification when you get a new background.\n- Blacklist images you dont like\n- Get images tailored to your resolution\n- Many more features are shown in the config below, so take a look at that if you want some more insight into what this script can do.\n\n## Required Modules\n- [PyWin32](https://pypi.org/project/pywin32/)\n- [Win10Toast-Click](https://pypi.org/project/win10toast-click/)\n- [Astral](https://pypi.org/project/astral/) - Optional if you want to use the night backgrounds (Remove it from the imports if you don't want to use it)\n\n## Configuration\n*Create a file called `config.py` and copy all the contents of [template_config.py](https://github.com/coredev-uk/reddit-background-changer/blob/main/template_config.py#L3) then edit all you want.*\n```python\nSETTINGS = {\n    \"blacklist\": [], # Add the image ID or if you use save-images you can use the file name of what you'd not like to see in the future\n    \"subreddits\": ['EarthPorn'], # Add your subreddit's here, its randomised each time its ran, so it'll be one from the list (it can just be one subreddit if you'd just like that)\n    \"diff-bg\": False, # This just gives you a different background from reddit everytime it checks, I suggest not turning it on if you run the script very often as it will run out of images and default to the first one after.\n    \"monitor-x\": \"\", # This is your monitor x resolution of your highest resolution monitor (I.e. 1920 for a 1920x1080 (1080p) display) - Leave this empty if you would like it to auto-detect your primary display resolution. (and if you have a single monitor)\n    \"monitor-y\": \"\", # This is your monitor y resolution of your highest resolution monitor (I.e. 1080 for a 1920x1080 (1080p) display) - Leave this empty if you would like it to auto-detect your primary display resolution. (and if you have a single monitor)\n    \"night-backgrounds\": {\n        \"toggle\": True, # Do you want to enable different backgrounds at night (Sunset to Sunrise using Astral)\n        \"diff-bg\": False,\n        \"methods\": {\n            \"chosen-method\": \"All\", # Link / Local / Subreddit / All | Do you want night backgrounds to be fetched from Local (Your custom path), Link (From links below), Subreddit (Also below) or all where it just randomises.\n            \"links\": [], # This pretty much is the options you have for where you get your backgrounds at night\n            \"subreddits\": [], # This is the method you chose to use, this can be either Link, Local, Subreddit or All. These will be explained below.\n            \"local\": False, # This enables the use of custom images, that you can store in your own custom directory, or the one already made in `img/bg_custom`. Images need to be PNG/JPG/JPEG format, and it picks a random one from the file, so only put one in there if you just want one being used.\n        },\n        \"city\": 'London', # If you are using night-backgrounds, you will need to put your local large city in here. Check https://astral.readthedocs.io/en/latest/#cities list to find the closest one to you.\n        \"notify\": False # This is if you would like to be notified if you got a new background at night. This occurs every time you run the script if you use custom method.\n    },\n    \"downloaded-path\": os.getcwd() + \"\\\\img\\\\bg_Downloaded\\\\\", # This is for the directory where you would like images to be downloaded to and stored.\n    \"custom-path\": os.getcwd() + \"\\\\img\\\\bg_Custom\\\\\", # This is where you can put your custom images that is used for night backgrounds, if you're not using night backgrounds just leave this default.\n    \"active-path\": os.getcwd() + \"\\\\img\\\\bg_Active\\\\\", # I also suggest leaving this default. This is where your active background images is stored (aside from if you use custom backgrounds).\n    \"imgur\": { # This feature allows you to put imgur albums in your links table, you need to go to https://api.imgur.com/oauth2/addclient and create an application if you'd like to use this feature.\n        \"client_id\": \"\", \n        \"client_secret\": \"\",\n        \"album_max\": 25\n    }\n}\n```\n\n## Task Scheduler Setup\n1. Open `taskschd.msc` and on the right panel there is an option to **Import Task**, click that.\n2. Navigate to your Reddit-Background-Changer install and go into the bin folder.\n3. Click on `Reddit Background Changer.xml` and this should open a prompt in Task Scheduler.\n4. In this prompt you need to go to **Actions** and edit the 'Start a program' action.\n5. All you need to do is change the 'Start in' box to the path of your reddit-background-changer install (I.e. C:\\Users\\%LOCALUSER%\\Downloads)\n*You can repeat all the previous if you wish to use the directory cleaner (this just wipes the images daily to optimise storage) as well.*\n\n## Final Notes\nWith the blacklist, to get the image ID you just look at the link of the post.\n\n![Reddit Image ID](https://i.imgur.com/E2AQYv0.png \"Reddit Image ID\")\n\nYou can open the page of your background by clicking on the notification of when your wallpaper changes, or you can find it on your chosen subreddit.\n- [Link to some good subreddits](https://www.reddit.com/r/sfwpornnetwork/wiki/network)\n\n## Credits\n[Member87](https://github.com/member87) - Made the base script and helped out with additions I made\n\n## Alternatives\nI highly recommend [Reddit-Wallpaper](https://github.com/Mamiglia/Reddit-Wallpaper) by Mamaiglia is you are looking for a UI based Reddit Wallpaper Changer.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcoredev-uk%2Freddit-background-changer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcoredev-uk%2Freddit-background-changer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcoredev-uk%2Freddit-background-changer/lists"}