DZEN(1)

💖 DZEN(1) — bestie edition 💖

okay so welcome to the DZEN(1) page from your very own General Commands Manual — it's giving "tiny program, huge personality", and I'm gonna walk you through every single flag, no skips, no shortcuts. 🫶

---

✨ NAME ✨

dzen2 — general-purpose messaging and notification for X11. that's it, that's the whole vibe. 💅

---

✨ SYNOPSIS ✨

dzen2 [-v] [-p [seconds]] [-m [v|h]] [-ta <l|c|r>] [-sa <l|c|r>]
      [-x <pixel>] [-y <pixel>] [-w <pixel>] [-tw <pixel>] [-u]
      [-e <string>] [-l <lines>]  [-fn <font>] [-bg <color>]
      [-fg <color>] [-xs <screen>]

---

✨ DESCRIPTION ✨

Dzen is a general-purpose messaging and notification program for X11. it was designed to be scriptable in any language, and to integrate well with window managers like dwm, wmii and xmonad — though ngl it will work with literally any window manager you throw at it. 🌈

the way it works: Dzen expects the status message on its standard input, and it uses a custom formatting language for colors and several other features (like bar meters and such). 👑 for detailed usage and scripting instructions, check the README.

---

✨ OPTIONS ✨

• -fg <color> — sets the foreground color. <color> can be a symbolic name (like red, darkgreen, etc.) or a #rrggbb hex value (like #ffffaa). both are valid, pick your fighter. 🎀
• -bg <color> — sets the background color, same format as -fg. 🖌️
• -fn <font> — sets the font, using the format of xlsfonts and xfontsel.
• -ta <l|c|r> — sets the alignment of the title window content: l(eft), c(enter) or r(ight). pick a side bestie. ⬅️↔️➡️
• -tw <pixels> — sets the title window width.
• -sa <l|c|r> — sets the alignment of the slave window (see -ta). 💫
• -l <lines> — number of lines to display in the slave window (see (1) in README).
• -e <event1=action1:option1:...,action2;event2=...> — sets up events and actions, e.g. responses to mouse clicks (see (2) in README). this is the fun one, fr fr. 🖱️
• -m — starts up in menu mode (see (3) in README).
• -u — updates the contents of the title and slave window simultaneously (see (4) in README).
• -p [<timeout>] — persists EOF, with an optional timeout in seconds. ✨
• -x <pixels> — sets the x position on the screen.
• -y <pixels> — sets the y position on the screen.
• -h <pixels> — sets the line height. heads up: it defaults to fontheight + 2 pixels. 📏
• -w <pixels> — width. yeah, that's the whole description. iconic brevity, honestly.
• -xs <n> — sets the Xinerama screen number where dzen should appear. 🖥️
• -v — displays version information.

💀 heads up bestie: several of these options send you straight to the README for the real details — -l to (1), -e to (2), -m to (3), and -u to (4). go read it, iykyk.

---

✨ AUTHOR ✨

Dzen2 was written by Robert Manea. this manpage was written — based on the dzen documentation — by Petr Ročkai, for Debian GNU/Linux, though it may be used by others. 🫶 this manpage falls under the same licence as Dzen2 itself — see /usr/share/doc/dzen2/copyright for the deets.

---

✨ SEE ALSO ✨

• dzen2-dbar(1)
• dzen2-gcpubar(1)
• dzen2-gdbar(1)
• dzen2-textwidth(1)

andddd more detailed documentation — especially on the formatting language of dzen2 — lives in /usr/share/doc/dzen2/README.gz. go off, read it, slay. 📚💖

---

and that's the whole page, bestie!! 💅✨ this was the DZEN(1) manual from the General Commands Manual — that's the source of this lil doc, no cap. mwah, go make your status bar gorgeous. 🎀🦋🌸