GPX → Fusion

Turn a GPX track into a map background and an animatable Fusion polyline for DaVinci Resolve. Version 1.5

View on GitHub Quick start

Overview

GPX → Fusion is a small Windows app. You open a GPX file from your watch, phone or bike computer (or draw a route by clicking in the map), choose the part of the track you want, and export:

🗺️ map.png

A map background (OpenStreetMap, satellite or CARTO) at up to 8K, framed around your track.

〰️ GpxTrack.setting

Native Fusion nodes: the track as a polyline mask, its color and the merge. Paste them with Ctrl+V.

✍️ Write On animation

The track draws itself over the clip, at a constant pace or at the real GPX pace including pauses.

🏷️ Labels & marker

Optional text labels and an image (e.g. a little train) that rides on the head of the line.

The app does not render video. Everything ends up as ordinary Fusion nodes that you can keep editing and animating in Resolve.

Installation

  1. Download GpxToFusion-v<version>-win-x64.zip from the latest release.
  2. Unzip it anywhere and run GpxToFusion.exe. No installation and no .NET runtime needed.

Requirements: Windows 10/11 (64-bit) and DaVinci Resolve (free or Studio) for the result.

The exe is not code-signed, so Windows SmartScreen may show a warning the first time. Click More info → Run anyway.

Or build and run from source (needs the .NET 10 SDK):

git clone https://github.com/DorwinDT/GpxToFusion.git
cd GpxToFusion
dotnet run --project src/GpxToFusion -- "C:\path\to\track.gpx"

The GPX path is optional. You can also start GpxToFusion.exe and open a file from the menu, or drag it into the window.

The main window

GPX → Fusion main window with a map preview, the settings panel on the right and the crop timeline at the bottom
Map preview (center), settings (right), crop timeline with speed and elevation (bottom).
AreaWhat it does
Menu & toolbarFile, Export, View, Edit, Help (Controls, User guide (online) and About with the version number). The toolbar has the most common commands: New route, Export, Copy .setting, preview mode, Auto frame, Label, Extend track and Edit route.
Map previewShows exactly what map.png will contain (Frame mode, F5) or the whole track with the export frame outlined (Full track, F6). Drag to pan, wheel to zoom.
Settings panelAll export options grouped as Map, Track, Fusion, Labels and Added points. The box below shows help for the selected option.
Track detailSlider for how many points the Fusion polyline gets (same as Simplification (px)). Move it right for fewer points and faster rendering in Resolve. The tolerance and the point count are shown next to it, and the line in the preview is drawn from the simplified points, so you can see when it starts cutting corners.
Info boxOutput size, zoom, number of tiles, map scale, point counts after filtering and simplification, and the resulting line width.
Crop timelineThe x axis is time, so pauses are visible. Speed is drawn in yellow, elevation in blue. Green and red handles mark the start and end.

Workflow

  1. Open a GPX.

    File → Open GPX… (Ctrl+O) or drag a .gpx file into the window. The track is shown on the map and the timeline fills with speed and elevation. You can also save everything as a project (*.g2f.json) and load it later. File → Save project (Ctrl+S) saves under the current name; the first time, or after opening a new GPX, it asks for a file name. Save project as… (Ctrl+Shift+S) saves a copy under a new name. The window title shows the project name.

  2. Or draw a route (instead of opening a GPX)

    No GPX file? Use File → New route (Ctrl+N) and click the route into the map, point by point. The points are joined by straight lines. If no track is loaded, the map starts on an overview of Central Europe; zoom in to your area first.

    • Click = new point at the end of the route, drag a point = move it, click on a segment = insert a point (you can drag it right away), right button on a point = delete.
    • Drag the map = pan, wheel = zoom (Shift = fine), Ctrl+Z = undo, Esc = done.
    • The map stays still while you draw. When you finish, the frame fits the route automatically. To set it by hand, adjust it afterwards as in Map & frame.
    • To change the route later, use Edit → Edit route points (Ctrl+R).
    • Times are computed from 5. Added points → Speed of added segments (0 = 4.5 km/h), and the route has no elevation.
    • Save the route with File → Save project to keep editing it later, or with File → Save track as GPX… to get a normal GPX file. A saved GPX opens as a recorded track, so its points can no longer be edited one by one.

    From here on, a drawn route works like any other track: you can crop it, add labels and export it. The app asks before discarding a route with unsaved changes.

  3. Crop the track.

    Drag the green handle (start) and the red handle (end). Dragging the middle moves the whole selection. For exact values use the Start / End fields under the timeline. Reset crop selects the whole track again.

    Keyboard: ←/→ move the selected handle by 1 point, with Shift by 60 and with Ctrl by 600 points (about 1 and 10 minutes for a track recorded every second). Home/End select the start or end handle.

  4. Extend the track (optional)

    Started the tracker too late or stopped it too early? Use Extend track → Start or End and click in the map. New points chain outward from the green (start) or red (end) point and are joined by straight lines, drawn dashed in the preview.

    • Click = new point, drag = move a point, click on a segment = insert a point, right button = delete, Esc = done.
    • Times for the added points are computed from 5. Added points → Speed of added segments (0 = your moving average from the GPX). Elevation is copied from the nearest recorded point.
    • Added points are saved in the project. The original GPX is never changed; File → Save track as GPX… writes a new file.

    If the track is cropped at that end, the added points are not exported until you reset the crop. The status bar warns you about this.

  5. Set up the map and the frame.

    In 1. Map choose the base map, the resolution (HD, 4K, 8K, vertical, square or custom), padding around the track, extra zoom-out and darkening. In 2. Track set the line color and width.

    By default the frame fits the cropped track automatically. To frame it yourself, drag the map in the preview (or use the middle button while adding labels or points) and zoom with the wheel (Shift = finer steps). In Full track mode you drag the frame outline directly. Auto frame (Ctrl+0) returns to the automatic frame; changing padding or extra zoom-out does the same.

    Planning to zoom or pan in Resolve? Export a bigger map (8K) or set Extra zoom-out to 0.5–1, so you have room to move and pixels don't show.

  6. Add map labels (optional)

    Click Label (Ctrl+L) and then the place in the map. A dialog lets you set text (multiple lines allowed), font, size, bold/italic, color, outline and alignment. In the preview: double-click = edit, drag = move, right button = edit/delete menu. A new label takes over the style of the previous one.

    Labels are anchored to a GPS position, so they stay in place when you change the crop or resolution. 4. Labels → Label output decides how they are exported:

    • Fusion Text+ (default): every label becomes a Label1, Label2… node merged by MergeLabel1… You can change text, font and position in Resolve and animate them (e.g. Blend on MergeLabelN). The font must be installed on the machine running Resolve.
    • Burn into map.png: labels are drawn into the map image, exactly as in the preview.
  7. Add an image at the line head (optional)

    In 2. Track → Image at line head choose a PNG with a transparent background and set Image size. The image moves along the track together with the end of the drawn line. See Animating the track for the Fusion side.

  8. Export.

    Export… (Ctrl+E) asks for a folder (default: <gpx name>_fusion next to the GPX), downloads the map tiles and writes:

    FileContent
    map.pngThe map at the chosen resolution, without the track.
    GpxTrack.settingFusion nodes: map Loader, track polyline, color, merges (plus labels, marker and calibration frame if enabled).
    track.pngThe track alone on a transparent background, as a raster alternative.
    track_points.csvPolyline points with time, km, pixel position and write_length, handy for timing keyframes.

    Tiles are cached in %LOCALAPPDATA%\GpxToFusion\tiles, so the next export is much faster. If some tiles fail to download (gray areas), just export again.

Using it in DaVinci Resolve

Paste the nodes

  1. Put a Fusion Composition on the timeline (Effects → Toolbox → Effects → Fusion Composition), or open the Fusion page on any clip.
  2. Export first, so the Loader points to the right map.png. Then bring the nodes into the Fusion page Node editor in one of two ways:
    • Drag and drop: drag GpxTrack.setting from the export folder (Windows Explorer) into the Node editor.
    • Clipboard: in the app click Copy .setting (Ctrl+Shift+C), then click into the Node editor and press Ctrl+V.
  3. Connect the output of MergeCalib (or the last merge) to MediaOut1.

Node graph

MapLoadermap.png TrackPathpolyline mask TrackColorline color MergeTrackBG map · FG line MergeCalibdisabled MediaOut1timeline

Optional nodes are inserted after MergeTrack when enabled: LabelN + MergeLabelN for labels, and MarkerLoader + MarkerPath + MergeMarker for the line head image.

NodeRole
MapLoaderLoads map.png and holds it on every frame. Replaced by MediaIn1 in the MediaIn variant.
TrackPathThe track as a polyline mask. Border Width is the line width; Write On animates the drawing.
TrackColorA Background node in the line color, cut out by TrackPath.
MergeTrackPuts the line over the map.
MergeCalibA disabled calibration overlay: a magenta rectangle 10 px inside the map edges. See Troubleshooting.

Animating the track

The drawing is controlled by TrackPath → Inspector → Controls → Write On (Length).

  • Fit to clip length (default, needs Add Write Length keyframes on): Write Length gets an expression instead of keyframes, so the animation always spans the whole Fusion clip. Shorten the clip and the track draws faster; lengthen it and it draws slower. Start Delay (frames) and End Hold (frames) on TrackPath → Controls set when it starts and finishes.
  • Fixed length: turn Fit to clip length off and set Animation length (frames) to get regular keyframes.
  • Time by GPX time: the line grows at your real pace, including pauses. When off, it grows evenly by distance.
  • Manual: leave Add Write Length keyframes off and keyframe Write Length 0 → 1 yourself. track_points.csv tells you the write_length value for each point in time.

Line head image. MarkerPath is a path with the same points as the track. Its Displacement is an expression driven by TrackPath.WriteLength, so the image follows the line head however you animate it. Change size and rotation on MergeMarker → Size / Angle. If the image runs ahead of or behind the line, try the other options in MarkerPath → Controls → Path Sync (default Mask px / Path normalized; Off uses Write Length directly).

Camera moves

Add a Transform node after the last merge and keyframe Center and Size to pan and zoom. If the map is larger than the timeline (e.g. 4K map on an HD timeline), Fusion works at map resolution and MediaOut1 scales it down.

MediaIn alternative (no Loader)

If the Loader gives you trouble, put the map on the timeline yourself:

  1. Set 3. Fusion → Map source in Fusion to MediaIn1 and export.
  2. Import map.png into the Media Pool, put it on the timeline and stretch it to the length you need.
  3. Open the Fusion page on that clip. It contains MediaIn1 → MediaOut1.
  4. Press Ctrl+V. If MediaIn1 doesn't connect by itself, drag its output to the yellow (background) input of MergeTrack.
  5. Connect MergeCalib to MediaOut1.

Settings reference

Every setting is also explained in the help box under the settings panel.

1. Map

SettingDescription
Base mapOpenStreetMap (place names in the local script), OpenStreetMap – Latin labels (useful for Arabic or Cyrillic regions; big cities show the Latin name, German where one exists, next to the local one), National Geographic – English labels (up to zoom 12, so for routes between cities rather than a walk), Satellite (Esri World Imagery), CARTO dark, CARTO light.
Resolution / Width / HeightSize of map.png. Presets: HD, 4K UHD, 8K, vertical HD/4K, square, or custom.
Padding (%)Free space around the track on each side.
Extra zoom-out0 = the track fills the frame; 1 = the map covers a 2× larger area. Fractions allowed.
FrameShows whether the frame is automatic or manual (set by dragging/zooming the preview).
Darken map (%)Black overlay over the map (0–80 %), useful with satellite imagery.
Attribution textWrites the map copyright notice into map.png.

2. Track

SettingDescription
Line colorColor of the track line.
Line width (px at 1080p)Scaled with the resolution (4K → 2×).
Simplification (px)Douglas–Peucker tolerance in map.png pixels. Larger = fewer polyline points in Fusion and faster rendering. Also set by the Track detail slider.
GPS noise filter (m)Drops points closer than this to the previous one (e.g. standing still). 0 = off.
Image at line head / Image sizeOptional PNG that rides on the end of the line; size of its longer side at 1080p.

3. Fusion

SettingDescription
Map source in FusionLoader (loads map.png from file) or MediaIn1 (map on the timeline).
Add Write Length keyframesCreates the drawing animation 0 → 1. Off = full track, animate it yourself.
Fit to clip lengthUses an expression so the animation always fills the clip.
Animation length (frames)Used only when Fit to clip length is off.
Start delay / End hold (frames)Hidden frames at the start, complete-track frames at the end. Also editable in Fusion.
Time by GPX timeReal pace including pauses instead of even growth by distance.
Calibration frameAdds the disabled MergeCalib rectangle for checking alignment.

4. Labels

SettingDescription
Label outputFusion Text+ nodes (editable in Resolve) or Burn into map.png.
Label countNumber of labels on the map.

5. Added points

SettingDescription
Speed of added segments (km/h)Used to compute times for added points and drawn routes. 0 = moving average from the GPX (4.5 km/h for a drawn route).
Added start / Added endNumber of points added before the start / after the end.

Shortcuts

Press F1 in the app for the same overview.

Keys / mouseAction
Ctrl+NNew route (draw on the map)
Ctrl+REdit route points
Ctrl+ZUndo the last route edit (while drawing)
Ctrl+OOpen GPX
Ctrl+Shift+O / Ctrl+SLoad / save project
Ctrl+Shift+SSave project as…
Ctrl+EExport
Ctrl+Shift+CCopy .setting to the clipboard
F5 / F6Preview the export frame / the full track
Ctrl+0Automatic frame
Ctrl+LAdd label
Drag map / middle buttonPan the frame
Mouse wheel (Shift = fine)Zoom the frame
← → (Shift ×60, Ctrl ×600)Move the selected crop handle by points
Home / EndSelect the start / end crop handle
EscLeave label, extend or route drawing mode
F1Controls overview

Troubleshooting

Check alignment with the calibration frame

Select MergeCalib and press Ctrl+P to enable it. A magenta rectangle should appear exactly 10 px inside the map edges. If it does, the track lines up with the map.

The result is black

In Fusion select a node and press 1 to show it in the viewer:

  • MapLoader is black or red → the Loader did not find map.png (check Inspector → File) or the image is not on the current frame (check Hold First Frame / Hold Last Frame). Exporting before copying the .setting avoids a wrong path. The MediaIn variant avoids the Loader entirely.
  • TrackColor shows the line but MergeTrack is black → the merge has no background; the problem is the map input.

The line looks thinner or thicker than in the preview

Adjust TrackPath → Border Width in Fusion, or change Line width in the app and export again.

Labels use a different font in Resolve

Text+ needs the same font installed on the machine running Resolve. Otherwise choose Burn into map.png.

Rendering in Resolve is slow

Long tracks give the polyline thousands of points (and the marker path the same number). Move the Track detail slider to the right, or raise Simplification (px), until the point count drops to a few hundred. At 4K, 2–5 px is usually not visible. Watch the preview line: it shows the simplified track. Then export again and paste the new .setting.

Export takes long

The info box warns when a map needs many tiles. Use a smaller resolution or less extra zoom-out. Downloaded tiles are cached, so repeated exports are fast.

Map sources & licenses

  • OpenStreetMap: © OpenStreetMap contributors. Please respect the tile usage policy; the app downloads at most 2 tiles at a time and caches them.
  • OpenStreetMap – Latin labels: © OpenStreetMap contributors, tiles from openstreetmap.de.
  • National Geographic: Tiles © Esri — National Geographic, Esri, DeLorme, NAVTEQ, UN-WCMC, USGS, NASA, ESA, METI, NRCAN, GEBCO, NOAA, iPC.
  • Esri World Imagery: Tiles © Esri — Source: Esri, Maxar, Earthstar Geographics.
  • CARTO: © OpenStreetMap contributors © CARTO.

The attribution text is written into map.png by default; keep it on when you publish your video.

License

GPX → Fusion is free and open source under the MIT License © Peter Turcan (DorwinDT). You may use, modify and redistribute it, including commercially, as long as the license notice is kept. The map data is not covered by this license; each map source above has its own terms.