Русский

Turns raw F1 22 and Assetto Corsa Competizione lap telemetry into compact Markdown reports you can paste into an LLM for analysis. A full raw lap is ~1M tokens; these reports are 1–35k.

# from the tool/ folder
python -m telemetry technique "races/Zandvoort/Practice/zandvoort_P1_L7_74.074_ferrari.csv"
# -> races/Zandvoort/Practice/reports/zandvoort_P1_L7_74.074_ferrari_technique.md (~35k tokens)

Or just double-click run-gui.bat and click Generate report.

• Python 3.10+ (uses only the standard library — no pip install).
• Tk is required for the GUI; it ships with the standard Python installer on Windows/macOS. The CLI works without it.

Download or clone the repository. Keep your telemetry CSVs in the parent folder of tool/ (see folder layout).

Six modes. Five produce reports, one renames files. Both F1 22 and ACC (GT3/GT4) CSVs are supported — the game is detected automatically from each file's metadata.

Reports include a legend explaining every column and have the analysis prompt auto-appended at the end — just drop the file into an LLM. Prompts come in RU and EN; pick with --lang en on the CLI or the language radio in the GUI.

Flags: --no-prompt omits the embedded analysis prompt (smaller files for agent pipelines; in the GUI it's the Include prompt checkbox). --force regenerates even when an up-to-date report already exists (runs are otherwise skipped as cached). --game {auto,f1,acc} overrides the auto-detected game (default auto).

Typical optimized flow: run profile first to see chronic tendencies and which laps matter, then generate technique/setup/compare only for those laps with --no-prompt.

GT3/GT4 cars have no hybrid system, and ACC does not export the car setup:

• technique and race reports omit the DRS / ERS / MGU-K sections.
• setup mode: ACC's in-game setup export is all zeros, so the parameter table is replaced by a note ("ACC does not export setup — analysis derived from telemetry"); the telemetry-derived sections (corner balance, tyres, brakes, suspension) are retained.
• Fuel is in litres (GT) rather than kg (F1). Tyres are Pirelli dry/wet compounds, not F1 C1–C5.

Telemetry/
 races/
 F1 22/
 Zandvoort/
 Practice/ <- CSVs go here after renaming
 zandvoort_P1_L7_74.074_ferrari.csv
 reports/ <- technique/setup/compare reports land here
 Qualifying/
 zandvoort_Q1_L3_74.897_ferrari.csv
 reports/
 Race/
 zandvoort_R_L7_74.152_ferrari.csv
 reports/
 Race_race.md <- race mode report
 ACC/
 Hungaroring/
 Practice/
 hungaroring_P_L1_123.702_ktm_gt4.csv
 reports/
 tool/ <- this repository
 telemetry/
 prompts/
 run-gui.bat

GUI — double-click run-gui.bat (or run-gui.pyw for no console window, or run python -m telemetry gui). The window has two tabs — F1 22 and ACC — each with its own independent controls and log. Pick a mode and language (RU/EN), browse to the file/folder, click Generate. The file browser remembers the last used directory per mode. The Rename unprocessed button adds the session type and lap number to files that don't have them yet and leaves the rest alone. If a file's detected game doesn't match the active tab, the GUI logs a warning but proceeds.

CLI — from the tool/ folder:

python -m telemetry technique races/Zandvoort/Practice/lap.csv
python -m telemetry setup races/Zandvoort/Practice/lap.csv
python -m telemetry compare races/Zandvoort/Practice/lap_a.csv races/Zandvoort/Practice/lap_b.csv
python -m telemetry race races/Zandvoort/Race
python -m telemetry profile races/Zandvoort/Race # cheap cross-lap tendencies + lap picks
python -m telemetry rename races/Zandvoort/Practice # or individual files
# choose prompt language (default: ru)
python -m telemetry technique races/Zandvoort/Practice/lap.csv --lang en
# override game detection (default: auto)
python -m telemetry technique ACC/races/Hungaroring/Practice/lap.csv --game acc
# agent pipeline: drop the prompt, reuse fresh reports
python -m telemetry technique races/Zandvoort/Practice/lap.csv --no-prompt
python -m telemetry technique races/Zandvoort/Practice/lap.csv --force # ignore cache

Every report run prints the output path and a token estimate:

C:\...\Telemetry\reports\lap_technique.md
~33834 tokens (budget 60k)

Rename inserts tokens AND sorts into folders. Point it at a folder containing CSVs (e.g., D:\Games\Telemetry\Data\lapdata\f1_2022) — the script:

• Recursively scans all subdirectories
• Reads metadata from each CSV (track, session type)
• Inserts P1_L7 into filenames that don't have both tokens yet
• Moves files to races/<track>/Practice|Qualifying|Race/
• Even already-renamed files are moved if they're not in the right folder
• Only skips files that are already in the correct location with the correct name

Re-running on the same folder is safe — in-place files are left alone.

F1 22 UDP telemetry or ACC telemetry, both exported to CSV (F1 22 tested with F1Laps). UTF-8, 108 channels, one file = one lap (F1 22 is ≈1800 rows/lap at ≈29 Hz; ACC laps are denser, ~14k rows — reports stay compact via adaptive resampling). For race mode, drop all of a race's lap files into one folder. The CSV format is identical between F1 22 and ACC; the game is detected from the Game metadata field in each file.

Pure-stdlib Python. Pipeline: parser → segments (+ corner_metrics) → resample → report_*. See ARCHITECTURE.md.

cd tool
python -m pytest -q # run the test suite
python -m telemetry gui # launch the GUI

Adding a mode: drop a telemetry/report_<mode>.py exposing generate(...) -> (abs_path, tokens) and wire one line into telemetry/__main__.py. The parser, corner detection, adaptive trace, and shared report blocks are reused.

Built for analysing personal F1 22 and ACC hotlaps. Telemetry export format from F1Laps. In-game telemetry captured with Telemetry Tool by Iasione.

MIT — see LICENSE.