waybar-river-window(5)

🌊 waybar-river-window(5) — the manual page, bestie edition 💖

Okay so this is waybar-river-window(5), from the file formats manual, and it is exactly the page you want if you're a river user who wants their bar to show off what window they're in. Stay with me, it's short and it ate. ✨

---

🌸 NAME 🌸

waybar — the river window module. yup that's it, that's the name, she's simple and she's iconic 💅

---

🦋 DESCRIPTION 🦋

The window module displays the title of the currently focused window in river. that's the whole vibe — one job, done flawlessly, no notes 👑

---

🎀 CONFIGURATION 🎀

You address this whole thing by river/window. like, that's its little address in your config, that's how it knows it's being talked to 🫶

---

• format — typeof: string, default: {}. This is the format, aka how the info should be displayed. On {} the data gets inserted. so {} is literally the placeholder for the window title. slay.
• rotate — typeof: integer. A positive value rotates the text label, and it does it in 90 degree increments. so you're rotating in lil quarter-turns, no in-between 🌀
• max-length — typeof: integer. The maximum length in character the module should display. (yes, "character", singular, the manpage said it, I'm not fixing it, it's camp 💀)
• min-length — typeof: integer. The minimum length in characters the module should accept.
• align — typeof: float. The alignment of the label within the module, where 0 is left-aligned and 1 is right-aligned. and if the module is rotated, it will follow the flow of the text. cute, it knows where it's going ✨
• justify — typeof: string. The alignment of the text within the module's label, and you get to pick 'left', 'right', or 'center' to define the positioning.
• on-click — typeof: string. Command to execute when clicked on the module.
• on-click-middle — typeof: string. Command to execute when middle-clicked on the module using mousewheel. yup, the mousewheel click counts, she's inclusive 🖱️
• on-click-right — typeof: string. Command to execute when you right-click on the module.
• menu — typeof: string. Action that popups the menu.
• menu-file — typeof: string. Location of the menu descriptor file. There need to be an element of type GtkMenu with id menu.
• menu-actions — typeof: array. The actions corresponding to the buttons of the menu.
• expand — typeof: bool, default: false. Enables this module to consume all left over space dynamically. main character energy: she takes up the whole room 💅

---

💜 EXAMPLES 💜

okay this is the one you actually came for, here's how it looks in your config:

"river/window": {
     "format": "{}"
}

periodt. that's the whole setup. 🎀

---

🌈 STYLE 🌈

The CSS selectors you can style, bestie:

• #window
• #window.focused — Applied when the output this module's bar belongs to is focused. so when your bar's output is the focused one, this class shows up and you can make it glow, or not, your call 👑

---

🌸 ok that's the entire page, no cap. now go make your bar pretty and tell river I said hi 💖

signing off: this was waybar-river-window(5), dated 2026-02-08, and yeah, that's the manual name and the version/date info folded right in here at the end instead of a boring footer line, you're welcome 🫶✨