![](data/key-mapper.svg)
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
![](readme/coverage.svg)
## Installation
##### Manjaro/Arch
```bash
pacaur -S key-mapper-git
```
##### Ubuntu/Debian
Get a .deb file from the [release page](https://github.com/sezanzeb/key-mapper/releases)
or install the latest changes via:
```bash
sudo apt install git python3-setuptools gettext
git clone https://github.com/sezanzeb/key-mapper.git
cd key-mapper && ./scripts/build.sh
sudo apt install ./dist/key-mapper-1.1.0.deb
```
key-mapper is now part of [Debian Testing](https://packages.debian.org/testing/key-mapper)
##### pip
```bash
sudo pip install --no-binary :all: git+https://github.com/sezanzeb/key-mapper.git
sudo systemctl enable key-mapper
sudo systemctl restart key-mapper
```
If it doesn't seem to install, you can also try `sudo python3 setup.py install`
## Screenshots