Skip to content

lock_keys

Shows Caps Lock / Num Lock / Scroll Lock state from the active XKB keyboard state.

Configuring this widget keeps lock-key state polling active even when [osd.kinds].lock_keys = false.

SettingTypeDefaultDescription
displaystring"short""short" (C N S) or "full" (Caps Num Scroll)
show_caps_lockbooltrueShow the Caps Lock indicator
show_num_lockbooltrueShow the Num Lock indicator
show_scroll_lockboolfalseShow the Scroll Lock indicator
hide_when_offboolfalseHide each indicator when it is off
[widget.lock_keys]
display = "short"
show_caps_lock = true
show_num_lock = true
show_scroll_lock = false
hide_when_off = false