1wob(1)                      General Commands Manual                     wob(1)
2
3
4

NAME

6       wob - Wayland Overlay Bar
7

DESCRIPTION

9       wob is a lightweight overlay volume/backlight/progress/anything bar for
10       Wayland.
11

SYNOPSIS

13       wob [options...]
14

OPTIONS

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

USAGE

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)
Impressum