wob(1)

✨ wob — Wayland Overlay Bar ✨

okay bestie, let me introduce you to wob — that's the manual for the wob(1) command, and honestly? she's iconic. 💅

🦋 NAME 🦋

wob — literally stands for Wayland Overlay Bar, no cap. 🎀

💖 DESCRIPTION 💖

wob is a lightweight overlay volume/backlight/progress/anything bar for Wayland. that's it, that's the vibe. volume bar? slay. backlight bar? slay. progress bar? slay. anything bar?? she does it all, main character energy fr fr. 🌈

🌸 SYNOPSIS 🌸

wob [options...]

✨ OPTIONS ✨

okay so here's her whole flag collection, and yes she ate 👑

• -c, --config <file> — tells wob where your config file lives. pick the location yourself, you're a grown-up. 🎀
• -v, --verbose — turns up the chatter. by default she only speaks up for errors and warnings only, so this is your "tell me everything" button. 🗣️
• -V, --version — shows the version number and dips. out. bye. 👋
• -h, --help — shows the help message and dips, same energy. 🫶

🧚 USAGE 🧚

so how do you actually talk to her? wob reads the values she should display from standard input, in these formats:

<value>

or

<value> <style>

where <value> is a number in the interval from 0 to max, and <style> is a style that's defined over in wob.ini(5). iykyk 💫

🍓 CONFIGURATION 🍓

wob goes hunting for a config file in these locations, in exactly this order:

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

first one she finds wins, periodt. ✨

want the tea on the config file format? that's all in wob.ini(5). 📖

👑 ENVIRONMENT 👑

these environment variables have an effect on wob, bestie:

• WOB_DISABLE_PLEDGE — disables seccomp syscall filtering on Linux. set this if you're having trouble running wob with tools like valgrind. like, if it's being weird with valgrind specifically, this is your girl. 😭

⭐ See also ⭐

wob.ini(5) — go read it, she's worth it 💜

---

and that's the whole page, bestie!! 🦋 this little cutie is dated 2025-05-21 and lives at wob(1) in the General Commands Manual — go forth and make the prettiest bars on Wayland, ilysm 🫶💖🎀