1.0.01MIT
strict
core22
Per-application X11 mouse button, scroll, and chord remapper with Shift Layers
A lightweight Linux X11 alternative to X-Mouse Button Control for
per-application mouse button, wheel, and chord remapping across multiple
Shift Layers. Independent open-source project, not affiliated with,
sponsored by, or endorsed by Highresolution Enterprises or X-Mouse Button
Control. Uses standard X11 window class detection, pointer polling, passive
XGrabButton remapping, XTest input dispatch, and EWMH window actions on X11;
Wayland-native sessions restrict external X11 pointer remapping.
FEATURES
- Per-Application WMCLASS Profiles: automatically detect the active X11
window WMCLASS and apply custom mappings for browsers, code editors, file
managers, or any window picked with the interactive crosshair tool.
- 4 Shift Layers & Button Chords: map Middle (Btn 2), Side Back (Btn 8),
Side Forward (Btn 9), Wheel Up/Down, and multi-button chords across four
switchable layers via hotkeys, modifier hold, or button actions.
- Real X11 & EWMH Actions: emit key chords, insert text snippets, send
scroll steps, or trigger minimize, maximize, close, and always-on-top.
- Live Monitor & JSON Presets: inspect live pointer coordinates, held
buttons, open X11 windows, audit firing logs, import/export JSON profiles,
and switch between English and Vietnamese interfaces.
SUPPORT & DONATE
- Created by Thanh Nguyen — https://buymeacoffee.com/thanhnv128b
per-application mouse button, wheel, and chord remapping across multiple
Shift Layers. Independent open-source project, not affiliated with,
sponsored by, or endorsed by Highresolution Enterprises or X-Mouse Button
Control. Uses standard X11 window class detection, pointer polling, passive
XGrabButton remapping, XTest input dispatch, and EWMH window actions on X11;
Wayland-native sessions restrict external X11 pointer remapping.
FEATURES
- Per-Application WMCLASS Profiles: automatically detect the active X11
window WMCLASS and apply custom mappings for browsers, code editors, file
managers, or any window picked with the interactive crosshair tool.
- 4 Shift Layers & Button Chords: map Middle (Btn 2), Side Back (Btn 8),
Side Forward (Btn 9), Wheel Up/Down, and multi-button chords across four
switchable layers via hotkeys, modifier hold, or button actions.
- Real X11 & EWMH Actions: emit key chords, insert text snippets, send
scroll steps, or trigger minimize, maximize, close, and always-on-top.
- Live Monitor & JSON Presets: inspect live pointer coordinates, held
buttons, open X11 windows, audit firing logs, import/export JSON profiles,
and switch between English and Vietnamese interfaces.
SUPPORT & DONATE
- Created by Thanh Nguyen — https://buymeacoffee.com/thanhnv128b
Update History
1.0.0 (1)14 Nov 2026, 07:15 UTC
14 Nov 2026, 07:07 UTC
14 Nov 2026, 07:06 UTC
14 Nov 2026, 07:15 UTC


