Installation

Splitter is packaged for Alpine Linux:

$ doas apk add splitter

Otherwise you should be able to build it. It depends on the Hare toolsuite, Wayland stuff, and Cairo:

wayland-dev wayland-protocols libbsd-dev cairo-dev libxkbcommon-dev hare hare-ev hare-wayland hare-cairo hare-xkb scdoc

$ git clone https://git.sr.ht/~stacyharper/splitter
$ make -C splitter
$ doas make install -C splitter

Usage

Splitter uses a simple .ini file to configure its appareance, split names, and to save runs. Here an example for the Celeste game:

[global]
bg=#303030FF
fg=#FFFFFFFF
gold=#e6c547FF
better=#b9ca4aFF
worse=#d54e53FF
margin=10
font_face=Sans
font_size=13.0

[game]
title=Celeste
category=any%
pause_after_forward=true

[checkpoint]
title=Forsaken City
title=Old Site
title=Celestial Resort
title=Golden Ridge
title=Mirror Temple
title=Reflection
title=The Summit

Once you wrote this file, you can give it to the splitterui command:

$ splitterui -c celeste.ini

Then you can either use the keyboard to control the GUI, or you can bind global shortcuts to the client splitterctl.

$ splitterctl stop     # Stop the GUI, similary to the q keybind.
$ splitterctl forward  # Move the split forward, similary to the space keybind.
$ splitterctl backward # Move the split backward, similary to the backspace keybind.
$ splitterctl save     # Save the run, similary to the s keybind.
$ splitterctl discard  # Discard the run, similary to the d keybind.
$ splitterctl pause    # Pause the run, similary to the p keybind.