libxkbcommon
1.10.0
Library implementing the XKB specification for parsing keyboard descriptions and handling keyboard state
|
See: Introduction to XKB.
See: terminology.
The xkbcommon project does not provide keyboard layouts. See the xkeyboard-config project for further information.
See this issue.
There could be many reasons!
libxkbcommon may not be able to load your configuration due to an issue (file not found, syntax error, unsupported keysym, etc.). Please use our debugging tools to get further information.
Note that the xkbcommon project does not provide keyboard layouts. See the xkeyboard-config project for further information.
This is most probably an issue with your Compose configuration. If you customized it, do not forget to restart your session before trying it.
Please use our debugging tools with the option --enable-compose
to get further information.
This project does not provide any keyboard layout database:
See also the keymap text format documentation for the syntax.
Use our debugging tools.
🚧 TODO
Consider the following use cases:
Caps_Lock
is on the second level of some key, and Shift
is latched, pressing the key locks Caps
while also breaking the Shift
latch, ensuring that the next character is properly uppercase.ISO_Level5_Latch
is on the third level of <AC04>
. So if a level 3 latch (typically on <RALT>
) is used to access it, the level 5 must break the previous level 3 latch, else both latches would be active: the effective level would be 7 instead of the intended 5.Both uses cases can be implemented using the following features:
VoidAction()
: to break latches.Patch that fixes the first use case:
xmodmap -pm
There is no strict equivalent. Since 1.10 xkbcli compile-keymap
has the option --modmaps
to print the modifiers maps from a keymap, but it does not print keysyms. In order to get the output for the current keymap, use it with xkbcli dump-keymap-*
:
xmodmap -e "…"
xmodmap /path/to/file
xkbcli
does not modify the display server keymap. setxkbmap -print -layout …
Since 1.9 one can use the --kccgst
option:
setxkbmap -query
No equivalent: xkbcli
only query raw keymaps and has no access to the original RMLVO settings.
setxkbmap -layout …
No equivalent: xkbcli
does not modify the display server keymap. One must use the tools specific to each display server in order order to achieve it.
If you use a custom layout, please have a look at User-configuration, which enables making custom layouts discoverable by keyboard configuration GUI.
xkbcomp -xkb /path/to/keymap/file -
xkbcomp -xkb $DISPLAY -
xkbcomp - $DISPLAY
xkbcomp /path/to/keymap/file $DISPLAY
No equivalent: xkbcli
does not modify the display server keymap. One must use the tools specific to each display server in order order to achieve it. Please have a look at User-configuration, which enables making custom layouts discoverable by keyboard configuration GUI.
The virtual modifiers mappings to real modifiers is an implementation detail. However, some applications may require it in order to interface with legacy code.
Use the dedicated function xkb_keymap::xkb_keymap_mod_get_mask()
.
Use the following snippet: