Skip to content

Marco v1.0

Latest

Choose a tag to compare

@sripadsirik sripadsirik released this 21 Feb 05:33
· 3 commits to main since this release
a52f61b

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

  1. Download Marco.zip from the assets below
  2. Extract the Marco/ folder anywhere on your PC
  3. Double-click Marco.exe
  4. 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 to Marco.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.