wayremap
Dynamic keyboard remapper for Wayland.
It works on both X Window Manager and Wayland, but focused on Wayland as it intercepts evdev input and require root permission.
Motivation
Wayland and Sway is awesome. It brings lots of benefit to Linux desktop environment.
When I was using X desktop envionment, there is an awesome tool called xremap which remap keys based on current focused application.
https://github.com/k0kubun/xremap
I was looking for something similar to xremap for Wayland, but not found, so I decided to create on my own.
Install
sudo pip install wayremap
Run
For Wayland security model, we have to do execute key remapping as root.
Simply write your own service and run it as python script:
# /opt/wayremap.py
from wayremap.config import WayremapConfig, Binding
from wayremap.main import run
import uinput as k
wayremap_config = WayremapConfig(
# Filter applications which remap will be applied
applications=[
'Chromium',
'Brave-browser',
'Leafpad',
'firefoxdeveloperedition',
],
bindings=[
# Emacs-like key binding
Binding('ctrl.alt.a', [[k.KEY_LEFTCTRL, k.KEY_HOME]]),
Binding('ctrl.alt.e', [[k.KEY_LEFTCTRL, k.KEY_END]]),
Binding('ctrl.alt.h', [[k.KEY_LEFTCTRL, k.KEY_BACKSPACE]]),
Binding('ctrl.f', [[k.KEY_RIGHT]]),
Binding('ctrl.b', [[k.KEY_LEFT]]),
Binding('ctrl.p', [[k.KEY_UP]]),
Binding('ctrl.n', [[k.KEY_DOWN]]),
Binding('ctrl.k',
[[k.KEY_LEFTSHIFT, k.KEY_END], [k.KEY_LEFTCTRL, k.KEY_X]]),
Binding('ctrl.a', [[k.KEY_HOME]]),
Binding('ctrl.e', [[k.KEY_END]]),
Binding('ctrl.y', [[k.KEY_LEFTCTRL, k.KEY_V]]),
Binding('alt.f', [[k.KEY_LEFTCTRL, k.KEY_RIGHT]]),
Binding('alt.b', [[k.KEY_LEFTCTRL, k.KEY_LEFT]]),
Binding('alt.d', [[k.KEY_LEFTCTRL, k.KEY_DELETE]]),
Binding('ctrl.h', [[k.KEY_BACKSPACE]]),
Binding('ctrl.s', [[k.KEY_LEFTCTRL, k.KEY_F]]),
# OSX-like key binding
Binding('alt.a', [[k.KEY_LEFTCTRL, k.KEY_A]]),
Binding('alt.c', [[k.KEY_LEFTCTRL, k.KEY_C]]),
Binding('alt.v', [[k.KEY_LEFTCTRL, k.KEY_V]]),
Binding('alt.x', [[k.KEY_LEFTCTRL, k.KEY_X]]),
# Slack helm!
Binding('alt.x', [[k.KEY_LEFTCTRL, k.KEY_K]]),
])
run(wayremap_config, '/dev/input/event4')
And then
sudo modprobe uinput
sudo python /opt/wayremap.py
Note that '/dev/input/event4' varies among system.
Known bugs
3is pressed when changing focused window- Key repeating become slow while switching focused windowd
Roadmap
- Enable to run wihtout Sway
- Packaging for Arch Linux, Debian, Fedora, etc.
- Enable to load per-application config.
- Re-write in Rust for better performance.
2 Dec 14, 2022
26 Dec 30, 2022
2 Jan 18, 2022
5 Nov 8, 2021
4 Oct 11, 2022
3 Jan 24, 2022
7 Jul 30, 2022
1 Nov 28, 2021
290 Jan 7, 2023
6 Mar 11, 2022
5 Oct 7, 2022
8 Oct 22, 2022
250 Dec 30, 2022
407 Dec 30, 2022
56 Jan 3, 2023
13 Dec 23, 2022
3 Nov 19, 2021
2 Jan 15, 2022
1.9k Jan 4, 2023