wob(1)

wob1

Wayland overlay bar

Usage

wob [options ...]

Overview

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

Options

-c, --config <file>

Configuration file location.

-v, --verbose

Increase verbosity of messages, defaults to errors and warnings only.

-V, --version

Show the version number and quit.

-h, --help

Show help message and quit.

Usage

wob reads values to display from standard input in the following formats:

<value>

or

<value> <style>

Where <value> is number in interval from 0 to max and <style> is style defined in wob.ini(5).

Configuration

wob searches for a config file in the following locations, in this order:

1. $XDG_CONFIG_HOME/wob/wob.ini 2. ~/.config/wob/wob.ini 3. /etc/wob/wob.ini

For information on the config file format, see wob.ini(5).

Environment

The following environment variables have an effect on wob:

WOB_DISABLE_PLEDGE

Disable seccomp syscall filtering on Linux. Set this if you are having trouble running wob with tools like valgrind.

Releases

4 releases since Debian 11 (Bullseye); the text changed 2 times.

  1. 11
  2. 12–13
  3. Arch

--config since Debian 12 (Bookworm); --verbose since Debian 12 (Bookworm); -V since Debian 12 (Bookworm); -c since Debian 12 (Bookworm).

--anchor until Debian 11 (Bullseye); --background-color until Debian 11 (Bullseye); --bar-color until Debian 11 (Bullseye); --border until Debian 11 (Bullseye); --border-color until Debian 11 (Bullseye); --height until Debian 11 (Bullseye); --margin until Debian 11 (Bullseye); --max until Debian 11 (Bullseye); --offset until Debian 11 (Bullseye); --output until Debian 11 (Bullseye); --padding until Debian 11 (Bullseye); --timeout until Debian 11 (Bullseye); --width until Debian 11 (Bullseye); -H until Debian 11 (Bullseye); -M until Debian 11 (Bullseye); -O until Debian 11 (Bullseye); -W until Debian 11 (Bullseye); -a until Debian 11 (Bullseye); -b until Debian 11 (Bullseye); -m until Debian 11 (Bullseye); -o until Debian 11 (Bullseye); -p until Debian 11 (Bullseye); -t until Debian 11 (Bullseye).

From wob 0.16-2 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.