# 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. Picking an item runs `wallpaper-switcher --set FILE`, which runs the configured command and saves the path to `$XDG_STATE_HOME/wallpaper-switcher/current` (usually `~/.local/state/wallpaper-switcher/current`). Items call the program by its absolute path, so it does not need to be on `PATH`. ## Restoring at login Add this to `~/.config/labwc/autostart` (or `~/.config/openbox/autostart`): wallpaper-switcher --restore & It sets the saved wallpaper again with the current `command` setting. If you pass `--config` or `--command` to the menu, pass the same options here. ## Configuration Optional. Put it in `$XDG_CONFIG_HOME/wallpaper-switcher/config` (usually `~/.config/wallpaper-switcher/config`): ``` # Where to look (~ and $HOME are expanded). Subdirectories become submenus; # hidden ones (starting with .) are skipped. directory = ~/.wallpapers # Shell command run when an item is picked or restored. %f is the file # (already quoted for the shell), %% is a literal %. It is run with sh -c and # waited for, so anything long-running (like swaybg) must end with &. The # wallpaper is only saved if the command exits with status 0. 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