waybar-idle-inhibitor(5)

💤 waybar-idle-inhibitor(5) 💤

okay bestie, welcome to the waybar-idle-inhibitor page from the File Formats Manual — yes it's a section 5 joint, we're being fancy today 👑

---

✨ NAME ✨

waybar — the idle_inhibitor module, aka the one that stops your screen from ghosting you 🫶

---

🌸 DESCRIPTION 🌸

The idle_inhibitor module can inhibit the idle behavior — think screen blanking, locking, and screensaver. You know it, you love it: it's the one and only "presentation mode". 💅

Basically your laptop stays awake when you need it to, no cap.

---

🎀 CONFIGURATION 🎀

okay this is the long part but stay with me, every single one of these matters, fr fr 💖

• format — typeof: string The format, how the state should be displayed.
• format-icons — typeof: array Based on the current state, the corresponding icon gets selected. ✨
• 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. Lowkey important: 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. Bestie note: a click also toggles the state 👀
• 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.
• start-activated — typeof: bool, default: false Whether the inhibit should be activated when starting waybar.
• timeout — typeof: double The number of minutes the inhibition should last.
• tooltip — typeof: bool, default: true Option to disable tooltip on hover.
• tooltip-format-activated — typeof: string This format is used when the inhibit is activated.
• tooltip-format-deactivated — typeof: string This format is used when the inhibit is deactivated.
• menu — typeof: string Action that popups the menu. Cannot be "on-click". 🚫
• 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.

---

🦋 FORMAT REPLACEMENTS 🦋

these are the little placeholders you can drop into your formats, iykyk 🧚

• {status} — status (activated or deactivated)
• {icon} — Icon, as defined in format-icons

---

⭐ EXAMPLES ⭐

not me giving you a whole config snippet, obsessed 😭

"idle_inhibitor": {
     "format": "{icon}",
     "format-icons": {
          "activated": "",
          "deactivated": ""
     },
     "timeout": 30.5
}

heads up bestie: those two icon values in format-icons are real glyphs, so copy them exactly as they appear — don't retype them by hand or you'll get sad little boxes. 💀

---

💜 STYLE 💜

the selectors you can flex in your CSS, in order:

• #idle_inhibitor
• #idle_inhibitor.activated
• #idle_inhibitor.deactivated

---

🌈 SEE YOU, BESTIE 🌈

That's the whole page! This one comes from the File Formats Manual, dated 2026-02-08, filed under waybar-idle-inhibitor(5) — so go forth, keep your screen awake, and slay 💅✨🎀🦋