{
 "schema_version": 1,
 "generated": "2026-10-31",
 "id": "systran-faster-whisper--make-word-level-subtitles-with-faster-whisper",
 "repo": "SYSTRAN/faster-whisper",
 "repo_url": "https://github.com/SYSTRAN/faster-whisper",
 "repo_slug": "systran-faster-whisper",
 "title": "Get word-level timestamps for subtitles and captions",
 "page_title": "How to get word-level timestamps for subtitles and captions with Faster Whisper",
 "summary": "Turn on word_timestamps so every word comes back with its own start and end time.",
 "who": "A video editor or creator who wants tightly synced captions or karaoke-style subtitles.",
 "problem": "Segment-level timestamps are too coarse for captions that highlight words as they are spoken.",
 "outcome": "A list of words with start and end times you can turn into SRT, VTT or animated captions.",
 "steps": [
  "Install with `pip install faster-whisper` and load a WhisperModel",
  "Transcribe with `model.transcribe(\"audio.mp3\", word_timestamps=True)`",
  "Loop over each segment and then over segment.words to read word.start, word.end and word.word",
  "Add `vad_filter=True` style filtering if long silences confuse the timing; by default the VAD only removes silence longer than 2 seconds",
  "Write the words out in your caption format of choice"
 ],
 "agent_prompt": "Using SYSTRAN/faster-whisper, transcribe <video audio file> with word_timestamps=True and the VAD filter on, then write an SRT file with one caption per short phrase and a JSON file of every word with its start and end time.",
 "agents": [
  "claude-code",
  "codex",
  "cursor"
 ],
 "difficulty": "Intermediate",
 "time": "30 minutes",
 "basis": "readme",
 "caveat": "The caption file format is up to you: Faster Whisper returns the timings, not an SRT writer.",
 "category": "Content",
 "tags": [
  "Content"
 ],
 "lang": "python",
 "requirements": [
  "Python 3.9 or greater",
  "No system FFmpeg needed: audio is decoded with PyAV",
  "For GPU: NVIDIA cuBLAS for CUDA 12 and cuDNN 9 for CUDA 12"
 ],
 "risk": "none",
 "seen_in_the_wild": false,
 "mentioned_publicly": false,
 "risks": [],
 "best": false,
 "score": 0.9,
 "evidence": [],
 "url": "https://dedupedai.com/use-cases/systran-faster-whisper/make-word-level-subtitles-with-faster-whisper/",
 "md": "https://dedupedai.com/use-cases/systran-faster-whisper/make-word-level-subtitles-with-faster-whisper/index.md",
 "disclaimer": "Deduped lists open-source repositories that belong to other people. We do not own, maintain, audit, or vouch for any of them, and a repo appearing here is not an endorsement or a safety check. The use cases, steps, and prompts are written by AI and may be incomplete, outdated, or just wrong. Where a use case is marked \"Seen in the wild\", we link to public posts where someone described something similar, but we have not verified those posts and the use case itself is still our AI's own write-up. Use all of this at your own risk. Only run code, commands, or agents on systems and accounts you are authorized to use, and read the code and every command before you run it, especially anything that touches credentials, files, or the network. Nothing here is professional, security, legal, or financial advice. All trademarks and project names belong to their respective owners, and their use here does not imply affiliation. Content is provided as is, without warranties of any kind. Found a mistake, a safety problem, or something you want removed? Email hello@dedupedai.com and we will look at it promptly.",
 "api": "https://dedupedai.com/api/v1/usecases/systran-faster-whisper--make-word-level-subtitles-with-faster-whisper.json",
 "api_version": "v1"
}