diff options
Diffstat (limited to 'README.md')
| -rw-r--r-- | README.md | 21 |
1 files changed, 19 insertions, 2 deletions
@@ -22,6 +22,21 @@ In `menu.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 @@ -32,8 +47,10 @@ Optional. Put it in `$XDG_CONFIG_HOME/wallpaper-switcher/config` (usually # hidden ones (starting with .) are skipped. directory = ~/.wallpapers -# Shell command run when an item is picked. %f is the file (already quoted -# for the shell), %% is a literal %. +# 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. |
