input-remapper/README.md

Key Mapper

A Linux tool to change the mapping of your input device buttons.

Usage

To open the UI to modify the mappings, use:

key-mapper-gtk

You can also start it via your applications menu.

To keep injecting the mapping after closing the window, the daemon needs to be running. If it doesn't already after logging in, you can use:

key-mapper-service

Git Installation

git clone https://github.com/sezanzeb/key-mapper.git
cd key-mapper
sudo python3 setup.py install
usermod -a -G input $USER
usermod -a -G plugdev $USER

Depending on how those packages are called in your distro, you need the following dependencies:

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 valid devices
• creating presets per device
• renaming presets
• show a mapping table
• make that list extend itself automatically
• read keycodes with evdev
• inject the mapping
• 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 presets on login for plugged in devices
• automatically load presets when devices get plugged in after login
• make sure it works on wayland
• add to the AUR, provide .deb and .appimage files
• support timed macros, maybe using some sort of syntax