filter-key, filter-keytrans — Generic key event translator
filter-key : [file]
This filter translates key events according to a set of translation rules. This can be used to remap a keyboard.
The name of the configuration file. If none given, the filter will first look for the file filter/keytrans in the user GGI directory ($HOME/.ggi/ on UNIX), then in the base GGI directory if not found.
The mapping is specified through a simple text file, each line being a translation rule. A line starting with a # is a comment. Each line must contain 10 values in the following order:
Consider only the bits set here.
The bits set above must match this value.
If this is not KEY_UNMAPPED==0xffff, the button/label/symbol of the incoming key must match these fields.
Change these bits from the original modifiers...
... set them to these - one shouldn't use that.
The data that is then sent by the keymapper. Any fields set to KEY_UNMAPPED==0xffff will be copied from the incoming event.