gopro-overlay 0.29.0

Overlay graphics dashboards onto GoPro footage

Overlaying Dashboard onto GoPro MP4 Files

• Overlaying exciting graphics
• Convert GoPro movie metadata to GPX or CSV files
• Cut sections from GoPro movies (including metadata)
• Join multiple GoPro files together (including metadata)

Examples

Requirements

• Python3.8
• ffmpeg (you'll need the ffmpeg program installed)
• Unixy machine (probably, untested on Windows)

How to use

• Install with pip

python -m venv venv
venv/bin/pip install gopro-overlay

Overlaying a dashboard

venv/bin/gopro-dashboard.py

The GPS track in Hero 9 (at least) seems to be very poor. If you supply a GPX file from a Garmin or whatever, the program will use this instead for the GPS.

Privacy allows you to set a privacy zone. Various widgets will not draw points within that zone.

The data recorded in the GoPro video will uses GPS time, which (broadly) is UTC. The renderer will use your local timezone to interpret this, and use the local timezone. This may produce strange results if you go on holiday somewhere, but then render the files when you get back home! On linux you can use the TZ variable to change the timezone that's used.

Example

For full instructions on all command lines see docs/bin

venv/bin/gopro-dashboard.py --gpx ~/Downloads/Morning_Ride.gpx --privacy 52.000,-0.40000,0.50 ~/gopro/GH020073.MP4 GH020073-dashboard.MP4

Format of the Dashboard Configuration file

Several dashboards are built-in to the software, but the dashboard layout is highly configurable, controlled by an XML file.

For more information on the (extensive) configurability of the layout please see docs/xml

Converting to GPX files

venv/bin/gopro-to-gpx.py <input-file> [output-file]

Joining a sequence of MP4 files together

Use the gopro-join.py command. Given a single file from the sequence, it will find and join together all the files. If you have any problems with this, please do raise an issue - I don't have that much test data.

The joined file almost certainly won't work in the GoPro tools! - But it should work with gopro-dashboard.py - I will look into the additional technical stuff required to make it work in the GoPro tools.

This will require a lot of disk space!

venv/bin/gopro-join.py /media/sdcard/DCIM/100GOPRO/GH030170.MP4 /data/gopro/nice-ride.MP4

Cutting a section from a GoPro file

You can cut a section of the gopro file, with metadata.

Performance

Performance isn't really a major goal... Right now it processes video just a bit faster than realtime, so your 10 minute video will probably take about 10 minutes to render. This is highly dependent on your CPU though.

Pillow-SIMD

You might be able to get some more performance out of the program by using pillow-simd. Installing it is a bit more complicated. You'll need a compiler etc. Follow the installation instructions at https://github.com/uploadcare/pillow-simd#pillow-simd

On my computer, although for sure the frame-drawing is a bit faster ( 36fps v 25fps ), ffmpeg itself is the limiting factor, so overall it doesn't make much difference, it's 5 seconds faster for an 8-minute render. This is on an 4/8HT core Intel(R) Core(TM) i7-6700K CPU @ 4.00GHz (2015-Skylake), if you have a lot more CPU cores it might make a bigger difference.

FFMPEG GPU

My GPU isn't really new enough to use the GPU-enabled FFMPEG, so I can't test it out. If you have information to share about this, please do!

Known Bugs / Issues

• Only tested on a GoPro Hero 9, that's all I have. Sample files for other devices are welcomed.
• Aligning overlay with video - not exact! - Start garmin first, and wait for GPS lock before recording

Icons

Icon files in icons are not covered by the MIT licence

Map Data

Data © OpenStreetMap contributors

Some Maps © Thunderforest

References

https://github.com/juanmcasillas/gopro2gpx

https://github.com/JuanIrache/gopro-telemetry

https://github.com/gopro/gpmf-parser

https://coderunner.io/how-to-compress-gopro-movies-and-keep-metadata/

Other Related Software

https://github.com/progweb/gpx2video

https://github.com/JuanIrache/gopro-telemetry

Latest Changes

• 0.29.0
  • Add compass component (experimental!) - Draws a simple compass
  • Add frame component - Draws a clipping maybe-rounded box to contain other components.
  • Add initial docs for XML layout.
• 0.28.0
  • Only rerender moving map if it has moved since last frame - will be much quicker under certain circumstances
  • Refactorings in how map border/opacity is rendered (should have no visible effect, maybe marginally faster)
• 0.27.0
  • Fix Issue #20 Minor improvement in GPX parsing. Hopefully more tolerant of GPX files that don't contain hr/cadence/temp extensions
• 0.26.0
  • (Change in behaviour) - Fix Issue #17 Will now use local timezone when rendering datetimes. (H/T @tve )
• 0.25.0
  • (Change in behaviour) - Will now use speed from datasource, in preference to calculated. This should make it much more stable, if the datasource supplies it. (GoPro does, GPX not)
• 0.24.0
  • Big internal restructuring of metadata parsing. Will make it easier to import GYRO/ACCL data soon. Incidentally, should be a bit faster.
  • Hopefully no externally visible effects.
• 0.23.0
  • Rename --no-overlay to --overlay-only as it was too confusing
• 0.22.0
  • Filter points that have DOP too large.
• 0.21.0
  • Built-in support for 4k videos, with a supporting overlay. Feedback welcomed.
  • Use --overlay-size with --layout xml to use custom overlay sizes and layouts
  • Minor Bugfixes
• 0.20.0
  • Add "opacity" and "corner_radius" to maps xml components (H/T @KyleGW)
  • New Utility: gopro-cut.py - Extract a section of a GoPro recording, with metadata
• 0.19.0
  • Load custom XML layouts correctly on command line.
• 0.18.0
  • BUGFIX: pypi distribution was still broken. :-(
• 0.17.0
  • BUGFIX: pypi distribution was broken. :-(
• 0.16.0
  • Add support for degrees F for temp.
• 0.15.0
  • XML Layouts improved. Probably good/stable enough to make custom layouts
  • Include/Exclude named components using command line
• 0.14.0
  • Fix for some thunderforest themes (H/T @KyleGW)
  • XML layout support for vertical and colour text
• 0.13.0
  • Improved XML layout - text/metrics/unit conversions
• 0.12.0
  • New Utility: gopro-join.py - Join multiple GoPro files from a single session together
  • Improve Parsing Speed for GoPro Metadata
• 0.11.0
  • Allow XML layout definitions