|
libxkbcommon 1.8.1
Library implementing the XKB specification for parsing keyboard descriptions and handling keyboard state
|
xkbcommon provides multiple tools for debugging. Please consult the manual pages man xkbcli for the complete documentation of each tool.
libxkbcommon-tools package installed.xkbcli interactive-x11 to test your current configuration in an X11 session.xkbcli interactive-wayland to test your current configuration in a Wayland session. You may want to use the flag --enable-compose if your layouts use dead keys.xkbcli how-to-type: to find the key combinations to type in order to get a specific character or keysym.xkbcli interactive-evdev: to test a configuration without affecting your current configuration. This requires access to the /dev/input/event* devices, you may need to add your user to the input group or run as root.xkbcli compile-keymap: to check the resulting compiled keymap for some configuration.xkbcli compile-compose: to check the resulting Compose file.~/xkb-test. Note that in order to test it safely, it should not be one of the locations that xkbcommon searches.~/xkb-test/symbols/my-layout.Test if your changes compile successfully:
--include* arguments is important here.If it does not compile, you may add the flag --verbose for additional information.
Test if it behaves correctly. Note that you may need to add your user to the input group or run as root.
~/xkb-test to one of the user-configuration locations, restart your session, update the keyboard configuration using your usual UI and enjoy your XKB customization!X11: Unfortunately Xorg does not support alternative paths, so the next best option is to use the venerable xkbcomp tool.
Happy hacking!