git404hub

what is shotcut-multicam-sync fr?

vitaly-zdanevich/shotcut-multicam-sync — explained in plain English

Analysis updated 2026-05-18

1PythonAudience · developerLicenseSetup · moderate

tl;dr

A command line tool that automatically syncs multicam video footage to a master audio track and builds a ready-to-edit Shotcut project.

vibe map

mindmap
  root((shotcut-multicam-sync))
    What it does
      Syncs multicam footage
      Builds Shotcut project
      Flags low confidence clips
    Tech stack
      Python
      NumPy
      FFmpeg
    Use cases
      Multicam video editing
      Automatic timeline sync
      Confidence reporting
    Audience
      Video editors
      Developers
      Content creators

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Automatically sync footage from multiple cameras to a master audio recording without manual scrubbing.

VIBE 2

Generate a ready-to-open Shotcut project with one video track per camera folder.

VIBE 3

Spot-check clips flagged with low confidence instead of manually syncing every clip.

what's the stack?

PythonNumPyFFmpeg

how it stacks up fr

vitaly-zdanevich/shotcut-multicam-sync0xustaz/streamgatea-bissell/unleash-lite
Stars111
LanguagePythonPythonPython
Setup difficultymoderatehardhard
Complexity4/54/5
Audiencedeveloperdeveloperresearcher

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · moderate time til it works · 30min

Needs Python 3.11+, numpy, and ffmpeg/ffprobe available on your PATH.

in plain english

shotcut-multicam-sync is a small command line tool for video editors who film the same event with multiple cameras. If you have recorded one master audio track alongside video from several separate cameras, this tool automatically lines everything up in time and produces a ready to open project file for the free video editor Shotcut. Normally, matching up footage from different cameras by hand means scrubbing through each clip and guessing where it should sit on the timeline. This tool does that work for you. It works in a few steps. First it looks at the creation time saved inside each video file to get a rough starting position, accounting for the fact that iPhones and Android phones record this timestamp differently. Then it compares the audio waveform of each clip against the master audio recording to find the exact matching moment, correcting for the fact that camera clocks often drift by a few seconds. If a clip's timestamp is missing or the match is weak, it searches the entire master recording instead. Clips that still cannot be matched with confidence are left out of the final project with a warning, rather than being placed in the wrong spot, though there is an option to include them anyway. To run it, you point the tool at your master audio file and one or more folders of video clips, and it writes out a Shotcut project file where each folder becomes its own video track, already synced to the master audio. The tool also prints out how confident it was about each clip's placement, so you can spot anything that might need a manual check afterward. Using it requires a recent version of Python, the numpy library, and having ffmpeg installed on your computer, since the tool relies on it to read and analyze the audio and video files. It is a small, focused utility rather than a full editing application, and it is released under the MIT license, meaning it is free to use for any purpose.

prompts (copy fr)

prompt 1
Show me the exact command to sync footage from two camera folders against a master audio file using this tool.
prompt 2
Explain how the waveform cross-correlation sync method works in shotcut-multicam-sync.
prompt 3
Help me install the requirements for shotcut-multicam-sync, including ffmpeg and numpy.
prompt 4
What do the --window and --min-z options control, and when should I change them?

Frequently asked questions

what is shotcut-multicam-sync fr?

A command line tool that automatically syncs multicam video footage to a master audio track and builds a ready-to-edit Shotcut project.

What language is shotcut-multicam-sync written in?

Mainly Python. The stack also includes Python, NumPy, FFmpeg.

How hard is shotcut-multicam-sync to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is shotcut-multicam-sync for?

Mainly developer.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.