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