Compilación de FFmpeg desde el código fuente en Linux
En esta página se explica cómo configurar y compilar FFmpeg en Linux. 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 formas:
- 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 las siguientes herramientas y paquetes:
- Yasm.
- Paquetes de desarrollo para el backend de seguridad que hayas elegido (véase más abajo).
Instalación de paquetes
Para instalar los paquetes necesarios (incluido Yasm para FFmpeg), ejecuta:
apt-get install yasmAdemás, si vas a habilitar un backend de seguridad, necesitarás el paquete de desarrollo correspondiente, por ejemplo:
apt-get install libssl-devPara otros backends, instala los paquetes pertinentes:
- Para OpenSSL:
libssl-dev. - Para GnuTLS:
libgnutls-dev. - Para LibreSSL (libtls):
libtls-dev. - Para MbedTLS:
libmbedtls-dev.
Configuración y compilación de FFmpeg
Crea un directorio « build » dentro del directorio « ~/ffmpeg » y accede a él:
mkdir ~/ffmpeg/build
cd ~/ffmpeg/buildPara configurar FFmpeg, ejecuta:
../configure --prefix=/usr/local/ffmpeg --disable-doc --enable-network --enable-sharedEl 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 ».
Si estás compilando FFmpeg con un backend de seguridad, elige la opción adecuada:
../configure --enable-openssl # For OpenSSL
../configure --enable-gnutls # For GnuTLS
../configure --enable-libtls # For LibreSSL (libtls)
../configure --enable-mbedtls # For MbedTLSAsegúrate de tener instalado el paquete de desarrollo correspondiente, tal y como se ha mencionado anteriormente.
Aceleración por hardware
Por defecto, FFmpeg se compila sin aceleración por hardware a menos que se instalen los paquetes adecuados. Para obtener un mejor rendimiento, especialmente en sistemas con soporte para GPU, se recomienda instalar los paquetes de desarrollo de VAAPI:
apt-get install libva-devEsto permitirá que FFmpeg detecte la compatibilidad con VAAPI durante la configuración.
Si vas a utilizar FFmpeg con tarjetas gráficas NVIDIA, debes instalar los encabezados de códecs de NVIDIA. Se pueden descargar desde el siguiente repositorio: Encabezados de códecs de NVIDIA en GitHub.
Para compilar e instalar los encabezados, ejecuta los siguientes comandos:
mkdir ~/nv-codec-headers
cd ~/nv-codec-headers
git clone https://github.com/FFmpeg/nv-codec-headers.git
mkdir build
cd build
make -j installAsegúrate de comprobar la compatibilidad de los encabezados de códec de NVIDIA ( nv-codec-headers ) con tu versión del controlador de NVIDIA, ya que los más recientes ( nv-codec-headers ) pueden no ser compatibles con versiones anteriores del controlador. Consulta la documentación oficial para obtener más detalles.
Desactivación de la detección automática
Por defecto, FFmpeg intenta detectar automáticamente las dependencias disponibles en el sistema de compilación. Esto incluye la aceleración por hardware y los backends de seguridad. Si deseas desactivar la detección automática (por ejemplo, para evitar compilar dependencias innecesarias), puedes utilizar:
../configure --disable-autodetectSi estás compilando FFmpeg con alguna dependencia adicional (como un backend de seguridad o aceleración por hardware), asegúrate de que las bibliotecas necesarias estén instaladas en el sistema de destino. Hay varias formas de hacerlo:
- Proporcionar los binarios de las dependencias junto con FFmpeg.
- Asegúrate de que los binarios necesarios estén instalados en el sistema de destino.
- Implementar stubs de bibliotecas que puedan buscar las bibliotecas reales y devuelvan un código de error si no se encuentran.
RPATH y RUNPATH en Linux
En Linux, FFmpeg utiliza las secciones de metadatos RPATH y RUNPATH para gestionar las rutas de las bibliotecas. Recomendamos utilizar la utilidad patchelf para configurar la ruta de ejecución correcta:
patchelf --set-rpath "new/runpath" lib.soPor defecto, patchelf modifica el RUNPATH, ya que RPATH se considera obsoleto en Linux. Para establecer una ruta de ejecución relativa, puedes utilizar la variable $ORIGIN, que hace que la ruta sea relativa a la ubicación del ejecutable:
patchelf --set-rpath "$ORIGIN/../lib" lib.soEste enfoque garantiza la portabilidad al vincular las bibliotecas en función de sus ubicaciones relativas.
Compilación de FFmpeg
Una vez finalizado el comando ` configure `, compila e instala FFmpeg utilizando el comando ` make `.
make -j installSi 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.
© 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.