skelly-synchronize 2023.2.1005

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.

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. All videos in folder must have overlapping audio from the same real world event

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.