2020-11-10 22:14:28 +00:00
|
|
|
# Folder Structure of Key Mapper
|
|
|
|
|
|
2020-11-10 22:18:22 +00:00
|
|
|
Stuff has to be placed in `/usr/share/X11/xkb` to my knowledge. In order to
|
2020-11-10 22:14:28 +00:00
|
|
|
be able to make backups of the configs, which would be expected in the
|
2020-11-10 22:19:52 +00:00
|
|
|
users home directory, this is symlinked to home where the actual files are.
|
2020-11-10 22:14:28 +00:00
|
|
|
|
2020-11-10 22:20:22 +00:00
|
|
|
Every user gets a path within that `/usr/...` directory which is very
|
2020-11-10 22:14:28 +00:00
|
|
|
unconventional, but it works. This way the presets of multiple users
|
|
|
|
|
don't clash.
|
|
|
|
|
|
2020-11-10 22:18:22 +00:00
|
|
|
**Presets**
|
|
|
|
|
|
|
|
|
|
- `/usr/share/X11/xkb/symbols/key-mapper/<user>/<device>/<preset>`
|
|
|
|
|
- `/home/<user>/.config/key-mapper/<device>/<preset>`
|
|
|
|
|
|
2020-11-10 22:14:28 +00:00
|
|
|
This is how a single preset is stored. The path in /usr is a symlink, the
|
|
|
|
|
files are actually in home.
|
2020-11-10 22:18:22 +00:00
|
|
|
|
|
|
|
|
**Defaults**
|
|
|
|
|
|
|
|
|
|
- `/usr/share/X11/xkb/symbols/key-mapper/<user>/default`
|
|
|
|
|
- `/home/<user>/.config/key-mapper/default`
|
2020-11-10 22:14:28 +00:00
|
|
|
|
|
|
|
|
This is where key-mapper stores the defaults. They are generated from the
|
|
|
|
|
parsed output of `xmodmap` and used to keep the unmapped keys at their system
|
|
|
|
|
defaults.
|
|
|
|
|
|
2020-11-10 22:18:22 +00:00
|
|
|
**Keycodes**
|
|
|
|
|
|
|
|
|
|
- `/usr/share/X11/xkb/keycodes/key-mapper`
|
2020-11-10 22:14:28 +00:00
|
|
|
|
2020-11-10 22:18:22 +00:00
|
|
|
Because the concept of "reasonable symbolic names" ([www.x.org](https://www.x.org/releases/X11R7.7/doc/xorg-docs/input/XKB-Enhancing.html))
|
|
|
|
|
doesn't apply when mouse buttons are all over the place, an identity mapping
|
|
|
|
|
to make generating "symbols" files easier/possible exists. A keycode of
|
|
|
|
|
10 will be known as "<10>" in symbols configs. This has the added benefit
|
|
|
|
|
that keycodes reported by xev can be identified in the symbols file.
|
