Awesome Open Source
Awesome Open Source


This is a system tray app for windows that will change your desktop wallpaper based on the track you are listening to. Works with Spotify or

As the artwork provided is only 640px if you are using a higher resolution than 1080p the artwork will be smaller. However there is an option to resize the image in the settings. An internet connection is required.

Getting Started

Download installer for windows

There is a short initial setup:

  1. Start the app (This takes a while ~15s). A music note icon will appear in the system tray and a window will open prompting you to select your service (Spotify or and enter your API keys
  2. Press 'Save' and start the app again.
    • If you are using the Spotify service this time your browser will open prompting you to login to your Spotify account.
  3. Start playing music and your desktop wallpaper will change, you can click the icon in the system tray for more options.

If you are running the source you will also need to (this is not required if you are using the installer):

  • Install the dependencies pip install -r requirements.txt (Poetry users can use pyproject.toml)
  • Rename _services.ini to services.ini

Getting your API Keys

This section has been moved to the wiki


Any contributions are welcomed. Please ask questions and make suggestions in discussions and create an issue if you've encountered a problem.

System Usage

Very low CPU and network usage until a new image is generated (song is skipped)

CPU Usage spikes: ~3% Art/Wallpaper background, ~20-25% Gradient/Solid background

Network Usage spikes: <1mbps


Get A Weekly Email With Trending Projects For These Topics
No Spam. Unsubscribe easily at any time.
Python (1,137,692
Python3 (32,978
Music (5,459
Audio (3,991
Spotify (2,102
Wallpaper (751
Spotify Api (734
Songs (462
Background (344
Lastfm (322
Album (198
Artwork (162
Wallpaper Changer (126
Related Projects