Configuration

To configure the program you need to edit the config.txt file according to a simple syntax.

Each line of the config file defines a remapping rule: for each key typed by the user, the program will try to match it against the defined rules, and the first matching rule will be applied. Keys are indentified by their virtual key code in Windows.

Syntax of each line in the config file

<curKey> - <history> - <genKey> [action] ;

  • curKey: currently typed key code
  • history: codes list of previous keys, starting from the last one right before the current key declared in curKey, going backward
  • genKey: code of the key to generate when this rule is matched
  • action is optional, it can equals:
    • 0: no actions
    • 1-255: generates action "press backspace" events before generating genKey
    • 256: generates a "press shift" event before generating genKey
    • > 256: generates action - 256 "backspace" events and then a "shift" event before generating genKey
  • please note that each line must end with a ; character preceded by an empty space
  • codes must be expressed as decimal numbers, this table is the reference for such codes.

Here is listed an example of config.txt file content in order to implement a remapping from the latin keyboard into the russian one. 

69 - 74 - 222 1 ;
69 - - 84 ;
82 - - 72 ;
84 - - 78 ;
89 - - 83 ;
85 - 74 - 190 1 ;
85 - 89 - 190 1 ;
85 - - 69 ;
73 - - 66 ;
79 - 74 - 192 1 ;
79 - 89 - 192 1 ;
79 - - 74 ;
80 - - 71 ;
65 - 74 - 90 1 ;
65 - 89 - 90 1 ;
65 - - 70 ;
83 - - 67 ;
68 - - 76 ;
70 - - 65 ;
71 - - 85 ;
72 - 83 - 73 1 ;
72 - 72 83 - 79 1 ;
72 - 90 - 186 1 ;
72 - 67 - 88 1 ;
72 - - 219 ;
74 - - 81 ;
75 - - 82 ;
76 - - 75 ;
90 - - 80 ;
67 - - 87 ;
86 - - 68 ;
66 - - 188 ;
78 - - 89 ;
77 - - 86 ;
189 - 160 - 55 256 ;
189 - 161 - 55 256 ;
189 - - 77 ;
56 - 160 - 57 256 ;
56 - 161 - 57 256 ;
57 - 160 - 48 256 ;
57 - 161 - 48 256 ;
81 - - 221 ;
188 - - 191 256 ;
190 - - 191 ;
48 - 160 - 187 ;
48 - 161 - 187 ;
88 - - 219 ;
191 - - 189 ;

which includes the following correspondencies

  • я   ja|ya
  • ё   jo|yo
  • ю   ju|yu
  • э   je
  • ж   zh
  • ц   c
  • ш   sh
  • щ   shh
  • ч   ch
  • ъ   q
  • ь   '
  • ы   y

Here is listed an example of config.txt file content in order to implement a remapping from the latin keyboard into the german one. 

27 - 65 - 222 1 ;
27 - 79 - 192 1 ;
27 - 85 - 186 1 ;
27 - 83 - 219 1 ;

which includes the following correspondencies

  • ä   a ESC
  • ö   o ESC
  • ü   u ESC
  • ß   s ESC

reference key codes table