Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?


Failed to load latest commit information.
Latest commit message
Commit time
March 6, 2023 16:51
December 15, 2022 14:43
March 20, 2023 15:48
March 20, 2023 15:36
March 20, 2023 15:36
March 20, 2023 15:48
February 27, 2023 18:49
March 20, 2023 15:48
March 20, 2023 15:48
March 20, 2023 15:36
November 23, 2022 22:55
April 17, 2022 12:19
April 17, 2022 12:19
October 26, 2020 23:45
March 20, 2023 15:48
March 20, 2023 15:48

Input Remapper

An easy to use tool to change the behaviour of your input devices.
Supports X11, Wayland, combinations, programmable macros, joysticks, wheels,
triggers, keys, mouse-movements and more. Maps any input to any other input.

Usage - Macros - Installation - Development - Examples



yay -S input-remapper-git
sudo systemctl restart input-remapper
sudo systemctl enable input-remapper

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

sudo apt install git python3-setuptools gettext
git clone
cd input-remapper && ./scripts/
sudo apt install -f ./dist/input-remapper-2.0.0.deb

input-remapper is available in Debian and Ubuntu


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

Conda can cause problems due to changed python paths and versions.

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

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+
sudo systemctl enable input-remapper
sudo systemctl restart input-remapper

Migrating beta configs to version 2

By default, Input Remapper will not migrate configurations from the beta. If you want to use those you will need to copy them manually.

rm ~/.config/input-remapper-2 -r
cp ~/.config/input-remapper/beta_1.6.0-beta ~/.config/input-remapper-2 -r

Then start input-remapper