This project provides scripts and configuration to easily install and run LiveSplit on Linux using Wine or Proton, with optional global hotkey support.
- Automated installation of LiveSplit and required dependencies.
- Optional global hotkey support via a custom Rust binary.
- Desktop shortcuts for easy launching.
- Scripts for running LiveSplit with Wine, Proton for AutoSplit support.
- Install Dependencies
Make sure you have the following packages installed:
cargowinewinetricksunzipgitwgetdesktop-file-utils(fordesktop-file-install)zenity
On Ubuntu/Debian, you can install them with:
sudo apt install cargo wine winetricks unzip git wget desktop-file-utils zenity- Run the Installer
Clone this repository and run the install script:
git clone https://github.com/yourusername/livesplit-linux-install.git
cd livesplit-linux-install
./install.shThis will:
- Download and extract the latest LiveSplit build.
- Build and install the hotkey listener.
- Install required Wine dependencies.
- Set up desktop shortcuts and icons.
- Copy launch scripts to
/usr/local/bin.
After installation, you can launch LiveSplit from your application menu.
The following scripts are installed to /usr/local/bin:
livesplit-- Run LiveSplit with prepared wine prefix.livesplitwine-- Same as above, but using the wineprefix of the launcher.livesplitproton-- Run LiveSplit with Proton (for Steam integration and AutoSplit Support).
Both livesplitwine and livesplitproton will automatically ensure gdiplus is installed via winetricks so that LiveSplit displays correctly when running under a different prefix. This will make the program launch slower as winetricks is slow.
To enable global hotkeys, set the environment variable LIVESPLIT_HOTKEYS_ENABLED=1 before running the script. For example:
LIVESPLIT_HOTKEYS_ENABLED=1 livesplitwineOr, for Steam Proton integration, set your game's launch options to:
livesplitproton %command%
To enable hotkeys in this mode:
LIVESPLIT_HOTKEYS_ENABLED=1 livesplitproton %command%
To enable restart support for the game, set the environment variable LIVESPLIT_RESTARTABLE=1 before running the livesplitproton script. For example:
LIVESPLIT_RESTARTABLE=1 livesplitproton %command%This will grab the PID of the game and check if it's still running. Once it closes, it'll display a message box allowing you to restart the game.
Due to the implementation, some, if not all, games seem to hang livesplit once the game is restarted. So while this feature is supported, it won't be very usable until there is a proper fix for the livesplit freezing issue.
This uses the latest development build which allows for the TCP server to run at startup. As a consequence of this, if multiple LiveSplits are running, subsequent ones will crash as it will fail to open the TCP port.
With global hotkeys enabled, because of how difficult it is to differentiate if LiveSplit is in focus or not, hotkeys will get double sent.
Links the LiveSplit folder into prefixes so opening layouts and such are simplified by going into Favorites > LiveSplit.
- The LiveSplit configuration and binaries are installed to
~/LiveSplit. - The hotkey listener binary is installed as
~/LiveSplit/live-split-hotkeys. - Settings can be adjusted in
~/LiveSplit/settings.cfgor in LiveSplit itself (Changes aren't saved until the application is closed.).
To remove LiveSplit and its scripts:
rm -rf ~/LiveSplit
sudo rm /usr/local/bin/livesplit /usr/local/bin/livesplitwine /usr/local/bin/livesplitproton
rm ~/.local/share/applications/LiveSplit.desktop
rm ~/.local/share/applications/LiveSplitNoGlobals.desktop- Make sure all dependencies are installed.
- If you encounter issues with Wine or Proton, consult their documentation.
- For hotkey issues, ensure
LIVESPLIT_HOTKEYS_ENABLED=1is set.
Please submit an issue with any information about tests that can be performed to verify if livesplitwine works correctly with AutoSplitting.
- LiveSplit
- live-split-hotkeys (using my fork for comparison hotkeys and key deduplication, linking to upstream for credit)
Enjoy!