skelly-synchronize 2023.2.1004

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.

How to run

Synchronize your videos by setting the path to your freemocap data folder, your sessionID, and the file types of your videos into main.py, then run the file. The sessionID should be the name of a subfolder of your freemocap data folder, and should contain a subfolder called RawVideos containing the videos that need synching.

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.

Installation

When this package reaches a point of semi-stable development, it will be pip installable. For now, clone this repository and pip install the requirements.txt file.

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
3. Videos must have overlapping audio from the same real world event
4. Videos must be in a folder titled "RawVideos", with no other videos in the folder

Expected File Structure

To function correctly, Skelly Synchronize expects the following folder structure:

freemocap_data_folder:
    sessionID:
        RawVideos:
            Cam0.mp4
            Cam1.mp4
            ...
    ...

The camera names can be changed, and the file format may changed as well, although freemocap currently only uses .mp4.