Skip to content
Change your wallpaper to the most upvoted image of the day from /r/wallpapers or any other subreddit on system startup
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.
.gitignore Initial commit Jun 24, 2016

Daily Reddit Wallpaper

Build Status

This script changes your wallpaper to most upvoted image of the day on /r/wallpapers or from any other subreddit.

Run it on startup for new wallpaper on every session.

Supported: Linux (gnome, kde, mate, lxde), Windows and OS X


Make sure you have Python installed and PATH variable set.


If you don't have pip for Python:

sudo apt-get install python-pip

You will need modules requests and praw installed, which are in requirements.txt:

pip install -r requirements.txt


Follow this guide to install pip and configure PATH variable. The rest is the same.

Using script

Simply run:

python /home/silvio/Scripts/

If you wanna use other subreddit, include argument with the subreddit name:

python /home/silvio/Scripts/ --subreddit art

If you don't want to change your wallpaper daily, you can use newest, hourly, weekly, monthly or yearly wallpaper too by adding one of the following arguments: new, hour, week, month, year to the script.


python /home/silvio/Scripts/ --time week

NSFW images are disabled by default, to enable them add --nsfw.

On OS X, you can specify display number with option --display. Use 0 for all display (default), 1 for main display and so on.

To change default location where image will be saved, use --output folder/subfolder.

Running on startup


To make managment of the script simple, we can accomplish this using built-in Startup Applications.

Startup Applications

Click on Add.

Add new startup command

Note: you can use --subreddit and --time arguments here aswell.


We will be using Task Scheduler for this. You can find it in Windows search. Once you open it, click on Create Basic Task Follow the procedure.





In Add arguments field type the location of the script. Example



"D:\" --subreddit art --time week

Running every minute or hour

Look into using cronjobs on Linux or Task Scheduler on Windows for performing this.

Configuration file

Instead of writing arguments every time you run the script, you can also use configuration file which should be located at ~/.config/change_wallpaper_reddit.rc.

Example of configuration file:

You can’t perform that action at this time.