X11 input supercharger

Adds system-wide:

Can be used by mouse or graphics tablet users.

Scrolling mode requires selected button to be unbound (example).

Since 0.3.0, keyboard shortcuts are not captured correctly. So if you want to e.g. bind LMB to Z, and open link in a new tab by pressing Ctrl+Z (Ctrl+LMB), unbind Ctrl+Z in your browser settings beforehand.

Example config - Wacom Bamboo tablet

```toml

Windows-like auto-scrolling. Press button_id to start scrolling,

then move your mouse up or down. The longer the distance between the

cursor and the starting point, the faster you scroll. Remove/comment

out whole section if you don't want it.

[scroll]

Device with buttons. Use xinput list and xinput test-xi2 --root to

determine.

device = "Wacom Bamboo Pen stylus"

Change it if you have many devices with the same name.

subdevice = 0

hold = false means click once to enable, click once to disable.

Recommended false on tablets, as it's annoying when you connectivity

while using hold = true.

hold = false

Scrolling speed. Has different effect on different screen resolutions.

Recommended to set speed to high value and decrease system-wide

scrolling speed as much as possible. Equation: speed×distance[px]

÷1000000_000 = emulated mouse wheel rolls.

speed = 600000

Which button toggles scrolling. Button 2 is the middle mouse button.

Button 3 is upper button on Wacom Bamboo Pen.

button_id = 3

Click using keyboard. Active only until timeout_ms has passed since

the last time any of grabbed devices was used. Remove/comment out

whole section if you don't want it.

[keyboard_click]

Device that moves or has buttons, used to determine timeout. Use

xinput list and xinput test-xi2 --root to determine.

device = "Wacom Bamboo Pen stylus"

Change it if you have many devices with the same name.

subdevice = 0

How much time must pass until keys go back to normal.

timeout_ms = 500

Key that emulates left mouse button.

DO NOT USE TOGGLE BUTTON (CapsLock etc.)

key_lmb = 52 # Z

Key that emulates right mouse button.

DO NOT USE TOGGLE BUTTON (CapsLock etc.)

key_rmb = 53 # X

Key that will be used for temporary purposes.

DO NOT USE TOGGLE BUTTON (CapsLock etc.)

key_unused1 = 106 # numpad /

Key that will be used for temporary purposes.

DO NOT USE TOGGLE BUTTON (CapsLock etc.)

key_unused2 = 63 # numpad * ```

Example config - mouse

Use config above, but replace xinput_grep with f.e. "Gaming Mouse", and stylus_button_id with some button ID. Middle button ID is 2, but that requires you to unbind its pasting functionality somehow. I recommend using additional buttons if your mouse has these. Button IDs 4 and 5 are reserved for scroll events. You can check button IDs with xinput test-xi2 --root.

Installation

First, install xdotool and xmodmap.

Grab binary from Releases page, or build it yourself by copying the source and running cargo build --release, or have Cargo download the sources and put binary in PATH for you with cargo install x11-input-supercharger. Rust stable toolchain is required.

Config.toml must be in current working directory when starting the program.

Miscellaneous

Konsole (terminal emulator) doesn't like having a key pressed when selecting. Use Gnome Terminal.

The program grabs root X11 input device.

The code is ugly, and the program sometimes crashes on shutdown (but doesn't seem to leave the system in broken state).

KSysGuard shows the program uses 0-1% of CPU time on Intel i5 6300HQ.

If the program is unstable on your system, check out versions 0.2.x. They used text parser instead of X11 API. However, different keyboard grabbing solution was used back then, which caused lags in Chromium-based programs. See older tree for old README.

Acknowledgements

Thanks to Bruce Byfield for his Wacom-related articles for Linux Magazine.

Thanks to Linux Wacom Project developers for making it possible to use Wacom as input device on Linux.

Thanks to all X11 developers for awesome tools they created.