Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

A command line utility to download/create and set wallpapers from various sources.

Project Description

wallp selects one of the sources at random, downloads/creates image from it and sets it as desktop wallpaper.

Supported Sources


  • reddit (subreddits, search)
  • bing (gallery)
  • google (image search)
  • deviantart
  • imgur (search, wallpaper albums, favorites)
  • xkcd


  • single color bitmap
  • source code (rendered as image)

Supported Platforms

  • Python 2.7 / 3.4
  • Linux (Gnome or KDE Plasma)
  • Windows


  • Never repeats an image.
  • Can schedule the change of wallpaper.
  • Editable database of subreddits, imgur albums, search queries to get wallpapers.
  • Make a wallpaper stick (no change) for a certain period of time.
  • Print detailed info on image, such as, source url, size, path, username, description, etc.
  • Can manage favorites.


Some sample commands:

wallp                                    # change wallpaper
wallp source -h                          # list all sources
wallp schedule add 1h                    # change wallpaper every 1 hour
wallp info                               # print information about the current wallpaper image

wallp config dump                        # dump the program configuration
wallp config disable deviantart          # disable deviantart as a source of images
wallp config list query add 'linux'      # add 'linux' as a query to be used (at random) when searching for wallpapers
wallp config list subreddit add pics     # add subreddit pics
wallp config list imgur-album add SVFae  # add imgur album SVFae
wallp config set image.max_size 1000000  # limit image size to 1MB

wallp source imgur wallpaper-album       # select a random wallpaper album from imgur and get a random image from it
wallp source google -q 'wallpapers'      # query google for 'wallpapers' and get a random image from results

wallp keep 1d                            # like a wallpaper very much? keep it unchanged for 1 day
wallp stats                              # print usage stats

wallp -h                                 # get help

Release History

This version
History Node


History Node


History Node


History Node


History Node


History Node


History Node


Download Files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, Size & Hash SHA256 Hash Help File Type Python Version Upload Date
(55.2 kB) Copy SHA256 Hash SHA256
Source None Jul 14, 2016

Supported By

Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Google Google Cloud Servers DreamHost DreamHost Log Hosting