waybar-sway-mode(5)

✨ waybar-sway-mode(5) ✨

okay bestie, pull up a chair, we're reading the waybar-sway-mode page from the File Formats Manual 💖 it's short, it's iconic, and it's literally just one module, so let's go 🦋

---

🌸 NAME 🌸

waybar — the sway mode module 👑

---

💜 DESCRIPTION 💜

The mode module displays the current binding mode of Sway. that's it, that's the whole vibe ✨

---

🎀 CONFIGURATION 🎀

You address this one by sway/mode 💅

• format — typeof: string, default: {}. The format, how information should be displayed. On {} data gets inserted. 🫶 that curly-brace moment is where your actual mode text lands, no cap.
• rotate — typeof: integer. Positive value to rotate the text label (in 90 degree increments). 📐
• max-length — typeof: integer. The maximum length in character the module should display.
• 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. If the module is rotated, it will follow the flow of the text. 🌈
• justify — typeof: string. The alignment of the text within the module's label, allowing options '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.
• on-click-right — typeof: string. Command to execute when you right-click on the module.
• on-update — typeof: string. Command to execute when the module is updated.
• on-scroll-up — typeof: string. Command to execute when scrolling up on the module.
• on-scroll-down — typeof: string. Command to execute when scrolling down on the module.
• smooth-scrolling-threshold — typeof: double. Threshold to be used when scrolling.
• tooltip — typeof: bool, default: true. Option to disable tooltip on hover. 🙈 yeah it's phrased as the option to disable it, that's just how it is, don't come for me.
• 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. 💀 yes, an actual element, of type GtkMenu, with id menu — that's the requirement, periodt.
• 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, it takes up the whole bar if you let it.

---

⭐ EXAMPLES ⭐

here's the look, copy it exactly bestie:

"sway/mode": {
     "format": " {}",
     "max-length": 50
}

---

🧚 STYLE 🧚

• #mode

that's your selector, go wild 💅

---

and that's the whole page!! source/version situation: this is waybar-sway-mode(5) dated 2026-02-08, fr fr 💖 you're officially a sway mode module expert now, go slay those binding modes 👑✨