input-remapper Documentation

An easy to use tool to change the behaviour of your input devices.

6,016 stars Python Python 1 file ยท ~757 tokens #gamepad#gaming#keyboard#keyboard-shortcuts#linux#mouse
RAW Doc

File: README.md

Input Remapper

Installation

Ubuntu/Debian

Either download an installable .deb file from the latest release:

sh
wget https://github.com/sezanzeb/input-remapper/releases/download/2.2.1/input-remapper-2.2.1.deb
sudo apt install -f ./input-remapper-2.2.1.deb

Or install the very latest changes via:

sh
sudo apt install git gettext
git clone https://github.com/sezanzeb/input-remapper.git
cd input-remapper
./scripts/build-deb.sh
sudo apt purge input-remapper input-remapper-daemon input-remapper-gtk python3-inputremapper
sudo apt install -f ./dist/input-remapper-2.2.1.deb

Input Remapper is also available in the repositories of Debian
and Ubuntu via

sh
sudo apt install input-remapper

Input Remapper โ‰ฅ 2.0 requires at least Ubuntu 22.04.

Fedora

sh
sudo dnf install input-remapper
sudo systemctl enable --now input-remapper

Arch

sh
yay -S input-remapper-git
sudo systemctl enable --now input-remapper

Void

sh
sudo xbps-install -S input-remapper
sudo ln -s /etc/sv/input-remapper /var/service
sudo sv up input-remapper

Other Distros

Figure out the packages providing those dependencies in your distro, and install them:
python3-evdev โ‰ฅ1.3.0, gtksourceview4, python3-devel, python3-pydantic,
python3-dasbus, python3-psutil, python3-gi, python3-gi-cairo, python3-cairo, libayatana-appindicator

You can also use pip to install some of them. Python packages need to be installed
globally for the service to be able to import them. Don't use --user. Conda and such
may also cause problems due to changed python paths and versions.

sh
sudo pip install evdev pydantic dasbus PyGObject
sh
git clone https://github.com/sezanzeb/input-remapper.git
cd input-remapper
sudo python3 -m install --root /
sudo systemctl enable --now input-remapper

For all other options and help, check python3 -m install --help

To uninstall:

sh
sudo python3 -m install.uninstall

File: .reviewdog.yml


runner:
mypy:
name: mypy
cmd: mypy --show-column-numbers inputremapper tests install --ignore-missing-imports
errorformat:
- "%f:%l:%c: %m"

pylint:
name: pylint
cmd: pylint inputremapper tests --extension-pkg-whitelist=evdev
errorformat:
- "%f:%l:%c: %t%n: %m"

flake8:
cmd: flake8 inputremapper tests
format: flake8

black:
cmd: black --diff --quiet --check ./inputremapper ./tests
format: black