How to find the Key Labels
The key labels that you use in the capsicain.ini are a bit different from Autohotkey or TMK.
On a keyboard with ANSI layout:
and with ISO layout:
For example, REWIRE BSP RSHF will turn your backspace key into a right Shift key.
These labels are obvious only on US-English keyboards
/ ; ' \ [ ] - =
If you use an international keyboard layout, this is a bit confusing.
For example, Windows translates the ; key to Ö for German language settings, and German keyboards have a plastic [Ö] keycap - but for the hardware driver, this is still the ; key!
Only on ISO (Euro) boards
L\ is the 'left backslash key', between Left Shift and Z.
The right backslash is either above (ANSI) or left of (ISO) the Return key, but it's the same key (scancode).
Only on Korean boards
"Hanja" = LANG2
"Han/Yeong" = LANG1
These keys are special. They send no "key down", only a "key up" (or the other way around?).
If you need a special feature for these keys, open a ticket.
Either:
press [ESC]+[C] (for scanCodes) for a list of all keys
Or:
- Press [ESC]+[D] (for Debug mode, capsicain console shows every key event)
- Tap the left Shift key
- The console shows
( 123 ms) [LSHFv =2a 0] [M:0] (0 ms) -- {LSHFv #1}. - -> key label for the left shift key is "LSHF"
- Press any key you want and you see its label
! Be Careful if you select something in the console, this will freeze the console, and all keyboard input.
Make sure you right-click into the console after copying.
Some unusual keys have a label like 0x5A (0x + the raw scancode). Just use that in your .ini.
Not all keys send out a key code. In that case, you cannot do anything with it.
When you press the key, and no new line shows up in the debug output, that key is invisible to the keyboard driver.
For example, [Fn] is often handled by the keyboard.
Logitech media buttons like "Volume+" send 'special' USB codes, not key events.