A LiveSplit-inspired speedrunning split timer for the terminal.

• Configurable global hotkeys
• 🌈 Animated rainbow best splits
• Undo and delete split
• Splits stored in single human-editable file
• 24-bit terminal color
• 60 FPS rendering with low CPU usage

Flitter is designed to work on macOS and Linux (X11). Windows is not currently supported.

Head over to the releases page for precompiled binaries and an installation one-liner.

Alternatively, to quickly build and install flitter from source, install Rust and then run:

cargo install --git https://github.com/alexozer/flitter.git

On recent versions of macOS, on first launch you will be prompted to enable accessibility permissions for your terminal. This is required for Flitter to read global hotkeys when the terminal is not focused. Go to System Settings -> Privacy & Security -> Accessibility and enable the toggle for your terminal.

Install the X11 development libraries.

Debian/Ubuntu:

sudo apt install libx11-dev

Fedora/RHEL/CentOS:

sudo dnf install xorg-x11-server-devel

To get started, download and rename the template file examples/splits_minimal.json to a path of your choosing. Edit the file (title, category, split_names) to represent your current run.

All other fields (e.g. golds, personal_best) are optional and updated automatically as you complete your runs. See examples/splits.json for an example of a fully populated file, if you have existing splits you'd like to migrate.

Launch Flitter by providing the path to your splits file:

$ flitter path/to/my-splits.json

Warning: Don't edit your splits file while Flitter is running, your changes will be overwritten.

Keybindings are all global hotkeys; they will work even when the terminal is not focused. The following table is the default keybindings:

To change them, create $HOME/.config/flitter-timer/config.json and populate it with the example config. See the full list of keys for which key names you can use.

Feel free to make an issue or a pull request!