Ffsubsync Subtitle Synchronization Tool

---
name: "ffsubsync Subtitle Synchronization Tool"
slug: "ffsubsync-subtitle-synchronization-tool"
description: "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."
github_stars: 7659
verification: "security_reviewed"
source: "https://github.com/smacke/ffsubsync"
author: "smacke"
category: "Media & Transcription"
framework: "Multi-Framework"
tool_ecosystem:
  github_repo: "smacke/ffsubsync"
  github_stars: 7659
---

# 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/)