https://github.com/stashpeak/simlauncher
SimLauncher is an open-source launcher for sim racing titles like Assetto Corsa, iRacing, and tools like Sim Hub, Crew Chief, Trading Paints and Garage 61
https://github.com/stashpeak/simlauncher
gaming-tools iracing launcher open-source racing sim-racing simracing windows
Last synced: 2 days ago
JSON representation
SimLauncher is an open-source launcher for sim racing titles like Assetto Corsa, iRacing, and tools like Sim Hub, Crew Chief, Trading Paints and Garage 61
- Host: GitHub
- URL: https://github.com/stashpeak/simlauncher
- Owner: Stashpeak
- License: gpl-3.0
- Created: 2025-10-12T13:23:58.000Z (8 months ago)
- Default Branch: main
- Last Pushed: 2026-06-10T09:16:37.000Z (2 days ago)
- Last Synced: 2026-06-10T09:23:06.934Z (2 days ago)
- Topics: gaming-tools, iracing, launcher, open-source, racing, sim-racing, simracing, windows
- Language: TypeScript
- Homepage: https://simlauncher.com/
- Size: 4.11 MB
- Stars: 9
- Watchers: 1
- Forks: 0
- Open Issues: 31
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Security: SECURITY.md
Awesome Lists containing this project
README
# SimLauncher
[](../../releases)
[](../../releases)
[](../../actions/workflows/ci.yml)
[](LICENSE)
One-click startup for your entire sim racing setup.
Launch iRacing, Assetto Corsa, ACC and other sims on Windows, together with SimHub, Crew Chief, Trading Paints, overlays, telemetry tools and wheelbase software — automatically.
---
## Who is this for?
SimLauncher is built for people who run non-trivial sim setups and are tired of manual prep every time they want to drive.
You'll likely benefit from this if you:
- Run multiple sims (iRacing, AC, ACC, AMS2, etc.)
- Switch between different setups (VR vs triples, motion on/off, etc.)
- Use multiple companion apps (SimHub, CrewChief, overlays, telemetry, wheelbase software...)
- Care about launch order, delays, and reliability
- Want a single click to go from desktop to fully ready rig
**This app is probably unnecessary for you if:**
- You run one sim and one or two apps
- You're fine with everything starting with Windows
- You don't need different setups (e.g. always same screens, same config)
- You don't care about launch order or coordination between apps
In that case, your current setup is already simple enough.
---
## Features
- One-click launch of a sim game plus selected utilities
- Per-game profiles with drag-to-reorder launch order
- Integrated auto-updates to stay current with the latest features
- Optional auto-launch of the game itself
- 1–20 configurable custom app slots with editable names
- Configurable launch delay between apps (1s / 1.5s / 2s presets, or custom up to 30s)
- Automotive-themed accent color presets and a custom color picker
- Light, dark, and system theme modes
- Kill and relaunch controls for running companion apps
- Config export and import
- Start with Windows, start minimized, and minimize to tray options
- Toast notifications for launch status and errors
## Planned Features
- **Optional auto-close**: Automatically terminate companion apps and utilities when the sim game session ends.
- **Smart path detection**: Automatic detection of installed sims and common utility app installation paths.
- **Themed color collections**: Expanded accent presets and curated color palettes for deeper UI personalization.
- **Enhanced session management**: Session-state-aware app launching and advanced restart triggers.
- **Global profile actions**: Explicit "Close Full Profile" and "Close Game" actions for better control.
## Supported Games
Assetto Corsa, Assetto Corsa Competizione, Assetto Corsa Evo, Assetto Corsa Rally, Automobilista, Automobilista 2, BeamNG, DCS World, Dirt Rally, Dirt Rally 2.0, EA WRC, F1 24, F1 25, iRacing, Le Mans Ultimate, Project Motor Racing, RaceRoom Racing Experience, Richard Burns Rally, Rennsport, rFactor, rFactor 2
## Supported Utilities
SimHub, Crew Chief, Trading Paints, Garage 61, Second Monitor, plus up to 20 user-added custom app slots
---
## Installation
1. Download the latest installer from [Releases](../../releases).
2. Run the installer and follow the setup wizard.
3. Open SimLauncher, go to Settings, set paths to your games and utilities, then save.
4. On the Launcher screen, click the settings icon next to a game to choose which utilities launch with it.
5. Click Launch to start everything at once.
---
## Troubleshooting
### "Windows protected your PC" (SmartScreen)
The installer isn't code-signed yet, so SmartScreen may warn on first launch. Click **More info → Run anyway**.
### A game won't launch
- Check that the executable path in Settings points to the correct `.exe`.
- If the game is already running, SimLauncher intentionally skips re-launching it (reported as "skipped — already running"), so this is expected rather than a failure. Close it first if you want a fresh launch.
- If the game needs elevated permissions, try running SimLauncher as Administrator.
### A utility isn't detected as running
- Some utilities (e.g. SimHub) take longer to start — increase the launch delay in Settings.
- Process detection matches by the executable's file name (not the full path), so a renamed copy you've configured _is_ detected. Detection can fail when the app launches a differently-named child or wrapper process — add that process name under "Secondary executables to watch" in the profile editor — or when two different files share the same `.exe` name.
### Auto-updater isn't working
- Make sure your firewall/proxy allows `github.com` and `objects.githubusercontent.com`.
- If an update hangs, restart SimLauncher — it retries on the next launch.
---
## Building from source
SimLauncher is a standard Electron + electron-vite project. You need [Node.js](https://nodejs.org/) 24 or newer and npm.
```bash
git clone https://github.com/Stashpeak/SimLauncher.git
cd SimLauncher
npm install
npm run dev # run in development
npm run dist:win # build a Windows installer into dist/
```
Other useful scripts: `npm test` (unit tests), `npm run lint`, and `npm run typecheck`.
---
## Trust & transparency
- **The source is public** and licensed under **GPL-3.0** — you can read every line, the full commit history, issues, pull requests, and CI runs before trusting a binary.
- **You can build it yourself** from source (see above) instead of running the published installer.
- **Releases are built in CI** from tagged commits, and each release's notes link the issues and PRs behind every change.
- **Development is AI-assisted** (Claude Code) with human review on every change, disclosed openly in the commit history.
- **Security issues** should be reported privately — see [Security](#security).
---
## Security
Please **don't** open a public issue for security vulnerabilities. Report them privately via [GitHub Security Advisories](../../security/advisories/new). More detail is in [SECURITY.md](SECURITY.md).
---
## Support
If SimLauncher saves you time on race day, a small tip is appreciated: [paypal.me/shieldxx](https://paypal.me/shieldxx)
---
## License
GNU GPL v3. See [LICENSE](LICENSE).