Skip to content
Jake Stanger edited this page Dec 27, 2024 · 1 revision

Note

This module requires your user is in the input group.

Displays the toggle state of the capslock, num lock and scroll lock keys.

Screenshot of clock widget with popup open

Configuration

Type: keys

Name Type Default Description
show_caps boolean true Whether to show capslock indicator.
show_num boolean true Whether to show num lock indicator.
show_scroll boolean true Whether to show scroll lock indicator.
icon_size integer 32 Size to render icon at (image icons only).
icons.caps_on string or image 󰪛 Icon to show for enabled capslock indicator.
icons.caps_off string or image '' Icon to show for disabled capslock indicator.
icons.num_on string or image Icon to show for enabled num lock indicator.
icons.num_off string or image '' Icon to show for disabled num lock indicator.
icons.scroll_on string or image Icon to show for enabled scroll lock indicator.
icons.scroll_off string or image '' Icon to show for disabled scroll lock indicator.
seat string seat0 ID of the Wayland seat to attach to.
JSON
{
  "end": [
    {
      "type": "keys",
      "show_scroll": false,
      "icons": {
        "caps_on": "󰪛"
      }
    }
  ]
}
TOML
[[end]]
type = "keys"
show_scroll = false

[end.icons]
caps_on = "󰪛"
YAML
end:
  - type: keys
    show_scroll: false
    icons:
      caps_on: 󰪛
Corn
{
end = [ 
        { 
            type = "keys" 
            show_scroll = false 
            icons.caps_on = "󰪛" 
        }
    ]
}

Styling

Selector Description
.keys Keys box container widget.
.keys .key Individual key indicator container widget.
.keys .key.enabled Key indicator where key is toggled on.
.keys .key.caps Capslock key indicator.
.keys .key.num Num lock key indicator.
.keys .key.scroll Scroll lock key indicator.
.keys .key.image Key indicator image icon.
.keys .key.text-icon Key indicator textual icon.

For more information on styling, please see the styling guide.

Clone this wiki locally