Saltar al contenido

Qué es VapourSynth y por qué los reproductores de vídeo lo usan

¿Qué es VapourSynth? Aprende cómo este servidor de fotogramas en Python impulsa la interpolación en tiempo real en SVP y mpv, y cómo instalarlo en macOS.

En resumen

  • VapourSynth es una librería de procesado de vídeo no lineal y de código abierto que manipula fotogramas mediante guiones estándar en Python 3.
  • Fue creada por Fredrik Mellbin como un sucesor moderno, multiplataforma y de 64 bits de la antigua herramienta AviSynth exclusiva de Windows.
  • Reproductores como mpv y SmoothVideo Project (SVP) usan VapourSynth como servidor de fotogramas en tiempo real para aplicar suavizado de movimiento, desentrelazado QTGMC y reducción de ruido.
  • MacLC se conecta directamente a VapourSynth para alojar el motor de movimiento de SVP en Apple Silicon cuando SVP 4 Mac está instalado.
En esta página
  1. ¿Qué es VapourSynth y por qué se creó para sustituir a AviSynth?
  2. ¿Cómo procesa VapourSynth los fotogramas de vídeo?
  3. ¿Por qué reproductores de vídeo como mpv y SVP usan VapourSynth?
  4. Cómo instalar VapourSynth en un Mac con Homebrew
  5. ¿Cuáles son los plugins más populares de VapourSynth?
  6. ¿Cuáles son las limitaciones de VapourSynth para reproducción en tiempo real?
  7. Desbloquear el control de vídeo a nivel de fotograma en macOS

VapourSynth es una librería de procesado de vídeo de código abierto y un framework de scripting que permite a desarrolladores y entusiastas del vídeo manipular fotogramas de forma programática mediante scripts de Python. En lugar de funcionar como un reproductor de vídeo independiente con botones y menús, VapourSynth opera entre bastidores como un servidor de fotogramas (frameserver) de alto rendimiento, proporcionando el pipeline computacional de filtrado en el que se apoyan reproductores como mpv y SmoothVideo Project (SVP) para interpolación de movimiento en tiempo real, desentrelazado de nivel de estudio y restauración de vídeo.

Creado como un sucesor moderno y multiplataforma de la veterana aplicación AviSynth de 32 bits de principios de los 2000, VapourSynth funciona de forma nativa en macOS, Linux y Windows. Entender cómo procesa VapourSynth los fotogramas de vídeo —y cómo se conectan los reproductores de escritorio modernos a su pipeline— explica por qué sigue siendo la herramienta elegida para mejorar de forma avanzada la calidad del vídeo en Apple Silicon.

Animación

Cómo procesan fotogramas los reproductores a través de VapourSynth

  1. Fuente de vídeoFotogramas decodificados
  2. VapourSynthScript Python / SVP
  3. PantallaVídeo interpolado

¿Qué es VapourSynth y por qué se creó para sustituir a AviSynth?

Para entender por qué se construyó VapourSynth, conviene repasar la historia del procesado de vídeo digital en ordenadores personales.

A principios de la década de 2000, una aplicación de código abierto para Windows llamada AviSynth transformó la posproducción de vídeo y el fansubbing de anime. AviSynth fue pionera en el concepto de «frameserver»: en lugar de editar un vídeo, guardar un archivo intermedio gigante sin comprimir y volver a codificarlo, un script de AviSynth cargaba fotogramas en memoria del sistema, aplicaba filtros sobre la marcha y servía esos fotogramas modificados directamente a un codificador o reproductor.

Sin embargo, AviSynth arrastraba graves defectos de arquitectura:

  1. Arquitectura exclusiva de Windows: Estaba ligada de forma fija a las APIs Win32 de Windows y Video for Windows (VFW), haciendo prácticamente imposibles las adaptaciones nativas a macOS y Linux.
  2. Lenguaje de scripting propietario: AviSynth utilizaba su propia sintaxis peculiar que carecía de estructuras de datos modernas, manejo de excepciones y librerías estándar.
  3. Techos de memoria de 32 bits: La arquitectura original estaba limitada al direccionamiento de memoria de 32 bits, por lo que se quedaba sin RAM con frecuencia al procesar vídeo en alta definición 1080p.
  4. Límites de precisión RGB / YUV: El procesado interno solía estar restringido a matemáticas de color enteras de 8 bits.

En 2012, el ingeniero de software sueco Fredrik Mellbin (conocido en línea como Myrsloik) creó VapourSynth desde cero bajo la licencia GNU LGPL-2.1 (Repositorio de VapourSynth en GitHub).

Mellbin rediseñó todo el paradigma del frameserver:

  • Scripting estándar en Python 3: En lugar de inventar una sintaxis propia, VapourSynth utiliza Python estándar como lenguaje de scripting. Los usuarios pueden aprovechar bucles estándar de Python, lógica condicional, librerías matemáticas como NumPy y paquetes de terceros.
  • Soporte multiplataforma real: Funciona de forma nativa en Mac con Apple Silicon (ARM64), sistemas Linux x86_64 y Windows moderno.
  • Pipelines de color de alta precisión: Admite color entero de 8, 10, 12, 14 y 16 bits, y precisión completa en coma flotante de 32 bits en espacios de color YUV, RGB y Gray.
  • Multihilo moderno: Construido con un núcleo multihilo asíncrono basado en grafos capaz de saturar todos los núcleos de rendimiento disponibles de la CPU.

Según las notas oficiales de lanzamiento del proyecto, la versión estable de VapourSynth es la R81 (publicada el 22 de octubre de 2026), lo que demuestra un mantenimiento activo continuo.

¿Cómo procesa VapourSynth los fotogramas de vídeo?

VapourSynth opera sobre un pipeline no lineal bajo demanda.

Cuando se ejecuta un script de procesado de vídeo, VapourSynth no decodifica y renderiza toda la película en memoria de principio a fin. En su lugar, construye un grafo acíclico dirigido (DAG) que representa las operaciones solicitadas:

  1. Carga de la fuente: Un plugin fuente (como lsmas o ffms2) indexa el archivo de vídeo, permitiendo saltos instantáneos a cualquier keyframe arbitrario.
  2. Encadenamiento de filtros: El script de Python especifica filtros secuenciales. Por ejemplo:
    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. Solicitud fotograma a fotograma: Cuando un reproductor de vídeo o la utilidad de línea de comandos vspipe solicita el Fotograma 1.000, VapourSynth recorre hacia atrás el grafo de dependencias. Solicita únicamente los fotogramas de origen exactos necesarios para calcular el Fotograma 1.000, los procesa por la cadena activa de filtros entre hilos de trabajo y entrega el fotograma terminado sin comprimir a la pantalla.

Como los fotogramas se generan bajo demanda, VapourSynth requiere un espacio mínimo de almacenamiento en disco y puede avanzar y retroceder por un flujo de vídeo sin demora.

¿Por qué reproductores de vídeo como mpv y SVP usan VapourSynth?

Mientras que los especialistas en restauración de vídeo usan VapourSynth para codificación offline desde línea de comandos mediante FFmpeg, los reproductores de escritorio integran VapourSynth directamente en sus pipelines de reproducción en tiempo real.

El ejemplo más destacado es SmoothVideo Project (SVP 4 Mac). SVP utiliza VapourSynth como su motor de compensación de movimiento en tiempo real:

  1. Cuando reproduces un vídeo a 24 fps, el reproductor intercepta los fotogramas decodificados en bruto.
  2. Los fotogramas se pasan directamente a una instancia activa de VapourSynth que ejecuta un script de movimiento de SVP.
  3. El script utiliza el plugin MVTools para calcular vectores de movimiento óptico entre fotogramas secuenciales y generar fotogramas intermedios.
  4. VapourSynth devuelve un flujo de vídeo fluido a 60 fps o 120 fps hacia la capa de presentación del reproductor.

De forma similar, el reproductor multimedia de código abierto mpv incluye un gancho de filtro de vídeo integrado --vf=vapoursynth (como se documenta en el manual de referencia de mpv). Esto permite a usuarios avanzados inyectar scripts personalizados de restauración en Python —como telecine inverso, debanding o escalado por IA— directamente en su flujo de vídeo de mpv. Explora nuestro análisis dedicado de mpv en Mac.

Cómo instalar VapourSynth en un Mac con Homebrew

Como VapourSynth es un framework modular de desarrollo que requiere compilación dinámica en Python y binarios de línea de comandos, no se distribuye a través del Mac App Store.

El método estándar y verificado para instalar VapourSynth en macOS es mediante Homebrew, tal como se documenta en la fórmula oficial de VapourSynth en Homebrew:

  1. Abre Terminal en tu Mac.
  2. Asegúrate de que Homebrew esté instalado y actualizado:
    brew update
  3. Instala VapourSynth ejecutando:
    brew install vapoursynth

Homebrew descarga y enlaza automáticamente:

  • La librería dinámica central: /opt/homebrew/lib/libvapoursynth.dylib.
  • La herramienta frameserver de línea de comandos: /opt/homebrew/bin/vspipe.
  • El módulo nativo de Python 3 dentro del entorno Python de Homebrew de tu sistema.

Para verificar tu instalación en Terminal, ejecuta:

vspipe --version

Terminal imprimirá la versión activa del núcleo de VapourSynth y el nivel de API.

¿Cuáles son los plugins más populares de VapourSynth?

La verdadera fortaleza de VapourSynth reside en su amplio ecosistema de plugins de código abierto:

Nombre del plugin Función principal Por qué lo usan los entusiastas del vídeo
MVTools Estimación y compensación de movimiento Impulsa la interpolación de fotogramas en tiempo real en SVP y la reducción temporal de ruido de alta precisión
QTGMC Desentrelazado adaptativo al movimiento de nivel de estudio El filtro de referencia mundial para eliminar artefactos de peine en metraje 1080i y DVD
KNLMeansCL Reducción de ruido de vídeo por medias no locales Reducción de ruido acelerada por GPU (OpenCL/Metal) para grano de película y ruido de sensor ISO alto
fmtconv Conversión de formato y espacio de color Transformaciones matriciales de alta precisión, dithering de profundidad de bits y conversiones de curva gamma
RIFE / VS-RIFE Interpolación de fotogramas por red neuronal profunda Conecta el modelo de IA RIFE dentro de scripts de VapourSynth para generación neuronal de fotogramas
Waifu2x / Real-ESRGAN Escalado de superresolución por IA Sintetiza texturas de alta resolución para contenido animado y vídeo antiguo

Para una exploración detallada de los modelos neuronales de generación de fotogramas, lee nuestro análisis explicando qué es RIFE y nuestra guía sobre interpolación de movimiento.

¿Cuáles son las limitaciones de VapourSynth para reproducción en tiempo real?

Aunque VapourSynth es excepcionalmente versátil, ejecutar grafos complejos de filtros en Python en tiempo real durante la reproducción de vídeo plantea retos técnicos:

  • Fuerte sobrecarga de procesado: Aplicar filtros complejos de compensación de movimiento o desentrelazadores multipasada como QTGMC puede saturar los núcleos de la CPU. En archivos 4K de alta tasa de bits, el procesado en tiempo real puede caer por debajo de la frecuencia de actualización de la pantalla y provocar tirones.
  • Fragilidad del entorno Python: Como VapourSynth depende de Python 3, las actualizaciones de Python del sistema en macOS o entornos virtuales desajustados pueden romper ocasionalmente los enlaces de plugins y las variables de ruta.
  • Complejidad de configuración: Escribir scripts .vpy requiere soltura con herramientas de línea de comandos, gestores de paquetes y editores de texto.

Para quienes ven películas de forma casual, los reproductores independientes que integran desentrelazado interno y motores de interpolación acelerados por hardware (como los filtros integrados Metal y Core ML de MacLC) ofrecen una alternativa mucho más sencilla en un clic. Sin embargo, para usuarios avanzados que exigen personalización profunda y procesado de vídeo de nivel de estudio, VapourSynth sigue siendo insuperable.

Desbloquear el control de vídeo a nivel de fotograma en macOS

VapourSynth transformó la ingeniería de vídeo al unir una arquitectura profesional de frameserving con la flexibilidad del Python moderno. Al permitir que los reproductores de vídeo manipulen fotogramas a nivel de píxel antes de que lleguen al panel de la pantalla, VapourSynth impulsa algunos de los flujos de trabajo más sofisticados de mejora de movimiento y restauración que existen.

Tanto si ejecutas VapourSynth mediante Homebrew para scripting personalizado de vídeo como si lo conectas a SmoothVideo Project dentro de MacLC, este versátil framework te da control total sobre el movimiento del vídeo en tu Mac.

Preguntas frecuentes

¿Qué es VapourSynth?

VapourSynth es un motor de manipulación de vídeo de código abierto y una librería central en C++. Utiliza Python como interfaz de scripting, permitiendo aplicar filtrado avanzado, telecine inverso, desentrelazado e interpolación de fotogramas de forma no destructiva a flujos de vídeo.

¿Es VapourSynth un reproductor de vídeo?

No. VapourSynth no es un reproductor multimedia con interfaz gráfica de usuario; es un servidor de fotogramas (frameserver). Recibe vídeo de un decodificador, procesa fotogramas individuales a través de un script de Python y envía el vídeo modificado a un reproductor (como mpv o MacLC) o a un codificador (como FFmpeg).

¿Cuál es la diferencia entre VapourSynth y AviSynth?

AviSynth era una herramienta antigua exclusiva de Windows que usaba un lenguaje de scripting propio y peculiar con límites de memoria de 32 bits. VapourSynth es totalmente multiplataforma (funciona de forma nativa en macOS, Linux y Windows), usa Python 3 estándar, admite multihilo nativo de 64 bits y gestiona altas profundidades de bits (hasta coma flotante de 32 bits).

¿Cómo instalo VapourSynth en un Mac?

El método estándar y verificado para instalar VapourSynth en macOS es mediante Homebrew. Ejecutar 'brew install vapoursynth' en Terminal instala la librería central (libvapoursynth.dylib), la utilidad CLI vspipe y enlaza el módulo de Python 3 en /opt/homebrew.

Antes de descargar

MacLC es gratuito. Si te resulta útil, una aportación le ayuda a evitar el aviso «Abrir igualmente» y financia la próxima versión.