TCX

Generated by scripts/gen-format-pages.py from docs/data/format-metadata/, FILE_FORMATS.csv and docs/formats-master.csv. Do not edit by hand: change the source, then run the script.

Garmin TCX Preview.

At a glance


Purpose	A Garmin Training Center XML file: activities with laps and track points (position, time, heart rate, distance).
Extensions	`.tcx`
Poka parser	`poka-tcx`
Viewer	`poka-vector-viewer`
Depth tier	Parser with a shared viewer (see Depth tiers)
Breadth tier	B3 Core (see Breadth tiers)

How much Poka reads

B3 Core. Only the main content type or types are decoded (for example geometry but not materials, layers or annotations, or only one version family). The list of gaps is substantial.

Confidence: medium (the reviewer read the code). Basis: Reviewed 2026-10-26: read parsers/poka-tcx/src/main.rs (288 lines) and plugin.json. No unit tests or tests/samples.rs; the corpus has sample.tcx, read by no test. Covers .tcx. The track points with a position are collected into one polyline per track and drawn on the 2D map; the activity's sport, distance and duration ride along in the summary line. Judgement: B3: the GPS track is drawn, but the training data is not.

What Poka does not read

Laps, heart rate, cadence, speed and altitude are not shown
Activities without GPS (indoor) are refused
Courses and workouts are not read (judgement from the code)
Only the first 50,000 points are used

Libraries

Libraries Poka uses or has assessed for this format, with the status, licence and language the registry records.

roxmltree (used; MIT OR Apache-2.0; Rust)
tcx (rust_tcx) (candidate; MIT; Rust; https://github.com/msimms/rust_tcx) — serde-based parser; does not implement the whole schema; last crate release seen was 2021.
python-tcxparser (candidate; BSD-2-Clause; Python; https://github.com/vkurup/python-tcxparser) — Minimal, self-described as not exhaustive; exposes summary fields such as distance, duration and heart rate.

Sources

parsers/poka-tcx/src/main.rs
parsers/poka-tcx/plugin.json