input-remapper/README.md

1.3 KiB

Key Mapper

Almost done

GUI tool to map input buttons to e.g. change the macro keys of a mouse or any keyboard to something different. It should not be device specific, any input device supported by Linux plug and play that reports keyboard events will likely work.

Running

sudo python3 setup.py install --prefix /usr && 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

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 it work on wayland
  • add to the AUR, provide .deb and .appimage files