- Home
- Desktop Wallpaper Software
- Waypaper
Waypaper
What it is
Waypaper is a free graphical wallpaper setter for Linux window managers and macOS. It provides one interface for wallpaper backends including swaybg, swww, awww, wallutils, hyprpaper, mpvpaper, gslapper, feh, xwallpaper, linux-wallpaperengine, and macOS. It supports multiple monitors, Vim-style keyboard navigation, and restoring a wallpaper when a window manager launches. Animated GIFs work with selected backends, while video wallpaper options depend on mpvpaper, gslapper, or linux-wallpaperengine. The documentation also lists caching, a distraction-free Zen mode, post-change script hooks, and customizable CSS theming. Waypaper requires at least one supported wallpaper backend to function as a frontend. Linux installation routes include pipx and packages or repositories for Arch-based distributions, NixOS, OpenSUSE, and Fedora. On macOS, installation requires GTK3 and PyGObject through Homebrew before installing Waypaper with pipx. The project is GPL-3.0 licensed; its documentation identifies Roman Anufriev as developer and says development began in 2023.
For and against
For
- Supports multiple monitors.
- Can restore wallpaper when a window manager launches.
- Includes Vim-style keyboard navigation.
- Offers caching, Zen mode, script hooks, and CSS theming.
- GPL-3.0 licensed.
Against
- Requires at least one compatible wallpaper backend.
- GIF and video options depend on backend support.
- macOS setup requires GTK3 and PyGObject through Homebrew.
The verdict
Waypaper provides a shared wallpaper interface with monitor support and optional animation through compatible backends. The separate backend requirement and platform-specific installation steps are worth checking before setup.
Who it suits
Waypaper may suit Linux window-manager users or macOS users who want a graphical interface over supported wallpaper backends. It also fits people who use multiple monitors or want GIF or video wallpapers, depending on backend support.
Plans and prices
Waypaper
Requires at least one wallpaper backend · Desktop application
Read 15 Oct 2026 · github.com
On the record
- Additional features
- The documentation lists caching, a distraction-free Zen mode, post-change script hooks, and customizable CSS theming.anufrievroman.gitbook.io · read 3 Oct 2026
- Animated GIFs
- GIF wallpapers work through selected backends including swww, awww, mpvpaper and gslapper.anufrievroman.gitbook.io · read 15 Oct 2026
- Animated wallpapers
- GIF animations are supported through selected backends, and video wallpapers through mpvpaper, gslapper, or linux-wallpaperengine.anufrievroman.gitbook.io · read 3 Oct 2026
- Backend integrations
- It acts as a frontend for wallpaper backends including swaybg, swww, awww, wallutils, hyprpaper, mpvpaper, gslapper, feh, xwallpaper, linux-wallpaperengine, and macOS.github.com · read 3 Oct 2026
- CLI controls
- Command-line options include random selection, folder selection, direct wallpaper setting, backend choice, monitor targeting and fill mode.anufrievroman.gitbook.io · read 15 Oct 2026
- Community limit: configuration reliability
- A Reddit commenter reported occasional startup cases where the configuration became empty and no wallpaper appeared.reddit.com · read 15 Oct 2026
- Community limit: startup persistence
- A Reddit user reported that Waypaper did not remember the wallpaper after reboot until advised to configure --restore.reddit.com · read 15 Oct 2026
- Community usability issue
- A Reddit user initially thought backend and folder controls were missing because Zen mode hid them; pressing Z resolved the issue.reddit.com · read 15 Oct 2026
- Configuration
- The first run creates a configuration file typically at ~/.config/waypaper/config.ini.anufrievroman.gitbook.io · read 15 Oct 2026
- Dependencies
- Documented dependencies include GTK Python bindings, Pillow, imageio, imageio-ffmpeg, screeninfo and platformdirs.anufrievroman.gitbook.io · read 15 Oct 2026
- Developer and start year
- The documentation identifies Roman Anufriev as developer and says development began in 2023.anufrievroman.gitbook.io · read 15 Oct 2026
- Documentation depth
- Published documentation covers installation, usage, keybindings, configuration, troubleshooting and contribution.anufrievroman.gitbook.io · read 15 Oct 2026
- Independent feature confirmation
- LinuxLinks independently confirms Wayland, Xorg, animated GIF, video, multi-monitor, Vim-key and restore capabilities.linuxlinks.com · read 15 Oct 2026
- Installation channels
- Installation is documented through pipx, Arch AUR, NixOS packages, Fedora repositories and macOS Homebrew prerequisites.anufrievroman.gitbook.io · read 15 Oct 2026
- Installation requirement
- Users install Waypaper and at least one supported wallpaper backend for it to work as a frontend.github.com · read 3 Oct 2026
- JSON listing
- The --list option outputs current wallpapers, monitors and backend information as JSON.anufrievroman.gitbook.io · read 15 Oct 2026
- Keyboard navigation
- The interface provides Vim-style keyboard navigation.anufrievroman.gitbook.io · read 15 Oct 2026
- Latest release
- Version 2.9 was released on 30 August 2026 and added GUI slideshows, improved macOS support, Zen mode and several fixes.github.com · read 15 Oct 2026
