Waypaper

Overview

Waypaper is a graphical wallpaper manager for Linux window managers and macOS, built for people who want to choose and manage desktop backgrounds through an interface rather than rely only on backend commands. Its main appeal is breadth: one frontend can work with several wallpaper-setting tools and support static, animated, or video backgrounds, though it requires a compatible backend installed separately.

Developed by Roman Anufriev, with development beginning in 2023, Waypaper is GPL-3.0 licensed. The backend requirement makes it a better fit for users comfortable setting up their desktop environment than for anyone expecting a self-contained wallpaper app.

Key features

Multiple backends and displays

Waypaper can front swaybg, swww, awww, wallutils, hyprpaper, mpvpaper, gslapper, feh, xwallpaper, linux-wallpaperengine, and macOS. That range gives Linux users flexibility to pair the interface with a supported tool already suited to their setup; it does not remove the need to install and configure at least one backend. Multiple-monitor support is useful for users managing more than one display, while automatic restoration can bring the wallpaper back when a window manager launches.

Animated backgrounds and workflow controls

Animated wallpaper support depends on the backend: GIFs work through selected backends, while video backgrounds use mpvpaper, gslapper, or linux-wallpaperengine. The project also documents interactive wallpapers and performance controls, but the way those capabilities behave depends on the selected backend. Vim-style keyboard navigation is a practical option for keyboard-oriented users. Caching, Zen mode, post-change script hooks, and CSS theming add ways to adapt the browsing and wallpaper-change workflow without changing the app’s basic role.

Pricing

Waypaper costs free. The free, open-source GUI requires a compatible wallpaper backend, so the app itself has no paid tier, but getting it working may require installing an additional tool. There is no free trial because there is no paid plan to trial.

Platforms

Waypaper supports Linux and macOS. Linux installation options include pipx and documented packages or repositories for Arch-based distributions, NixOS, OpenSUSE, and Fedora. On macOS, setup requires GTK3 and PyGObject installed through Homebrew before installing Waypaper with pipx. Those prerequisites make macOS support less plug-and-play than simply downloading a standalone app.

Who it's for

Waypaper suits Linux desktop users who want a graphical way to work with multiple wallpaper backends, manage backgrounds across monitors, or use supported animated and video wallpapers. It can also suit macOS users willing to install its GTK-related prerequisites. Users who want a self-contained wallpaper setter, or who do not want to choose and install a backend, should look elsewhere.

Pros and cons

• Pros: A broad set of supported backends lets users choose among multiple wallpaper-setting tools rather than being locked into one.
• Pros: Multi-monitor support, automatic restoration, and support for selected animated and video wallpaper backends cover more than basic image selection.
• Pros: Vim-style navigation, caching, Zen mode, script hooks, and CSS theming offer useful workflow customization.
• Cons: Waypaper requires a separately installed compatible backend, adding setup work and making the experience dependent on that tool.
• Cons: macOS installation requires GTK3 and PyGObject through Homebrew, a notable prerequisite burden for users seeking a conventional app install.

Alternatives

Desktop Wallpaper Software is the broader directory to consult when comparing wallpaper tools across categories.

• Waywallen is a free Linux wallpaper manager; consider it if you want a Linux-only alternative.
• Fresco is a free Linux option under GPL-3.0; consider it if you want another open-source wallpaper app.
• DesktopHut is free on Windows 10/11 64-bit, with no subscription, trial, or premium tier; choose it for that platform instead.
• John’s Background Switcher has a free Windows plan and supports macOS; consider it if you need a cross-platform alternative for those systems.
• Vivid Walls offers eight bundled wallpapers free on Mac, with a one-time 9.99 USD Full Library purchase; choose it if you want a curated library and are willing to pay once for the full collection.
• MuGen Wallpaper is a macOS freemium option with up to 10 dynamic wallpapers on its free plan and a one-time purchase to remove that limit; consider it if you specifically want dynamic wallpapers on Mac.
• PUSH Video Wallpaper is a Windows option whose free version enables all features with a visible watermark; consider it if Windows video wallpaper is the priority.
• Razer Axon is free on Windows and Android, with AI wallpaper generation using tokens that may be claimed in-app or purchased; consider it if those platforms and generation features matter more than Linux or macOS support.

Verdict

Choose Waypaper if you use Linux or macOS and want a flexible graphical frontend for supported wallpaper backends, especially for multiple displays or backend-enabled animated and video backgrounds. Its breadth and free GPL-3.0 license are compelling, but the separate backend requirement—and macOS setup prerequisites—make it a poor fit for users who expect a ready-to-run, self-contained wallpaper app.