Need help with hyprpaper

Bugs / FRs / Support
, , ,
1

When I start hyperpaper it outputs…

Error in config: 
Config error in file /home/moongoat/.config/hypr/hyprpaper.conf at line 6: config option <wallpaper:monitor> does not exist.

It also outputs the lines…

[WARN] Monitor DP-2 does not have a target! A wallpaper will not be created.
[WARN] Monitor DP-3 does not have a target! A wallpaper will not be created.
[WARN] Monitor DP-1 does not have a target! A wallpaper will not be created.

Anyone know what the issue is?

Hyprland version 
Hyprland 0.52.2 built from branch v0.52.2 at commit 386376400119dd46a767c9f8c8791fd22c7b6e61 clean ([gha] Nix: update inputs).
Date: Wed Dec 3 22:59:30 2025
Tag: v0.52.2, commits: 6581

Libraries:
Hyprgraphics: built against 0.4.0, system has 0.4.0
Hyprutils: built against 0.10.4, system has 0.10.4
Hyprcursor: built against 0.1.13, system has 0.1.13
Hyprlang: built against 0.6.7, system has 0.6.7
Aquamarine: built against 0.10.0, system has 0.10.0

no flags were set
Full output of hyprpaper 
[LOG] Welcome to hyprpaper!
built from commit  ()
[LOG] Cleaned old hyprpaper preloads (2), removing 34.6MB
Error in config: 
Config error in file /home/moongoat/.config/hypr/hyprpaper.conf at line 6: config option <wallpaper:monitor> does not exist.
[LOG] Preloaded target /usr/share/wallpapers/cachyos-wallpapers/DarkStreaks.png in 4.67ms -> Pixel size: [960, 540]
[LOG] Buffer created for target /usr/share/wallpapers/cachyos-wallpapers/DarkStreaks.png, Shared Memory usage: 14.7MB
[LOG] Buffer created for target /usr/share/wallpapers/cachyos-wallpapers/DarkStreaks.png, Shared Memory usage: 19.8MB
[LOG] Total SM usage for all buffers: 34.6MB
[WARN] Monitor DP-2 does not have a target! A wallpaper will not be created.
[WARN] Monitor DP-3 does not have a target! A wallpaper will not be created.
[WARN] Monitor DP-1 does not have a target! A wallpaper will not be created.
[LOG] hyprpaper socket started at /run/user/1000/hypr/386376400119dd46a767c9f8c8791fd22c7b6e61_1764971029_623395502/.hyprpaper.sock (fd: 4)
My hyprpaper.conf 
preload = /usr/share/wallpapers/cachyos-wallpapers/DarkStreaks.png

wallpaper {
    monitor = DP-1
    path = /usr/share/wallpapers/cachyos-wallpapers/DarkStreaks.png
    fit_mode = cover    # optional { contain | [cover] | tile | fill }
}

wallpaper {
    monitor = DP-2
    path = /usr/share/wallpapers/cachyos-wallpapers/DarkStreaks.png
    fit_mode = cover    # optional { contain | [cover] | tile | fill }
}

wallpaper {
    monitor = DP-3
    path = /usr/share/wallpapers/cachyos-wallpapers/DarkStreaks.png
    fit_mode = cover    # optional { contain | [cover] | tile | fill }
}

Also: Is preload not required anymore? I noticed all mentions of it are not present in the current version wiki.

Thanks

2

There have been changes to the syntax as part of the move to hyprtoolkit, but those changes are not in a release yet. Wiki is versioned, go back to 0.52.

1 Like
3

Of course. How silly of me. Thank you, Vaxry. Looking forward to the new release. I much prefer the new syntax.