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

50 lines
1.3 KiB
Markdown

4 years ago
# Key Mapper
4 years ago
**Almost done**
4 years ago
4 years ago
GUI tool to map input buttons to e.g. change the macro keys of a mouse or
any keyboard to something different. It should not be device specific, any
4 years ago
input device supported by Linux plug and play that reports keyboard events
will likely work.
<p align="center">
<img src="data/screenshot.png"/>
</p>
# Running
```bash
sudo python3 setup.py install && sudo key-mapper-gtk -d
```
4 years ago
You can also start it via your applications menu.
4 years ago
4 years ago
# Dependencies
Depending on how those packages are called in your distro:
`python3-distutils-extra` `python3-evdev`
# Tests
```bash
sudo python3 setup.py install && python3 tests/test.py
```
4 years ago
4 years ago
# Roadmap
4 years ago
- [x] show a dropdown to select an arbitrary device from `xinput list`
4 years ago
- [x] creating presets per device
- [x] renaming presets
4 years ago
- [x] show a list for mappings `[keycode -> target]`
4 years ago
- [x] read keycodes with evdev
4 years ago
- [x] make that list extend itself automatically
- [x] load that file with `setxkbmap` on button press
4 years ago
- [x] keep the system defaults for unmapped buttons
4 years ago
- [x] button to stop mapping and using system defaults
- [x] highlight changes and alert before discarding unsaved changes
4 years ago
- [ ] automatically load the preset when the mouse connects
4 years ago
- [x] ask for administrator permissions using polkit
4 years ago
- [ ] make it work on wayland
- [ ] add to the AUR, provide .deb and .appimage files