Keyword: ALPHA_FROM, ALPHA_TO, ALPHA_END

ALPHA_FROM / ALPHA_TO / ALPHA_END

ALPHA_FROM key1  key2  ... keyN
ALPHA_TO   key1' key2' ... keyN'
ALPHA_END

key : any valid key label

Maps one set of keys to another set of keys.

This is useful to define alternative keyboard layouts, like DVORAK or COLEMAK.

Key position in the FROM string equals the position of the resulting key in the TO string.
(third key in FROM is mapped to third key in TO).

Both sets must define the same number of characters.

Only one alpha map per config.

Multiple blanks and line breaks do not matter. They are only for pretty formatting.

Control keys and virtual keys are valid, but not recommended and barely tested. Use combos instead.
Alpha maps are designed for character keys.

Example

Key [1] is mapped to A; 2 to B, 3 to C, 4 to D

ALPHA_FROM  1 2 3 4
ALPHA_TO    A B C D
ALPHA_END

Same config as before; with line breaks that are ignored.

ALPHA_FROM  1  2 
             3  4
ALPHA_TO    A  B
             C  D
ALPHA_END

This is the complete config for a DVORAK keyboard layout

ALPHA_FROM
   q  w  e  r  t     y  u  i  o  p  [  ]
    a  s  d  f  g     h  j  k  l  ;  '
     z  x  c  v  b     n  m  ,  .  /
ALPHA_TO
   '  ,  .  p  y     f  g  c  r  l  /  =     # closing the apostrophe ' here to help my editor
    a  o  e  u  i     d  h  t  n  s  -
     ;  q  j  k  x     b  m  w  v  z
ALPHA_END

Complications

Alpha map is processed after the COMBO rules

• When a COMBO matches, the alpha map is skipped
• Combos evaluate the original (or rewired) key, not the result of the alpha map

Your own shortcut keys always stay the same, regardless of your alpha map.

OPTION LcontrolLwinBlocksAlphaMapping

With this option enabled, with a DVORAK mapping

• C is mapped to J
• Ctrl+C is not mapped to Ctrl+J (the Ctrl-C shortcut stays where it is)

See Keyword: OPTION for more details.