No description
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
nnra6864 127ef10556 feat: hyprpaper can set wallpapers in a hyprpaper.conf kosm does not own
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-14 01:27:54 +01:00
.gitignore feat: Wallpapers set per monitor or for all, written to hyprpaper and switched live 2026-11-13 18:41:31 +01:00
App.zig feat: hyprpaper can set wallpapers in a hyprpaper.conf kosm does not own 2026-11-14 01:27:54 +01:00
build.zig feat: Wallpapers set per monitor or for all, written to hyprpaper and switched live 2026-11-13 18:41:31 +01:00
build.zig.zon feat: hyprpaper can set wallpapers in a hyprpaper.conf kosm does not own 2026-11-14 01:27:54 +01:00
README.md feat: hyprpaper can set wallpapers in a hyprpaper.conf kosm does not own 2026-11-14 01:27:54 +01:00
root.zig feat: hyprpaper can set wallpapers in a hyprpaper.conf kosm does not own 2026-11-14 01:27:54 +01:00

kosm_hyprpaper

hyprpaper for kosm: the wallpaper on each monitor.

By default the app owns ~/.config/hypr/hyprpaper.conf and writes it whole, with splash and one wallpaper block per wallpaper. With owned = false the file is yours: kosm only sets splash and each wallpaper's path and fit_mode in the wallpaper block naming its monitor (monitor = for every monitor), keeping your comments and other keys, and fails naming the monitor when a block or key is missing. Either way it then sets each on the running hyprpaper (hyprctl hyprpaper wallpaper), which reads its config only at start. With no hyprpaper running that is a warning. With no wallpaper set nothing is written, so a theme alone leaves the file alone: from(theme) sets none, as a wallpaper is the kosmos' own.

apps.hyprpaper.?.wallpapers = &.{
    .{ .path = "~/Pictures/mountain.jxl" },
    .{ .monitor = "DP-2", .path = "~/Pictures/sea.png", .fit_mode = .contain },
};

A path or monitor hyprpaper cannot read (holding #, , or a line break, or empty), or two wallpapers (or, in a file kosm does not own, two blocks) for one monitor, fails the apply naming it. The package exports hyprlang_adapter (from kosm_hyprlang), which edits a file it does not own.

Fields

Field Default
file ~/.config/hypr/hyprpaper.conf
owned true: kosm writes file whole; false: only sets values in it
splash null: not written, hyprpaper's default (off)
wallpapers none: nothing is written

Wallpaper: monitor (null: every monitor no other wallpaper names), path (absolute or ~/), fit_mode (.cover, .contain, .tile, .fill; null: hyprpaper's default, cover).