Development

Contributions are very welcome, I will gladly review and discuss any merge requests.

Roadmap

show a dropdown to select valid devices
creating presets per device
renaming presets
show a mapping table
make that list extend itself automatically
read keycodes with evdev
inject the mapping
keep the system defaults for unmapped buttons
button to stop mapping and using system defaults
highlight changes and alert before discarding unsaved changes
automatically load presets on login for plugged in devices
make sure it works on wayland
support timed macros, maybe using some sort of syntax
add to the AUR, provide .deb file
basic support for gamepads as keyboard and mouse combi
executing a macro forever while holding down the key using h
mapping D-Pad directions as buttons
configure joystick purpose and speed via the GUI
support for non-GUI TTY environments with a command to stop and start
start the daemon in such a way to not require usermod
mapping a combined button press to a key
add "disable" as mapping option
mapping joystick directions as buttons, making it act like a D-Pad
mapping mouse wheel events to buttons
automatically load presets when devices get plugged in after login (udev)
using keys that aren't available in the systems keyboard layout
user-friendly way to map the left mouse button

Tests

sudo pip install coverage
pylint keymapper --extension-pkg-whitelist=evdev
sudo pip install . && coverage run tests/test.py
coverage combine && coverage report -m

To read events, evtest is very helpful. Add -d to key-mapper-gtk to get debug output.

Releasing

ssh/login into a debian/ubuntu environment

./scripts/build.sh

This will generate key-mapper/deb/key-mapper-0.6.0.deb

Badges

sudo pip install git+https://github.com/jongracecox/anybadge
./scripts/badges.sh

New badges, if needed, will be created in readme/ and they just need to be commited.

Files

service

bin/key-mapper-service executable that starts listening for commands via dbus and runs the injector when needed. It shouldn't matter how it is started as long as it manages to start without throwing errors. It usually needs root rights.

gui

bin/key-mapper-gtk the executable that starts the gui. It also sends messages to the service via dbus if certain buttons are clicked.
bin/key-mapper-gtk-pkexec opens a password promt to grant root rights to the GUI, so that it can read from devices.
data/key-mapper.policy is needed for pkexec
data/key-mapper.desktop is the entry in the start menu

cli

bin/key-mapper-control is an executable to send messages to the service via dbus. It can be used to start and stop injection without a GUI.

systemd

data/key-mapper.service starts key-mapper-service automatically on boot on distros using systemd.
data/keymapper.Control.conf is needed to connect to dbus services started by systemd from other applications.

user stuff

key-mapper-autoload.desktop executes on login and tells the systemd service to stop injecting (possibly the presets of another user) and to inject the users autoloaded presets instead (if any are configured)

Resources

PyGObject API Reference

python-evdev

3.4 KiB Raw Blame History