Skip to content

Configuration One Handed Mode

reminiscience edited this page Aug 13, 2026 · 1 revision

One-handed mode

While one-handed mode is active and the mirror key is held, the keyboard is mirrored left-to-right: the keys under your right hand produce what the left half would have produced, and the other way round. Release the key and the keyboard is normal again.

It is meant for typing with one hand – or with one hand occupied – without learning a second layout.

Switch it on with M3+F10, from the tray menu, or with the toggleOneHandedMode hotkey. Switching it on does not change anything by itself; the mirroring only happens while the mirror key is held.

Options

"oneHandedMode": {
    "mirrorKey": "39",
    "mirrorMap": {
        "02": "0B",
        "03": "0A",
        ...
    }
}

mirrorKey

The scan code of the key that triggers the mirroring while held. "39" is the space bar.

mirrorMap

Which key becomes which, as "original": "mirrored" pairs of scan codes. The default maps the standard rows symmetrically: the 1 key becomes the 0 key, the leftmost letter of a row becomes the rightmost, and so on.

The map is one-directional in notation but works both ways: an entry "02": "0B" also makes 0B produce 02.

You will want to adjust this for ergonomic and matrix keyboards, where the physical mirror axis is not where a standard board has it, and for boards with a different number of keys per row. Scan codes are hexadecimal; a plus sign at the end sets the extended bit (36+ is the right Shift key). The same notation is used in layouts.json.

The easiest way to find a scan code is the map section of layouts.json – it is indexed by scan code, and layer 1 of each entry tells you which key it is.

Clone this wiki locally