Hyprpaper is a wayland wallpaper utility with IPC controls.
cpp20wallpaperwaylandwlroots
Key Metrics
Star Growth
Stars
1.4k
Forks
113
Weekly Growth
+-1
Issues
44
5001k
Jan 2023Aug 2023Apr 2024Nov 2024Jul 2025Mar 2026Oct 2026
README
hyprpaper
Hyprpaper is a simple and fast wallpaper utility for Hyprland with the ability to dynamically change wallpapers through sockets.
Features
- Per-output wallpapers
- fill, tile, cover or contain modes
- fractional scaling support
- IPC for fast wallpaper switches
Installation
Arch Linux: pacman -S hyprpaper
OpenSuse Linux: zypper install hyprpaper
Manual:
Dependencies
The development files of these packages need to be installed on the system for hyprpaper to build correctly.
(Development packages are usually suffixed with -dev or -devel in most distros' repos).
- hyprtoolkit
- hyprlang
- hyprutils
- hyprwire
Building
Building is done via CMake:
cmake --no-warn-unused-cli -DCMAKE_BUILD_TYPE:STRING=Release -DCMAKE_INSTALL_PREFIX:PATH=/usr -S . -B ./build
cmake --build ./build --config Release --target hyprpaper -j`nproc 2>/dev/null || getconf _NPROCESSORS_CONF`
Install with:
cmake --install ./build