Key Mapper

GUI tool to map input buttons to e.g. change the macro keys of a mouse or any keyboard to something different.

Running

sudo python3 setup.py install && sudo key-mapper-gtk -d

You can also start it via your applications menu.

Dependencies

Depending on how those packages are called in your distro:

python3-distutils-extra python3-evdev python3-dbus

It works with both Wayland and X11.

Tests

pylint keymapper --extension-pkg-whitelist=evdev
sudo python3 setup.py install && python3 tests/test.py

Roadmap

• show a dropdown to select an arbitrary device from xinput list
• creating presets per device
• renaming presets
• show a list for mappings [keycode -> target]
• read keycodes with evdev
• make that list extend itself automatically
• load that file with setxkbmap on button press
• keep the system defaults for unmapped buttons
• button to stop mapping and using system defaults
• highlight changes and alert before discarding unsaved changes
• automatically load the preset when the mouse connects
• ask for administrator permissions using polkit
• make sure it works on wayland
• add to the AUR, provide .deb and .appimage files
• support timed macros, maybe using some sort of syntax