About Features Files Privacy ← Home Set It Up → Support
File Manifest

What's Inside
Each Download.

Full contents of every TRACE distribution — Windows, Linux, macOS, and Python source.

Python Source — gt7telem-source.zip

Runs on Windows, macOS, or Linux with Python 3.10+. pip3 install -r requirements.txt then python3 launcher.py.
FilePurpose
launcher.pyThe file you actually run — python launcher.py. A thin top-level wrapper (sits next to gt7telem/) so nothing needs installing or `cd`-ing into a subfolder first.
gt7telem/__init__.pyPackage entry point — re-exports the public telemetry/settings API (import gt7telem)
gt7telem/launcher.pyUnified entry point — opens the TRACE menu (Dashboard / Lap Analyst / Race Analyst); the top-level launcher.py above just calls into this
dashboard.pyLive telemetry dashboard app
udp.pyUDP telemetry capture, decrypt, and parsing
lap_analyst.pyLap analysis app — charts, A/B compare, replay, plus the leaderboard/ghost-download/consensus-line panel
race_analyst.pyRace analysis app
cars.pyCar ID to name lookup
tracks.pyTrack/course ID to name lookup
add_track.pyCLI tool to add a missing track to course_ids.csv
add_car.pyCLI tool to add a missing car to car_ids.csv
config.pySettings persistence (console IP, laps folder, sample rate, PSN name, analytics opt-out)
analytics.pySends the anonymous usage-analytics ping (tool/version/OS) to Supabase on launch — see Privacy
leaderboard.pyGlobal lap leaderboard, ghost-lap download, and consensus racing-line client — talks to the same Supabase project as analytics.py
auth.pySupabase auth client — sign-up/sign-in and session handling used by leaderboard.py and analytics.py
metrics_server.pyOptional Prometheus metrics export (off by default) — speed/rpm/throttle/brake/fuel/lap-time gauges for Grafana or any Prometheus-compatible scraper
car_ids.csvCar ID database — refreshed every time 10 or more new cars have been added since the last update
course_ids.csvTrack ID database
py.typedPEP 561 marker so IDEs get proper autocomplete for import gt7telem
requirements.txtPython dependencies
README.txtSetup instructions
21 files

Windows — gt7telem-windows.zip

Standalone build. No Python install needed.
Contains a single self-contained executable: TRACE.exe. Everything from the source distribution above is bundled inside it.
1 file

Linux — gt7telem-linux.zip

Standalone build. No Python install needed.
Contains a single self-contained binary: TRACE. Everything from the source distribution above is bundled inside it.
1 file

macOS — gt7telem-macos.zip

Standalone build. No Python install needed. Apple Silicon; use the Python source on an older Intel Mac.
Contains a single self-contained app bundle: TRACE.app. Built automatically on a GitHub-hosted Apple Silicon runner every release — see build-macos.yml.
1 file