Repository navigation
Releases: mindalyze-com/mtl-explorer
Release list
MTL Explorer v.0.9.0
MTL Explorer Release v.0.9.0
Improved segment comparison and replay, route planning with saved places, and optional health data.
Changes since v.0.8.1,
ordered by user impact.
Important before updating
An in-place upgrade should work. For this release, we recommend a
fresh PostgreSQL database to rebuild derived data consistently.
Back up before resetting: a reset deletes saved plans and manual edits.
Preserve anything you need, then
start with a fresh database.
Keep original GPS and media files and other data folders.
See Updating for the installation guide.
Calories and energy estimates
- Active and total calories: Track Overview shows activity-specific estimates
separately from external or vehicle work, with model assumptions and limits. - Body-weight adjustment: Preview and save a weight for each track. It
survives reimport and recalculation without changing your default. - Coverage explanations: Partial estimates explain excluded time. Missing or
unsupported data remains unavailable rather than zero. - Reliable recalculation: Activity changes refresh estimates and charts;
failures retry. - Calculation corrections: Moving power uses consistent moving-time intervals.
Cycling and water-sport estimates exclude unsupported work, including altitude
changes for water sports.
See calorie estimates.
Segment comparison and replay
- Discovery and selection: Explore trends, individual visits, and the optional
segment matrix. Select exact attempts, including repeated visits from one track;
selections survive full-track inspection. - More reliable visits: Movements around a zone's edge stay one visit. Results
include only tracks that visit every placed zone. - More reliable timing: Times are more precise and include stops; gaps
and unclear crossings are marked. Incomplete attempts stay out of performance
averages, and replay requires reliable timing and complete distance. - Aligned charts: Compare speed, elevation, power, energy, slope, time, and
available heart rate between the same checkpoints. Chart size and detail
settings are remembered. - Reference attempt: A diamond marked R identifies the reference.
Finish comparisons show how much faster or slower each attempt was; the opening
chart compares time at equal traveled distance, including stops. - Shared inspection and position map: Move along a chart with the mouse,
touch, or keyboard to see the matching spot on the map for every attempt. - Ghost positions: See where other attempts were when the reference reached
a distance, with ahead/behind values, route trails, and an optional lead chart. - Replay here: Start replay at the inspected position with the same attempts,
colors, and reference. Marker numbers match rankings; hover reveals progress. - Targeted retries: If loading fails, retry only the part that failed.
Refresh results after a track changes.
See segment analysis.
GPS reliability and review
- Review: Inspect import failures and GPS problems, compare original
and processed paths, center the map on each finding, and see what was cleaned
up during import. Highlighted points link to explanations. - Map and statistics choices: Include or exclude whole sources or individual
sections from the map, statistics, or both. The findings stay visible. - External correction: Download the original or a GPX version, fix it in
another tool, and put it back in the GPS folder to import and check it again. - Improved processing: Smoothing handles variable sampling and missing
measurements; altitude spikes no longer affect later points. Recording gaps
stay disconnected on maps and in calculations. - Clearer motion and events: Separate moving, stopped, and unknown time.
Short pauses count toward stopped time; visible breaks start at one minute.
Select breaks or GPS gaps to locate them on the activity map. - Import fixes: Preserve GeoJSON elevation and separate lines, zero altitude
in FIT files, and date-line crossings. Reimporting avoids transferring unrelated
review choices.
See Review and motion analysis.
Maps and points of interest
- Map POIs: Explore peaks, water, huts, food, transport, and more across
21 categories. Tap for details and save visibility and opacity preferences. - Clearer data status: See preparation, stale data, errors, and offline status.
Map lookups tell you when processing isn't finished yet. - Rendering fixes: OSM Dark works without an API key. Maps recover from tile
failures and restore GPS markers; terrain handles missing ocean tiles, and
Swiss Topo labels use the correct fonts. - Mini-map recovery: Activity maps still appear when offline map data fails,
and resize with their panels.
Route planning
- Planner hub: Start drawing, open saved plans, or read the guide while
preserving your current draft. - Mountain-bike routing: Added alongside touring bike, road bike, hiking,
and car profiles. - Personal POIs: Save named places with icons and notes, alone or with a
route. Move or remove them with shared undo/redo. - Waypoint editing: Larger drag targets, tap-to-move, insertion, reverse,
trimming, and undo/redo work on desktop and phone. - Saved plans and draft protection: Search and reopen plans, save edited
copies, and confirm before replacing unsaved work. Failed saves retain input. - Elevation and routing: More consistent whole-route ascent and descent,
resizable elevation charts, clearer failures, and improved BRouter recovery. - GPX export: Exports contain the route; personal POIs remain in the saved plan.
Google Health beta
Automatically match heart rate to GPS tracks from independent devices.
Record GPS on a Garmin and heart rate on a Fitbit, for example. MTL Explorer
matches recorded times after import, without device pairing or manual linking.
The optional, read-only connection also imports
exercise, sleep, steps, daily activity, body measurements, and health observations.
Available data depends on your account and devices.
Setup requires your own Google Cloud project with Google Health API access and
a Google Account linked to an active Google Health profile.
Google may limit new API projects; check the
setup requirements before you start.
The supported personal setup uses Testing mode, which
requires reauthorization after seven days.
Imported history stays available. Setup and sync may still encounter errors or
interruptions.
- Track and segment heart rate: Aligned graphs and averages show available
coverage. Optional cardiac-cost comparisons relate heart rate to estimated work. - Health overview: Explore activity, vitals, sleep, and body charts by date or
calendar period. Latest values shows the most recent measurements,
independent of the chart period. Choose Intraday to see one day in detail:
all charts zoom together, down to one-second heart rate and individual body
measurements. - Records and routes: Filter stored records and add available exercise routes
to the GPS archive. - Resumable sync: Recent data refreshes while older history imports in
resumable batches. Settings shows progress, gaps, and retries for recent data,
history, and routes. - Connection controls: Renew expired access without repeating server setup.
Disconnecting keeps imported history; deleting it requires separate confirmation. - Synthetic demo: When enabled, explore generated health trends and matching
track heart rate without a Google account. Use your own installation to connect
real data.
See the Health guide.
Filters and statistics
- Filter refinements: Preview results and category counts before Apply, with
validation and date shortcuts. Shared criteria stay selected, and geographic
drawing returns to the filter controls. - Map colors: No coloring now stays selected when you switch views, and
Reset returns each view to its default colors. - Statistics hub: Preview the latest activity and browse Overview, Trends,
and Tracks. Settings and search are preserved when returning. - Chart and browser controls: Reorder and resize trend charts with saved
preferences; clear track searches easily. Unreliable timing stays unavailable. - Consistent media filtering: Map media and statistics use the matching
tracks' time range, showing all media or only track-related items. Empty or
undated selections show no media.
See media filtering.
Photos and video
- Image previews: Better support for newer iPhone HEIC files, efficient
resizing, and retained orientation, aspect ratio, and PNG transparency. - Recovery and downloads: Thumbnails reload automatically when the server is
busy, and a photo without a preview still opens. Retry reloads the photo
and its filmstrip thumbnail. Download original files, inc...
MTL Explorer v.0.8.1
MTL Explorer Release v.0.8.1
- Fixed the map update notice reappearing after it was dismissed.
- Fixed successfully imported GPS tracks remaining hidden while large imports were still running.
- Reduced duplicate status requests with shared eight-second polling.
MTL Explorer v.0.8.0
MTL Explorer Release v.0.8.0
This release expands media indexing, browsing, and video playback. It also
fixes stale media records after files are removed and rescanned.
Media Browsing
- Added a Photos tab to Track Details with a paged timeline and mini-map.
- Added map collections for one location, a cluster, the current map view, and
photos along a GPS track. - Added photo and video trends to Statistics with period drill-downs.
- Expanded the media viewer with a filmstrip, metadata, nearby tracks, zoom,
fullscreen controls, and a separate light or dark theme.
Indexing And Positioning
- Improved media format detection and capture, GPS, image, and video metadata
extraction. - Added durable activity matching with preserved EXIF, estimated, and
user-assigned position sources. - Added reversible camera-clock correction and manual location assignment.
- Removed stale indexed and derived media records after source files are
deleted and media is rescanned, addressing
#6.
Video Playback
- Added video thumbnails, byte-range streaming, and original-file downloads.
- Added optional on-demand H.264/AAC playback conversion when a browser cannot
decode the original video. - Added conversion progress, cancellation, reconnection, and bounded quality
choices.
Reliability And Performance
- Added bounded server-side paging for large media timelines and collections.
- Coordinated resource-intensive background jobs and limited concurrent image
processing. - Reduced memory use during demo media generation.
- Expanded automated and end-to-end coverage for indexing, media workflows,
playback, and large collections.
MTL Explorer v.0.7.0
MTL Explorer Release v.0.7.0
This release adds Imperial (US) measurement support and a redesigned filtering workflow. It also resolves both issues that were open in the public GitHub tracker at release time—#4 and #5—along with all findings from the latest full regression.
Features
- Added a persistent Metric and Imperial (US) measurement preference across maps, statistics, track details, charts, planning, filtering, and related views.
- Added unit-aware server milestones and consistent API measurement handling.
- Redesigned filtering with live updates, searchable views, scoped categories, stable map colors, pause and resume, reset with undo, and shared results across the app.
- Refined responsive workflows for Map settings, Admin, archive replay, Track Browser, and Track Details.
Fixes And Changes
- Resolved all current open GitHub issues:
- Fixed Filter and Statistics refresh after importing or deleting tracks.
- Preserved Statistics view and search state when opening and closing Track Details.
- Added exact activity-type filtering and improved category-selection behavior.
- Fixed temporary map visibility state not resetting when filters change.
- Corrected crossing calculations for reverse-indexed track sections.
- Correctly report failed and empty imports in Admin.
- Added a visible retry and dismiss notice when map configuration loading fails.
- Added Google Search Console verification.
- Expanded automated coverage and refreshed public documentation, generated API types, and regression evidence.
MTL Explorer v.0.6.1
MTL Explorer Release v.0.6.1
Features
- Minor release only.
Fixes And Changes
- Added activity, statistics, and highlight curation controls to Track Details quality.
- Improved Garmin and GPX activity detection, including rowing and common Garmin activity aliases.
- Preserved the 2D map camera when leaving 3D replay.
- Fixed animation speed controls so slow is left and fast is right.
- Improved Track Details mobile graph controls with a compact tuning toggle.
- Made Track Details and mini-map opening more stable and less jumpy.
- Added focused frontend and backend test coverage for these changes.
MTL Explorer v.0.6.0
MTL Explorer Release v.0.6.0
Features
- Added cinematic 3D track replay from Track Details, with playback controls, duration presets, camera styles, telemetry, and a 2D fallback when 3D is not available.
- Added a richer, more colorful map style that makes roads, terrain, and route context easier to read at a glance.
- Added an optional 3D terrain map view so routes can be inspected with elevation context directly on the main map.
- Expanded track import beyond GPX/FIT with support for more GPS file formats, including TCX, KML/KMZ, IGC, NMEA, GeoJSON, and GDB.
- Added original-file download and GPX export actions from Track Details, making it easier to recover or share imported activities.
- Improved Track Details with stronger overview metrics, energy and power views, synced graphs, mini-map interaction, events, quality information, and related activities.
- Expanded Statistics with a richer overview, activity breakdowns, highlights, milestones, recent activity, and better review tools for tracks excluded from statistics or highlights.
- Improved route and segment analysis with better comparison views, virtual race playback, archive animation, and planner workflows.
- Added a broader Admin workspace for uploads, indexing status, data freshness, Garmin sync, helper tools, logs, runtime information, settings, session cleanup, and attribution.
Fixes And Changes
- Reworked map settings so map style, visible layers, opacity, terrain settings, and overlay choices persist more reliably.
- Improved local and remote map behavior, including raster fallback, attribution display, cache handling, and several additional map styles.
- Improved GPS file conversion reliability, especially for KMZ and GeoJSON, and removed the unsupported SBP format from the documented supported list.
- Improved activity-type correction so user changes are saved consistently and related energy values are recalculated.
- Added rider-weight adjustment for energy estimates, including preview and save behavior in Track Details.
- Improved filter behavior for date, text, track-id, SQL-template, keyword, year, and geo-shape parameters.
- Improved data freshness handling so imports, deletes, rescans, and server-side changes can refresh the client without repeated reload loops.
- Improved mobile sheets, map controls, planner interaction, and several responsive layouts.
- Improved session and error recovery behavior, including expired-login handling and recovery from failed map, media, planner, and track-detail requests.
- Improved performance and maintainability across the map, track cache, statistics, mini-map synchronization, and replay flows.
- Added a much larger regression and unit-test suite covering frontend flows, backend GPS processing, conversion, energy, security, map status, statistics, and API contracts.
- Updated public-facing documentation and release evidence, including full-regression and container-build reports.