Global hotkeys for X11 and all Wayland compositors by using linux device api. Keyboards are grabbed and only the non-hotkey keys are passed through to the system. The program accepts text commands as input. Run the program with the option --virtual to only grab virtual devices. This is useful when using keyboard input mapping software such as kanata, otherwise kanata may fail to launch or this program may fail to launch.

Commands

Bind

To add a key send bind <action> <keycode+keycode+...><newline> to the programs stdin, for example:

bind show_hide 56+44

which will bind alt+z. When alt+z is pressed the program will output show_hide (and a newline) to stdout. The program only accepts one key for each keybind command but accepts a multiple modifier keys. The keybinding requires at least one modifier key (ctrl, alt, super or shift) and a key to be used. The keycodes are values from <linux/input-event-codes.h> linux api header (which is the same as X11 keycode value minus 8).

Unbind

To unbind all keys send unbind_all<newline> to the programs stdin, for example:

unbind_all

Exit

To close gsr-global-hotkeys send exit<newline> to the programs stdin, for example:

exit