> [!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](https://f.jstanger.dev/github/ironbar/keys.png) ## 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](images) | `󰪛` | Icon to show for enabled capslock indicator. | | `icons.caps_off` | `string` or [image](images) | `''` | Icon to show for disabled capslock indicator. | | `icons.num_on` | `string` or [image](images) | `` | Icon to show for enabled num lock indicator. | | `icons.num_off` | `string` or [image](images) | `''` | Icon to show for disabled num lock indicator. | | `icons.scroll_on` | `string` or [image](images) | `` | Icon to show for enabled scroll lock indicator. | | `icons.scroll_off` | `string` or [image](images) | `''` | Icon to show for disabled scroll lock indicator. | | `seat` | `string` | `seat0` | ID of the Wayland seat to attach to. |
JSON ```json { "end": [ { "type": "keys", "show_scroll": false, "icons": { "caps_on": "󰪛" } } ] } ```
TOML ```toml [[end]] type = "keys" show_scroll = false [end.icons] caps_on = "󰪛" ```
YAML ```yaml end: - type: keys show_scroll: false icons: caps_on: 󰪛 ```
Corn ```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](styling-guide).