ForzaTelemetryV3 Launcher

A tiny cross-platform (Linux/Windows) GUI launcher for ForzaTelemetryV3 built with egui.

What it does

1. On start, shows Updating.. while it clones (first run) or git pulls the tool repo.
2. Lets you pick a branch and Release / Debug run mode on one page.
3. On Launch: checks out the branch, runs cargo build (shows Building..), then spawns cargo run detached and quits the launcher.

Your last branch + run mode are remembered. If the saved branch no longer exists, it falls back to master, then main, then the first available branch.

Quick start

Grab the binary for your OS from the releases page after installing the prerequisites below.

Windows

1. Install the prerequisites with winget, then restart the terminal so cargo and git are on PATH:

   winget install Rustlang.Rustup
   winget install Git.Git

2. Download and run ForzaTelemetryV3Launcher-windows.exe.

Linux

1. Install rust/cargo and git via your package manager, e.g.:

   sudo pacman -S rust git        # Arch
   sudo apt install cargo git     # Debian/Ubuntu

2. Download ForzaTelemetryV3Launcher-linux, then chmod +x it and run it.

Paths

Everything lives in the OS data dir (~/.local/share/ForzaTelemetryV3Launcher on Linux, %APPDATA%\ForzaTelemetryV3Launcher on Windows):

• repo/ — the cloned ForzaTelemetryV3 working copy
• config.txt — last branch + run mode
• run.log — build & run output

Requirements

git and cargo must be on PATH.

Build from source

cargo run                                    # debug
cargo build --release                        # native release
cargo build --release --target x86_64-pc-windows-gnu   # cross-compile to Windows