Skip to main content

Python command line for syncing audio video recordings with YaLTC tracks.

Project description


Warning: this is at pre-alpha stage (crappy code ahead)

dualsoundsync is a python command to sync audio and video files shot with dual system sound using a specific hardware timecode generator called the atomicsynchronator. The timecode is called YaLTC for yet another longitudinal time code and should be recorded on a scratch track on each device for the syncing to be performed.


$ pip install dualsoundsync


Apart from dependencies installed by pip, you'll need a running ffmpeg installation on your PATH.


The command takes one argument: the folder containing all the files from the camera and from the audio recoder. Those recordings should contain an AUX audio track with encoded YaLTC

$ dualsoundsync <path to rushes folder>

If you want to try it out but don't have yet built your own atomicsynchronator, you can download some sample files with YaLTC from the repo.



Some stdout outputs will be written (time is UTC):

scanning rushes_folder
splitting audio from video...
splitting audio R and L channels
trying to decode YaLTC in audio files
1 of 4: nope
2 of 4: ZOOM_Rchan.wav started at 2021-10-13 01:45:08.263145+00:00
3 of 4: nope
4 of 4: fuji_a_Lchan.wav started at 2021-10-13 01:45:14.361967+00:00
looking for time overlaps forming pairs...
joining back synced audio to video: dualsoundsync/synced/fuji.mp4

Folder and files created

A logfile named out.txt with loguru messages is dumped in the current directory. Inside the rushes_folder those nested subdirectories are created:

  • dualsoundsync/split/ contains all audio split into Right and Left channels and video files split from their audio.
  • dualsoundsync/synced/ contains video files with their synced sound track.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Built Distribution

dualsoundsync-0.1.4a4-py3-none-any.whl (18.8 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page