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
| Aufgabe | Befehl |
|---|---|
| SRT einbrennen | ffmpeg -i video.mp4 -vf "subtitles=subs.srt" output.mp4 |
| ASS einbrennen | ffmpeg -i video.mp4 -vf "ass=subs.ass" output.mp4 |
| Weichen Untertitel hinzufügen | ffmpeg -i video.mp4 -i subs.srt -c copy -c:s mov_text output.mp4 |
| Untertitel extrahieren | ffmpeg -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" |
| Format | Erweiterung | Am besten geeignet für |
|---|---|---|
| SRT | .srt | Einfach, universell |
| ASS | .ass | Gestylt, animiert, Anime |
| VTT | .vtt | Web/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
| Format | Erweiterung | Funktionen | Anwendungsfall |
|---|---|---|---|
| SubRip | .srt | Einfaches Timing + Text | Universell, Web |
| Advanced SubStation Alpha | .ass/.ssa | Umfangreiches Styling, Positionierung, Effekte | Anime, gestylte Untertitel |
| WebVTT | .vtt | Webstandard, Hinweise, Styling | HTML5-Video |
| TTML/DFXP | .ttml/.dfxp | Rundfunk, Barrierefreiheit | Streaming-Dienste |
| MOV Text | .mov (eingebettet) | QuickTime nativ | Apple-Ökosystem |
| DVB Untertitel | (eingebettet) | Bitmap-basiert | Europäischer Rundfunk |
| PGS | .sup | Blu-ray Bitmap-Untertitel | Blu-ray |
| CEA-608/708 | (eingebettet) | Closed Captions | US-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
| Parameter | Beschreibung | Beispiel |
|---|---|---|
| FontName | Schriftfamilie | FontName=Arial |
| FontSize | Größe in Punkt | FontSize=24 |
| PrimaryColour | Textfarbe (AABBGGRR) | PrimaryColour=&HFFFFFF |
| SecondaryColour | Karaoke-Farbe | SecondaryColour=&H00FFFF |
| OutlineColour | Umrandungs-/Randfarbe | OutlineColour=&H000000 |
| BackColour | Schatten-/Hintergrundfarbe | BackColour=&H80000000 |
| Bold | Fetter Text (0/1) | Bold=1 |
| Italic | Kursiver Text (0/1) | Italic=1 |
| Underline | Unterstrichener Text (0/1) | Underline=1 |
| Outline | Umrandungsbreite | Outline=2 |
| Shadow | Schattentiefe | Shadow=1 |
| Alignment | Position (Nummernblock-Stil) | Alignment=2 |
| MarginL/R/V | Ränder in Pixeln | MarginV=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
- Verwenden Sie kontrastreiche Farben (weiß auf dunklem Grund, gelb auf dunklem Grund)
- Minimale Schriftgröße von 24pt für Standardvideos
- Fügen Sie bei mehreren Sprechern eine Sprecheridentifikation hinzu
- Positionieren Sie Untertitel so, dass sie keine wichtigen visuellen Inhalte verdecken
- Halten Sie Zeilen kurz (maximal 42 Zeichen pro Zeile)
- Anzeigedauer: mindestens 1 Sekunde, maximal 7 Sekunden pro Untertitel
Qualität
- Verwenden Sie das ASS-Format für gestylte Untertitel (Anime, Musikvideos)
- Verwenden Sie SRT für einfache Dialoge
- Verwenden Sie WebVTT für die Webauslieferung
- Bewahren Sie nach Möglichkeit das ursprüngliche Styling
- Testen Sie vor der Verteilung auf den Zielgeräten
Leistung
- Brennen Sie Untertitel nur bei Bedarf ein (Streaming, Kompatibilität)
- Bevorzugen Sie weiche Untertitel für Archivierung und Flexibilität
- Verwenden Sie Hardwarekodierung beim Einbrennen von Untertiteln in große Dateien
- 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.