Documentation générale

1 Bibliothèques externes

FFmpeg peut être associé à de nombreuses bibliothèques externes pour prendre en charge davantage de formats. Aucune n'est utilisée par défaut ; leur emploi doit être explicitement demandé en passant les indicateurs appropriés à ./configure.

1.1 Alliance for Open Media (AOM)

FFmpeg peut utiliser la bibliothèque AOM pour le décodage et l'encodage AV1.

Rendez-vous sur http://aomedia.org/ et suivez les instructions d'installation de la bibliothèque. Passez ensuite --enable-libaom à configure pour l'activer.

1.2 AMD AMF/VCE

FFmpeg peut utiliser la bibliothèque AMD Advanced Media Framework pour accélérer l'encodage H.264 et HEVC (Windows uniquement) sur du matériel doté du Video Coding Engine (VCE).

Pour activer la prise en charge, vous devez obtenir les fichiers d'en-tête du framework AMF (version 1.4.9 ou supérieure) depuis https://github.com/GPUOpen-LibrariesAndSDKs/AMF.git.

Créez un répertoire AMF/ dans le chemin d'inclusion système. Copiez-y le contenu de AMF/amf/public/include/. Configurez ensuite FFmpeg avec --enable-amf.

L'initialisation de l'encoder amf se déroule dans cet ordre : 1) tentative d'initialisation via dx11 (Windows uniquement) 2) tentative d'initialisation via dx9 (Windows uniquement) 3) tentative d'initialisation via vulkan

Pour utiliser l'encoder h.264 (AMD VCE) sous linux, la version 19.20 ou supérieure d'amdgru-pro et le paquet amf-amdgpu-pro (inclus dans amdgru-pro mais non installé automatiquement) sont nécessaires.

Ce pilote peut être installé à l'aide du script amdgpu-pro-install fourni dans l'archive officielle des pilotes amd.

1.3 AviSynth

FFmpeg peut lire des scripts AviSynth en entrée. Pour activer la prise en charge, passez --enable-avisynth à configure après avoir installé les en-têtes fournis par AviSynth+. AviSynth+ peut être configuré pour n'installer que les en-têtes, soit en passant -DHEADERS_ONLY:bool=on au système de build CMake habituel, soit en utilisant le GNUmakefile fourni.

Sous Windows, les variantes d'AviSynth prises en charge sont AviSynth 2.6 RC1 ou supérieur pour les builds 32 bits, et AviSynth+ r1718 ou supérieur pour les builds 32 et 64 bits.

Sous Linux, macOS et BSD, la seule variante d'AviSynth prise en charge est AviSynth+, à partir de la version 3.5.

En 2016, AviSynth+ a ajouté la prise en charge du build avec GCC. Cependant, en raison des particularités des conventions d'appel de Windows, les builds GCC 32 bits d'AviSynth+ ne sont pas compatibles avec les builds 32 bits habituels de FFmpeg.

Par défaut, FFmpeg suppose une compatibilité avec les builds MSVC 32 bits d'AviSynth+, car il s'agit de la configuration de build la plus répandue et la plus établie. Il est possible de modifier ce comportement et d'activer la prise en charge des builds GCC 32 bits d'AviSynth+ en passant -DAVSC_WIN32_GCC32 à --extra-cflags lors de la configuration de FFmpeg.

Les builds 64 bits de FFmpeg ne sont pas concernés et peuvent utiliser aussi bien les builds MSVC que GCC d'AviSynth+, sans indicateur particulier.

AviSynth(+) est chargé dynamiquement. Les distributeurs peuvent construire FFmpeg avec --enable-avisynth, et les binaires obtenus fonctionnent que l'utilisateur final ait AviSynth installé ou non. Si un utilisateur final souhaite ensuite utiliser des scripts AviSynth, il lui suffit d'installer AviSynth(+) pour que FFmpeg puisse le détecter et l'utiliser afin d'ouvrir les scripts.

1.4 Chromaprint

FFmpeg peut utiliser la bibliothèque Chromaprint pour générer des empreintes audio. Passez --enable-chromaprint à configure pour l'activer. Voir https://acoustid.org/chromaprint.

1.5 codec2

FFmpeg peut utiliser la bibliothèque codec2 pour le décodage et l'encodage codec2. Il n'existe pour l'instant aucun decoder natif ; le décodage doit donc passer par libcodec2.

Rendez-vous sur http://freedv.org/ et téléchargez "Codec 2 source archive". Construisez et installez la bibliothèque avec CMake. Les utilisateurs de Debian peuvent installer le paquet libcodec2-dev à la place. Une fois libcodec2 installé, passez --enable-libcodec2 à configure pour l'activer.

Le moyen le plus simple d'utiliser codec2 est de recourir aux fichiers .c2, car ils contiennent les informations de mode nécessaires au décodage. Pour créer un tel fichier, utilisez l'extension .c2 et donnez l'option -mode à l'encoder libcodec2 : ffmpeg -i input.wav -mode 700C output.c2. La lecture est aussi simple que ffplay output.c2. Pour obtenir la liste des modes pris en charge, exécutez ffmpeg -h encoder=libcodec2. Les fichiers codec2 bruts sont également pris en charge. Pour les interpréter correctement, le mode utilisé doit être indiqué comme option de format : ffmpeg -f codec2raw -mode 1300 -i input.raw output.wav.

1.6 dav1d

FFmpeg peut utiliser la bibliothèque dav1d pour le décodage vidéo AV1.

Rendez-vous sur https://code.videolan.org/videolan/dav1d et suivez les instructions d'installation de la bibliothèque. Passez ensuite --enable-libdav1d à configure pour l'activer.

1.7 davs2

FFmpeg peut utiliser la bibliothèque davs2 pour le décodage vidéo AVS2-P2/IEEE1857.4.

Rendez-vous sur https://github.com/pkuvcl/davs2 et suivez les instructions d'installation de la bibliothèque. Passez ensuite --enable-libdavs2 à configure pour l'activer.

libdavs2 est distribuée sous GNU Public License Version 2 ou supérieure (voir http://www.gnu.org/licenses/old-licenses/gpl-2.0.html pour plus de détails) ; pour l'utiliser, vous devez faire passer la licence de FFmpeg en GPL.

1.8 uavs3d

FFmpeg peut utiliser la bibliothèque uavs3d pour le décodage vidéo AVS3-P2/IEEE1857.10.

Rendez-vous sur https://github.com/uavs3/uavs3d et suivez les instructions d'installation de la bibliothèque. Passez ensuite --enable-libuavs3d à configure pour l'activer.

1.9 Game Music Emu

FFmpeg peut utiliser la bibliothèque Game Music Emu pour lire l'audio des formats de fichiers de musique de jeux vidéo pris en charge. Passez --enable-libgme à configure pour l'activer. Voir https://bitbucket.org/mpyne/game-music-emu/overview.

1.10 Intel QuickSync Video

FFmpeg peut utiliser Intel QuickSync Video (QSV) pour accélérer le décodage et l'encodage de plusieurs codecs. Pour utiliser QSV, FFmpeg doit être lié au dispatcher libmfx, qui charge les bibliothèques de décodage proprement dites.

Ce dispatcher est open source et peut être téléchargé depuis https://github.com/lu-zero/mfx_dispatch.git. FFmpeg doit être configuré avec l'option --enable-libmfx, et pkg-config doit pouvoir localiser les fichiers .pc du dispatcher.

1.11 Kvazaar

FFmpeg peut utiliser la bibliothèque Kvazaar pour l'encodage HEVC.

Rendez-vous sur https://github.com/ultravideo/kvazaar et suivez les instructions d'installation de la bibliothèque. Passez ensuite --enable-libkvazaar à configure pour l'activer.

1.12 LAME

FFmpeg peut utiliser la bibliothèque LAME pour l'encodage MP3.

Rendez-vous sur http://lame.sourceforge.net/ et suivez les instructions d'installation de la bibliothèque. Passez ensuite --enable-libmp3lame à configure pour l'activer.

1.13 LCEVCdec

FFmpeg peut utiliser la bibliothèque liblcevc_dec pour décoder la couche d'amélioration LCEVC sur les bitstreams pris en charge.

Rendez-vous sur https://github.com/v-novaltd/LCEVCdec et suivez les instructions d'installation de la bibliothèque. Passez ensuite --enable-liblcevc-dec à configure pour l'activer.

LCEVCdec est distribuée sous licence BSD-3-Clause-Clear.

1.14 libilbc

iLBC est un codec vocal à bande étroite mis gratuitement à disposition par Google dans le cadre du projet WebRTC. libilbc en est une copie facilitant l'empaquetage du codec iLBC. FFmpeg peut utiliser la bibliothèque libilbc pour le décodage et l'encodage iLBC.

Rendez-vous sur https://github.com/TimothyGu/libilbc et suivez les instructions d'installation de la bibliothèque. Passez ensuite --enable-libilbc à configure pour l'activer.

1.15 libjxl

JPEG XL est un format d'image destiné à remplacer complètement le JPEG traditionnel sur le long terme. Voir https://jpegxl.info/ pour plus d'informations, et https://github.com/libjxl/libjxl pour le code source de la bibliothèque. Vous pouvez passer --enable-libjxl à configure afin d'activer le wrapper libjxl.

1.16 libvpx

FFmpeg peut utiliser la bibliothèque libvpx pour le décodage et l'encodage VP8/VP9.

Rendez-vous sur http://www.webmproject.org/ et suivez les instructions d'installation de la bibliothèque. Passez ensuite --enable-libvpx à configure pour l'activer.

1.17 ModPlug

FFmpeg peut utiliser cette bibliothèque, issue de Modplug-XMMS, pour lire les fichiers musicaux de type MOD. Voir https://github.com/Konstanty/libmodplug. Passez --enable-libmodplug à configure pour l'activer.

1.18 ONNX Runtime

FFmpeg peut utiliser la bibliothèque ONNX Runtime comme backend pour les filtres basés sur des DNN.

Rendez-vous sur https://onnxruntime.ai/ et suivez les instructions d'installation de la bibliothèque. Des paquets précompilés sont disponibles pour diverses plateformes.

Configurez FFmpeg avec la prise en charge d'ONNX Runtime :

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

Sur les systèmes basés sur ELF (Linux, BSD), vous voudrez peut-être également intégrer le chemin de recherche de la bibliothèque, afin que le binaire ffmpeg installé retrouve la bibliothèque partagée à l'exécution sans avoir à définir 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"

L'indicateur -Wl,-rpath est spécifique à ELF et doit être omis sur les autres plateformes (Windows, macOS).

Pour les builds MinGW GCC, ajoutez l'indicateur -D_stdcall=__stdcall pour assurer la compatibilité avec les en-têtes d'ONNX Runtime.

1.19 Bibliothèques OpenCORE, VisualOn et Fraunhofer

Issues des sources de Google Android, les bibliothèques OpenCore, VisualOn et Fraunhofer fournissent des encoders pour un certain nombre de codecs audio.

Les bibliothèques OpenCORE et VisualOn sont distribuées sous Apache License 2.0 (voir http://www.apache.org/licenses/LICENSE-2.0 pour plus de détails), incompatible avec la LGPL version 2.1 et la GPL version 2. Pour les utiliser, vous devez faire passer la licence de FFmpeg en LGPL version 3 (ou, si des composants GPL sont activés, en GPL version 3) en passant --enable-version3 à configure.

La licence de la bibliothèque Fraunhofer AAC est incompatible avec la GPL. Par conséquent, pour les builds GPL, vous devez passer --enable-nonfree à configure afin de l'utiliser. À notre connaissance, elle est compatible avec la LGPL.

1.19.1 OpenCORE AMR

FFmpeg peut utiliser les bibliothèques OpenCORE pour le décodage/encodage AMR-NB et le décodage AMR-WB.

Rendez-vous sur http://sourceforge.net/projects/opencore-amr/ et suivez les instructions d'installation des bibliothèques. Passez ensuite --enable-libopencore-amrnb et/ou --enable-libopencore-amrwb à configure pour les activer.

1.19.2 Bibliothèque VisualOn AMR-WB encoder

FFmpeg peut utiliser la bibliothèque VisualOn AMR-WBenc pour l'encodage AMR-WB.

Rendez-vous sur http://sourceforge.net/projects/opencore-amr/ et suivez les instructions d'installation de la bibliothèque. Passez ensuite --enable-libvo-amrwbenc à configure pour l'activer.

1.19.3 Bibliothèque Fraunhofer AAC

FFmpeg peut utiliser la bibliothèque Fraunhofer AAC pour le décodage et l'encodage AAC.

Rendez-vous sur http://sourceforge.net/projects/opencore-amr/ et suivez les instructions d'installation de la bibliothèque. Passez ensuite --enable-libfdk-aac à configure pour l'activer.

1.19.4 Bibliothèque Fraunhofer MPEG-H 3D Audio decoder

FFmpeg peut utiliser la bibliothèque Fraunhofer MPEG-H decoder pour le décodage MPEG-H 3DA.

Rendez-vous sur https://github.com/Fraunhofer-IIS/mpeghdec et suivez les instructions d'installation de la bibliothèque. Passez ensuite --enable-libmpeghdec --enable-nonfree à configure pour l'activer.

1.19.5 Bibliothèque LC3

FFmpeg peut utiliser la bibliothèque Google LC3 pour le décodage et l'encodage LC3.

Rendez-vous sur https://github.com/google/liblc3/ et suivez les instructions d'installation de la bibliothèque. Passez ensuite --enable-liblc3 à configure pour l'activer.

1.20 OpenH264

FFmpeg peut utiliser la bibliothèque OpenH264 pour le décodage et l'encodage H.264.

Rendez-vous sur http://www.openh264.org/ et suivez les instructions d'installation de la bibliothèque. Passez ensuite --enable-libopenh264 à configure pour l'activer.

Pour le décodage, cette bibliothèque est bien plus limitée que le decoder intégré à libavcodec ; à l'heure actuelle, elle ne prend pas en charge le décodage des images B ni certaines autres fonctionnalités des profils main/high (elle ne prend en charge, pour l'instant, que le profil constrained baseline et le CABAC). Son usage est surtout utile à des fins de test et pour profiter de la licence du portefeuille de brevets de Cisco (http://www.openh264.org/BINARY_LICENSE.txt).

1.21 OpenJPEG

FFmpeg peut utiliser les bibliothèques OpenJPEG pour le décodage/encodage des vidéos J2K. Rendez-vous sur http://www.openjpeg.org/ pour obtenir les bibliothèques et suivez les instructions d'installation. Pour activer OpenJPEG dans FFmpeg, passez --enable-libopenjpeg à ./configure.

1.22 rav1e

FFmpeg peut utiliser rav1e (Rust AV1 Encoder), via ses liaisons C, pour encoder des vidéos. Rendez-vous sur https://github.com/xiph/rav1e/ et suivez les instructions pour construire la bibliothèque C. Pour activer rav1e dans FFmpeg, passez --enable-librav1e à ./configure.

1.23 SVT-AV1

FFmpeg peut utiliser la bibliothèque Scalable Video Technology for AV1 pour l'encodage AV1.

Rendez-vous sur https://gitlab.com/AOMediaCodec/SVT-AV1/ et suivez les instructions d'installation de la bibliothèque. Passez ensuite --enable-libsvtav1 à configure pour l'activer.

1.24 SVT-JPEG-XS

FFmpeg peut utiliser la bibliothèque Scalable Video Technology for JPEG-XS pour le décodage et l'encodage JPEG-XS.

Rendez-vous sur https://github.com/OpenVisualCloud/SVT-JPEG-XS et suivez les instructions d'installation de la bibliothèque. Passez ensuite --enable-libsvtjpegxs à configure pour l'activer.

1.25 TwoLAME

FFmpeg peut utiliser la bibliothèque TwoLAME pour l'encodage MP2.

Rendez-vous sur http://www.twolame.org/ et suivez les instructions d'installation de la bibliothèque. Passez ensuite --enable-libtwolame à configure pour l'activer.

1.26 VapourSynth

FFmpeg peut lire des scripts VapourSynth en entrée. Pour activer la prise en charge, passez --enable-vapoursynth à configure. Vapoursynth est détecté via pkg-config. Les versions 42 et supérieures sont prises en charge. Voir http://www.vapoursynth.com/.

Pour des raisons de sécurité, les scripts Vapoursynth ne sont pas détectés automatiquement ; le format d'entrée doit donc être forcé. Pour les outils en ligne de commande ff*, ajoutez -f vapoursynth avant l'entrée -i yourscript.vpy.

1.27 x264

FFmpeg peut utiliser la bibliothèque x264 pour l'encodage H.264.

Rendez-vous sur http://www.videolan.org/developers/x264.html et suivez les instructions d'installation de la bibliothèque. Passez ensuite --enable-libx264 à configure pour l'activer.

x264 est distribuée sous GNU Public License Version 2 ou supérieure (voir http://www.gnu.org/licenses/old-licenses/gpl-2.0.html pour plus de détails) ; pour l'utiliser, vous devez faire passer la licence de FFmpeg en GPL.

1.28 x265

FFmpeg peut utiliser la bibliothèque x265 pour l'encodage HEVC.

Rendez-vous sur http://x265.org/developers.html et suivez les instructions d'installation de la bibliothèque. Passez ensuite --enable-libx265 à configure pour l'activer.

x265 est distribuée sous GNU Public License Version 2 ou supérieure (voir http://www.gnu.org/licenses/old-licenses/gpl-2.0.html pour plus de détails) ; pour l'utiliser, vous devez faire passer la licence de FFmpeg en GPL.

1.29 xavs

FFmpeg peut utiliser la bibliothèque xavs pour l'encodage AVS.

Rendez-vous sur http://xavs.sf.net/ et suivez les instructions d'installation de la bibliothèque. Passez ensuite --enable-libxavs à configure pour l'activer.

1.30 xavs2

FFmpeg peut utiliser la bibliothèque xavs2 pour l'encodage vidéo AVS2-P2/IEEE1857.4.

Rendez-vous sur https://github.com/pkuvcl/xavs2 et suivez les instructions d'installation de la bibliothèque. Passez ensuite --enable-libxavs2 à configure pour l'activer.

libxavs2 est distribuée sous GNU Public License Version 2 ou supérieure (voir http://www.gnu.org/licenses/old-licenses/gpl-2.0.html pour plus de détails) ; pour l'utiliser, vous devez faire passer la licence de FFmpeg en GPL.

1.31 eXtra-fast Essential Video Encoder (XEVE)

FFmpeg peut utiliser la bibliothèque XEVE pour l'encodage vidéo EVC.

Rendez-vous sur https://github.com/mpeg5/xeve et suivez les instructions d'installation de la bibliothèque XEVE. Passez ensuite --enable-libxeve à configure pour l'activer.

1.32 eXtra-fast Essential Video Decoder (XEVD)

FFmpeg peut utiliser la bibliothèque XEVD pour le décodage vidéo EVC.

Rendez-vous sur https://github.com/mpeg5/xevd et suivez les instructions d'installation de la bibliothèque XEVD. Passez ensuite --enable-libxevd à configure pour l'activer.

1.33 ZVBI

ZVBI est une bibliothèque de décodage VBI que FFmpeg peut utiliser pour décoder les pages de télétexte DVB et les sous-titres télétexte DVB.

Rendez-vous sur http://sourceforge.net/projects/zapping/ et suivez les instructions d'installation de la bibliothèque. Passez ensuite --enable-libzvbi à configure pour l'activer.

2 Formats de fichiers, codecs et fonctionnalités pris en charge

Les options -formats et -codecs permettent d'obtenir une liste exhaustive.

2.1 Formats de fichiers

FFmpeg prend en charge les formats de fichiers suivants via la bibliothèque libavformat :

X signifie que la fonctionnalité de cette colonne (encodage / décodage) est prise en charge.

2.2 Formats d'image

FFmpeg peut lire et écrire des images pour chaque image d'une séquence vidéo. Les formats d'image suivants sont pris en charge :

X signifie que la fonctionnalité de cette colonne (encodage / décodage) est prise en charge.

E signifie que la prise en charge est assurée par une bibliothèque externe.

2.3 Codecs vidéo

X signifie que la fonctionnalité de cette colonne (encodage / décodage) est prise en charge.

E signifie que la prise en charge est assurée par une bibliothèque externe.

2.4 Codecs audio

X signifie que la fonctionnalité de cette colonne (encodage / décodage) est prise en charge.

E signifie que la prise en charge est assurée par une bibliothèque externe.

I signifie qu'une version entière (integer-only) est également disponible (elle garantit de bonnes performances sur les systèmes dépourvus de calcul flottant matériel).

2.5 Formats de sous-titres

X signifie que la fonctionnalité est prise en charge.

E signifie que la prise en charge est assurée par une bibliothèque externe.

2.6 Protocoles réseau

X signifie que le protocole est pris en charge.

E signifie que la prise en charge est assurée par une bibliothèque externe.

2.7 Périphériques d'entrée/sortie

X signifie que l'entrée/sortie est prise en charge.

2.8 Code temporel

Hébergement fourni par telepoint.bg