goodlifeinc / gopro-telemetry-dashware-formatter

extracts telemetry data from videos shot on GoPro models with GPS and accelerometer logging and formats for use in DashWare.

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

gopro-telemetry-dashware-formatter

GPTDF extracts and formats telemetry data from videos shot on GoPro models with GPS and accelerometer logging. It uses gpmf-extract and gopro-telemetry for copying the data stream from the video and ffmpeg to compress the original video for processing.

Also included are templates for using the extracted data for gauge overlays within DashWare.

gopro video with gauge overlays

Installation

Using a release

You will need ffmpeg in your path. A guide to do so can be found here.

Download and extract a release, install ffmpeg, and drag a video from your GoPro onto the script.

The telemetry CSV will appear in the same folder as the input video. This will work for videos copied directly from the camera as well as videos imported via Quik - it will not work for videos already edited in Quik, though, so you'll need to do trimming after the videos have been imported into DashWare.

Building via source

Alternatively, if you would prefer to work on the source you can build the script locally. Use the package manager npm to install the requirements.

npm install

If you intend to drag video files onto the script, you'll also need pkg installed to build the script into a binary executable.

# Install pkg globally
npm install -g pkg
# Build the script
pkg index.js -o gptdf

Usage

If you have compiled the script into a binary or have downloaded an exe release, just drag a video directly from the GoPro onto the script.

In DashWare, import the data format XMLs from the download or source folder. Create a new project, add your video file, add the CSV file and select the data format you just imported, go to the synchronization tab and check the box.

To run from command line:

node .\index.js   'e:\folder\folder2\folder with spaces\filename.MP4'

Contributing

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.

License

MIT

About

extracts telemetry data from videos shot on GoPro models with GPS and accelerometer logging and formats for use in DashWare.


Languages

Language:JavaScript 100.0%