Goldsplit

A lightweight speedrun timer for macOS, Windows, and Linux.

Features

• Create games with custom segments
• Organize runs into named categories (e.g. Any%, 100%)
• Compare splits against personal best or best segments
• Sum of Best calculation using current run segments to fill gaps
• Pause, resume, undo split, and skip split
• Edit attempt times after a run
• Customizable delta colors (ahead/behind, gaining/losing)
• Configurable hotkeys
• Always-on-top mode
• Cross-platform — built with Wails (Go + Svelte)

Screenshots

Games List	Categories & Resume	Edit Game
New Category	Attempt Editor	Settings — General
Settings — Hotkeys	Settings — Colors	About

Installation

Download the latest release for your platform from the Releases page.

Platform	File
macOS	Goldsplit.app.zip
Windows	Goldsplit-windows-amd64.exe
Linux	goldsplit-linux-amd64

macOS note: The binary is not signed. On first launch, macOS Gatekeeper will block it. To allow it, run:

xattr -cr /Applications/Goldsplit.app

Alternatively, you can build from source.

Building from Source

Prerequisites

• Go 1.25+
• Node.js 23+

Tip: If you use mise, run mise install to set up Go, Node.js, and dev tools automatically.

Then install the Wails CLI:

make setup

Linux only: GTK and WebKit development libraries are required. See Wails Linux prerequisites.

Build

git clone https://github.com/tyrantkhan/goldsplit.git
cd goldsplit
wails build

The built application will be in build/bin/.

Development

Start the dev server with hot reload:

make dev

Make Targets

Target	Description
make setup	Install Wails CLI and other Go tools
make dev	Start Wails dev server with hot reload
make build	Production build
make lint	Run golangci-lint (builds frontend first)
make frontend-check	Run svelte-check on frontend
make test	Run Go tests
make ci	Run lint + frontend-check + test

Project Structure

goldsplit/
├── internal/        # Go backend (domain logic, persistence)
│   ├── split/       # Domain types (Template, Attempts)
│   └── persist/     # JSON file persistence
├── frontend/        # Svelte 5 + TypeScript UI
│   └── src/
├── build/           # Wails build config and assets
└── Makefile

Default Hotkeys

Action	Key
Start/Split	Space
Pause	P
Reset	R
Undo Split	Backspace
Skip Split	S

Hotkeys can be customized in Settings → Hotkeys.

License

MIT