Skip to content

Latest commit

 

History

History
185 lines (149 loc) · 7.1 KB

README.md

File metadata and controls

185 lines (149 loc) · 7.1 KB
Raw

Go Pro Merge

pipeline status

Merge Go Pro generated chaptered files into a single file

Demo

Demo

Directory tree before:

❯ tree                                                                                                                                                00:41:57
.
└── raw
    ├── GH010307.MP4
    ├── GH010308.MP4
    ├── GH010309.MP4
    ├── GH010310.MP4
    ├── GH010314.MP4
    ├── GH010315.MP4
    ├── GH010316.MP4
    ├── GH010317.MP4
    ├── GH010318.MP4
    ├── GH020308.MP4
    ├── GH020314.MP4
    ├── GH020316.MP4
    ├── GH020317.MP4
    ├── GH030314.MP4
    ├── GH030316.MP4
    ├── GH030317.MP4
    ├── GH030318.MP4
    ├── GH040317.MP4
    ├── GH040318.MP4
    ├── GH050317.MP4
    ├── GH050318.MP4
    ├── GH060317.MP4
    ├── GH060318.MP4
    ├── GOPR0311.JPG
    ├── GOPR0312.JPG
    └── GOPR0313.JPG

1 directory, 26 files

Directory tree after:

❯ tree                                                                                                                                                00:42:02
.
├── GH000307.MP4
├── GH000308.MP4
├── GH000309.MP4
├── GH000310.MP4
├── GH000314.MP4
├── GH000315.MP4
├── GH000316.MP4
├── GH000317.MP4
├── GH000318.MP4
└── raw
    ├── GH010307.MP4
    ├── GH010308.MP4
    ├── GH010309.MP4
    ├── GH010310.MP4
    ├── GH010314.MP4
    ├── GH010315.MP4
    ├── GH010316.MP4
    ├── GH010317.MP4
    ├── GH010318.MP4
    ├── GH020308.MP4
    ├── GH020314.MP4
    ├── GH020316.MP4
    ├── GH020317.MP4
    ├── GH030314.MP4
    ├── GH030316.MP4
    ├── GH030317.MP4
    ├── GH030318.MP4
    ├── GH040317.MP4
    ├── GH040318.MP4
    ├── GH050317.MP4
    ├── GH050318.MP4
    ├── GH060317.MP4
    ├── GH060318.MP4
    ├── GOPR0311.JPG
    ├── GOPR0312.JPG
    └── GOPR0313.JPG

1 directory, 35 files

Supported cameras and file formats

The tables have been built from the following GoPro Camera File Naming Convention page.

HERO10 Black, HERO9 Black, HERO6 Black, & HERO7 (White, Silver, Black), HERO8 Black

Recording type Example Supported
Single Video GH011234.mp4,GX011234.mp4 ✅
Chaptered Video GH011234.mp4,GH021234.mp4 ✅
Looping Video GHAA0001.mp4,GHAA0002.mp4 ✅

Max 360

Recording type Example Supported
Video GS012345.360 ❌
TimeWarp GS012345.360 ❌
Photo GS_1234.jpeg ❌
PowerPano GP_1234.jpeg ❌

Max HERO

Recording type Example Supported
Video GH012345.mp4 ❌
TimeWarp GH012345.mp4 ❌
Photo GS_1234.jpeg ❌
TimeLapse Video GH012345.mp4 ❌
TimeLapse Photo GPAA_1234.jpeg ❌

Fusion

Recording type Example Supported
Single Video GPFR0001.mp4 ❌
Chaptered Video GPFR0002.mp4,GF010002.mp4,GPBK0002.mp4,GB010002.mp4 ❌
Single Photo GPFR0003.mp4,GPBK0004.mp4 ❌

HD HERO2, HERO3, HERO3+, HERO (2014), HERO Session, HERO4, HERO5 Black, HERO5 Session, HERO (2018)

Recording type Example Supported
Single Video GOPR1234.mp4 ❌
Chaptered Video GOPR1234.mp4,GP011234.mp4,GP021234.mp4 ❌
Single Photo GOPR0002.jpg ❌
Burst, Time-Lapse Photo, Looping Video G0231111.jpg – G0231120.jpg, G0241121.jpg – G0241221.jpg ❌
3D Recording 3D_L0002.mp4,3D_R0002.mp4,3D_L1234.jpg,3D_R1234.jpg ❌

Usage

❯ gopro-merge --help                                                                                                                                  01:02:58
gopro-merge 0.1.0

USAGE:
    gopro-merge [OPTIONS] [ARGS]

FLAGS:
    -h, --help       Prints help information
    -V, --version    Prints version information

OPTIONS:
    -p, --parallel <parallel>    The amount of parallel movies to be merged. [default: amount of cores]
    -r, --reporter <reporter>    The reporter to be used for progress one of "json" | "progressbar" [default:
                                 progressbar]

ARGS:
    <input>     Directory where to read movies from. [default: current directory]
    <output>    Directory where to write merged movies. [default: <input>]

Debugging

Set RUST_LOG=debug and follow the logs as well as ffmpeg stderr output log files:

[2021-11-14T23:15:25Z DEBUG gopro_merge::merge::ffmpeg::merger] setting progress len for GH000307.MP4 to 0 seconds
[2021-11-14T23:15:25Z DEBUG gopro_merge::merge::ffmpeg::command] Creating ffmpeg command with args ["-f", "concat", "-safe", "0", "-y", "-i", "/var/folders/11/7dvgz63d6rd047j_7vc854400000gn/T/.0307.txt", "-c", "copy", "/<FULL_PATH>/GH000307.MP4", "-loglevel", "error", "-progress", "pipe:1"]
[2021-11-14T23:15:25Z INFO  gopro_merge::merge::ffmpeg::command] creating ffmpeg stderr file at /var/folders/11/7dvgz63d6rd047j_7vc854400000gn/T/.ffmpeg_stderr_GH000307.MP4.log
[2021-11-14T23:15:25Z DEBUG gopro_merge::merge::ffmpeg::merger] updating progress for GH000307.MP4 to 0 seconds

Installation

No prebuilt binaries are available. Install cargo and then install this repo with cargo install:

  1. https://www.rust-lang.org/tools/install
  2. cargo install --git https://gitlab.com/gngeorgiev/gopro-merge
  3. Install ffmpeg, it should also include ffprobe. Both binaries should be in your $PATH

License

MIT