Untertitel mit Lua einfach in Videos einbinden

Tim Koschützki

Mitgründer · Berlin, Deutschland ·

Untertitel in Videos verbessern die Barrierefreiheit und stärken die Bindung der Zuschauer. Lua, eine schlanke und vielseitige Skriptsprache, bietet einen einfachen und zugleich effizienten Ansatz, um Untertitel in Ihre Videoprojekte einzubinden.

Die Bedeutung von Untertiteln in Videoinhalten

Untertitel sind entscheidend, um ein breiteres Publikum zu erreichen. Sie unterstützen Zuschauer mit Hörbehinderung und kommen zugleich mehrsprachigen Nutzern zugute, indem sie übersetzten Text bereitstellen. Das Einbinden von Untertiteln kann das Verständnis deutlich verbessern und die Nutzerbindung steigern.

Lua: eine schlanke Skriptsprache für die Videoverarbeitung

Lua ist bekannt für seine Geschwindigkeit, seine Einfachheit und die unkomplizierte Einbettung. Sein minimaler Ressourcenbedarf macht die Sprache ideal für Skriptaufgaben, einschließlich der Videoverarbeitung. Dank der klaren Syntax von Lua können Sie das Hinzufügen von Untertiteln schnell automatisieren, ohne unnötigen Overhead.

Ihre Lua-Umgebung für die Videoverarbeitung einrichten

Das folgende Skript ist für Lua 5.3 oder neuer unter Linux oder macOS ausgelegt, mit einer POSIX-Shell und /dev/fd. FFmpeg muss den Filter subtitles, der libass voraussetzt, sowie den Encoder libx264 enthalten. Paket-Builds unterscheiden sich: Prüfen Sie nach der Installation ffmpeg -filters und ffmpeg -encoders.

Für Ubuntu/Debian:

sudo apt-get update
sudo apt-get install lua5.3 ffmpeg

Für macOS:

brew update
brew install lua ffmpeg

Das Standard-FFmpeg-Paket für macOS enthält libass möglicherweise nicht. Verwenden Sie einen Build mit dem erforderlichen Filter; die Installation von Lua allein aktiviert noch keine Darstellung von Untertiteln. Führen Sie dieses POSIX-Shell-Skript unter Windows nicht über CMD oder PowerShell aus, sondern nutzen Sie eine kompatible Linux-Umgebung wie WSL.

Arbeiten mit Untertitelformaten

Bevor Sie Untertitel einbinden, stellen Sie sicher, dass Ihre Untertiteldateien in einem unterstützten Format vorliegen. Zu den gängigsten Formaten zählen:

SRT (SubRip): Standardformat mit Zeit- und Textinformationen; wird breit unterstützt.
SSA/ASS (Advanced SubStation Alpha): Bietet erweiterte Gestaltungs- und Positionierungsoptionen.
VTT (Web Video Text Tracks): Wird häufig für webbasierte Videoanwendungen verwendet.

Stellen Sie sicher, dass Ihre Untertiteldateien in der Zeichencodierung UTF-8 gespeichert sind und den korrekten Zeitvorgaben entsprechen.

Schritt-für-Schritt-Anleitung zum Hinzufügen von Untertiteln mit Lua und FFmpeg

Das folgende Lua-Skript brennt UTF-8-SRT-Untertitel in eine MP4-Datei ein. Es setzt Shell-Argumente in Anführungszeichen und übergibt die Untertiteldatei über Deskriptor 3, sodass ihr Dateiname niemals Teil der Filtersyntax von FFmpeg wird. So funktionieren auch Namen, die Leerzeichen, Anführungszeichen, Doppelpunkte und Klammern enthalten.

#!/usr/bin/env lua

if #arg ~= 0 and #arg ~= 3 then
  io.stderr:write("Usage: lua add_subtitles.lua <video.mp4> <subtitles.srt> <new-output.mp4>\n")
  os.exit(1)
end

local video_file = arg[1] or "input.mp4"
local subtitles_file = arg[2] or "subtitles.srt"
local output_file = arg[3] or "output.mp4"

local existing = io.open(output_file, "rb")
if existing then
  existing:close()
  io.stderr:write("Output already exists; choose a new filename.\n")
  os.exit(1)
end

local function shell_quote(value)
  return "'" .. value:gsub("'", "'\\''") .. "'"
end

local function local_path(value)
  if value:sub(1, 1) == "/" then return value end
  return "./" .. value
end

local filter = "subtitles=/dev/fd/3"
local command = string.format(
  "ffmpeg -nostdin -n -i %s -vf %s -c:v libx264 -crf 23 -c:a copy %s 3<%s",
  shell_quote(local_path(video_file)),
  shell_quote(filter),
  shell_quote(local_path(output_file)),
  shell_quote(local_path(subtitles_file))
)

local success = os.execute(command)
if not success then
  io.stderr:write("Subtitle conversion failed. Inspect any partial output before retrying.\n")
  os.exit(1)
end
print("Subtitles added successfully.")

Speichern Sie dieses Skript als add_subtitles.lua und machen Sie es ausführbar:

chmod +x add_subtitles.lua

Führen Sie das Skript so aus:

./add_subtitles.lua input.mp4 subtitles.srt output.mp4

Die Vorabprüfung meldet eine bereits vorhandene Ausgabedatei als Fehler, und -n weist FFmpeg an, sie nicht zu ersetzen. Verwenden Sie ein privates Arbeitsverzeichnis ohne gleichzeitige Schreibzugriffe: Dieses kleine Skript bietet keine transaktionale Veröffentlichung, falls ein anderer Prozess die Ausgabedatei nach der Prüfung erstellt. Eine fehlgeschlagene Konvertierung kann dennoch eine neue, unvollständige Datei hinterlassen; prüfen Sie diese und wählen Sie vor einem erneuten Versuch einen frischen Ausgabepfad. Das Audio wird kopiert, daher muss der Audio-Codec der Eingabe mit MP4 kompatibel sein. Führen Sie FFmpeg bei nicht vertrauenswürdigen Uploads in einem isolierten Worker mit Limits für Dateisystem, Netzwerk, Speicher und Ausführungszeit aus. Shell-Quoting ist keine Media-Sandbox.

Häufige Probleme beheben

Nachfolgend finden Sie einige Tipps für Probleme, die beim Einbinden von Untertiteln häufig auftreten:

Probleme mit der Zeichencodierung:

Wenn Ihre Untertiteldatei nicht in UTF-8 vorliegt, konvertieren Sie sie mit:
```
iconv -f ISO-8859-1 -t UTF-8 input.srt > output.srt
```
Synchronisierung des Untertitel-Timings:

Wenn die Untertitel nicht synchron erscheinen, fügen Sie mit FFmpeg eine Verzögerung hinzu. Um beispielsweise eine Verzögerung von 2,5 Sekunden einzufügen, erstellen Sie eine separate, zeitversetzte SRT-Datei und übergeben diese anschließend an das Lua-Skript:
```
ffmpeg -nostdin -n -itsoffset 2.5 -i subtitles.srt -c:s srt shifted.srt
lua add_subtitles.lua input.mp4 shifted.srt delayed.mp4
```
Probleme bei der Schriftdarstellung:

Installieren Sie eine Schriftart, die Ihre Untertitelzeichen enthält, und ersetzen Sie dann im Skript nur die Variable filter. Zum Beispiel bei installiertem DejaVu Sans:
```
local filter = "subtitles=/dev/fd/3:force_style='FontName=DejaVu Sans,FontSize=24'"
```

Belassen Sie diese Stilzeichenfolge unverändert im Skript. Beliebige, von Nutzern bereitgestellte Filterausdrücke benötigen eine eigene Validierung; Shell-Quoting validiert die Filtersyntax von FFmpeg nicht.

Erweiterte Untertitelbearbeitung (optional)

Für eine aufwendigere Gestaltung erstellen Sie eine ASS-Untertiteldatei mit einem speziellen Untertiteleditor und prüfen das Ergebnis, bevor Sie sie in das Video einbrennen. Die Dokumentation zum subtitles-Filter von FFmpeg beschreibt die unterstützten Optionen. Halten Sie Anpassungen des Untertitel-Timings wie im SRT-Beispiel oben von der Darstellung getrennt, statt die Verzögerung als Option des Schriftstils zu behandeln.

Bewährte Verfahren für die Einbindung von Untertiteln

Beachten Sie beim Einbinden von Untertiteln in Ihre Videos die folgenden bewährten Verfahren:

Validieren Sie alle Eingabedateien vor der Verarbeitung.
Stellen Sie sicher, dass Untertiteldateien die Zeichencodierung UTF-8 verwenden und dem korrekten Format entsprechen.
Testen Sie mit kürzeren Videoabschnitten, um Synchronisierung und Formatierung zu überprüfen.
Bewahren Sie Sicherungskopien Ihrer Originaldateien auf, um versehentlichen Datenverlust zu vermeiden.
Implementieren Sie eine Fehlerbehandlung in Ihren Skripten, um die Fehlersuche zu vereinfachen.

Fazit

Das Einblenden von Untertiteln mit Lua und FFmpeg ist eine praktische Lösung, um die Barrierefreiheit und die Zuschauerbindung von Videos zu verbessern. Indem Sie die Skriptfähigkeiten von Lua mit den robusten Funktionen von FFmpeg kombinieren, können Sie den Prozess automatisieren und häufige Herausforderungen wirksam bewältigen. Für skalierbare Projekte und anspruchsvolle Verarbeitungsanforderungen lohnt sich ein Blick auf Transloadit, das umfassende APIs und Dienste für Video-Encoding und die Einbindung von Untertiteln bietet.