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 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.

Export route

Works almost everywhere. Colours and turn cues go in every form apps read.
POIs and turns become course points on the device.
For the course points in order and your planned times, copy the .fit into your Garmin's Garmin/NewFiles folder over USB: Garmin Connect re-places them and drops the times. Why?
Roads ridden twice
KML embeds your POI category colours and group folders natively - open it in Google Earth, Google My Maps, Organic Maps or OsmAnd.
Zips the KML with each POI's own icon, as a .gpz carries them. Google Earth, Google My Maps and Locus Map open a .kmz.
A tour that flies along the route in Google Earth: double-click it in the Places list to play. Other apps ignore it.
Navigation cues are GPX extensions - read by Cruiser, Locus Map and a few other apps.
Your own icons travel only in a .gpz: pick GPX + icons & photos.
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.
See the file these settings would export
0 POIs will be exported
Advanced options

Which POIs

No flagged POIs - all POIs will be exported

Names

On the device:

Times

Ticked when the route has a start time. A file with times looks like a ride you have already done, so Strava, Ride with GPS and Komoot may import it as a completed activity: untick it for those, and it stays unticked next time. Locus Map and Garmin's Virtual Partner use the times.

Course points

Routes

Icons in the .gpz

A zipped GPX, usually about a seventh of the size. Cruiser, Locus Map and GPX Viewer open it directly.

Colours

Filename

Source file

Course Points
    Course End
    On the device How the POIs in this file will look in the course points list on a Garmin Edge, in order along the route. Scroll the screen to see them all.

    Waypoints far from your track

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