Repository navigation
Releases
Releases · bresca-ai/TrailReplay
TrailReplay v1.5.0
Create richer route stories with place and border animations, a new media timeline, more flexible overlays, and sharper video exports.
Added
- Places and borders: Reveal countries, regions and local places during the opening or as the route travels. Choose boundary levels, camera movement, timing, borders and labels. Coverage varies by location; boundary requests disclose route countries to geoBoundaries and GitHub.
- GPX waypoints: Turn named waypoints into map captions or route notes when importing a GPX file.
- Media timeline: See and edit photos, videos and annotations along the route, zoom and navigate the timeline, and adjust the length of annotation moments. Place several unlocated media items together on the map, at the playhead or by coordinates; set photo durations in bulk.
- Media recovery: Relink missing project media from a local folder in one step.
- Map and journey controls: Add optional 3D buildings, adjust terrain exaggeration and follow-camera tilt, and use a minimal landmark style. Animate camera transitions between journey routes and display elevation profiles for individual routes.
- Overlay controls: Move the route overview, resize the elevation profile, and choose its colour and fill or outline appearance. The overview can show route progress without a marker.
- Undo and redo: Use project-wide keyboard shortcuts and undo in the cover editor.
Improved
- Annotations: Redesigned annotation and timing controls support shared defaults and per-annotation timing. Map captions and field notes have more consistent designs in previews and exports, with clearer default text sizing.
- Video export: Studio renders the map and overlays at the selected output resolution, with improved map detail and crop alignment. Disk-backed MP4 export reduces memory use for long exports on supported browsers.
- Cinematic playback: Terrain-aware camera planning, steadier framing and tile preparation improve flight and repeated playback. New journeys default to constant pace.
- Map presentation: Esri Clarity is the default satellite imagery; map filters and landmark colours are more consistent. Selecting a landmark on the map opens its editor, and landmark priority can be adjusted.
- Cover editing: Improved controls and undo make cover layouts easier to refine.
- Languages and discovery: Localized home, help and GPX/Strava landing pages make the website easier to find and navigate in supported languages.
- Reliability: A sidebar panel failing to load no longer makes the whole app unusable. Winter satellite imagery endpoints and cached imagery were also updated.
- Dependencies and documentation: Updated application and development dependencies, including icon, upload and state-management libraries. Refreshed the README demo video.
Fixed
- Keep manually placed media and annotations aligned during constant-pace playback, including annotation slowdown and timeline display.
- Preserve typed spaces in annotation headings and allow blank annotation text.
- Restart playback paused with the opening sequence, and keep compact landmark pins anchored correctly.
- Preserve the selected basemap during export and improve cropped video and overlay placement.
- Bound landmark coordinates and tile enumeration before allocation to avoid excessive memory use.
- Updated the minimatch dependency to address a regular-expression denial-of-service vulnerability.
What's Changed
Maintenance
- chore: bump the development-dependencies group across 1 directory with 2 updates by @dependabot[bot] in #231
- chore: bump the development-dependencies group in /app with 6 updates by @dependabot[bot] in #244
- chore: bump @radix-ui/react-label from 2.1.15 to 2.1.17 in /app by @dependabot[bot] in #245
- chore: bump heic-to from 1.6.5 to 1.6.7 in /app by @dependabot[bot] in #247
- chore: bump zustand from 5.0.15 to 5.0.16 in /app by @dependabot[bot] in #248
- chore: bump immer from 11.1.21 to 11.2.9 in /app by @dependabot[bot] in #246
- chore: bump zustand from 5.0.16 to 5.1.0 in /app by @dependabot[bot] in #264
- chore: bump react-dropzone from 20.1.4 to 20.2.0 in /app by @dependabot[bot] in #263
- chore: bump lucide-react from 1.60.0 to 1.71.0 in /app by @dependabot[bot] in #262
- chore: bump the development-dependencies group across 1 directory with 6 updates by @dependabot[bot] in #260
- chore: bump @waysidemapping/pinhead from 15.25.0 to 16.26.0 in /app by @dependabot[bot] in #261
New Contributors
- @marcllort made their first contribution in #242
Full Changelog: v1.4.0...v1.5.0
TrailReplay v1.4.0
This release makes it easier to compare routes, arrange a replay, and prepare a video or shareable image. It also refreshes the editor from route import through export.
Added
- Route comparisons: Group routes in the timeline and compare their recorded times with a live leaderboard, or compare their geometry to highlight sections where they diverge. Set the separation threshold and slowdown, and customize the leaderboard's appearance, position and size. These settings are saved with the project and appear in exported videos.
- Route trimming and languages: Trim imported GPX routes before using them in a replay, and use the editor in Traditional Chinese (Taiwan).
- Annotation placement: Choose between a short map caption and a larger field note, then place it at a specific kilometre or at the playhead. Annotation opacity is adjustable.
- Route colouring: Define coloured route segments using either percentages or distances in kilometres. Heart-rate colour controls have also been reorganized.
- Landmark icons: Search a larger icon library or select an emoji for route landmarks; selected icons and colours are retained in saved projects and exports.
- Experimental recorded elevation: An optional map setting displays a route at its recorded altitude instead of following the terrain. Terrain clearance depends on loaded tiles, missing elevations may appear at sea level, and comparison tracks retain their existing behaviour. Further real-flight and export validation is needed.
Improved
- Editor navigation: Redesigned Routes, Style, Map & Camera, Media and Generate panels organize controls around the task at hand. Workflow headers link to the next step, and secondary options take less space.
- Map and camera: Camera controls are more prominent, map styles have visual previews, and overlays and points of interest are more compact. Pitch and bearing can also be adjusted with sliders.
- Route styling: Route name and colour are easier to find, followed by advanced colouring, marker, label and statistics options. Comparison and route ordering are managed in the timeline instead of duplicated in Routes.
- Video export: Configure format, visual aspect ratio, quality and frame rate directly in Generate. The file-size estimate now reflects resolution, frame rate and rendering quality. Studio uses a higher target bitrate to preserve map detail.
- Image and cover export: Visual presets and expandable design, photo, map, title, statistics, route and logo controls make the image editor easier to scan. The interactive preview and video-cover workflow remain available. Project saving is accessible from both video and image modes.
- Replay and presentation: Improved cinematic camera behaviour, elevation sections, cover editing and export sky. Elevation gain is less affected by noisy data, and replay totals stay consistent. The replay marker follows the painted route more closely.
- Export branding and localization: Preview the watermark while arranging overlays, use the transparent white logo in video and cover exports, and benefit from more consistent German translations.
- Updated application dependencies and improved manual preview support for contributions from forks.
Fixed
- Prevent route trimming from invalidating route-anchored elevation sections and colour zones.
- Improve landmark coordinate editing and prevent landmark-layer errors when the map style changes.
- Update the Zod dependency to address a known vulnerability.
What's Changed
Maintenance
- chore: bump actions/upload-artifact from 4 to 7 by @dependabot[bot] in #207
- chore: bump actions/download-artifact from 4 to 8 by @dependabot[bot] in #208
- chore: bump the react-packages group in /app with 2 updates by @dependabot[bot] in #209
- chore: bump the development-dependencies group in /app with 5 updates by @dependabot[bot] in #210
- chore: bump @radix-ui/react-switch from 1.4.0 to 1.4.1 in /app by @dependabot[bot] in #211
- chore: bump exifreader from 4.42.0 to 4.50.0 in /app by @dependabot[bot] in #212
- chore: bump lucide-react from 0.562.0 to 1.60.0 in /app by @dependabot[bot] in #213
New Contributors
- @joy3352763 made their first contribution in #218
Full Changelog: v1.3.0...v1.4.0
TrailReplay v1.3.0
Added
- Design an optional one-second opening cover for video exports directly over the map. Four starting layouts, including Long Way and two photo-and-map designs, support movable and resizable map, title, stats, and photo frames. Photos can be added from the project or dropped into frames, then cropped and zoomed.
- Customize cover stats with activity icons, labels, values, colors, order, and layout. The cover shares the selected video typography and can be configured by agent recipes.
- Dynamic elevation sections focus the profile on notable climbs and descents during replay and Studio export, with section markers and gain or loss labels.
- Import a Strava activity GPX through a browser bookmarklet, with a guided setup and import walkthrough.
- Paste or enter coordinates when adding a route landmark.
- Choose from additional bundled typography styles, including bold condensed options for covers.
Improved
- Real Pace follows GPX and FIT timestamps, including pauses and stationary periods, so the marker, media, annotations, camera, and exports stay synchronized.
- Studio export uses deterministic map timing, waits for tiles before encoding, and produces higher-bitrate, more compatible H.264 video.
- Annotation text scales more clearly on mobile and portrait videos, and large route imports show progress while processing off the main interface thread.
- Map First poster editing pans and zooms the underlying map while keeping the trail aligned; route landmarks are localized across the five supported languages.
- Fresh projects start with the satellite map style, and the tutorial now covers camera modes and dynamic elevation more clearly.
What's Changed
Maintenance
- chore: bump eslint from 10.11.0 to 10.12.0 in /app in the development-dependencies group across 1 directory by @dependabot[bot] in #165
- chore: bump web-vitals from 5.1.0 to 6.2.2 in /app by @dependabot[bot] in #166
- chore: bump the development-dependencies group in /app with 4 updates by @dependabot[bot] in #170
- chore: bump immer from 11.1.3 to 11.1.21 in /app by @dependabot[bot] in #173
- chore: bump maplibre-gl from 6.10.0 to 6.12.0 in /app by @dependabot[bot] in #171
- chore: bump heic-to from 1.5.2 to 1.6.5 in /app by @dependabot[bot] in #174
- chore: bump @fontsource/source-serif-4 from 5.3.0 to 5.3.1 in /app by @dependabot[bot] in #193
- chore: bump @radix-ui/react-switch from 1.2.6 to 1.4.0 in /app by @dependabot[bot] in #192
- chore: bump maplibre-gl from 6.10.0 to 6.14.0 in /app by @dependabot[bot] in #191
- chore: bump the development-dependencies group in /app with 4 updates by @dependabot[bot] in #189
New Contributors
Full Changelog: v1.2.0...v1.3.0
TrailReplay v1.2.0
Added
- Cinematic camera keyframes now support MapLibre's full zoom range, enabling continent-scale overview shots and smooth transitions into close route details.
- The cinematic camera editor shows the current zoom value while composing a shot.
Improved
- German translations use consistent informal language and correct activity terminology, including heart-rate labels.
- React, Zustand, Radix Slider, Tailwind Merge, and the development toolchain have been updated to compatible current versions.
Security
- Updated
source-map-jsandbrace-expansionto patched versions.
What's Changed
Maintenance
- chore: bump zustand from 5.0.10 to 5.0.15 in /app by @dependabot[bot] in #143
- chore: bump tailwind-merge from 3.4.0 to 3.7.0 in /app by @dependabot[bot] in #145
- chore: bump @radix-ui/react-slider from 1.3.6 to 1.4.7 in /app by @dependabot[bot] in #144
- chore: bump brace-expansion from 5.0.9 to 5.0.12 in /app by @dependabot[bot] in #159
- chore: bump compatible development dependencies in /app by @dependabot[bot] in #160
- chore: bump React packages to 19.3.0 in /app by @dependabot[bot] in #142
- chore: bump source-map-js from 1.2.1 to 1.2.2 in /app by @dependabot[bot] in #163
New Contributors
Full Changelog: v1.1.0...v1.2.0
TrailReplay v1.1.0
Resolves #111 — Video export performance is significantly slower than expected.
Added
- Missing pictures restored from a
.replayproject can be re-linked automatically by uploading files with the same names, while preserving their route positions, durations, titles, and descriptions. - An opt-in export profiler and repeatable browser benchmark report map rendering, overlay capture, frame compositing, and encoding time.
Fixed
- Photos and video clips open when the route marker reaches them instead of appearing early on long replays.
- Long MP4 exports release temporary document clones and media URLs instead of retaining them across repeated captures or re-links.
- Concurrent overlay captures clean up only their own temporary iframe, preventing missing or corrupted overlays.
Improved
- Video export reuses static overlay captures and lightweight document clones, substantially reducing export time and memory growth while keeping map frames, media, stats, and elevation progress at full output frame rate.
- Picture holds default to three seconds, producing more concise replays while keeping existing custom durations unchanged.
- The 1080p/30 fps release candidate was verified as H.264 High profile at approximately 5 Mbps, with a valid downloadable duration and full-resolution overlays.
Full Changelog: v1.0.2...v1.1.0
TrailReplay v1.0.2
Version 1.0.1 was prepared but never published as a release; its changes ship here.
Added
- Route annotations: notes and icon changes anchored to a point on the route, shown on the map or in a side panel, with a playback hold and localized content. Recipes can author them too.
Fixed
- Annotations and icon changes stay at the right place on the route when switching between Constant Pace and Real Pace, including annotations from older projects.
- Route-note content is fully editable.
- Stat icons and labels appear again in exported videos.
- Local Studio export works and reports frame progress.
Improved
- Video exports with annotations use far less memory and finish faster: redundant slowdown frames are skipped, the background map warm-up is released during export, and encoded video is no longer held in memory until the end.
- Product analytics records the camera stability and follow-distance actually used during replay and export, including default values.
- Replay, video export, and poster export report bounded choices for major camera, map, annotation, media, video-format, and presentation options. Disabled choices are explicit; private annotation and poster text is never sent.
- Annotation creation is counted separately from annotations present in a replay or export.
Reporting
- The GA4 product-usage exploration and custom dimensions are prepared. Breakdowns require new production events after deployment; historical parameters cannot be backfilled through custom dimensions.
What's Changed
Maintenance
- chore(deps): bump actions/checkout from 4 to 7 by @dependabot[bot] in #119
- chore(deps): bump actions/setup-node from 4 to 7 by @dependabot[bot] in #120
- build(deps): bump @radix-ui/react-label from 2.1.8 to 2.1.15 in /app by @dependabot[bot] in #122
- build(deps): bump heic-to from 1.4.2 to 1.5.2 in /app by @dependabot[bot] in #123
- chore: bump sonner from 2.0.7 to 2.0.8 in /app by @dependabot[bot] in #124
- chore: bump react-dropzone from 14.3.8 to 20.1.2 in /app by @dependabot[bot] in #125
- chore: bump the development-dependencies group across 1 directory with 17 updates by @dependabot[bot] in #128
New Contributors
- @dependabot[bot] made their first contribution in #119
Full Changelog: v1.0.0...v1.0.2
TrailReplay v1.0.0
Added
- A browser-based GPX storytelling studio with route replay, comparisons, annotations, media placement, live stats, elevation profiles, and export-ready video.
- Public release, contribution, security, and maintenance practices for the project.
Security
- Updated MapLibre and other dependencies to resolve known advisories. MapLibre 6 now requires WebGL2 for map rendering.
Licensing
- TrailReplay remains available under its existing attribution license. Apps using the software must display the attribution described in
LICENSE.
New Contributors
- @Thovi98 made their first contribution in #61
- @LeoTayot made their first contribution in #69
- @markhbish made their first contribution in #92
Full Changelog: https://github.com/bresca-ai/TrailReplay/commits/v1.0.0