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.

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 each app will see. For this file as it is, and after a PitStopper export, so you can tell why a colour, icon or turn cue goes missing in one app and not another.
  • 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 with colours, icons, turn-by-turn and names in the form each app reads.
  • 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 which app reads it, 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 each app reads its own form: Locus Map and OsmAnd read gpx_style, Cruiser and some others read xsi:gpx, and Garmin reads one of 16 colour names. A file that only carries one form shows no colour elsewhere. The inspector shows which form your file has and what each app will see, 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 and KML carries them as styles and folders.

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.

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.

Export GPX

GPX suits most apps and devices. FIT suits Garmin. KML suits Google Earth.
KML embeds your POI category colours and group folders natively - open it in Google Earth, Google My Maps, Organic Maps or OsmAnd.
Navigation cues are GPX extensions - read by Cruiser, Locus Map and a few other apps.
A zipped GPX, usually about a seventh of the size. Cruiser, Locus Map and GPX Viewer open it directly.
Your own icons travel only in a .gpz - tick Compress it.
Packs our POI icons into the archive, so Locus Map and GPX Viewer draw them instead of their own. Other apps, and any Garmin device, ignore them and are unaffected.
The set drawn for your maps sits beside the route, where apps look for it. The other rides along in a folder of its own, ready to swap in.
Importing into Garmin Connect? On routes over 200 miles, Garmin Connect imports the course points at 0 km from the start. Export as FIT instead - PitStopper's FIT course points import at the correct positions.
No flagged POIs - all POIs will be exported
For a place the route passes more than once, such as on an out-and-back: one waypoint per pass, each with its own side and time, as in the FIT export. Off, it is one waypoint for the place.
0 POIs will be exported
Advanced options
See the file these settings would export
Off by default - a timed track looks like a ride you have already done, so sites such as Strava may import it as a completed activity.
Uncheck for short names suited to bike computers
Adds side + distance from the track (e.g. L20 = 20 m to the left). Prefix survives name truncation on some devices.
When you reach each point, to the nearest 5 minutes, from the route's start time. A place you pass twice shows both times.
Keeps the source app's creator tag (e.g. Strava) instead of PitStopper. Garmin trusts some sources and re-smooths data it thinks came from elsewhere, which can subtly change your route - leave this on to avoid that.
Colour is the waypoint colour OsmAnd, Organic Maps and Cruiser read (it takes the place of the category colour on these stops); Garmin has no waypoint colour and draws each stop by its icon. Shape is the marker OsmAnd draws behind each icon, so starred and flagged stand out there even when every marker shares a colour.
Extra colour hints for other map apps (Garmin, Locus Map, Cruiser, GPX Viewer, OsmAnd, Organic Maps). Not part of the GPX standard - apps that don't read them, such as Strava and Komoot, ignore them, so the file stays valid everywhere.
Writes each POI's map colour (including your custom colours) into the waypoint. Read by Cruiser, OsmAnd and Organic Maps.
Writes each route's colour and line width into its track, for Cruiser, Locus Map, gpx.studio and GPX Viewer, and Garmin's nearest of its 16 colours. Replaces a colour the file already had.
Sets the FIT course sport so your device picks the right data screens and climb features.
Adds your distance markers (e.g. every 10 km) to the FIT course so they show on your device for pacing.

Waypoints far from your track

Some waypoints may be lost
Flags that the waypoint was moved from its real location