hyprwm/hyprpaper
1
0
Fork 0
mirror of https://github.com/hyprwm/hyprpaper.git synced 2024-12-22 04:19:47 +01:00
Code Issues Projects Releases Packages Wiki Activity
A read-only mirror of https://github.com/hyprwm/hyprpaper
25 commits 7 branches 10 tags 722 KiB
C++ 86.6%
CMake 7.3%
Nix 6.1%
Find a file
Kainoa Kanter 11c5921d97
AUR
2022-07-11 23:14:18 -07:00
protocols initial code commit 2022-07-01 23:05:58 +02:00
src reset parse error for socket 2022-07-07 15:34:27 +02:00
.gitignore initial commit 2022-07-01 23:05:00 +02:00
CMakeLists.txt remove some unused deps 2022-07-04 00:11:09 +02:00
LICENSE Initial commit 2022-07-01 20:16:45 +02:00
Makefile Fixes spacing issue in Makefile 2022-07-03 03:05:10 -04:00
README.md AUR 2022-07-11 23:14:18 -07:00

README.md

hyprpaper

Hyprpaper is a blazing fast wallpaper utility for Hyprland with the ability to dynamically change wallpapers through sockets. It will work on all wlroots-based compositors, though.

Installation

AUR: yay -S hyprpaper-git

Manual:

git clone https://github.com/hyprwm/hyprpaper
cd hyprpaper
make all

the output binary will be in ./build/, copy it to your PATH, e.g. /usr/bin

Usage

Hyprpaper is controlled by the config, like this:

~/.config/hypr/hyprpaper.conf

preload = /path/to/image.png

# .. more preloads

wallpaper = monitor,/path/to/image.png

# .. more monitors

Preload will tell Hyprland to load a particular image (supported formats: png, jpg, jpeg). Wallpaper will apply the wallpaper to the selected output (monitor is the monitor's name, easily can be retrieved with hyprctl monitors)

A Wallpaper cannot be applied without preloading. The config is not reloaded dynamically.

IPC

You can use hyprctl hyprpaper (if on Hyprland) to issue a keyword, for example

hyprctl hyprpaper wallpaper DP-1,~/Pictures/myepicpng.png

For other compositors, the socket works like socket1 of Hyprland, and is located in /tmp/hypr/.hyprpaper.sock (this path only when Hyprland is not running!)