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

2.7 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)

  • Mapping relative axis to relative axis (mouse to mouse) is not possible
  • Mapping relative axis to absolute axis (mouse to gamepad) is not possible
  • Mapping absolute axis to absolute axis (gamepad to gamepad) is not possible

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.6.0-beta.deb

input-remapper is now part of Debian Unstable and of Ubuntu

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

Beta

The beta branch contains features that still require work, but that are ready for testing. It uses a different config path, so your presets won't break. input-remapper-beta-git can be installed from the AUR. If you are facing problems, please open up an issue.

Screenshots