A key mapper program.
Features:
- Map a key plus any number of modifiers to a command
- Map a modifier release to a command
- Configure which keys to use as modifiers
- Works in Xorg, Wayland, and the TTY (using libevdev)
- Run:
git clone https://github.com/aaronamk/hkd.git
cd hkd
sudo make install
- Add yourself to the
inputgroup:sudo usermod -a -G input <username>. This allows hkd to access/modify input devices in the filesystem without root access. - Reboot for the change to take affect
The file config.h is where you set your key bindings. This is similar to suckless's software practices. config.h is part of the source, so you must recompile and restart the program for any changes to take effect. Some default bindings are provided; you can add or remove them as needed.
See linux/input-event-codes.h for a list of available key codes or use the evtest command to see device events printed to the terminal.
hkd /dev/input/by-id/<device-id-1> /dev/input/by-id/<device-id-2> ...
NOTICE: Please check the issues board if you find a bug or would like a feature added. Open a new issue if it is not listed.