Watch folder
Place files in the mounted ./data/gpx/ directory. The server watches the folder and indexes new files.
Supported GPS formats
Keep different track files in one archive.
MTL Explorer accepts nine common GPS and activity formats. GPX is read directly; the other formats are converted to GPX in memory before the normal track parser processes them.
File format reference.
Support means that MTL Explorer recognizes the extension and can pass a valid track file through the documented import path.
| Format | Extension | Processing | Common source |
|---|---|---|---|
| GPX | .gpx | Read directly | GPS devices, route planners, and activity exports |
| FIT | .fit | Converted with GPSBabel | Garmin and other fitness devices |
| TCX | .tcx | Converted with GPSBabel | Training Center activity exports |
| KML | .kml | Converted with GPSBabel | Google Earth and mapping tools |
| KMZ | .kmz | Extracted and converted with GPSBabel | Compressed Google Earth files |
| IGC | .igc | Converted with GPSBabel | Gliding and flight loggers |
| NMEA | .nmea | Converted with GPSBabel | Recorded NMEA 0183 GPS sentences |
| GeoJSON | .geojson | Converted with GPSBabel | GIS and web mapping tools |
| GDB | .gdb | Converted with GPSBabel | Garmin MapSource databases |
The extension is only the first check.
A file must contain usable track geometry and valid data for its format. Invalid, empty, or unsupported variants can be reported as failed imports.
Use the import method that fits the host.
All accepted files enter the same background processing flow.
Admin upload
Upload supported track files from the protected Admin workspace when direct access to the host folder is inconvenient.
Garmin sync
Optional Garmin Connect export can download new activities into the import directory before indexing.
Manual rescan
Queue a GPS rescan from Admin if a mounted filesystem does not deliver a file-change event.
After import
Review one normalized archive.
The source file remains in the import directory. MTL Explorer reads GPX directly or converts another accepted format to GPX in memory for parsing.
- Detect duplicate and failed imports.
- Classify activity types while preserving user changes.
- Build precise and simplified track geometry.
- Expose the original source download and GPX export from Track Details.
