Sur cette page

Compiler FFmpeg à partir du code source sous macOS

Cette page explique comment configurer et compiler FFmpeg sous macOS. Les étapes à suivre sont les suivantes :

  • Télécharger le code source de FFmpeg.
  • Installez les dépendances requises.
  • Configurer FFmpeg depuis la ligne de commande.
  • Compiler les bibliothèques de développement.

Obtenir le code source de FFmpeg

Vous pouvez obtenir le code source de FFmpeg de différentes manières :

  • Téléchargez-le depuis la page de téléchargement de FFmpeg.
  • Cloner depuis Git. Par exemple, cette commande clone la version 9.0.1 des sources de FFmpeg vers ~/ffmpeg.
    git clone --branch n9.0.1 https://git.ffmpeg.org/ffmpeg.git ffmpeg

Il est recommandé d’utiliser la même version de FFmpeg que celle indiquée sur la page d’accueil deQt Multimedia .

Les paragraphes suivants partent du principe que vous stockez le code source de FFmpeg dans le répertoire ~/ffmpeg.

Prérequis

Pour compiler FFmpeg, les outils et paquets suivants sont requis :

Installation de Homebrew

Pour installer Homebrew, exécutez la commande suivante :

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

Installation des paquets Homebrew

Pour installer le paquet Homebrew Yasm, exécutez :

brew install yasm

Configuration et compilation de FFmpeg

Créez un répertoire « build » à l'intérieur du répertoire « ~/ffmpeg » et accédez-y :

mkdir ~/ffmpeg/build
cd ~/ffmpeg/build

Pour configurer FFmpeg, exécutez :

../configure --prefix=/usr/local/ffmpeg --disable-doc --enable-network --enable-shared

L'argument ` --prefix ` spécifie le chemin d'accès où les bibliothèques de développement de FFmpeg seront installées après la compilation. La documentation n'est pas nécessaire, mais les fonctionnalités réseau doivent être activées. Pour compiler FFmpeg sous forme de bibliothèques statiques, omettez l'option ` --enable-shared `.

Dans l’extrait de code précédent, un chemin absolu a été utilisé intentionnellement pour l’argument --prefix. Si vous spécifiez un chemin d’accès relatif (par exemple, ../install), les dépendances seront référencées à l’aide de ce chemin relatif et non du chemin correct utilisant @rpath. L’utilisation de chemins d’accès absolus rend la compilation de FFmpeg non portable. Pour utiliser des chemins d’accès relatifs et rendre la compilation de FFmpeg portable, vous devez corriger manuellement les dépendances à l’aide d’otool.

Une fois la commande ` configure ` terminée, compilez et installez FFmpeg à l’aide de la commande ` make `.

make -j install

Si la compilation s’effectue sans erreur, les bibliothèques de développement FFmpeg sont installées dans le répertoire /usr/local/ffmpeg. Si vous compilez Qt Multimedia, ce chemin est stocké dans la variable FFMPEG_DIR utilisée lors de la configuration de Qt Multimedia.

Configuration et compilation des binaires universels FFmpeg

Pour créer des binaires universels sous macOS (par exemple, pour les architectures x86_64 et arm64), procédez comme suit :

  • Configurer et compiler FFmpeg pour l'architecture arm64 :
    ../configure --prefix=/usr/local/ffmpeg/arm64 --disable-doc --enable-network \
        --enable-shared --enable-cross-compile --arch=arm64 --cc="clang -arch arm64"
    make -j install
  • Configurer et compiler FFmpeg pour l'architecture x86_64 :
    ../configure --prefix=/usr/local/ffmpeg/x86_64 --disable-doc --enable-network \
        --enable-shared --enable-cross-compile --arch=x86_64 --cc="clang -arch x86_64"
    make -j install
  • Combinez les versions compilées en un binaire universel à l'aide de lipo.

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.