ffsubsync Subtitle Synchronization Tool

ffsubsync automatically aligns subtitle files to spoken audio by analyzing timing from a reference video or audio file. It is a strong fit for agent workflows that need to repair drifting subtitles without manual waveform editing.

Installation

Use the upstream install or setup path that matches your environment:

• brew install ffmpeg
• pip install ffsubsync
• pip install git+https://github.com/smacke/ffsubsync@latest

Requirements and caveats from upstream:

• 
• Next, grab the package (compatible with Python >= 3.6):
• ffmpeg and the ffmpeg-python wrapper, for extracting raw audio from video

Basic usage or getting-started notes:

---

• First, make sure ffmpeg is installed. On MacOS, this looks like:
• Source: https://github.com/smacke/ffsubsync
• Extracted from upstream docs: https://raw.githubusercontent.com/smacke/ffsubsync/HEAD/README.md

Source

• Agent Skill Exchange