to.set_caps_lock_led

set_caps_lock_led controls the Caps Lock LED independently of the Caps Lock state.

Example

Press Caps Lock to toggle a layer that changes w, a, s, and d to arrow keys. The Caps Lock LED is illuminated while the layer is active.

{
    "description": "Use the Caps Lock LED as a layer indicator",
    "description_notes": [
        "Press caps_lock to toggle a layer in which w/a/s/d work as arrow keys."
    ],
    "manipulators": [
        {
            "type": "basic",
            "from": {
                "key_code": "caps_lock",
                "modifiers": { "optional": ["any"] }
            },
            "to": [
                {
                    "set_variable": {
                        "name": "layer",
                        "expression": "layer == 0 ? 1 : 0"
                    }
                },
                {
                    "set_caps_lock_led": "on",
                    "conditions": [
                        {
                            "type": "variable_unless",
                            "name": "layer",
                            "value": 1
                        }
                    ]
                },
                {
                    "set_caps_lock_led": "auto",
                    "conditions": [
                        {
                            "type": "variable_if",
                            "name": "layer",
                            "value": 1
                        }
                    ]
                }
            ]
        },

        //
        // WASD -> arrows
        //

        {
            "type": "basic",
            "from": { "key_code": "w" },
            "to": [{ "key_code": "up_arrow" }],
            "conditions": [
                { "type": "variable_if", "name": "layer", "value": 1 }
            ]
        },
        {
            "type": "basic",
            "from": { "key_code": "a" },
            "to": [{ "key_code": "left_arrow" }],
            "conditions": [
                { "type": "variable_if", "name": "layer", "value": 1 }
            ]
        },
        {
            "type": "basic",
            "from": { "key_code": "s" },
            "to": [{ "key_code": "down_arrow" }],
            "conditions": [
                { "type": "variable_if", "name": "layer", "value": 1 }
            ]
        },
        {
            "type": "basic",
            "from": { "key_code": "d" },
            "to": [{ "key_code": "right_arrow" }],
            "conditions": [
                { "type": "variable_if", "name": "layer", "value": 1 }
            ]
        }
    ]
}

Specification

{
    "to": [
        {
            "set_caps_lock_led": "on | off | auto"
        }
    ]
}
ValueDescription
on Forces the Caps Lock LED on.
(Available since Karabiner-Elements 16.99.8)
off Forces the Caps Lock LED off.
(Available since Karabiner-Elements 16.99.8)
auto Removes the override so that the LED follows the Caps Lock state again.
(Available since Karabiner-Elements 16.99.8)
Last modified: 2026-10-26 Markdown