aboutsummaryrefslogtreecommitdiff
path: root/README.md
blob: f43ecd844db457c77990570862f822c5ff9ba989 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
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
<menu id="wallpapers" label="Wallpapers" execute="wallpaper-switcher" />
```

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