Skip to main content
Help us improve PyPI by participating in user testing. All experience levels needed!

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

Project details

Release history Release notifications

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
wallp-2.0.27.tar.gz (55.2 kB) Copy SHA256 hash SHA256 Source None Jul 14, 2016

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page