waybar-river-tags(5)

💖 waybar-river-tags — the manual, bestie edition 💖

okay so this is waybar-river-tags(5), a File Formats Manual page, and it's all about the river tags module for waybar. yes it's a number-5 man page, no that doesn't mean it's scary. come sit with me 🫶

---

✨ NAME ✨

waybar — the river tags module. that's it, that's the name, she's simple and she slays 💅

---

🌸 DESCRIPTION 🌸

The tags module displays the current state of tags in river. literally its whole job. it watches your river tags and shows you what's going on. iconic behaviour tbh 👑

---

🎀 CONFIGURATION 🎀

You address this module by river/tags. yes, exactly like that, with the slash. iykyk.

• num-tags — typeof: uint, default: 9. how many tags should be displayed. max 32, so don't get greedy bestie, the ceiling is real 😭
• tag-labels — typeof: array. the label to display for each tag. this is where you name your babies 🌈
• disable-click — typeof: bool, default: false. if it's set to false, you can left-click to set the focused tag, and right-click to toggle tag focus. if it's set to true, this behaviour is disabled. so like... if you set it true, the mouse does nothing. zero clicks, zero drama 🙈
• expand — typeof: bool, default: false. enables this module to consume all left over space dynamically. it's giving main character energy, taking up the whole room ✨
• hide-vacant — typeof: bool, default: false. only show relevant tags — tags that are either focused or have a window on them. no vacant tags allowed, they're not invited to the party 🚫

---

💜 EXAMPLE 💜

"river/tags": {
     "num-tags": 5
}

five tags. five. that's the vibe. 🖐️

---

🦋 STYLE 🦋

here's your selector menu, bestie:

• #tags button
• #tags button.occupied
• #tags button.focused
• #tags button.urgent

note that occupied/focused/urgent status may overlap. that is, a tag may be both occupied and focused at the same time. so don't be confused when the styles stack — a tag can be booked and the moment, both things are true, she contains multitudes 💀

---

⭐ SEE ALSO ⭐

waybar(5), river(1)

---

and that's the whole page fr fr. this was waybar-river-tags(5) from source/version waybar-river-tags(5), dated 2026-02-08. go forth and style your tags, you absolute legend 🌟🎀