Communitygithub.com

ffmpeg-captions-subtitles

Vollständiges Untertitel- und Caption-System für FFmpeg 7.1 LTS und 8.0.1 (aktuelles stabiles Release, veröffentlicht am 20.11.2025). Proaktiv einsetzen für: (1) Einbrennen von Untertiteln (SRT/ASS/VTT), (2) Hinzufügen von weichen Untertitelspuren, (3) Extrahieren von Untertiteln aus Videos, (4) Konvertierung von Untertitelformaten, (5) Gestaltete Captions (Schriftart, Farbe, Umrandung, Schatten), (6) Untertitel-Positionierung und -Ausrichtung, (7) CEA-608/708 Closed Captions, (8) Texteinblendungen mit drawtext, (9) Whisper AI automatische Transkription (FFmpeg 8.0+ mit VAD, mehrsprachig, GPU), (10) Stapelverarbeitung von Untertiteln. Bietet: Format-Referenztabellen, Style-Parameter-Leitfaden, Positionierungs-Ausrichtungstabellen, Whisper-Modellvergleich, VAD-Konfiguration, dynamische Textbeispiele, Best Practices zur Barrierefreiheit. Gewährleistet: Professionelle Captions mit korrektem Styling und Einhaltung der Barrierefreiheitsstandards.

Was ist ffmpeg-captions-subtitles?

Diese umfassende FFmpeg-Fähigkeit ist die zentrale Anlaufstelle für sämtliche Untertitel- und Caption-Aufgaben in den Versionen FFmpeg 7.1 LTS und 8.0.1 (Stand 2025). Sie deckt alle gängigen Workflows ab: das Einbrennen (Hardcoding) von SRT-, ASS- und VTT-Untertiteln, das Hinzufügen als weiche Spuren in MP4- und MKV-Container, das Extrahieren von Untertiteln aus Video-Streams sowie die Konvertierung zwischen Formaten (z. B. SRT ↔ ASS ↔ WebVTT). Darüber hinaus bietet sie eine detaillierte Referenz für das Styling von Untertiteln mittels ASS-Parametern (Schriftart, Farbe, Umrandung, Schatten), die präzise Positionierung auf dem Bildschirm (über das 9-Feld-Raster), die Textanimation mit drawtext und die Integration des Whisper-KI-Transkriptionssystems zur automatischen Generierung von Untertiteln aus Sprache (inkl. VAD-Unterstützung). Durch die strukturierte Aufbereitung – mit Beispielbefehlen für Einzel- und Stapelverarbeitung, Tabellen zu Farbformaten und Positionierungen sowie Troubleshooting-Hinweisen – spart sie Entwicklern und Betreibern wertvolle Zeit und sorgt für professionelle, barrierefreie Ergebnisse.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Biel-developer/skills-videos/tree/HEAD/skills/ffmpeg-captions-subtitles

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

KRITISCHE RICHTLINIEN

Windows-Dateipfad-Anforderungen

VERPFLICHTEND: Verwenden Sie unter Windows immer Backslashes () für Dateipfade, KEINE einfachen Schrägstriche (/).

Wenn Sie unter Windows Edit- oder Write-Tools verwenden, MÜSSEN Sie Backslashes (\) in Dateipfaden verwenden, NICHT einfache Schrägstriche (/).

Dokumentationsrichtlinien

Erstellen Sie NIEMALS neue Dokumentationsdateien, es sei denn, der Benutzer fordert explizit dazu auf.


Kurzreferenz

AufgabeBefehl
SRT einbrennenffmpeg -i video.mp4 -vf "subtitles=subs.srt" output.mp4
ASS einbrennenffmpeg -i video.mp4 -vf "ass=subs.ass" output.mp4
Weichen Untertitel hinzufügenffmpeg -i video.mp4 -i subs.srt -c copy -c:s mov_text output.mp4
Untertitel extrahierenffmpeg -i video.mkv -map 0:s:0 output.srt
Untertitel stylen-vf "subtitles=s.srt:force_style='FontSize=24,PrimaryColour=&HFFFFFF'"
Texteinblendung-vf "drawtext=text='Hallo':x=10:y=10:fontsize=24:fontcolor=white"
FormatErweiterungAm besten geeignet für
SRT.srtEinfach, universell
ASS.assGestylt, animiert, Anime
VTT.vttWeb/HTML5-Video

Wann diese Fähigkeit einsetzen

Verwenden Sie diese für Untertitel- und Caption-Operationen:

  • Einbrennen (Hardcoding) von Untertiteln in Videos
  • Hinzufügen von weichen Untertitelspuren zu Containern
  • Extrahieren von Untertiteln aus MKV/MP4
  • Styling von Captions (Schriftart, Farbe, Position)
  • Dynamische Texteinblendungen

FFmpeg Captions und Subtitles (2025)

Vollständiger Leitfaden für die Arbeit mit Untertiteln, Closed Captions und Texteinblendungen unter Verwendung von FFmpeg.

Untertitel-Format-Referenz

Unterstützte Formate

FormatErweiterungFunktionenAnwendungsfall
SubRip.srtEinfaches Timing + TextUniversell, Web
Advanced SubStation Alpha.ass/.ssaUmfangreiches Styling, Positionierung, EffekteAnime, gestylte Untertitel
WebVTT.vttWebstandard, Hinweise, StylingHTML5-Video
TTML/DFXP.ttml/.dfxpRundfunk, BarrierefreiheitStreaming-Dienste
MOV Text.mov (eingebettet)QuickTime nativApple-Ökosystem
DVB Untertitel(eingebettet)Bitmap-basiertEuropäischer Rundfunk
PGS.supBlu-ray Bitmap-UntertitelBlu-ray
CEA-608/708(eingebettet)Closed CaptionsUS-Rundfunk, Streaming

Formatcharakteristiken

SRT (SubRip):
- Einfaches textbasiertes Format
- Unterstützt grundlegende HTML-Tags (<b>, <i>, <u>)
- Weitgehend kompatibel
- Keine Positionierung oder erweitertes Styling

ASS/SSA:
- Erweitertes Styling (Schriftarten, Farben, Umrandungen)
- Präzise Positionierung an jeder Stelle auf dem Bildschirm
- Unterstützung für Animationen und Effekte
- Karaoke-Timing

WebVTT:
- HTML5-Standardformat
- CSS-ähnliches Styling
- Hinweiseinstellungen für Positionierung
- Sprecheridentifikation

Untertitel einbrennen (Hardcoding)

Grundlegendes Einbrennen von Untertiteln

# SRT-Untertitel einbrennen
ffmpeg -i video.mp4 -vf "subtitles=subs.srt" output.mp4

# ASS/SSA-Untertitel einbrennen (Styling bleibt erhalten)
ffmpeg -i video.mp4 -vf "ass=subs.ass" output.mp4

# Untertitel aus MKV-Container einbrennen
ffmpeg -i video.mkv -vf "subtitles=video.mkv" output.mp4

# Bestimmte Untertitelspur einbrennen (Index 0)
ffmpeg -i video.mkv -vf "subtitles=video.mkv:si=0" output.mp4

# Untertitel mit Stream-Index einbrennen
ffmpeg -i video.mkv -vf "subtitles=video.mkv:stream_index=1" output.mp4

Stilvolles Einbrennen von Untertiteln

# Stil erzwingen (überschreibt Untertitel-Styling)
ffmpeg -i video.mp4 \
  -vf "subtitles=subs.srt:force_style='FontName=Arial,FontSize=24,PrimaryColour=&HFFFFFF,OutlineColour=&H000000,Outline=2,Shadow=1'" \
  output.mp4

# Gelbe Untertitel mit schwarzer Umrandung
ffmpeg -i video.mp4 \
  -vf "subtitles=subs.srt:force_style='FontSize=28,PrimaryColour=&H00FFFF,OutlineColour=&H000000,Outline=3'" \
  output.mp4

# Größere Schriftart für Barrierefreiheit
ffmpeg -i video.mp4 \
  -vf "subtitles=subs.srt:force_style='FontSize=36,Bold=1'" \
  output.mp4

ASS-Style-Parameter

ParameterBeschreibungBeispiel
FontNameSchriftfamilieFontName=Arial
FontSizeGröße in PunktFontSize=24
PrimaryColourTextfarbe (AABBGGRR)PrimaryColour=&HFFFFFF
SecondaryColourKaraoke-FarbeSecondaryColour=&H00FFFF
OutlineColourUmrandungs-/RandfarbeOutlineColour=&H000000
BackColourSchatten-/HintergrundfarbeBackColour=&H80000000
BoldFetter Text (0/1)Bold=1
ItalicKursiver Text (0/1)Italic=1
UnderlineUnterstrichener Text (0/1)Underline=1
OutlineUmrandungsbreiteOutline=2
ShadowSchattentiefeShadow=1
AlignmentPosition (Nummernblock-Stil)Alignment=2
MarginL/R/VRänder in PixelnMarginV=50

Farbformat (ASS)

ASS verwendet das Format &HAABBGGRR (Alpha, Blau, Grün, Rot):
- Weiß: &HFFFFFF oder &H00FFFFFF
- Schwarz: &H000000 oder &H00000000
- Gelb: &H00FFFF (00-Blau, FF-Grün, FF-Rot)
- Rot: &H0000FF
- Blau: &HFF0000
- 50 % transparentes Schwarz: &H80000000

Hinzufügen von Untertitelspuren (weiche Untertitel)

SRT als Spur einbetten

# SRT zu MP4 hinzufügen (MOV-Text)
ffmpeg -i video.mp4 -i subs.srt \
  -c copy -c:s mov_text \
  output.mp4

# SRT zu MKV hinzufügen
ffmpeg -i video.mp4 -i subs.srt \
  -c copy -c:s srt \
  output.mkv

# SRT zu WebM hinzufügen (WebVTT)
ffmpeg -i video.webm -i subs.srt \
  -c copy -c:s webvtt \
  output.webm

Mehrere Untertitelspuren

# Mehrere Sprachen hinzufügen
ffmpeg -i video.mp4 -i subs_en.srt -i subs_es.srt -i subs_fr.srt \
  -map 0:v -map 0:a -map 1 -map 2 -map 3 \
  -c copy -c:s mov_text \
  -metadata:s:s:0 language=eng -metadata:s:s:0 title="Englisch" \
  -metadata:s:s:1 language=spa -metadata:s:s:1 title="Spanisch" \
  -metadata:s:s:2 language=fra -metadata:s:s:2 title="Französisch" \
  output.mp4

# ASS-Untertitel zu MKV hinzufügen (Styling bleibt erhalten)
ffmpeg -i video.mp4 -i styled.ass \
  -map 0 -map 1 \
  -c copy -c:s ass \
  output.mkv

Standard-Untertitelspur festlegen

# Untertitel als Standard festlegen
ffmpeg -i video.mp4 -i subs.srt \
  -c copy -c:s mov_text \
  -disposition:s:0 default \
  output.mp4

# Forcierte Untertitel festlegen (immer anzeigen)
ffmpeg -i video.mp4 -i forced.srt \
  -c copy -c:s mov_text \
  -disposition:s:0 forced \
  output.mp4

Extrahieren von Untertiteln

In externe Datei extrahieren

# Erste Untertitelspur in SRT extrahieren
ffmpeg -i video.mkv -map 0:s:0 output.srt

# Bestimmten Untertitel-Stream extrahieren
ffmpeg -i video.mkv -map 0:s:1 output.srt

# In ASS-Format extrahieren
ffmpeg -i video.mkv -map 0:s:0 output.ass

# In WebVTT extrahieren
ffmpeg -i video.mkv -map 0:s:0 output.vtt

# Alle Untertitelspuren extrahieren
ffmpeg -i video.mkv -map 0:s subs_%d.srt

Verfügbare Untertitelspuren auflisten

# Alle Streams einschließlich Untertitel anzeigen
ffprobe -v error -show_entries stream=index,codec_name,codec_type:stream_tags=language,title \
  -of csv=p=0 video.mkv

# Nur Untertitel-Streams anzeigen
ffprobe -v error -select_streams s \
  -show_entries stream=index,codec_name:stream_tags=language,title \
  -of csv=p=0 video.mkv

Untertitelformate konvertieren

# SRT in ASS
ffmpeg -i subs.srt subs.ass

# ASS in SRT (Styling geht verloren)
ffmpeg -i subs.ass subs.srt

# SRT in WebVTT
ffmpeg -i subs.srt subs.vtt

# WebVTT in SRT
ffmpeg -i subs.vtt subs.srt

drawtext-Overlays und Whisper-KI-Integration

Detaillierte Beispiele für drawtext-Overlays (Schriftarten, Positionierung, Maskierung, Zeitausdrücke, Boxen, Umrandungen, animierter Text) und Whisper-KI-Transkriptions-/Untertitelgenerierungs-Workflows befinden sich in references/drawtext-and-whisper.md. Laden Sie diese Referenz, wenn Sie eingebrannte Textgrafiken erstellen oder Untertitel aus Sprache generieren möchten.

CEA-608/708 Closed Captions

Closed Captions extrahieren

# CEA-608-Captions aus ATSC-Stream extrahieren
ffmpeg -f lavfi -i "movie=broadcast.ts[out0+subcc]" -map 0:1 captions.srt

# Aus Video mit eingebetteten CC extrahieren
ffmpeg -i video_with_cc.mp4 \
  -filter_complex "[0:v]format=yuv420p[v];[0:v]crop=1:1:0:0[c]" \
  -map "[c]" -c:v libx264 -f null - 2>&1 | grep -A 1 "Closed caption"

CEA-608-Captions hinzufügen

# CEA-608-Captions einbetten (erfordert eia608-Zeile)
ffmpeg -i video.mp4 -i captions.scc \
  -c:v libx264 -c:a copy \
  -vf "movie=captions.scc[captions];[0:v][captions]overlay" \
  output.mp4

Untertitel-Positionierung

ASS-Ausrichtungswerte

7 (oben-links)     8 (oben-mitte)     9 (oben-rechts)
4 (mitte-links)    5 (mitte-mitte)    6 (mitte-rechts)
1 (unten-links)    2 (unten-mitte)    3 (unten-rechts)

Positionsbeispiele

# Oben mittig
ffmpeg -i video.mp4 \
  -vf "subtitles=subs.srt:force_style='Alignment=8,MarginV=20'" \
  output.mp4

# Linksbündig
ffmpeg -i video.mp4 \
  -vf "subtitles=subs.srt:force_style='Alignment=1,MarginL=50,MarginV=30'" \
  output.mp4

# Rechte Seite für Sprecheridentifikation
ffmpeg -i video.mp4 \
  -vf "subtitles=subs.srt:force_style='Alignment=3,MarginR=50'" \
  output.mp4

Mehrere Untertitelpositionen

# Zwei Untertitelspuren an verschiedenen Positionen
ffmpeg -i video.mp4 \
  -vf "[in]subtitles=speaker1.srt:force_style='Alignment=1,MarginL=50'[tmp];\
       [tmp]subtitles=speaker2.srt:force_style='Alignment=3,MarginR=50'" \
  output.mp4

Stapelverarbeitung

Untertitel in mehrere Videos einbrennen

#!/bin/bash
# burn_subs_batch.sh

for video in *.mp4; do
    base="${video%.mp4}"
    if [ -f "${base}.srt" ]; then
        ffmpeg -i "$video" \
          -vf "subtitles=${base}.srt:force_style='FontSize=24,Outline=2'" \
          -c:a copy \
          "output/${base}_subbed.mp4"
    fi
done

Batch-Untertitelformat konvertieren

#!/bin/bash
# convert_subs.sh

for srt in *.srt; do
    base="${srt%.srt}"
    ffmpeg -i "$srt" "${base}.vtt"
done

Fehlerbehebung

Häufige Probleme

„Unable to find a suitable output format“

# Ausgabeformat explizit angeben
ffmpeg -i video.mkv -map 0:s:0 -f srt output.srt

Verzerrte Zeichen in Untertiteln

# UTF-8-Kodierung erzwingen
ffmpeg -i video.mp4 \
  -vf "subtitles=subs.srt:charenc=UTF-8" \
  output.mp4

Schriftart nicht gefunden

# Schriftartenverzeichnis angeben
ffmpeg -i video.mp4 \
  -vf "subtitles=subs.srt:fontsdir=/path/to/fonts" \
  output.mp4

# Verfügbare Schriftarten auflisten
fc-list : family | sort | uniq

Untertitel-Timing-Versatz

# Untertitel um 2 Sekunden verzögern
ffmpeg -i video.mp4 \
  -vf "subtitles=subs.srt:itsoffset=2" \
  output.mp4

# Oder setpts zur Anpassung verwenden
ffmpeg -i subs.srt -itsoffset 2 delayed.srt

Untertitel werden in hochauflösenden Videos nicht angezeigt

# Untertitel-Rendering an Videoauflösung anpassen
ffmpeg -i video_4k.mp4 \
  -vf "subtitles=subs.srt:force_style='FontSize=48,Outline=3'" \
  output.mp4

Überprüfungsbefehle

# Prüfen, ob Untertitel vorhanden sind
ffprobe -v error -select_streams s -show_entries stream=codec_name -of default=nw=1 video.mp4

# Anzahl der Untertitelzeilen zählen
grep -c "^[0-9]" subs.srt

# SRT-Format validieren
ffmpeg -i subs.srt -f null -

Best Practices

Barrierefreiheit

  1. Verwenden Sie kontrastreiche Farben (weiß auf dunklem Grund, gelb auf dunklem Grund)
  2. Minimale Schriftgröße von 24pt für Standardvideos
  3. Fügen Sie bei mehreren Sprechern eine Sprecheridentifikation hinzu
  4. Positionieren Sie Untertitel so, dass sie keine wichtigen visuellen Inhalte verdecken
  5. Halten Sie Zeilen kurz (maximal 42 Zeichen pro Zeile)
  6. Anzeigedauer: mindestens 1 Sekunde, maximal 7 Sekunden pro Untertitel

Qualität

  1. Verwenden Sie das ASS-Format für gestylte Untertitel (Anime, Musikvideos)
  2. Verwenden Sie SRT für einfache Dialoge
  3. Verwenden Sie WebVTT für die Webauslieferung
  4. Bewahren Sie nach Möglichkeit das ursprüngliche Styling
  5. Testen Sie vor der Verteilung auf den Zielgeräten

Leistung

  1. Brennen Sie Untertitel nur bei Bedarf ein (Streaming, Kompatibilität)
  2. Bevorzugen Sie weiche Untertitel für Archivierung und Flexibilität
  3. Verwenden Sie Hardwarekodierung beim Einbrennen von Untertiteln in große Dateien
  4. Verarbeiten Sie Stapelvorgänge parallel

Dieser Leitfaden deckt FFmpeg-Untertitel- und Caption-Operationen ab. Für Texteinblendungen mit Formen und Grafiken siehe die Fähigkeit shapes-graphics.

Verwandte Skills