Add .360 video mode (MAX)

[himynamesdave]

Currently we suppport .mp4 video mode.

GoPro MAX cameras also produce a .360 video format.

For GoPro MAX Unprocessed Video mode (.360):

1. takes GoPro .360 video (equirectangular) with GPMF data
2. converts to an equirectangular frames
3. optionally adds a nadir to the resulting video
4. stores output/uploads output/etc

GoPro2GSV validates .360 inputs before processing as follows;

• file extension must be .360
• filenames must start with GS
• GoPro:Model is GoPro Max
• trackN:MetaFormat is gpmd
• trackN:GPSDateTime has more than 10 entries.

Where trackN is the track that contains the gpmd telemetry.

For processing, the same flags as .mp4 video mode can be used, and the processing is somewhat similar to mp4.

ffmpeg first extracts frames. However, these frames need to be converted to equirectangular projection (because GoPro .360 is EAC format).

We already have some old code to join

• Tool: https://github.com/trek-view/max2sphere
• Example implementation in another tool: https://github.com/trek-view/gopro2frames/blob/main/docs/LOGIC.md#7a-max2sphere-flow-2-gopro-eax-frames

Note: resusing code is fine, but do not copy the whole codebase of this implementation.

After this, the GPS points are then embedded to the equirectangular images (same as #26) and the final video is processed in the same way as the image->video pipeline including the new function; https://github.com/trek-view/gopro2gsv/issues/25

[fqrious]

about this, should I require a path to max2sphere binary or should I assume the user has this fork of ffmpeg

[himynamesdave]

@fqrious ask for max2sphere binary (ideally clone it on install as a gitmodule). This is what https://github.com/trek-view/gopro2frames does

[himynamesdave]

closing, will raise individual issue separately