Marco v1.0 — F1 25 Race Engineer
Double-click Marco.exe to run. No Python, no Node, no install needed.
What is Marco?
Marco is a live lap engineer for F1 25 Time Trial. It listens to UDP telemetry from the game, builds a fastest-lap reference, and gives you real-time voice coaching — plus a live dashboard you
can open on your phone by scanning a QR code.
Features
Live voice coaching
- Brake zone warnings and "brake now" calls
- Gear and throttle prompts
- Sector time callouts — purple / green / yellow
- Corner-by-corner feedback
Live telemetry dashboard (phone or browser)
- Track map with car position dot
- Delta display and sector bars
- Lap time list with PB / OK / INV tags
- Heatmap overlay — green where you're faster, red where you're losing time
- Compare current lap vs PB, or last lap vs PB
Analytics cards (update every lap automatically)
- Top Time Losses — corners costing you the most time
- Consistency — lap σ, sector σ, most/least consistent corner
- Skill Scores — 0–100 bars for Braking, Throttle, Exit, Consistency, Line
- Corner Mastery — per-corner score and trend
- Driver Profile — heuristic tags (Aggressive Braker, Smooth Throttle, etc.)
- Optimal Lap — theoretical best from sectors and bins
Analyze Past Sessions
- Dedicated analysis screen for every saved session
- Track heatmap from your PB lap — toggle between Speed and Inputs view
- Full performance report with all analytics
- Lap-by-lap time table
Post-session report
- JSON + Markdown report saved automatically
- Spoken engineer-style debrief at session end
- Toast notifications showing exactly where files were saved
How to install
- Download Marco.zip from the assets below
- Extract the
Marco/folder anywhere on your PC - Double-click Marco.exe
- Scan the QR code with your phone — or open the printed URL in any browser on the same Wi-Fi
Keep the
_internal/folder next toMarco.exe— the exe needs it to run.
F1 25 telemetry settings
In-game → Settings → Telemetry:
| Setting | Value |
|---|---|
| UDP Telemetry | On |
| UDP Broadcast Mode | On |
| UDP Port | 20777 |
| UDP Format | 2025 |
| UDP Send Rate | 60 Hz |
| Telemetry | Public |
Session files (Coaching + Logging mode only)
Saved to session_data/session_###_YYYYMMDD_HHMMSS/ next to the exe:
| File | Contents |
|---|---|
telemetry.csv |
Raw frame-by-frame telemetry |
reference_lap.csv |
Your fastest lap |
performance_report.json |
Full structured analytics |
performance_report.md |
Human-readable summary |
Report quality improves with more clean laps — 8–10 laps gives the strongest data.
Troubleshooting
No voice — check your system audio output is set correctly.
Phone can't connect — make sure phone and PC are on the same Wi-Fi. Allow port 5000 through Windows Firewall.
No telemetry data — re-check the in-game UDP settings above. Allow port 20777 through Windows Firewall.