input-remapper/README.md
2022-05-08 10:00:07 +02:00

2.5 KiB

Input Remapper (Beta)

Formerly Key Mapper

An easy to use tool to change the mapping of your input device buttons.
Supports mice, keyboards, gamepads, X11, Wayland, combined buttons and programmable macros.
Allows mapping non-keyboard events (click, joystick, wheel) to keys of keyboard devices.

Usage - Macros - Installation - Development - Screenshots - Examples

Known Issues (Beta Branch)

  • The GUI is currently is not adapted to reflect all new features and might behave strange. Mapping a gamepad to mouse is currently not possible in the GUI. Also mapping joystick or mouse axis to buttons might not work. Those are only limitations of the GUI, when editing the preset manually all those features are still available.

Installation

Manjaro/Arch
pacaur -S input-remapper-git
Ubuntu/Debian

Get a .deb file from the release page or install the latest changes via:

sudo apt install git python3-setuptools gettext
git clone https://github.com/sezanzeb/input-remapper.git
cd input-remapper && ./scripts/build.sh
sudo apt install ./dist/input-remapper-1.5.0-beta.deb

input-remapper is now part of Debian Unstable

Manual

Dependencies: python3-evdev ≥1.3.0, gtksourceview4, python3-devel, python3-pydantic, python3-pydbus

Python packages need to be installed globally for the service to be able to import them. Don't use --user

sudo pip install evdev -U  # If newest version not in distros repo
sudo pip uninstall key-mapper  # In case the old package is still installed
sudo pip install --no-binary :all: git+https://github.com/sezanzeb/input-remapper.git
sudo systemctl enable input-remapper
sudo systemctl restart input-remapper

If it doesn't seem to install, you can also try sudo python3 setup.py install

Screenshots