keyVent - LibreSplit Global Hotkeys

Warning

Still in beta stage. Expect bugs!

Note

Only single-key hotkeys are supported.

This program uses udev to enable display server independent global hotkeys for LibreSplit on Linux.

It detects keyboard input devices in /dev/input/event* and reads key presses from there. The program then controls LibreSplit through it's libresplit-ctl unix domain socket.

Note

This software is heavily based on https://github.com/MarinX/keylogger

Compatibility

This program was tested on

Debian 13 / Gnome / Wayland
Ubuntu 24.04 / Gnome / Wayland + X11

Permissions

You need to be in the input group for this program to work.

Config

Example config:

{
    "keybinds": {
        "start_or_split": 82,
        "stop_or_reset": 83,
        "unsplit": 75,
        "skip_split": 77,
        "cancel": 72,
        "close_libresplit": 0
    }
}

Start/Split: Keypad 0
Stop/Reset: Keypad Dot
Undo Split: Keypad 4
Skip Split: Keypad 6
Cancel Run: Keypad 8
Close Libresplit: disabled

The keybinds must be valid keycodes. You can run keyvent dumpkeys to print all incoming key presses to the terminal, or have a look at keymap.go
Use 0 to disable the key bind.

Usage

keyvent <command> [args...]

Commands:

  help
    Print this help text

  control <config>
    Read the <config>-file and start listening for global hotkeys

  info    <config>
    Show informations about the given config file and the environment

  dumpkeys
    Print all keypresses to stdout

Example

keyvent control ./path/to/config.json

1.6 KiB Raw Permalink Blame History