Quick Guide

For those of you who don't need to know the exact details of the code, this quick guide should get the program working.

The requirements to directly run this code with no modifications are:
- A Debain based operating system such as Ubuntu.
- Python3 installed, which can be found here.
- GoLang installed which can be found here.

Firstly we need to make a directory for the Go tools, I have provided my own fork as it is updated to work with GoPro Hero 8 but ben-milanko can be substituted for stilldavid and it will work up to GoPro Hero 7.

mkdir -p $HOME/go/src/github.com/ben-milanko/ && cd $HOME/go/src/github.com/ben-milanko/

Next we need to clone the repo into the directory we just made.

git clone https://github.com/ben-milanko/gopro-utils.git

Then we will get and install the tools with Go commands.

go get github.com/ben-milanko/gopro-utils/bin/gopro2json &&
go install github.com/ben-milanko/gopro-utils/bin/gopro2json

Now that we have setup all the prerequisites we clone the repo...

cd ~/ &&
git clone https://github.com/ben-milanko/GoPro2ImageSequence.git &&
cd GoPro2ImageSequence

...and install any python packages.

pip3 install -r requirements.txt --user

Finally we need to place the .MP4 file into the same folder and run

python3 video2photo.py

The default distance between images is 10m (0.01km) which can be changed at the top of video2photo.py. Output will be placed in {vidFile}_output by default.
All images will have EXIF timestamps and GPS coordinates added back in.