OpenSplit

---

Free & open-source speedrun split timer with an emphasis on customization.

Join the ZellyDev Games Discord and select "OpenSplit" to discuss the application or get involved with development!

Quickstart • Nightly builds • Skins • Development • Contributing

---

Highlights

• 🖥️ Cross Platform.
• 🕒 Fast, readable timer built for speedrunning.
• 🎨 Fully skinnable UI — drop CSS-based skins into a folder and switch at runtime.
• 🎮 Global hotkeys.
• 🔎 Speedrun.com integration to search games, categories, and fetch art.
• 🏁 Racetime.gg integration to facilitate live racing.
• 🧰 Modern stack: Go + React/TypeScript via Wails.

Status: early development/alpha. Expect rapid change and frequent nightlies.

---

Downloads

Nightly builds (updated on each merge to main):

• Windows (x64)
• macOS (Apple Silicon) (Make sure you read the Quick Start! There's extra steps to avoid the "damaged file" error.)
• Linux

---

Quickstart

Run the app

1. Download a nightly for your OS (or build from source).
2. Unzip and run the binary. For Mac Open the DMG and move OpenSplit to Applications.
   • On Mac there's a couple of additional steps:
   • from a terminal run xattr -rd com.apple.quarantine /Applications/OpenSplit.app to clear the qurauntine flags.
   • Go to Settings > Privacy and Security > Accesibility and remove OpenSplit with the "-" button at the bottom if it exists.
   • Click the "+" button then add /Applications/OpenSplit. You'll need to do this every new version.
   • Go to Settings > Privacy and Security > Input Monitoring and remove OpenSplit with the "-" button at the bottom if it exists.
   • Click the "+" button then add /Applications/OpenSplit. You'll need to do this every new version.
3. Click "Create Split File" to get started.

Create your first splitfile

• Create a new split file (Game + Category).
• Add segments, press Split hotkey (default: Space) to start a run.
• Press your Split hotkey (default: Space) at each segment end.

---

Features (current & roadmap)

• Timer: HH:MM:SS.cc display with centiseconds; formatting adapts to hours/minutes.
• Skins: theme tokens + component styles + images; per-skin folder with live switching.
• Split editor: add/rename/remove; total attempts.
• Hotkeys: Cross-platform global hotkeys for Windows, Mac, and X11 Linux distros. Wayland coming soon.
• Data: simple JSON split files (.osf) for portability.
• Integrations: Speedrun.com lookup for game/category art.

---

Development

Contributing – Development

Contributing

There's many ways to help with the project, How to contribute

Architecture

OpenSplit uses Wails to bundle a Go backend and a React/TypeScript frontend.