waybar-river-layout(5)

✨ waybar-river-layout ✨

okay bestie, this is the manpage for the river layout module of waybar, living in section 5 of the File Formats Manual. it's a whole vibe and it's shorter than you think, so let's go 💅

---

🌸 NAME 🌸

waybar — the river layout module 🦋

---

💖 DESCRIPTION 💖

so this module literally just shows you the current layout in river. that's it. that's the whole job. iconic behavior honestly ✨

heads up though: it may not be set until a layout is first applied. so if your bar is looking a little empty at first, don't panic — that's just the vibe before river has a layout to show you 🙈

---

🎀 CONFIGURATION 🎀

you reach this module through river/layout. that's the address, that's the key, periodt 💖

• format — typeof: string, default: {} — how the info actually gets displayed. the {} is the lil spot where your data gets inserted, like a magic little hole 🕳️✨
• rotate — typeof: integer — a positive value rotates the text label, in increments of 90 degrees. spin that thing 🔄
• max-length — typeof: integer — the max length, in characters, that the module should display. it's giving boundaries 🫶
• min-length — typeof: integer — the minimum length in characters the module should accept.
• align — typeof: float — where the label sits inside the module, where 0 is left-aligned and 1 is right-aligned. if the module is rotated, it will follow the flow of the text 🌈
• justify — typeof: string — how the text sits inside the module's label. you can pick 'left', 'right', or 'center' to define the positioning ✨
• on-click — typeof: string — the command to execute when you click on the module 👆
• on-click-middle — typeof: string — the command to execute when you middle-click the module using the mousewheel.
• on-click-right — typeof: string — the command to execute when you right-click the module.
• menu — typeof: string — the action that popups the menu.
• menu-file — typeof: string — where the menu descriptor file lives. there needs to be an element of type GtkMenu with id menu in there 📁
• menu-actions — typeof: array — the actions that correspond to the buttons of the menu.
• expand — typeof: bool, default: false — lets this module consume all the leftover space dynamically. main character energy, taking up the whole room 👑

---

🦋 EXAMPLE 🦋

here's a lil config moment for you, copy it exactly bestie:

"river/layout": {
     "format": "{}",
     "min-length": 4,
     "align": "right"
}

---

💜 STYLE 💜

these are the CSS selectors you can style up, slay:

• #layout
• #layout.focused — applied when the output this module's bar belongs to is focused 👀
• #layout.<layout> — applied when the output this module's bar belongs to uses this layout 🎯

---

🌟 SEE ALSO 🌟

waybar(5), river(1)

---

and that's the whole page fr fr 🍓

this lil masterpiece is from the File Formats Manual, dated 2026-02-08, and it's filed under waybar-river-layout(5). go forth and have the cutest river layout on the block 💖✨🫶