input-remapper/README.md

70 lines
2.4 KiB
Markdown
Raw Normal View History

2022-01-01 12:00:49 +00:00
<p align="center"><img src="data/input-remapper.svg" width=100/></p>
2020-12-20 16:33:59 +00:00
2022-01-01 12:00:49 +00:00
<h1 align="center">Input Remapper</h1>
<p align="center"><b>Formerly Key Mapper</b></p>
2020-10-26 22:45:22 +00:00
2020-12-19 18:42:55 +00:00
<p align="center">
2021-01-01 13:51:40 +00:00
An easy to use tool to change the mapping of your input device buttons.<br/>
Supports mice, keyboards, gamepads, X11, Wayland, combined buttons and programmable macros.<br/>
Allows mapping non-keyboard events (click, joystick, wheel) to keys of keyboard devices.
2020-12-19 18:42:55 +00:00
</p>
2020-11-26 20:37:15 +00:00
2021-10-02 19:52:29 +00:00
<p align="center"><a href="readme/usage.md">Usage</a> - <a href="readme/macros.md">Macros</a> - <a href="#installation">Installation</a> - <a href="readme/development.md">Development</a> - <a href="#screenshots">Screenshots</a> - <a href="readme/examples.md">Examples</a></p>
2020-12-20 16:33:59 +00:00
<p align="center"><img src="readme/pylint.svg"/> <img src="readme/coverage.svg"/></p>
2020-11-16 12:01:42 +00:00
2020-12-20 16:33:59 +00:00
## Installation
2020-11-01 20:32:06 +00:00
2020-12-20 16:33:59 +00:00
##### Manjaro/Arch
```bash
2022-01-01 12:00:49 +00:00
pacaur -S input-remapper-git
2020-12-20 16:33:59 +00:00
```
##### Ubuntu/Debian
2022-01-01 12:00:49 +00:00
Get a .deb file from the [release page](https://github.com/sezanzeb/input-remapper/releases)
2021-03-17 20:36:25 +00:00
or install the latest changes via:
2021-01-07 16:25:27 +00:00
2020-12-20 16:33:59 +00:00
```bash
sudo apt install git python3-setuptools gettext
2022-01-01 12:00:49 +00:00
git clone https://github.com/sezanzeb/input-remapper.git
cd input-remapper && ./scripts/build.sh
2022-03-19 08:34:57 +00:00
sudo apt install ./dist/input-remapper-1.4.2.deb
2020-12-20 16:33:59 +00:00
```
2020-11-29 12:55:37 +00:00
input-remapper is now part of [Debian Unstable](https://packages.debian.org/sid/input-remapper)
2022-03-23 09:37:00 +00:00
##### Manual
2020-11-29 15:24:44 +00:00
2022-03-23 09:37:00 +00:00
Dependencies: `python3-evdev` ≥1.3.0, `gtksourceview4`, `python3-devel`, `python3-pydantic`, `python3-pydbus`
2022-03-19 08:34:57 +00:00
Python packages need to be installed globally for the service to be able to import them. Don't use `--user`
2020-12-20 16:33:59 +00:00
```bash
2022-03-19 08:34:57 +00:00
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
2022-01-01 12:00:49 +00:00
sudo systemctl enable input-remapper
sudo systemctl restart input-remapper
```
2021-09-29 18:17:45 +00:00
If it doesn't seem to install, you can also try `sudo python3 setup.py install`
2021-07-03 13:49:23 +00:00
2022-05-08 08:44:15 +00:00
##### 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](https://github.com/sezanzeb/input-remapper/issues).
2020-12-20 16:33:59 +00:00
## Screenshots
2020-12-20 13:02:31 +00:00
<p align="center">
<img src="readme/screenshot.png"/>
</p>
<p align="center">
<img src="readme/screenshot_2.png"/>
</p>