Documentación general

1 Bibliotecas externas

FFmpeg puede combinarse con numerosas bibliotecas externas para añadir compatibilidad con más formatos. Ninguna se utiliza de forma predeterminada: su uso debe solicitarse explícitamente pasando los flags adecuados a ./configure.

1.1 Alliance for Open Media (AOM)

FFmpeg puede utilizar la biblioteca AOM para la decodificación y codificación de AV1.

Visite http://aomedia.org/ y siga las instrucciones para instalar la biblioteca. A continuación, pase --enable-libaom a configure para habilitarlo.

1.2 AMD AMF/VCE

FFmpeg puede usar la biblioteca AMD Advanced Media Framework para acelerar la codificación H.264 y HEVC (solo en Windows) en hardware con Video Coding Engine (VCE).

Para habilitar la compatibilidad debe obtener los archivos de cabecera del framework AMF (versión 1.4.9 o superior) desde https://github.com/GPUOpen-LibrariesAndSDKs/AMF.git.

Cree un directorio AMF/ en la ruta de inclusión del sistema. Copie el contenido de AMF/amf/public/include/ en ese directorio. Luego configure FFmpeg con --enable-amf.

La inicialización del encoder amf ocurre en este orden: 1) se intenta inicializar mediante dx11 (solo Windows) 2) se intenta inicializar mediante dx9 (solo Windows) 3) se intenta inicializar mediante vulkan

Para usar el encoder h.264 (AMD VCE) en linux se requieren amdgru-pro versión 19.20 o superior y el paquete amf-amdgpu-pro (incluido en amdgru-pro, pero no se instala automáticamente).

Este controlador puede instalarse con el script amdgpu-pro-install del archivo oficial de controladores amd.

1.3 AviSynth

FFmpeg puede leer scripts de AviSynth como entrada. Para habilitar la compatibilidad, pase --enable-avisynth a configure después de instalar las cabeceras que proporciona AviSynth+. AviSynth+ puede configurarse para instalar solo las cabeceras, ya sea pasando -DHEADERS_ONLY:bool=on al sistema de compilación habitual basado en CMake, o usando el GNUmakefile incluido.

En Windows, las variantes de AviSynth compatibles son AviSynth 2.6 RC1 o posterior para compilaciones de 32 bits, y AviSynth+ r1718 o posterior para compilaciones de 32 y 64 bits.

En Linux, macOS y BSD, la única variante de AviSynth compatible es AviSynth+, a partir de la versión 3.5.

En 2016, AviSynth+ incorporó compatibilidad con la compilación mediante GCC. Sin embargo, debido a las peculiaridades de las convenciones de llamada de Windows, las compilaciones de 32 bits de AviSynth+ con GCC no son compatibles con las compilaciones típicas de 32 bits de FFmpeg.

De forma predeterminada, FFmpeg asume compatibilidad con las compilaciones de 32 bits de AviSynth+ con MSVC, ya que es la configuración de compilación más extendida y consolidada. Los usuarios pueden anular esto y habilitar la compatibilidad con compilaciones de 32 bits de AviSynth+ con GCC pasando -DAVSC_WIN32_GCC32 a --extra-cflags al configurar FFmpeg.

Las compilaciones de 64 bits de FFmpeg no se ven afectadas y pueden usar compilaciones de AviSynth+ con MSVC o con GCC sin ningún flag especial.

AviSynth(+) se carga dinámicamente. Los distribuidores pueden compilar FFmpeg con --enable-avisynth, y los binarios funcionarán independientemente de si el usuario final tiene AviSynth instalado. Si el usuario final desea usar scripts de AviSynth, puede instalar AviSynth(+) y FFmpeg podrá encontrarlo y usarlo para abrir los scripts.

1.4 Chromaprint

FFmpeg puede utilizar la biblioteca Chromaprint para generar huellas digitales de audio. Pase --enable-chromaprint a configure para habilitarlo. Consulte https://acoustid.org/chromaprint.

1.5 codec2

FFmpeg puede utilizar la biblioteca codec2 para la decodificación y codificación de codec2. Actualmente no existe un decoder nativo, por lo que debe usarse libcodec2 para decodificar.

Visite http://freedv.org/ y descargue "Codec 2 source archive". Compile e instale con CMake. Los usuarios de Debian pueden instalar en su lugar el paquete libcodec2-dev. Una vez instalado libcodec2, puede pasar --enable-libcodec2 a configure para habilitarlo.

La forma más sencilla de usar codec2 es con archivos .c2, ya que contienen la información de modo necesaria para decodificar. Para codificar un archivo así, use la extensión .c2 y proporcione al encoder de libcodec2 la opción -mode: ffmpeg -i input.wav -mode 700C output.c2. Reproducirlo es tan simple como ffplay output.c2. Para ver la lista de modos admitidos, ejecute ffmpeg -h encoder=libcodec2. También se admiten archivos codec2 en bruto. Para poder interpretarlos, el modo en uso debe especificarse como opción de formato: ffmpeg -f codec2raw -mode 1300 -i input.raw output.wav.

1.6 dav1d

FFmpeg puede utilizar la biblioteca dav1d para la decodificación de vídeo AV1.

Visite https://code.videolan.org/videolan/dav1d y siga las instrucciones para instalar la biblioteca. A continuación, pase --enable-libdav1d a configure para habilitarlo.

1.7 davs2

FFmpeg puede utilizar la biblioteca davs2 para la decodificación de vídeo AVS2-P2/IEEE1857.4.

Visite https://github.com/pkuvcl/davs2 y siga las instrucciones para instalar la biblioteca. A continuación, pase --enable-libdavs2 a configure para habilitarlo.

libdavs2 se distribuye bajo la GNU Public License versión 2 o posterior (véanse los detalles en http://www.gnu.org/licenses/old-licenses/gpl-2.0.html); para usarla debe actualizar la licencia de FFmpeg a GPL.

1.8 uavs3d

FFmpeg puede utilizar la biblioteca uavs3d para la decodificación de vídeo AVS3-P2/IEEE1857.10.

Visite https://github.com/uavs3/uavs3d y siga las instrucciones para instalar la biblioteca. A continuación, pase --enable-libuavs3d a configure para habilitarlo.

1.9 Game Music Emu

FFmpeg puede utilizar la biblioteca Game Music Emu para leer audio de los formatos de archivo de música de videojuegos admitidos. Pase --enable-libgme a configure para habilitarlo. Consulte https://bitbucket.org/mpyne/game-music-emu/overview.

1.10 Intel QuickSync Video

FFmpeg puede usar Intel QuickSync Video (QSV) para acelerar la decodificación y codificación de múltiples codecs. Para usar QSV, FFmpeg debe enlazarse con el dispatcher libmfx, que carga las bibliotecas de decodificación reales.

El dispatcher es de código abierto y puede descargarse desde https://github.com/lu-zero/mfx_dispatch.git. FFmpeg debe configurarse con la opción --enable-libmfx, y pkg-config debe poder localizar los archivos .pc del dispatcher.

1.11 Kvazaar

FFmpeg puede utilizar la biblioteca Kvazaar para la codificación de HEVC.

Visite https://github.com/ultravideo/kvazaar y siga las instrucciones para instalar la biblioteca. A continuación, pase --enable-libkvazaar a configure para habilitarlo.

1.12 LAME

FFmpeg puede utilizar la biblioteca LAME para la codificación de MP3.

Visite http://lame.sourceforge.net/ y siga las instrucciones para instalar la biblioteca. A continuación, pase --enable-libmp3lame a configure para habilitarlo.

1.13 LCEVCdec

FFmpeg puede utilizar la biblioteca liblcevc_dec para decodificar la capa de mejora LCEVC en los bitstreams admitidos.

Visite https://github.com/v-novaltd/LCEVCdec y siga las instrucciones para instalar la biblioteca. A continuación, pase --enable-liblcevc-dec a configure para habilitarlo.

LCEVCdec se distribuye bajo la licencia BSD-3-Clause-Clear.

1.14 libilbc

iLBC es un codec de voz de banda estrecha que Google puso a disposición de forma gratuita como parte del proyecto WebRTC. libilbc es una copia del codec iLBC más fácil de empaquetar. FFmpeg puede utilizar la biblioteca libilbc para la decodificación y codificación de iLBC.

Visite https://github.com/TimothyGu/libilbc y siga las instrucciones para instalar la biblioteca. A continuación, pase --enable-libilbc a configure para habilitarlo.

1.15 libjxl

JPEG XL es un formato de imagen concebido para reemplazar por completo al JPEG tradicional durante un largo periodo. Consulte https://jpegxl.info/ para más información y https://github.com/libjxl/libjxl para el código fuente de la biblioteca. Puede pasar --enable-libjxl a configure para habilitar el wrapper de libjxl.

1.16 libvpx

FFmpeg puede utilizar la biblioteca libvpx para la decodificación y codificación de VP8/VP9.

Visite http://www.webmproject.org/ y siga las instrucciones para instalar la biblioteca. A continuación, pase --enable-libvpx a configure para habilitarlo.

1.17 ModPlug

FFmpeg puede utilizar esta biblioteca, originada en Modplug-XMMS, para leer archivos de música de tipo MOD. Consulte https://github.com/Konstanty/libmodplug. Pase --enable-libmodplug a configure para habilitarlo.

1.18 ONNX Runtime

FFmpeg puede utilizar la biblioteca ONNX Runtime como backend para los filtros basados en DNN.

Visite https://onnxruntime.ai/ y siga las instrucciones para instalar la biblioteca. Hay paquetes precompilados disponibles para varias plataformas.

Configure FFmpeg con compatibilidad para ONNX Runtime:

./configure \
    --enable-libonnxruntime \
    --extra-cflags="-I/path/to/onnxruntime/include" \
    --extra-ldflags="-L/path/to/onnxruntime/lib"

En sistemas basados en ELF (Linux, BSD) quizá también quiera incrustar la ruta de búsqueda de bibliotecas para que el binario ffmpeg instalado encuentre la biblioteca compartida en tiempo de ejecución sin necesidad de definir LD_LIBRARY_PATH:

./configure \
    --enable-libonnxruntime \
    --extra-cflags="-I/path/to/onnxruntime/include" \
    --extra-ldflags="-L/path/to/onnxruntime/lib -Wl,-rpath,/path/to/onnxruntime/lib"

El flag -Wl,-rpath es específico de ELF y debe omitirse en otras plataformas (Windows, macOS).

Para compilaciones con MinGW GCC, añada el flag -D_stdcall=__stdcall para lograr compatibilidad con las cabeceras de ONNX Runtime.

1.19 Bibliotecas OpenCORE, VisualOn y Fraunhofer

Surgidas del código fuente de Google Android, las bibliotecas OpenCore, VisualOn y Fraunhofer proporcionan encoders para varios codecs de audio.

Las bibliotecas OpenCORE y VisualOn se distribuyen bajo la Apache License 2.0 (véanse los detalles en http://www.apache.org/licenses/LICENSE-2.0), incompatible con LGPL versión 2.1 y GPL versión 2. Para usarlas debe actualizar la licencia de FFmpeg a LGPL versión 3 (o a GPL versión 3 si tiene habilitados componentes GPL) pasando --enable-version3 a configure.

La licencia de la biblioteca Fraunhofer AAC es incompatible con la GPL. Por ello, en compilaciones GPL debe pasar --enable-nonfree a configure para poder usarla. Según nuestro conocimiento, sí es compatible con la LGPL.

1.19.1 OpenCORE AMR

FFmpeg puede utilizar las bibliotecas OpenCORE para la decodificación/codificación de AMR-NB y la decodificación de AMR-WB.

Visite http://sourceforge.net/projects/opencore-amr/ y siga las instrucciones para instalar las bibliotecas. A continuación, pase --enable-libopencore-amrnb y/o --enable-libopencore-amrwb a configure para habilitarlas.

1.19.2 Biblioteca del encoder VisualOn AMR-WB

FFmpeg puede utilizar la biblioteca VisualOn AMR-WBenc para la codificación de AMR-WB.

Visite http://sourceforge.net/projects/opencore-amr/ y siga las instrucciones para instalar la biblioteca. A continuación, pase --enable-libvo-amrwbenc a configure para habilitarlo.

1.19.3 Biblioteca Fraunhofer AAC

FFmpeg puede utilizar la biblioteca Fraunhofer AAC para la decodificación y codificación de AAC.

Visite http://sourceforge.net/projects/opencore-amr/ y siga las instrucciones para instalar la biblioteca. A continuación, pase --enable-libfdk-aac a configure para habilitarlo.

1.19.4 Biblioteca decoder Fraunhofer MPEG-H 3D Audio

FFmpeg puede utilizar la biblioteca decoder Fraunhofer MPEG-H para la decodificación de MPEG-H 3DA.

Visite https://github.com/Fraunhofer-IIS/mpeghdec y siga las instrucciones para instalar la biblioteca. A continuación, pase --enable-libmpeghdec --enable-nonfree a configure para habilitarlo.

1.19.5 Biblioteca LC3

FFmpeg puede utilizar la biblioteca Google LC3 para la decodificación y codificación de LC3.

Visite https://github.com/google/liblc3/ y siga las instrucciones para instalar la biblioteca. A continuación, pase --enable-liblc3 a configure para habilitarlo.

1.20 OpenH264

FFmpeg puede utilizar la biblioteca OpenH264 para la decodificación y codificación de H.264.

Visite http://www.openh264.org/ y siga las instrucciones para instalar la biblioteca. A continuación, pase --enable-libopenh264 a configure para habilitarlo.

Para la decodificación, esta biblioteca es mucho más limitada que el decoder integrado en libavcodec; actualmente carece de compatibilidad para decodificar B-frames y otras características de los perfiles main/high. (Por ahora solo admite el perfil constrained baseline y CABAC.) Resulta útil principalmente para pruebas y para aprovechar la licencia de la cartera de patentes de Cisco (http://www.openh264.org/BINARY_LICENSE.txt).

1.21 OpenJPEG

FFmpeg puede usar las bibliotecas OpenJPEG para decodificar/codificar vídeos J2K. Visite http://www.openjpeg.org/ para obtener las bibliotecas y siga las instrucciones de instalación. Para habilitar el uso de OpenJPEG en FFmpeg, pase --enable-libopenjpeg a ./configure.

1.22 rav1e

FFmpeg puede utilizar rav1e (Rust AV1 Encoder) a través de sus bindings de C para codificar vídeos. Visite https://github.com/xiph/rav1e/ y siga las instrucciones para compilar la biblioteca en C. Para habilitar el uso de rav1e en FFmpeg, pase --enable-librav1e a ./configure.

1.23 SVT-AV1

FFmpeg puede utilizar la biblioteca Scalable Video Technology for AV1 para la codificación de AV1.

Visite https://gitlab.com/AOMediaCodec/SVT-AV1/ y siga las instrucciones para instalar la biblioteca. A continuación, pase --enable-libsvtav1 a configure para habilitarlo.

1.24 SVT-JPEG-XS

FFmpeg puede utilizar la biblioteca Scalable Video Technology for JPEG-XS para la decodificación y codificación de JPEG-XS.

Visite https://github.com/OpenVisualCloud/SVT-JPEG-XS y siga las instrucciones para instalar la biblioteca. A continuación, pase --enable-libsvtjpegxs a configure para habilitarlo.

1.25 TwoLAME

FFmpeg puede utilizar la biblioteca TwoLAME para la codificación de MP2.

Visite http://www.twolame.org/ y siga las instrucciones para instalar la biblioteca. A continuación, pase --enable-libtwolame a configure para habilitarlo.

1.26 VapourSynth

FFmpeg puede leer scripts de VapourSynth como entrada. Para habilitar la compatibilidad, pase --enable-vapoursynth a configure. Vapoursynth se detecta mediante pkg-config. Se admiten las versiones 42 o superiores. Consulte http://www.vapoursynth.com/.

Por motivos de seguridad, los scripts de Vapoursynth no se detectan automáticamente, por lo que hay que forzar el formato de entrada. En las herramientas de línea de comandos ff*, añada -f vapoursynth antes de la entrada -i yourscript.vpy.

1.27 x264

FFmpeg puede utilizar la biblioteca x264 para la codificación de H.264.

Visite http://www.videolan.org/developers/x264.html y siga las instrucciones para instalar la biblioteca. A continuación, pase --enable-libx264 a configure para habilitarlo.

x264 se distribuye bajo la GNU Public License versión 2 o posterior (véanse los detalles en http://www.gnu.org/licenses/old-licenses/gpl-2.0.html); para usarla debe actualizar la licencia de FFmpeg a GPL.

1.28 x265

FFmpeg puede utilizar la biblioteca x265 para la codificación de HEVC.

Visite http://x265.org/developers.html y siga las instrucciones para instalar la biblioteca. A continuación, pase --enable-libx265 a configure para habilitarlo.

x265 se distribuye bajo la GNU Public License versión 2 o posterior (véanse los detalles en http://www.gnu.org/licenses/old-licenses/gpl-2.0.html); para usarla debe actualizar la licencia de FFmpeg a GPL.

1.29 xavs

FFmpeg puede utilizar la biblioteca xavs para la codificación de AVS.

Visite http://xavs.sf.net/ y siga las instrucciones para instalar la biblioteca. A continuación, pase --enable-libxavs a configure para habilitarlo.

1.30 xavs2

FFmpeg puede utilizar la biblioteca xavs2 para la codificación de vídeo AVS2-P2/IEEE1857.4.

Visite https://github.com/pkuvcl/xavs2 y siga las instrucciones para instalar la biblioteca. A continuación, pase --enable-libxavs2 a configure para habilitarlo.

libxavs2 se distribuye bajo la GNU Public License versión 2 o posterior (véanse los detalles en http://www.gnu.org/licenses/old-licenses/gpl-2.0.html); para usarla debe actualizar la licencia de FFmpeg a GPL.

1.31 eXtra-fast Essential Video Encoder (XEVE)

FFmpeg puede utilizar la biblioteca XEVE para la codificación de vídeo EVC.

Visite https://github.com/mpeg5/xeve y siga las instrucciones para instalar la biblioteca XEVE. A continuación, pase --enable-libxeve a configure para habilitarlo.

1.32 eXtra-fast Essential Video Decoder (XEVD)

FFmpeg puede utilizar la biblioteca XEVD para la decodificación de vídeo EVC.

Visite https://github.com/mpeg5/xevd y siga las instrucciones para instalar la biblioteca XEVD. A continuación, pase --enable-libxevd a configure para habilitarlo.

1.33 ZVBI

ZVBI es una biblioteca de decodificación de VBI que FFmpeg puede usar para decodificar páginas de teletexto DVB y subtítulos de teletexto DVB.

Visite http://sourceforge.net/projects/zapping/ y siga las instrucciones para instalar la biblioteca. A continuación, pase --enable-libzvbi a configure para habilitarlo.

2 Formatos de archivo, codecs o funciones admitidos

Puede usar las opciones -formats y -codecs para obtener una lista exhaustiva.

2.1 Formatos de archivo

FFmpeg admite los siguientes formatos de archivo a través de la biblioteca libavformat:

X indica que la característica de esa columna (codificación/decodificación) es compatible.

2.2 Formatos de imagen

FFmpeg puede leer y escribir imágenes para cada fotograma de una secuencia de vídeo. Se admiten los siguientes formatos de imagen:

X indica que la característica de esa columna (codificación/decodificación) es compatible.

E indica que la compatibilidad se proporciona mediante una biblioteca externa.

2.3 Codecs de vídeo

X indica que la característica de esa columna (codificación/decodificación) es compatible.

E indica que la compatibilidad se proporciona mediante una biblioteca externa.

2.4 Codecs de audio

X indica que la característica de esa columna (codificación/decodificación) es compatible.

E indica que la compatibilidad se proporciona mediante una biblioteca externa.

I indica que también hay disponible una versión solo con enteros (garantiza un buen rendimiento en sistemas sin compatibilidad de coma flotante por hardware).

2.5 Formatos de subtítulos

X indica que la característica es compatible.

E indica que la compatibilidad se proporciona mediante una biblioteca externa.

2.6 Protocolos de red

X indica que el protocolo es compatible.

E indica que la compatibilidad se proporciona mediante una biblioteca externa.

2.7 Dispositivos de entrada/salida

X indica que la entrada/salida es compatible.

2.8 Código de tiempo

Alojamiento proporcionado por telepoint.bg