somebar(1)

💖 somebar 💖

okay so welcome to the General Commands Manual page for somebar(1) — the little bar with big main-character energy. grab a strawberry 🍓 and let's get into it.

---

✨ NAME ✨

somebar — a dwm-like bar for dwl. literally that's the whole vibe.

---

🦋 SYNOPSIS 🦋

somebar [-h] [-v] [-s path] [-c command arguments... ]

---

💅 DESCRIPTION 💅

somebar is a status bar for dwl, and it looks and functions like the dwm bar. no cap, it's giving “dwm but make it dwl.” 💖

---

🌸 USAGE 🌸

bestie, you must start somebar using dwl's -s flag, like this:

dwl -s somebar

Somebar can be controlled by writing to $XDG_RUNTIME_DIR/somebar-0, or to the path defined by the -s argument. here's the command menu:

• status TEXT — updates the status bar
• hide MONITOR — hides somebar on the specified monitor
• show MONITOR — shows somebar on the specified monitor
• toggle MONITOR — toggles somebar on the specified monitor

MONITOR is an zxdg_output_v1 name, which you can determine e.g. using weston-info. also, MONITOR can be all (all monitors) or selected (the monitor with focus). iconic options, honestly. 👑

Commands can be sent either by writing to the file name above, or equivalently by calling somebar with the -c argument. for example:

somebar -c toggle all

This is recommended for shell scripts, because there is no race-free way to write to a file only if it exists.

bestie, that race-free thing is important — don't try to be cute with file writes and then act surprised when it's flaky. 💀

---

🎀 OPTIONS 🎀

• -h — displays a short help text and exits
• -v — displays version information and exits
• -s — sets the path to the somebar control FIFO. the default value is $XDG_RUNTIME_DIR/somebar-0
• -c — sends a command to the control FIFO. see the USAGE section.

---

💀 BUGS 💀

send bug reports to ~raphi/public-inbox@lists.sr.ht — yes, that's the whole section. go off. 🫶

---

mwah 💋 — this was somebar-1.0, and you were reading the somebar(1) page. go be iconic ✨