smacke/subsync
Subsync
Subsync is a subtitle synchronization tool that aligns subtitle timing to video audio tracks or other synchronized subtitle files. It functions as an audio-based aligner and timing validator to ensure dialogue and captions match during playback.
The system utilizes audio-text cross-correlation to match voice activity peaks in audio tracks against subtitle timestamps. It includes a remote media sync client that retrieves files from external servers using standard network protocols for local processing.
To ensure accuracy, the tool calculates confidence scores to block updates that fall below a quality threshold or contain implausible time offsets. Processing efficiency is managed through segment-based audio sampling and duration limits to reduce analysis time for long files.
The core logic can be driven through programmatic interfaces and monitored via callback handlers.
Features
- Subtitle Synchronization - Aligns subtitles to a video by matching voice activity in the audio track with the timing of the text.
- Audio-Text Cross-Correlation - Matches voice activity peaks in audio tracks against subtitle timestamps to calculate timing offsets.
- Media Post-Processing Utilities - Provides automated tools to fix timing issues in video files and subtitles across large media collections.
- Alignment - Calculates mathematical alignment scores to prevent subtitle updates that fall below a quality threshold.
- Synchronization Quality Validation - Prevents subtitle modifications when the alignment score is too low or the time offset is implausible.
- Timing Validation - Calculates alignment scores to ensure subtitle synchronization is accurate before applying modifications.
- Performance Optimization - Reduces processing time for long files by sampling specific segments or limiting the analysis duration.
- Audio Segmentation Utilities - Reduces analysis time by processing specific time windows of audio instead of the full duration.
- Media Automation - Tool for automatically synchronizing subtitles with video.
- Audio and Subtitle Tools - Tool to automatically synchronize subtitles with video.
