skelly-synchronize 2023.6.1018

Basic template of a python repository

Skelly Synchronize

This package synchronizes a set of videos of the same event by cross-correlating their audio files. The videos will be synchronized so that they all start at the earliest shared time, and end at the latest shared time.

Install and Run

Skelly_synchronize can be installed through pip by running pip install skelly_synchronize in your terminal. Once it has installed, it can be run with the command python -m skelly_synchronize. While running, the GUI window may appear frozen, but the terminal should show the progress. Large videos may take a significant amount of time.

Skelly_synchronize currently depends on FFmpeg, a command line tool that handles the video files. If you do not have FFmpeg downloaded, you will need to install it separately. You can download FFmpeg here: https://ffmpeg.org/download.html

Video Requirements

The following requirements must be met for the script to function:

1. Videos must have audio
2. Videos must be in the same file format (default is ".mp4")
3. Videos must have the exact same framerate (frames per second). There are often slight differences between brands/models of camera that lead to one camera's "60 fps" being different from another's. If your frame rates do not match, an error will be thrown.
4. Videos must have the same audio sample rate. Most cameras record either 44100 or 48000 Hz, so there are not as much variation in audio sample rates as there are in video framerates.
5. All videos in folder must have overlapping audio from the same real world event

Downsampling

If you video frame rates or audio sample rates do not match, it is possible to downsample them in a separate tool like VLC to have matching frame rates and sample rates. This must be done before trying to synchronize the videos using skelly_synchronize.

How to run from source

First clone this repository and pip install the requirements.txt file.

Synchronize your videos by setting the path to your folder of raw videos and the file types of your videos into skelly_synchronize.py, lines 343-344, then run the file.

The terminal output while running should look like this:

A SyncedVideos folder will be created in the session folder and filled with the synchronized video files. The session folder will also have an AudioFiles folder containing audio files of the raw videos, which are used in processing.