A read-only mirror of https://github.com/hyprwm/hyprpaper
Find a file
John Mylchreest dca6536898
refactor(config): address PR review feedback & rebase against main
- Use Hyprutils::String::trim() instead of manual whitespace trimming
- Use Hyprutils::Utils::CScopeGuard for glob cleanup instead of manual
  globfree() calls
- Remove braces from short single-line if statements per style guide
- Remove duplicate absolutePath(), extend getPath() with optional
  basePath parameter instead

For source= directives, relative paths need to resolve relative to the
config file's directory, not CWD. So `source = ./themes/dark.conf` in
`~/.config/hypr/hyprpaper.conf` resolves to
`~/.config/hypr/themes/dark.conf`, not `$CWD/themes/dark.conf`.
2026-01-02 16:14:53 +00:00
.github/workflows CI/Nix: add cache-nix-action 2025-06-20 01:25:44 +03:00
hw-protocols core: migrate to hyprtoolkit (#288) 2025-12-04 17:58:54 +00:00
nix core: migrate to hyprtoolkit (#288) 2025-12-04 17:58:54 +00:00
protocols initial code commit 2022-07-01 23:05:58 +02:00
src refactor(config): address PR review feedback & rebase against main 2026-01-02 16:14:53 +00:00
systemd Add systemd service (#208) 2024-10-26 00:14:47 +03:00
.clang-format core: migrate to hyprwayland-scanner 2024-07-17 16:25:07 +02:00
.gitignore core: migrate to hyprtoolkit (#288) 2025-12-04 17:58:54 +00:00
CMakeLists.txt core: migrate to hyprtoolkit (#288) 2025-12-04 17:58:54 +00:00
flake.lock flake.lock: Update 2025-12-18 12:36:36 +02:00
flake.nix core: migrate to hyprtoolkit (#288) 2025-12-04 17:58:54 +00:00
LICENSE Initial commit 2022-07-01 20:16:45 +02:00
README.md core: migrate to hyprtoolkit (#288) 2025-12-04 17:58:54 +00:00
VERSION version: bump to 0.8.0 2025-12-29 17:00:47 +01:00

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