Waypaper

Change wallpapers with a style

GUI wallpaper setter for Wayland and Xorg window managers on Linux. It works as a frontend for popular wallpaper backends like swaybg, swww, wallutils, hyprpaper and feh. Developed by Roman Anufriev since 2023.

Features

• Vim-style keyboard navigation

• Support for GIF animations (with swww, awww, mpvpaper, or gslapper)

• Support for video wallpapers (with mpvpaper, gslapper, or linux-wallpaperengine)

• Support for multiple monitors

• Works on Wayland (with swww, awww, swaybg, hyprpaper, mpvpaper, gslapper, or wallutils)

• Works on Xorg (with feh, xwallpaper, or wallutils)

• Works on macOS (native support)

• Restores wallpaper at launch of your WM

• Caching for fast loading

• Zen mode for a minimal, distraction-free interface

• Post-command hook to run a script after each wallpaper change

• Customizable CSS stylesheet for theming

Contents

• Installation

• Usage

• Keybindings

• Configuration

• Troubleshooting

• Support and contribution

Demo

Repositories

• Code: https://github.com/anufrievroman/waypaper

• Documentation: https://github.com/anufrievroman/waypaper-docs

If you enjoy using Waypaper, please consider supporting the project.