1.5 KiB
| weight | title |
|---|---|
| 1 | hyprpaper |
hyprpaper is a fast, IPC-controlled wallpaper utility for hyprland.
Configuration
The config file is located at ~/.config/hypr/hyprpaper.conf. It is not
required.
Configuration is done via preloads, which load an image into memory. Then,
you use wallpaper keywords to apply the preloaded image to your monitor(s):
preload = /home/me/amongus.png
wallpaper = DP-1,/home/me/amongus.png
For wallpaper keywords:
You can also unload preloaded images to free up memory. unload all and
unload unused are a thing too.
To run hyprpaper at startup edit hyprland.conf and add:
exec-once = hyprpaper.
Misc options
| variable | description | type | default |
|---|---|---|---|
| splash | enable rendering of the hyprland splash over the wallpaper | bool | false |
| splash_offset | how far (in % of height) up should the splash be displayed | float | 2.0 |
| splash_color | color to use when rendering splash | color | 55ffffff |
| ipc | whether to enable IPC | bool | true |
IPC
hyprpaper supports IPC via hyprctl. Every dispatcher mentioned in
Configuration can be called with
hyprctl hyprpaper <dispatcher> <arg(s)>.
Additionally, you can get some info about the current state of hyprpaper with
listloaded and listactive.
Examples:
hyprctl hyprpaper preload "~/Pictures/myepicpng.png"
hyprctl hyprpaper wallpaper "DP-1,~/Pictures/myepicpng.png"
hyprctl hyprpaper listloaded
Please note all paths have to be absolute (or start with ~).