xkbcommon

Haskell bindings for libxkbcommon

Latest on Hackage:0.0.3

This package is not currently in any snapshots. If you're interested in using it, we recommend adding it to Stackage Nightly. Doing so will make builds more reliable, and allow stackage.org to host generated Haddocks.

MIT licensed by Auke Booij
Maintained by [email protected]

Wrapper library for libxkbcommon, which is the new alternative for the X11 XKB.h keyboard input API. Specifically, it finds keymap files from disk based on Rule/Model/Layout/Variant/Option specifications, and compiles them into a Keymap. From this Keymap, a KeyboardState can be constructed which represents the states of various physical buttons such as the shiftaltctrl keys, and can give the correct key symbol based on keyboard events. E.g., pressing the <h> key while <shift> is pressed produces the H symbol in the common QWERTY keymaps, but in e.g. the Dvorak keymap, it produces the D symbol.

After keymap creation, which libxkbcommon can do based on locale preferences and enviroment variables, this is all handled by routing keyboard events through libxkbcommon.

At this stage, these haskell bindings do not make libxkbcommon look much like a haskell library. For example, in principle the entire libxkbcommon library is just a stateful processor, and has nothing to do with the IO monad. However, because I am not yet a very good haskell programmer, and because in most realistic use cases input data comes from the IO monad anyway, the stateful operations are encoded in the IO monad anyway.

Note that these bindings load the keysym constants from the libxkbcommon C header files at compile time using TH, and similarly keycodes from the Linux header files. These should be present for correct compilation.