1wob(1) General Commands Manual wob(1)
2
3
4
6 wob - Wayland Overlay Bar
7
9 wob is a lightweight overlay volume/backlight/progress/anything bar for
10 Wayland.
11
13 wob [options...]
14
16 -h
17 Show help message and quit.
18
19 -v
20 Show the version number and quit.
21
22 -t <ms>
23 Hide wob after <ms> milliseconds, defaults to 1000.
24
25 -m <%>
26 Define the maximum percentage, defaults to 100.
27
28 -W <px>
29 Define bar width in pixels, defaults to 400.
30
31 -H <px>
32 Define bar height in pixels, defaults to 50.
33
34 -o <px>
35 Define border offset in pixels, defaults to 4.
36
37 -b <px>
38 Define border size in pixels, defaults to 4.
39
40 -p <px>
41 Define bar padding in pixels, defaults to 4.
42
43 -a <side>
44 Define anchor point, one of 'top', 'left', 'right', 'bottom', 'cen‐
45 ter' (default). May be specified multiple times.
46
47 -M <px>
48 Define anchor margin in pixels, defaults to 0.
49
50 -O <name>
51 Define output to show bar on or '*' for all. If ommited, focused
52 output is chosen. May be specified multiple times.
53
55 Launch wob in a terminal, enter a value (positive integer), press
56 return.
57
58 General case
59 You may manage a bar for audio volume, backlight intensity, or what‐
60 ever, using a named pipe. Create a named pipe, e.g. /tmp/wobpipe, on
61 your filesystem using.
62
63 mkfifo /tmp/wobpipe
64
65 Connect the named pipe to the standard input of an wob instance.
66
67 tail -f /tmp/wobpipe | wob
68
69 Set up your environment so that after updating audio volume, backlight
70 intensity, or whatever, to a new value like 43, it writes that value
71 into the pipe:
72
73 echo 43 > /tmp/wobpipe
74
75 Adapt this use-case to your workflow (scripts, callbacks, or keybind‐
76 ings handled by the window manager).
77
78 Sway WM example
79 Add these lines to your Sway config file:
80
81 exec mkfifo $SWAYSOCK.wob && tail -f $SWAYSOCK.wob | wob
82
83 Volume using alsa:
84
85 bindsym XF86AudioRaiseVolume exec amixer -q set Master 2%+ unmute && amixer sget Master | grep 'Right:' | awk -F'[][]' '{ print substr($2, 0, length($2)-1) }' > $SWAYSOCK.wob++
86 bindsym XF86AudioLowerVolume exec amixer -q set Master 2%- unmute && amixer sget Master | grep 'Right:' | awk -F'[][]' '{ print substr($2, 0, length($2)-1) }' > $SWAYSOCK.wob++
87 bindsym XF86AudioMute exec (amixer get Master | grep off > /dev/null && amixer -q set Master unmute && amixer sget Master | grep 'Right:' | awk -F'[][]' '{ print substr($2, 0, length($2)-1) }' > $SWAYSOCK.wob) || (amixer -q set Master mute && echo 0 > $SWAYSOCK.wob)
88
89 Volume using pulse audio:
90
91 bindsym XF86AudioRaiseVolume exec pamixer -ui 2 && pamixer --get-volume > $SWAYSOCK.wob
92 bindsym XF86AudioLowerVolume exec pamixer -ud 2 && pamixer --get-volume > $SWAYSOCK.wob
93
94 Brightness using haikarainen/light:
95
96 bindsym XF86MonBrightnessUp exec light -A 5 && light -G | cut -d'.' -f1 > $SWAYSOCK.wob
97 bindsym XF86MonBrightnessDown exec light -U 5 && light -G | cut -d'.' -f1 > $SWAYSOCK.wob
98
99
100
101 2020-04-06 wob(1)