GPX inspector and converter Work in progress
Load a GPX, GPZ, FIT or KML file. See what is in it, including every extension beyond plain GPX and which apps use each one, then write it back out with PitStopper's own export options for the app or device you need. Everything happens in your browser and the file never leaves your device.
Summary
Track preview
Elevation profile
In and out: what an export writes
File viewer
Click a triangle to fold an element. Pills name the app family an extension belongs to (from the same table as the sections below), flag Unknown ones, and mark standard parts PitStopper not kept yet.
Unknown to PitStopper
Diagnostic report
This is exactly what Copy diagnostic report copies. It has the file's structure only: counts, namespaces, element paths and short sample values. No coordinates, no names, no times. Nothing is sent anywhere; you decide whether to paste it into a message.
Export
Write the file out again with PitStopper's export options: GPX (and .gpz with icons), FIT or KML (and .kmz with icons), with the colours, icons, turn cues and names each app or device reads.
What this page does
- Shows what is in your file. A summary (creator, tracks, routes, waypoints, points, elevation, times, recorded or planned), a track preview drawn from the file's own colours, icons and turns, an elevation profile, and a colour-coded XML view you can fold.
- Names every extension. Each element beyond standard GPX 1.1 is listed with the app it comes from (Garmin, Locus Map, OsmAnd, Cruiser, gpx.studio, GPX Viewer and others) and what PitStopper does with it.
- Shows what goes in and what comes out. Each part of the file beside what a PitStopper export writes for it: kept as it came, written in more forms (a colour read in one form goes out in three), or added.
- Diagnoses the unknown. Standard parts PitStopper does not keep yet are marked, and anything it does not recognise goes into a diagnostic report with structure only that you can send us.
- Converts. Write the file out as GPX (or .gpz with icons), FIT or KML (or .kmz with icons) with colours, icons, turn-by-turn and names in every common form. FIT gets turn prompts, starred stops as favourites and the bike or run type; KML gets each stop's details as data and, if you like, a Google Earth flyover.
- Flags animated icons. Animated PNG, SVG and GIF icons in a .gpz or .kmz are marked, play in the preview, and say what PitStopper does with each.
- Stays on your device. Reading and converting happen in your browser and the file is never uploaded.
Works with .gpx, .gpz, .fit, .kml and .kmz files up to 10 MB. For what each element means and where it lives, see the GPX file reference, or read Any in, all out on how PitStopper reads and writes every app's form.
Questions about GPX files
What is in a GPX file?
A GPX file is XML. Standard GPX 1.1 holds waypoints (stops), routes and tracks, each made of points with a position and optionally an elevation and time, plus a name, description, symbol and type. Anything else, such as line colour, turn-by-turn cues or heart rate, sits in extensions that each app defines for itself. The inspector lists all of them.
Why do my track colours disappear in another app?
GPX has no colour in the standard, so apps use extensions for it: gpx_style, xsi:gpx and Garmin's 16 colour names are the common forms, and each app reads one or more of them. A file that carries only one form can show no colour in an app that reads another. The inspector shows which forms your file has, and PitStopper's export writes all three.
Can I convert GPX to FIT or KML?
Yes. Load the file, press Export options and choose GPX (or .gpz with icons), FIT or KML. The same options as the PitStopper app apply: colours, icons, turn-by-turn cues and names in the form each app or device reads. FIT carries stops and turns as course points (turns as the left, right and fork types devices prompt, starred stops as favourites); KML carries stops as styled placemarks in folders with their details as data, and a .kmz adds their icons.
What is a GPZ file?
A .gpz is a zipped GPX file that can also hold the icon pictures its stops use. Locus Map, Cruiser and GPX Viewer open it. The inspector reads the GPX inside and the icons it carries, and can write a .gpz with PitStopper's icons.
What does it read from a FIT or KML file?
From a FIT: the track with its times and sensor data, its stops, its turn course points (read as turn cues, not stops), favourites (read as starred) and the activity. From a KML or .kmz: each route with its colour, width, corridor (gx:physicalWidth) and, for a gx:Track, its times; each stop with its PitStopper data and, in a .kmz, its own icon and anchor. A GPX route keeps its corridor too, in the xsi:gpx physicalWidth element (see the GPX file reference).
Is my file uploaded?
No. The file is read and converted in your browser and never leaves your device. The page's security policy only allows requests to this site, and the diagnostic report is text you copy yourself and choose whether to send.
Which apps' extensions does it understand?
Garmin devices and Connect, Locus Map, OsmAnd, Cruiser, gpx.studio, GPX Viewer and PitStopper's own. Anything it does not recognise is listed as unknown with a diagnostic report, structure only, with no coordinates, names or times, that you can send us.