Guide d’initiation à FFmpeg avec Python

Python pilote généralement FFmpeg comme processus enfant ou par l’intermédiaire d’une surcouche ; FFmpeg effectue toujours le traitement des médias. Les décisions techniques importantes concernent la sécurité des arguments, les limites de ressources, la progression, l’annulation, les fichiers temporaires et la reproductibilité.

L’essentiel

• Écrivez les fichiers de sortie de manière atomique et supprimez les fichiers temporaires en cas de réussite, d’échec ou d’annulation.
• Tenez compte du processeur, de la mémoire, du disque et des encodages simultanés dans la planification de la capacité.

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)

Détails techniques à connaître

• Le module subprocess de Python peut transmettre une liste d’arguments directement à FFmpeg sans interpréteur de commandes, empêchant ainsi les espaces et les métacaractères des noms de fichiers d’être interprétés comme de la syntaxe de commande.
• ffprobe peut produire du JSON pour les flux, les paquets, les chapitres et les métadonnées du conteneur. Les résultats de l’inspection doivent être validés, car la durée, la fréquence d’images et les balises des flux peuvent être absentes ou incohérentes.
• Pour suivre la progression dans un format exploitable par une machine, FFmpeg prend en charge le protocole de progression sur un descripteur de fichier ou un tube. L’analyse de la sortie stderr habituelle est plus fragile, car son format destiné à la lecture humaine peut changer.
• Le code de sortie zéro de FFmpeg indique que la commande est terminée, sans garantir que le résultat répond aux attentes du produit ; inspectez les flux, la durée et les dimensions du résultat avant de le publier.
• Un dépassement du délai devrait entraîner l’arrêt de l’arborescence des processus et l’attente de la libération des ressources, car les encodeurs, les tubes et les processus d’encapsulation peuvent sinon subsister après l’abandon du processus appelant Python.
• Les limites de concurrence sont généralement plus importantes que la vitesse de chaque processus : plusieurs encodages peuvent épuiser simultanément les ressources CPU, la mémoire, l’espace disque temporaire ou les descripteurs de fichiers.

Une approche pratique

Quand Transloadit est utile

Pour les téléversements en production, un Template peut exprimer des Steps courants de /video/encode, de /video/thumbs et de /video/adaptive sans installer de codecs sur les serveurs applicatifs. Le SDK Python crée des Assemblies et reçoit un état structuré au lieu d’extraire ces informations de la sortie du processus.

Périmètre architectural

Transloadit est une solution gérée pour les charges de traitement asynchrone de fichiers, pas une interface Python directement substituable pour chaque option de FFmpeg. Conservez FFmpeg en local lorsque votre besoin principal est l’expérimentation à l’image près, l’exécution hors ligne ou l’utilisation de filtres non pris en charge.