From 884ed95ef3a3890cd1782941421cb2a2e8b41fd0 Mon Sep 17 00:00:00 2001 From: Vaxry <43317083+vaxerski@users.noreply.github.com> Date: Fri, 1 Jul 2022 23:13:43 +0200 Subject: [PATCH] readme updates --- README.md | 38 +++++++++++++++++++++++++++++++++++++- 1 file changed, 37 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index 0d3edb0..7aa79de 100644 --- a/README.md +++ b/README.md @@ -1,2 +1,38 @@ # hyprpaper -Hyprpaper is a blazing fast wayland wallpaper utility. + +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. + +*todo + +# Installation + +``` +git clone https://github.com/hyprwm/hyprpaper +make all +``` +*the output binary will be in `./build/`* + +# 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. 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. + +# todos + +- socket communication (hyprctl) +- switching wps +- allow setting only for selected monitors