From 0bca7a7eb09f0e094aa721f75d23f771d20c6bf3 Mon Sep 17 00:00:00 2001 From: "Christopher R. Nelson" Date: Sat, 31 Oct 2026 23:51:41 -0400 Subject: Initial wallpaper-switcher pipe menu Common Lisp tool that prints an Openbox pipe menu of the .png/.webp files in ~/.wallpapers, with each item setting the wallpaper via swaybg. Directory, command template and extensions are configurable through ~/.config/wallpaper-switcher/config or command-line options. Co-Authored-By: Claude Opus 5.5 --- README.md | 45 +++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 45 insertions(+) create mode 100644 README.md (limited to 'README.md') diff --git a/README.md b/README.md new file mode 100644 index 0000000..f43ecd8 --- /dev/null +++ b/README.md @@ -0,0 +1,45 @@ +# wallpaper-switcher + +An Openbox (or labwc) pipe menu that lists the `.png` and `.webp` files in +`~/.wallpapers` and sets the one you pick with `swaybg`. + +## Build + +Needs SBCL. The only dependency is UIOP, which ships with ASDF, so Quicklisp +is not required. + + make # builds ./wallpaper-switcher + make test + make install # copies it to ~/.local/bin (override with PREFIX=...) + +## Menu setup + +In `menu.xml`: + +```xml + +``` + +Then reference `wallpapers` from your root menu and reconfigure Openbox. + +## Configuration + +Optional. Put it in `$XDG_CONFIG_HOME/wallpaper-switcher/config` (usually +`~/.config/wallpaper-switcher/config`): + +``` +# Where to look (~ and $HOME are expanded). Subdirectories are not searched. +directory = ~/.wallpapers + +# Shell command run when an item is picked. %f is the file (already quoted +# for the shell), %% is a literal %. +command = pkill -x swaybg; swaybg -m fill -i %f & + +# File extensions to include, matched without regard to case. +extensions = png webp +``` + +Command-line options override the file: + + wallpaper-switcher --directory ~/Pictures/walls --command 'swaybg -m fit -i %f &' + wallpaper-switcher --config /path/to/other/config -- cgit v1.2.3