En esta página

Compilación de FFmpeg desde el código fuente en macOS

En esta página se explica cómo configurar y compilar FFmpeg en macOS. Los pasos necesarios son:

  • Descargar el código fuente de FFmpeg.
  • Instalar las dependencias necesarias.
  • Configurar FFmpeg desde la línea de comandos.
  • Compilar las bibliotecas de desarrollo.

Obtener el código fuente de FFmpeg

Puedes obtener el código fuente de FFmpeg de las siguientes maneras:

  • Descargándolo desde la página de descargas de FFmpeg.
  • Clonarlo desde Git. Por ejemplo, este comando clona la versión 9.0.1 del código fuente de FFmpeg en ~/ffmpeg.
    git clone --branch n9.0.1 https://git.ffmpeg.org/ffmpeg.git ffmpeg

Se recomienda utilizar la misma versión de FFmpeg que la indicada en la página principal deQt Multimedia .

En los párrafos siguientes se da por hecho que has guardado el código fuente de FFmpeg en ~/ffmpeg.

Requisitos previos

Para compilar FFmpeg, se necesitan estas herramientas y paquetes:

  • Homebrew.
  • Paquetes de Homebrew (yasm).

Instalación de Homebrew

Para instalar Homebrew, ejecuta:

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

Instalación de paquetes de Homebrew

Para instalar el paquete Yasm de Homebrew, ejecuta:

brew install yasm

Configuración y compilación de FFmpeg

Crea un directorio « build » dentro del directorio « ~/ffmpeg » y accede a él:

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

Para configurar FFmpeg, ejecuta:

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

El argumento ` --prefix ` especifica la ruta donde se instalarán las bibliotecas de desarrollo de FFmpeg tras la compilación. La documentación no es necesaria, pero deben habilitarse las funciones de red. Para compilar FFmpeg como bibliotecas estáticas, omite la opción ` --enable-shared `.

En el fragmento de código anterior, se ha utilizado intencionadamente una ruta absoluta para el argumento ` --prefix `. Si se especifica una ruta relativa (por ejemplo, ../install), se hará referencia a las dependencias utilizando esta ruta relativa y no la correcta, que es @rpath. El uso de rutas absolutas hace que la compilación de FFmpeg no sea portátil. Para utilizar rutas relativas y hacer que la compilación de FFmpeg sea portátil, es necesario corregir manualmente las dependencias mediante otool.

Una vez finalizado el comando configure, compila e instala FFmpeg utilizando el comando make.

make -j install

Si la compilación se completa sin errores, las bibliotecas de desarrollo de FFmpeg se instalan en el directorio /usr/local/ffmpeg. Si compilas Qt Multimedia, esta ruta se almacena en la variable FFMPEG_DIR, que se utiliza al configurar Qt Multimedia.

Configuración y compilación de binarios universales de FFmpeg

Para crear binarios universales en macOS (por ejemplo, tanto para la arquitectura x86_64 como para la arm64), sigue estos pasos:

  • Configurar y compilar FFmpeg para la arquitectura 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
  • Configurar y compilar FFmpeg para la arquitectura 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
  • Combina las compilaciones en un binario universal utilizando 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.