This python script allows you to automatically generate XKB keyboard layouts from a YAML file. This greatly speeds up the process of creating keyboards, and makes inputting Unicode characters much easier

PyYAML: pip install pyyaml

xkbgen.py <input> <output>, where <input> is the path to the YAML file and <output> is the path to the output file.

xkbgen.py --help for the builtin help message.

The following properties can or must be set in the YAML file:

The possible options for level3 and level5 can be viewed in /usr/share/X11/xkb/symbols/level3 and /usr/share/X11/xkb/symbols/level5, respectively.

The keys property contains all of the key mappings. For each field, the name is the original value of the key (determined by how layout and layout-locale were set), and the value is a list of keycodes. Here are the keycode formats:

• A space: no character is typed
• A single character: that character is typed
• Uxxxx: the Unicode character with the corresponding codepoint is typed
• dead_xxxx: a deadkey is typed (used for inserting diacritical marks)

Each keycode is separated by a space. The index of the keycode in the list determines what modifiers will be pressed to create it:

1. no modifiers
2. SHIFT
3. level3
4. SHIFT + level3
5. level5
6. SHIFT + level5
7. level3 + level5
8. SHIFT + level3 + level5

As an example, the line

   h: "h ʜ ɥ ħ ɦ ɧ ʰ H"

will cause the h key to type:

• h when no modifiers are pressed
• ʜ when SHIFT is pressed
• ɥ when level3 is pressed
• ħ when SHIFT + level3
• ɦ when level5 is pressed
• ɧ when SHIFT + level5 is pressed
• ʰ when level3 + level5 is pressed
• H when SHIFT + level3 + level5 is pressed

The examples directory contains example YAML files and their generated keyboard layouts, demonstrating all of the functionality described here.