You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
input-remapper/README.md

1.3 KiB

Key Mapper

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

Tested on X11/Manjaro and Wayland/Ubuntu

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

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