https://github.com/hyprwm/hyprpaper
Hyprpaper is a wayland wallpaper utility with IPC controls.
https://github.com/hyprwm/hyprpaper
cpp20 wallpaper wayland wlroots
Last synced: 15 days ago
JSON representation
Hyprpaper is a wayland wallpaper utility with IPC controls.
- Host: GitHub
- URL: https://github.com/hyprwm/hyprpaper
- Owner: hyprwm
- License: bsd-3-clause
- Created: 2022-07-01T18:16:44.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2026-01-08T21:16:59.000Z (about 1 month ago)
- Last Synced: 2026-01-10T17:47:14.305Z (about 1 month ago)
- Topics: cpp20, wallpaper, wayland, wlroots
- Language: C++
- Homepage: https://wiki.hyprland.org/Hypr-Ecosystem/hyprpaper/
- Size: 250 KB
- Stars: 1,194
- Watchers: 3
- Forks: 91
- Open Issues: 28
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-linux-ricing - hyprpaper - A fast Wayland wallpaper utility with IPC controls. (Wallpapers / Utilities)
- awesome-hyprland - Hyprpaper
- awesome-useful-projects - <img src="https://icon.horse/icon/github.com" height="20px" align="center"/>/hyprwm/hyprpaper - Wayland wallpaper utility (Linux / Other)
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](https://archlinux.org/packages/extra/x86_64/hyprpaper/): `pacman -S hyprpaper`
[OpenSuse Linux](https://software.opensuse.org/package/hyprpaper): `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:
```sh
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:
```sh
cmake --install ./build
```