From ea6cb868872a3a19222c3471dc0e2722069b15d9 Mon Sep 17 00:00:00 2001 From: Aly Raffauf Date: Mon, 2 Sep 2024 10:19:42 -0400 Subject: [PATCH] randomWallpaperD: add README.md --- .../services/randomWallpaper/README.md | 15 +++++++++++++++ 1 file changed, 15 insertions(+) create mode 100644 homeManagerModules/services/randomWallpaper/README.md diff --git a/homeManagerModules/services/randomWallpaper/README.md b/homeManagerModules/services/randomWallpaper/README.md new file mode 100644 index 00000000..ccdc57b9 --- /dev/null +++ b/homeManagerModules/services/randomWallpaper/README.md @@ -0,0 +1,15 @@ +# randomWallpaperD + +Dynamically sets per-monitor wallpapers and changes them on a 30 minute timer. Running as a daemon, this script supports monitor hotplugging by polling the window manager for active outputs, then intelligently assigns random wallpapers per-screen with [swaybg](https://github.com/swaywm/swaybg). + +## Arguments + +If called without arguments, it assumes wallpapers are in a directory `~/.local/share/backgrounds`. The first argument can be used to set the directory: + +```bash +./script.rb ~/path/to/my/wallpapers +``` + +## Window Manager Support + +Because this script polls the window manager directly by way of its CLI utility, it currently only supports Hyprland (with `hyprctl`) and Sway (with `swaymsg`).