1.0 #1
vulkan101
announced in
Announcements
1.0
#1
Replies: 0 comments
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Uh oh!
There was an error while loading. Please reload this page.
First release.
GoPro MAX splits long recordings into ~4GB chapter files. Stitch360 joins them back into one continuous
.360— losslessly, and in a form GoPro Player still opens and renders as a proper pannable 360 view.Install
Download
Stitch360-v0.1.0-win64.zip, unzip it anywhere, runStitch360.exe. FFmpeg is bundled; nothing else to install.What it does
<recording>_stitched.360Nothing is re-encoded. It's a container-level stream copy, so it's fast and doesn't touch a pixel.
What survives the join
Both fisheye video tracks, both audio tracks (compressed stereo and the raw 4-channel ambisonic track), and the GPS/gyro telemetry (GPMF).
Also — and this took the most work — the camera's own metadata block. FFmpeg keeps only the
moov/udtachildren it recognises, so GoPro's 26KB block (LENSlens calibration,CAMEcamera identity,FIRM,SETT, plus a 25KBGPMFblob) was being replaced by a 33-byte stub holding FFmpeg's encoder tag. GoPro Player reads that block to know how to warp the two circular lens images into the 360 view, so without it you get flat, apparently-rotated playback of a single raw lens — even though every stream and timestamp is perfect. Stitch360 transplants it back as the final step of every join.Two more things it guards against, both found on real footage rather than in theory:
Known limitations
tmcdandfdscauxiliary tracks are dropped. They carry no telemetry and FFmpeg cannot mux them — their codec is unresolvable even in the untouched original..360footage. Other GoPro models use the same chapter convention and will likely work, but are unverified.License
Stitch360 is under the PolyForm Noncommercial License 1.0.0 — free for personal, hobby, research, educational and charitable use. Commercial use needs permission; open an issue and ask.
The bundled FFmpeg is separately licensed under GPL v3 and your rights to it are unaffected — see THIRD-PARTY-LICENSES.md for source links and the full text. If you'd rather not receive GPL binaries, delete the bundled
_internal/ffmpeg/folder and the app will use an FFmpeg you install yourself.This discussion was created from the release 1.0.
All reactions