Track Manager
Import GPX routes and trails, organise them into groups, and visualise them on the map with custom colours, thickness, and line styles.
What Is the Track Manager?
The Track Manager lets you import pre-recorded routes in GPX format (the standard GPS exchange format used by hiking apps, navigation devices, and sports computers). Once imported, tracks are overlaid on the map as coloured lines.
Open the Track Manager from the navigation drawer → Tracks.
Track Groups
Tracks are organised into named groups. Each group can be expanded or collapsed to show or hide its track list. This keeps things tidy when you have many routes.
- Tap the group header to expand / collapse it
- Long-press a group to rename it
- Tap the delete icon on a group to remove it and all its tracks
Importing a GPX File
- In the Track Manager, tap Import GPX.
- A dialog asks which group to import into — select an existing group or create a new one.
- The Android file picker opens. Browse to your GPX file and select it.
- The app imports each track segment as a separate track. Multi-segment files are named
TrackName_1,TrackName_2, etc. - Each imported track is assigned a random colour from the app's colour palette.
Automatic Point Filtering
To keep the map performant, imported tracks are filtered in two stages before being stored:
- 50 m distance filter: Consecutive points closer than 50 m are removed. Applied to every track regardless of size.
- Bearing cleanup: On large tracks (1 000+ points after the first filter), points that do not contribute to direction changes are removed. Start, end, and turning points are always preserved.
Track Metadata
After import, each track displays:
- Number of GPS points kept
- Total distance in metres or kilometres
- Duration (start to end) — if the GPX file contains timestamps
- Source filename and import date
Managing Tracks
Each track row shows a colour swatch, name, point count, distance, and duration. You can:
- ☑️ Show / hide the track on the map using the visibility checkbox
- 🗺️ Jump to track — tap the track info area to navigate the map to fit the track's bounding box
- ✏️ Edit — open the track edit dialog to change name, colour, opacity, thickness, and line style
- 🗑️ Delete — remove the track and all its points after confirmation
Customising Track Appearance
Tap the edit button on any track to open the style editor:
| Setting | Options |
|---|---|
| Name | Free text |
| Color | 21 named colours from the app palette |
| Opacity | 25% / 50% / 75% / 100% |
| Thickness | 2–10 dp (slider, default 5 dp) |
| Line Style | Solid / Dashed / Dotted |
Tracks on the Map
Visible tracks are drawn as coloured polylines with individual point markers. Point markers show the track name as a tooltip; if the GPX has timestamps, the elapsed time from midnight is shown as a snippet.
Tracks are rendered when you return to the map, toggle trail visibility on, or change a visibility checkbox. A brief loading spinner appears during rendering for large tracks.