Passer au contenu

Qu'est-ce que VapourSynth et pourquoi les lecteurs vidéo l'utilisent

Qu'est-ce que VapourSynth ? Découvrez ce frameserver vidéo en Python pour l'interpolation temps réel dans SVP et mpv, et comment l'installer sur macOS.

En bref

  • VapourSynth est une bibliothèque open source de traitement vidéo non linéaire qui manipule les images via des scripts Python 3 standards.
  • Elle a été créée par Fredrik Mellbin comme successeur moderne, 64 bits et multiplateforme de l'ancien outil AviSynth limité à Windows.
  • Les lecteurs vidéo comme mpv et SmoothVideo Project (SVP) utilisent VapourSynth comme frameserver temps réel pour le lissage de mouvement, le désentrelacement QTGMC et le débruitage.
  • MacLC se connecte directement à VapourSynth pour héberger le moteur de mouvement de SVP sur Apple Silicon lorsque SVP 4 Mac est installé.
Sur cette page
  1. Qu’est-ce que VapourSynth et pourquoi a-t-il été créé pour remplacer AviSynth ?
  2. Comment VapourSynth traite-t-il les images vidéo ?
  3. Pourquoi des lecteurs comme mpv et SVP utilisent-ils VapourSynth ?
  4. Comment installer VapourSynth sur Mac avec Homebrew
  5. Quels sont les greffons VapourSynth les plus populaires ?
  6. Quelles sont les limites de VapourSynth pour la lecture en temps réel ?
  7. Maîtriser le contrôle vidéo image par image sur macOS

VapourSynth est une bibliothèque open source de traitement vidéo et un framework de script permettant aux développeurs et passionnés de manipuler des images vidéo par programmation grâce à des scripts Python. Plutôt que de fonctionner comme un lecteur vidéo autonome avec boutons et menus, VapourSynth opère en coulisses comme un frameserver haute performance, fournissant le pipeline de filtrage sur lequel s’appuient des lecteurs comme mpv et SmoothVideo Project (SVP) pour l’interpolation de mouvement en temps réel, le désentrelacement de qualité studio et la restauration vidéo.

Conçu comme le successeur moderne et multiplateforme de vénérable application 32 bits AviSynth du début des années 2000, VapourSynth fonctionne nativement sous macOS, Linux et Windows. Comprendre comment VapourSynth traite les images vidéo — et comment les lecteurs de bureau modernes se branchent sur son pipeline — explique pourquoi il reste l’outil de choix pour l’amélioration avancée de la qualité vidéo sur Apple Silicon.

Animation

Comment les lecteurs vidéo traitent les images via VapourSynth

  1. Source vidéoImages décodées
  2. VapourSynthScript Python / SVP
  3. ÉcranVidéo interpolée

Qu’est-ce que VapourSynth et pourquoi a-t-il été créé pour remplacer AviSynth ?

Pour comprendre la raison d’être de VapourSynth, penchons-nous sur l’histoire du traitement vidéo numérique sur ordinateur personnel.

Au début des années 2000, une application open source sous Windows appelée AviSynth a transformé la post-production vidéo et le fansub d’anime. AviSynth a inventé le concept de « frameserver » : au lieu de monter une vidéo, d’enregistrer un gigantesque fichier intermédiaire non compressé puis de le réencoder, un script AviSynth chargeait les images en mémoire vive, appliquait des filtres à la volée et servait ces images modifiées directement à un encodeur ou un lecteur.

Cependant, AviSynth souffrait de graves défauts d’architecture :

  1. Architecture réservée à Windows : Il était codé en dur autour des API Win32 et Video for Windows (VFW), rendant les portages natifs vers macOS et Linux quasi impossibles.
  2. Langage de script propriétaire : AviSynth utilisait une syntaxe de script idiosyncrasique dépourvue de structures de données modernes, de gestion d’exceptions et de bibliothèques standards.
  3. Plafonds mémoire 32 bits : L’architecture d’origine était limitée à l’adressage mémoire 32 bits, saturant fréquemment la RAM lors du traitement de vidéo 1080p HD.
  4. Limites de précision RVB / YUV : Le traitement interne était souvent bridé à des calculs entiers 8 bits hérités.

En 2012, l’ingénieur logiciel suédois Fredrik Mellbin (connu en ligne sous le nom de Myrsloik) a écrit VapourSynth de zéro sous licence GNU LGPL-2.1 (dépôt GitHub VapourSynth).

Mellbin a repensé tout le paradigme du frameserver :

  • Scripts en Python 3 standard : Au lieu d’inventer une syntaxe maison, VapourSynth utilise Python standard comme langage de script. Les utilisateurs profitent des boucles Python classiques, de la logique conditionnelle, de bibliothèques mathématiques comme NumPy et de paquets tiers.
  • Véritable prise en charge multiplateforme : Fonctionne nativement sur Mac Apple Silicon (ARM64), systèmes Linux x86_64 et Windows moderne.
  • Pipelines couleur haute précision : Prend en charge les couleurs entières 8, 10, 12, 14 et 16 bits ainsi que la virgule flottante 32 bits complète dans les espaces YUV, RVB et Niveaux de gris.
  • Multithreading moderne : Bâti sur un cœur multithread asynchrone basé sur des graphes, capable de saturer tous les cœurs de performance du CPU.

Selon les notes de version officielles du projet, la version stable de VapourSynth est la R81 (publiée le 22 octobre 2026), témoignant d’une maintenance active continue.

Comment VapourSynth traite-t-il les images vidéo ?

VapourSynth fonctionne selon un pipeline non linéaire piloté à la demande.

Lorsqu’un script de traitement vidéo est exécuté, VapourSynth ne décode pas et ne rend pas tout le film en mémoire du début à la fin. À la place, il construit un graphe orienté acyclique (DAG) représentant les opérations demandées :

  1. Chargement de la source : Un greffon source (comme lsmas ou ffms2) indexe le fichier vidéo, permettant une recherche instantanée vers n’importe quelle image clé.
  2. Chaînage des filtres : Le script Python enchaîne les filtres séquentiels. Par exemple :
    import vapoursynth as vs
    from vapoursynth import core
    
    video = core.ffms2.Source(source="input.mkv")
    video = core.std.Binarize(clip=video, threshold=128)
    video.set_output()
  3. Requête image par image : Lorsqu’un lecteur vidéo ou l’utilitaire en ligne de commande vspipe demande l’image 1 000, VapourSynth remonte le graphe de dépendances. Il ne réclame que les images sources exactes nécessaires pour calculer l’image 1 000, les passe dans la chaîne de filtres sur plusieurs threads et livre l’image finale non compressée à l’écran.

Parce que les images sont générées à la demande, VapourSynth exige un espace disque négligeable et peut avancer ou reculer dans un flux vidéo sans délai.

Pourquoi des lecteurs comme mpv et SVP utilisent-ils VapourSynth ?

Alors que les spécialistes de la restauration vidéo utilisent VapourSynth pour l’encodage hors ligne via FFmpeg, les lecteurs vidéo de bureau intègrent directement VapourSynth dans leurs pipelines de lecture en temps réel.

L’exemple le plus connu est SmoothVideo Project (SVP 4 Mac). SVP utilise VapourSynth comme moteur de compensation de mouvement en temps réel :

  1. Lorsque vous lisez une vidéo à 24 ips, le lecteur intercepte les images brutes décodées.
  2. Les images sont transmises directement à une instance VapourSynth active exécutant un script de mouvement SVP.
  3. Le script utilise le greffon MVTools pour calculer les vecteurs de mouvement optique entre images successives et générer des images intermédiaires.
  4. VapourSynth renvoie un flux vidéo fluide à 60 ou 120 ips vers la couche de présentation du lecteur vidéo.

De même, le lecteur multimédia open source mpv intègre un point d’ancrage vidéo --vf=vapoursynth (comme documenté dans le manuel de référence de mpv). Cela permet aux utilisateurs avancés d’injecter des scripts de restauration Python sur mesure — comme l’inverse telecine, le debanding ou l’upscaling IA — directement dans leur flux mpv. Consultez notre analyse dédiée à mpv sur Mac.

Comment installer VapourSynth sur Mac avec Homebrew

Parce que VapourSynth est un framework modulaire exigeant une compilation Python dynamique et des binaires en ligne de commande, il n’est pas distribué sur le Mac App Store.

La méthode standard et vérifiée pour installer VapourSynth sur macOS passe par Homebrew, comme indiqué dans la formule Homebrew officielle de VapourSynth :

  1. Ouvrez Terminal sur votre Mac.
  2. Vérifiez que Homebrew est installé et à jour :
    brew update
  3. Installez VapourSynth en exécutant :
    brew install vapoursynth

Homebrew télécharge et lie automatiquement :

  • La bibliothèque dynamique centrale : /opt/homebrew/lib/libvapoursynth.dylib.
  • L’outil frameserver en ligne de commande : /opt/homebrew/bin/vspipe.
  • Le module Python 3 natif dans votre environnement Python Homebrew.

Pour vérifier votre installation dans Terminal, exécutez :

vspipe --version

Terminal affichera la version active du cœur VapourSynth et le niveau d’API.

Quels sont les greffons VapourSynth les plus populaires ?

La véritable force de VapourSynth réside dans son vaste écosystème de greffons open source :

Nom du greffon Fonction principale Pourquoi les passionnés vidéo l’utilisent
MVTools Estimation et compensation de mouvement Propulse l’interpolation temps réel dans SVP et le débruitage temporel haute précision
QTGMC Désentrelacement adaptatif de qualité studio La référence mondiale pour éliminer les effets de peigne des sources 1080i et DVD
KNLMeansCL Débruitage vidéo par moyennes non locales Réduction de bruit accélérée GPU (OpenCL/Metal) pour le grain film et le bruit capteur ISO élevé
fmtconv Conversion de format et d’espace couleur Transformations matricielles haute précision, dithering et conversions de courbes gamma
RIFE / VS-RIFE Interpolation par réseau neuronal profond Relie le modèle IA RIFE aux scripts VapourSynth pour la génération neuronale d’images
Waifu2x / Real-ESRGAN Upscaling super-résolution par IA Synthétise des textures haute résolution pour l’animation et les vidéos d’archives

Pour explorer en détail les modèles de génération d’images neuronaux, lisez notre analyse qu’est-ce que RIFE et notre guide sur l’interpolation de mouvement.

Quelles sont les limites de VapourSynth pour la lecture en temps réel ?

Bien que VapourSynth soit exceptionnellement polyvalent, exécuter des graphes de filtres Python complexes en temps réel pendant la lecture pose des défis techniques :

  • Surcharge de calcul importante : Appliquer des filtres complexes de compensation de mouvement ou des désentrelaceurs multipasses comme QTGMC peut saturer les cœurs CPU. Sur des fichiers 4K à haut débit, le traitement temps réel peut passer sous la fréquence de l’écran, provoquant des saccades.
  • Fragilité de l’environnement Python : Comme VapourSynth repose sur Python 3, les mises à jour Python de macOS ou des environnements virtuels discordants peuvent parfois casser les liens de greffons et variables de chemin.
  • Complexité de mise en place : Écrire des scripts .vpy demande d’être à l’aise avec le terminal, les gestionnaires de paquets et les éditeurs de texte.

Pour les spectateurs occasionnels, les lecteurs autonomes qui intègrent des désentrelaceurs internes et des moteurs d’interpolation accélérés matériellement (comme les filtres Metal et Core ML intégrés de MacLC) offrent une alternative en un clic bien plus simple. Pour les utilisateurs experts exigeant une personnalisation poussée et un traitement de qualité studio, VapourSynth demeure toutefois inégalé.

Maîtriser le contrôle vidéo image par image sur macOS

VapourSynth a transformé l’ingénierie vidéo en mariant une architecture professionnelle de frameserver à la souplesse du Python moderne. En permettant aux lecteurs vidéo de manipuler les images au niveau du pixel avant qu’elles n’atteignent la dalle, VapourSynth alimente certains des flux d’amélioration du mouvement et de restauration les plus avancés qui existent.

Que vous utilisiez VapourSynth via Homebrew pour vos propres scripts vidéo ou que vous le connectiez à SmoothVideo Project dans MacLC, ce framework polyvalent vous donne la maîtrise complète du mouvement vidéo sur votre Mac.

Questions fréquentes

Qu'est-ce que VapourSynth ?

VapourSynth est un moteur open source de manipulation vidéo et une bibliothèque C++ centrale. Il utilise Python comme interface de script, permettant d'appliquer filtrage avancé, inverse telecine, désentrelacement et interpolation d'images de manière non destructive.

VapourSynth est-il un lecteur vidéo ?

Non. VapourSynth n'est pas un lecteur multimédia doté d'une interface graphique ; c'est un frameserver. Il reçoit la vidéo d'un décodeur, traite chaque image via un script Python et transmet la vidéo modifiée à un lecteur (comme mpv ou MacLC) ou à un encodeur (comme FFmpeg).

Quelle est la différence entre VapourSynth et AviSynth ?

AviSynth était un ancien outil exclusif à Windows utilisant un langage de script propriétaire avec des limites mémoire 32 bits. VapourSynth est entièrement multiplateforme (natif sur macOS, Linux et Windows), utilise Python 3 standard, gère le multithreading 64 bits natif et les hautes profondeurs de bits (jusqu'à 32 bits flottant).

Comment installer VapourSynth sur un Mac ?

La méthode standard et vérifiée pour installer VapourSynth sur macOS passe par Homebrew. Exécuter 'brew install vapoursynth' dans Terminal installe la bibliothèque centrale (libvapoursynth.dylib), l'outil CLI vspipe et lie le module Python 3 dans /opt/homebrew.

Before you download

MacLC is free. If it is useful to you, a gift helps it skip “Open Anyway” and funds the next release.