# 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.

- Skill: `agentskillexchange/ffsubsync-subtitle-synchronization-tool` (Agent Skill)
- Install (CLI): `npx skillmds@latest add agentskillexchange/ffsubsync-subtitle-synchronization-tool`
- Raw SKILL.md: https://api.skillmd.com/api/skills/agentskillexchange/ffsubsync-subtitle-synchronization-tool/raw
- Safety review: pending (external: skill-scanner PASS, skillspector CAUTION)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: agentskillexchange (https://skillmd.com/u/agentskillexchange)
- Updated: 2026-09-08
- Page: https://skillmd.com/skills/agentskillexchange/ffsubsync-subtitle-synchronization-tool

---


# 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:
- [![Python Versions](https://img.shields.io/pypi/pyversions/ffsubsync.svg)](https://pypi.org/project/ffsubsync)
- Next, grab the package (compatible with Python >= 3.6):
- [ffmpeg](https://www.ffmpeg.org/) and the [ffmpeg-python](https://github.com/kkroening/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](https://agentskillexchange.com/skills/ffsubsync-subtitle-synchronization-tool/)