Einsteigerleitfaden zu FFmpeg mit Python

Python steuert FFmpeg üblicherweise als Kindprozess oder über einen Wrapper; die Medienarbeit erledigt weiterhin FFmpeg. Die wichtigen technischen Entscheidungen betreffen Argumentsicherheit, Ressourcenlimits, Fortschritt, Abbruch, temporäre Dateien und Reproduzierbarkeit.

Worauf es besonders ankommt

• Schreiben Sie Ausgaben atomar und räumen Sie temporäre Dateien bei Erfolg, Fehler und Abbruch auf.
• Behandeln Sie CPU, Arbeitsspeicher, Festplatte und gleichzeitige Encodings als Eingangsgrößen für die Kapazitätsplanung.

from pathlib import Path
import subprocess
import tempfile


def make_preview(source: Path, destination: Path) -> None:
    destination.parent.mkdir(parents=True, exist_ok=True)
    with tempfile.NamedTemporaryFile(
        dir=destination.parent,
        prefix=f".{destination.name}.",
        suffix=".mp4",
        delete=False,
    ) as temporary:
        workfile = Path(temporary.name)
    try:
        subprocess.run(
            [
                "ffmpeg", "-nostdin", "-hide_banner", "-v", "error",
                "-i", str(source),
                "-map", "0:v:0", "-map", "0:a:0?",
                "-c:v", "libx264", "-crf", "23",
                "-c:a", "aac", "-b:a", "128k",
                "-movflags", "+faststart",
                "-f", "mp4",
                "-y", str(workfile),
            ],
            check=True,
            timeout=300,
        )
        workfile.replace(destination)
    finally:
        workfile.unlink(missing_ok=True)

import json
import subprocess


result = subprocess.run(
    [
        "ffprobe", "-v", "error", "-show_streams", "-show_format",
        "-of", "json", "input.mov",
    ],
    check=True,
    capture_output=True,
    text=True,
    timeout=30,
)
metadata = json.loads(result.stdout)

Wissenswerte technische Details

• Das subprocess-Modul von Python kann eine Argumentliste ohne Shell direkt an FFmpeg übergeben, sodass Leerzeichen und Metazeichen in Dateinamen nicht zu Befehlssyntax werden.
• ffprobe kann JSON für Streams, Pakete, Kapitel und Container-Metadaten ausgeben. Die Analyseergebnisse sollten validiert werden, da Dauer, Bildrate und Stream-Tags fehlen oder inkonsistent sein können.
• Für maschinenlesbaren Fortschritt unterstützt FFmpeg das progress-Protokoll über einen Dateideskriptor oder eine Pipe. Das Parsen des gewöhnlichen stderr ist fragiler, da sich dessen menschenlesbares Format ändern kann.
• Der Exit-Code null von FFmpeg zeigt an, dass der Befehl abgeschlossen wurde, nicht dass die Ausgabe den Produkterwartungen entspricht; prüfen Sie das Ergebnis auf Streams, Dauer und Abmessungen, bevor Sie es veröffentlichen.
• Ein Timeout sollte den Prozessbaum beenden und die Aufräumarbeiten abwarten, da Encoder, Pipes und Wrapper-Prozesse andernfalls weiterlaufen können, nachdem der aufrufende Python-Code aufgegeben hat.
• Grenzen für Nebenläufigkeit sind meist wichtiger als die Geschwindigkeit einzelner Prozesse: Mehrere Encodings können CPU, Arbeitsspeicher, temporären Festplattenspeicher oder Dateideskriptoren gleichzeitig erschöpfen.

Ein praxisnaher Ansatz

Wann Transloadit hilfreich ist

Für Uploads in der Produktion kann ein Template gängige Schritte wie /video/encode, /video/thumbs und /video/adaptive abbilden, ohne dass Codecs auf Anwendungsservern installiert werden müssen. Das Python-SDK erstellt Assemblies und erhält strukturierten Status, statt Prozessausgaben auszulesen.

Architekturgrenze

Transloadit ist eine verwaltete Alternative für asynchrone Workloads der Dateiverarbeitung, kein Drop-in-Python-Binding für jedes FFmpeg-Flag. Behalten Sie lokales FFmpeg, wenn Experimente auf Frame-Ebene, Offline-Ausführung oder nicht unterstützte Filter die primäre Anforderung sind.