Media Subtitle Sync

Context: $ARGUMENTS

Quick start

• Out-of-sync SRT, clean webrip: → Step 3 (ffsubsync, fast VAD+FFT)
• TV recording with commercial breaks: → Step 3 (alass, scene-split aware)
• Foreign-language sub to aligned reference sub: → Step 3 (sync-reference)
• Simple constant offset (e.g. "shift +3.5s"): → Step 3 (shift)
• Season folder of mismatched subs: → Step 3 (batch-sync)

When to use

• Subtitle file is progressively drifting from audio (framerate mismatch)
• Subtitle has a constant shift (intro/ad removed, shifted start)
• Commercial-break splits broke timing (TV caps on streaming source)
• You have a known-good sub in another language — use it as reference timing
• Need to auto-align an entire season with one command