Skip to main content

background changer using unsplash API.

Project description

Background Changer

A small program in Python 3 that grabs a random photo from Unsplash according to your screen resolution and sets it as your background.

Further testing

This hasn't yet been tested on Windows or Mac (being worked on), but it works for Ubuntu Linux. Any commands I might have gotten wrong to set it as your background, please feel free to fix those or add more!


This is pretty light on dependencies, but you will need to make sure you have a couple things:

  • tkinter - a python GUI toolkit, but is only used to get the screen resolution. This is usually installed via a system package.
  • requests - python module for HTTP requests.
  • pywal - generates color schemes and used for changing the wallpaper.

Optional Dependencies

  • feh, if you use a Linux system that's not Ubuntu or Elementary OS. This is not in PyPi, it'll be in your distros repos.

Installation and Usage

NOTE: For Mac, first test if you have tkinter directly installed with your Python version first:

>>> import tkinter

If that doesn't cause an error, you're good. If it does, follow this Stack Overflow Post to get that correctly set up. Then you can continue with the installation:

pip install backgroundchanger



# To view the help menu
backgroundchanger -h
# or
backgroundchanger --help

How to contribute?

For issue and PR guidelines, see

Project details

Download files

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

Source Distribution

backgroundchanger-1.5.0.tar.gz (6.9 kB view hashes)

Uploaded Source

Built Distribution

backgroundchanger-1.5.0-py3-none-any.whl (9.8 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page