A read-only mirror of https://github.com/hyprwm/hyprpaper
Find a file
John Mylchreest 023d7e6e62
feat(config): re-add source= include directive support
Re-implements the source= directive for including external config files,
which was originally added in PR #267 for v0.7.6 but lost during the
v0.8.0 hyprtoolkit rewrite.

Features:
- Include external config files using source=/path/to/file.conf
- Glob pattern support (e.g., source=~/.config/hypr/hyprpaper.d/*.conf)
- Tilde expansion for home directory paths
- Relative paths resolved relative to the current config file
- Proper error handling and logging for missing/invalid files

This restores parity with Hyprland's source= behavior, enabling modular
configuration management that was lost in the v0.8.0 transition.

Fixes: hyprwm/hyprpaper#302
2026-01-02 15:55: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 feat(config): re-add source= include directive support 2026-01-02 15:55: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