Skip to content

idle-inhibit

Toggle that prevents screen dim, lock, and suspend while active.

Controllable from the CLI: wayle idle on|off|duration|remaining|status.

Add it to your layout with idle-inhibit:

toml
[[bar.layout]]
monitor = "*"
right = ["idle-inhibit"]

General

FieldTypeDefaultDescription
startup-durationu3260Duration in minutes when service starts. 0 means indefinite.
icon-inactivestring"tb-coffee-off-symbolic"Icon when idle inhibitor is inactive.
icon-activestring"tb-coffee-symbolic"Icon when idle inhibitor is active.
formatstring"{{ state }}"Format string for the label.
border-showboolfalseDisplay border around button.
icon-showbooltrueDisplay module icon.
label-showbooltrueDisplay label.
label-max-lengthu320Max label characters before truncation with ellipsis. Set to 0 to disable.
More about format

Placeholders

  • {{ state }} - Inhibitor state text (On, Off)
  • {{ remaining }} - Time remaining (e.g., "45m", shows "--" when indefinite)
  • {{ duration }} - Total duration (e.g., "60m", shows "--" when indefinite)

Examples

  • "{{ state }}" - "On"
  • "{{ remaining }}/{{ duration }}" - "45m/60m"
  • "{{ state }} ({{ remaining }})" - "On (45m)"

Colors

FieldTypeDefaultDescription
border-colorColorValue"green"Border color token.
icon-colorColorValue"auto"Icon foreground color. Auto selects based on variant for contrast.
icon-bg-colorColorValue"green"Icon container background color token.
label-colorColorValue"green"Label text color token.
button-bg-colorColorValue"bg-surface-elevated"Button background color token.

Click actions

FieldTypeDefaultDescription
left-clickClickAction"wayle idle toggle --indefinite"Action on left click. Default toggles indefinite idle inhibit.
right-clickClickAction"wayle idle toggle"Action on right click. Default toggles timed idle inhibit.
middle-clickClickAction""Action on middle click.
scroll-upClickAction""Action on scroll up.
scroll-downClickAction""Action on scroll down.

Default configuration

toml
[modules.idle-inhibit]
startup-duration = 60
icon-inactive = "tb-coffee-off-symbolic"
icon-active = "tb-coffee-symbolic"
format = "{{ state }}"
border-show = false
border-color = "green"
icon-show = true
icon-color = "auto"
icon-bg-color = "green"
label-show = true
label-color = "green"
label-max-length = 0
button-bg-color = "bg-surface-elevated"
left-click = "wayle idle toggle --indefinite"
right-click = "wayle idle toggle"
middle-click = ""
scroll-up = ""
scroll-down = ""

Released under the MIT License.