En esta página

Compilación de FFmpeg a partir del código fuente en Windows

En esta página se explica cómo configurar y compilar FFmpeg en Windows. Los pasos a seguir 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 C:\FFmpeg\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 C:\FFmpeg\ffmpeg.

Requisitos previos

Para compilar FFmpeg, se necesitan estas herramientas y paquetes:

  • El compilador Microsoft Visual Studio (MSVC) o MinGW-w64.
  • MSYS2.
  • Paquetes de MSYS (make, yasm).

Consulta Qt para Windows: compilación desde el código fuente para ver los compiladores recomendados que también son compatibles con Qt. Puedes instalar un compilador MinGW-w64 compatible utilizando Qt Online Installer.

Instalación de MSYS2

Para instalar MSYS2, puedes:

Las instrucciones de este documento dan por hecho que MSYS2 está instalado en C:\msys64\, que es la ruta predeterminada al utilizar winget.

Una vez instalado, abre el shell de MSYS2 MINGW64 desde el menú de inicio de Windows y utilízalo para instalar las bibliotecas necesarias.

pacman -S --noconfirm make yasm diffutils

Antes de compilar FFmpeg, MSYS2 debe tener un compilador en su directorio « PATH ». Esto se hace de forma diferente para MSVC y MinGW-w64. Prepara el entorno MSYS2 para el compilador que utilices.

Preparación del entorno MSYS para la compilación con MinGW-w64

Si MinGW-w64 está instalado en C:\Qt\Tools\mingw1310_64\bin, puedes añadirlo a la variable de entorno PATH ( PATH ) exportando la variable de entorno PATH.

export PATH=/c/Qt/Tools/mingw1310_64/bin:$PATH

Ten en cuenta que también es posible instalar MinGW-w64 mediante pacman.

pacman -S mingw-w64-x86_64-toolchain

Preparación del entorno MSYS2 para MSVC

Para compilar FFmpeg con el compilador MSVC en MSYS2, es necesario iniciar MSYS2 con el compilador de C y C++ adecuado en la ruta. Para una compilación de 64 bits, puedes:

  • Iniciar el Símbolo del sistema de Visual Studio x64 Native Tools desde el menú de inicio de Windows.
  • Habilitar el compilador MSVC desde una línea de comandos existente ejecutando:
    "C:\Program Files\Microsoft Visual Studio\2022\BuildTools\VC\Auxiliary\Build\vcvarsall.bat" amd64

Desde esta línea de comandos, inicia el shell de MSYS2 con las opciones para seleccionar el entorno MINGW64 y habilitar la herencia de la ruta de acceso.

C:\msys64\msys2_shell.cmd -mingw64 -full-path

Esto abre una nueva ventana de shell en la que puedes comprobar que el compilador MSVC está disponible.

which cl.exe

Configuración y compilación de FFmpeg

Desde el shell de MSYS2 ya preparado, navega hasta el directorio /c/FFmpeg. En este directorio, crea un directorio build que contendrá los archivos resultantes de la compilación de FFmpeg y accede a él.

cd /c/FFmpeg/build

Para configurar FFmpeg, ejecuta:

../configure --prefix=../install --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 ».

Para configurar FFmpeg para su compilación con MSVC, especifica la cadena de herramientas además de las demás opciones de la línea de comandos:

../configure --prefix=../install --disable-doc --enable-network --enable-shared --toolchain=msvc

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 C:\FFmpeg\install. 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.