Waypaper is a graphical wallpaper manager that provides a convenient interface for choosing desktop backgrounds. Instead of rendering wallpapers itself, it acts as a front end for established wallpaper utilities. This makes it particularly useful with lightweight window managers and desktop setups that offer few built-in wallpaper controls.
The GTK interface displays wallpaper collections in a visual grid, allowing users to select an image without learning the commands for individual wallpaper setters. Waypaper can be configured through its interface, with additional options available for those who want finer control over its behaviour.
This is free and open source software.
Key Features
- Works with Wayland backends including awww, swww, swaybg, hyprpaper, mpvpaper, gslapper and wallutils.
- Supports Xorg wallpaper setters including feh, xwallpaper and wallutils.
- Can target individual monitors or apply a wallpaper to all monitors.
- Offers fill, fit, stretch, centre and tile image placement modes.
- Displays animated GIF wallpapers with compatible backends including awww, mpvpaper and gslapper.
- Handles video wallpapers through mpvpaper or gslapper.
- Supports linux-wallpaperengine for animated wallpapers from Steam’s Wallpaper Engine.
- Includes a built-in slideshow that changes to randomly selected wallpapers at configurable intervals.
- Restores the previously selected background after restart and can resume an enabled slideshow.
- Offers command-line controls for random wallpaper selection, individual images, folders, monitors and backends.
- Supports sorting, subfolder browsing, hidden-file display and filtering for animated GIFs.
- Includes Vim-style keyboard shortcuts and a distraction-free Zen mode.
- Can run custom scripts after wallpaper changes, passing wallpaper and monitor information.
- Supports CSS interface customisation and caching for faster image loading.
- Cross-platform support – runs on Linux and macOS.
Website: github.com/anufrievroman/waypaper
Support:
Developer: Roman Anufriev
License: GNU General Public License v3.0

Waypaper is written in Python. Learn Python with our recommended free books and free tutorials.
Related Software
| Wallpaper Setters | |
|---|---|
| Fantascene | Play video wallpapers on your background |
| Variety | Highly configurable utility that offers a great range of features |
| WallpaperDownloader | Download, change, manage wallpapers with this Java tool |
| Superpaper | Advanced multi monitor wallpaper manager |
| wpgtk | Colorscheme, wallpaper and template manager |
| Waywallen | Dynamic wallpaper manager for Wayland desktop environments |
| Picture Of The Day | Grabs a picture of the day from a variety of sources |
| HydraPaper | Gtk utility to set different backgrounds for each monitor on GNOME |
| Waypaper | Lightweight graphical wallpaper manager |
| pacwall | Live wallpaper showing dependency graph and installed packages |
| chwall | Tiny automatic wallpaper changer |
| swaybg | Wallpaper utility for Wayland compositors |
| mpvpaper | Video wallpaper software |
| Komorebi | Fully customisable image, video, and web page wallpapers |
| Azote | GTK+3 based picture browser and background setter |
| WSelector | Wallpaper selector manager |
| Wall Changer | Automatic wallpaper changer |
| Hyprpaper | Wallpaper utility designed for Hyprland |
| Fondo | Quickly find beautiful wallpapers from Unsplash |
| feh | Mode-based image viewer and cataloger aimed at console users |
| xwallpaper | Wallpaper setting utility |
| Damask | Automatically set wallpaper images |
| wpaperd | Lightweight wallpaper daemon with automatic image rotation |
| Walt | Wallpaper manager for Hyprland |
| awww | Wallpaper daemon for Wayland |
| flowy | Lean privacy-preserving dynamic wallpaper changer |
| hpaper | Advanced wallpaper management for Wayland |
| chwp | Changes the wallpaper from the command line |
| Wallrus | Generate colorful abstract wallpapers |
| awtwall | Fast TUI wallpaper picker for Wayland |
| Tinte | Wallpaper utility and theme generator |
| Nitrogen | Background browser and setter |
| gSlapper | Wallpaper utility for Wayland |
| wewa | Renders web content as desktop wallpaper |
| Walldo | Simple graphical wallpaper changer for Linux desktops |
| randwall | Randomly changes the desktop wallpaper |
| Matuwall | Fast graphical wallpaper picker for Wayland desktops |
| Icebg | Lightweight wallpaper setter for Wayland compositors |
| Clockwork Orange | Manage wallpapers and lock screen backgrounds |
Read our verdict in the software roundup.
LinuxLinks helps you discover the best free and open source software for Linux. Explore our extensive collection of recommended applications, including alternatives to popular proprietary software.We also publish software reviews, Linux tutorials, hardware reviews, free programming books and articles covering the wider open source community. Browse our Linux resources to discover more. Know a useful free and open source Linux application we haven't covered? Suggest a program for inclusion. Has your software been featured on LinuxLinks? Display one of our Featured on LinuxLinks badges on your website or GitHub README. |


Please read our Comment Policy before commenting.