En esta página

Creación de FFmpeg desde el código fuente en Windows

Esta página explica cómo configurar y compilar FFmpeg en Windows. Los pasos necesarios son:

  • Obtener el código fuente de FFmpeg.
  • Instalar las dependencias necesarias.
  • Configurar FFmpeg desde la línea de comandos.
  • Construir las librerías de desarrollo.

Obtener el código fuente de FFmpeg

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

  • Descarga desde la página de descargas de FFmpeg.
  • Clonar desde git. Por ejemplo, este comando clona la versión 7.1.3 de las fuentes de FFmpeg a C:\FFmpeg\ffmpeg.
    git clone --branch n7.1.3 https://git.ffmpeg.org/ffmpeg.git ffmpeg

Se recomienda utilizar la misma versión de FFmpeg que la documentada en la página principalQt Multimedia .

En los párrafos siguientes se asume que almacenas el código fuente de FFmpeg en C:\FFmpeg\ffmpeg.

Requisitos previos

Para compilar FFmpeg, se necesitan estas herramientas y paquetes:

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

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

Instalación de MSYS2

Para instalar MSYS2, puede:

  • Utilizar el instalador de MSYS2.
  • Utilizar el gestor de paquetes winget.
    winget install msys2.msys2

Las instrucciones de este documento se basan en la instalación de MSYS2 en C:\msys64\, que es la ruta por defecto cuando se utiliza winget.

Una vez instalado, inicie el intérprete de comandos MSYS2 MINGW64 desde el menú de inicio de Windows y utilícelo para instalar las bibliotecas necesarias.

pacman -S --noconfirm make yasm diffutils

Antes de compilar FFmpeg, MSYS2 debe tener un compilador en su 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 compilar con Mingw-w64

Para MinGW-w64 instalado en C:\Qt\Tools\mingw1310_64\bin, puede añadirlo a PATH exportando la variable de entorno PATH.

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

Tenga en cuenta que también es posible instalar MinGW-w64 utilizando pacman.

pacman -S mingw-w64-x86_64-toolchain

Preparación del entorno MSYS2 para el MSVC

Construir FFmpeg con el compilador MSVC bajo MSYS2 requiere que MSYS2 se inicie con el compilador C y C++ apropiado 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 un símbolo del sistema existente ejecutando:
    "C:\Program Files\Microsoft Visual Studio\2022\BuildTools\VC\Auxiliary\Build\vcvarsall.bat" amd64

Desde este símbolo del sistema, inicie el intérprete de comandos MSYS2 con las opciones para seleccionar el entorno MINGW64 y habilitar la herencia de rutas.

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

Se abrirá una nueva ventana del intérprete de comandos en la que podrás comprobar que el compilador MSVC está disponible.

which cl.exe

Configuración y compilación de FFmpeg

Desde el intérprete de comandos MSYS2 preparado, vaya al directorio /c/FFmpeg. En este directorio, crea un directorio build que contendrá los artefactos de construcción de FFmpeg, y navega dentro de él.

cd /c/FFmpeg/build

Para configurar FFmpeg, ejecuta:

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

El argumento --prefix especifica una ruta en la que se instalan las bibliotecas de desarrollo de FFmpeg después de la compilación. La documentación no es necesaria, pero las características de red deben estar habilitadas. Para construir FFmpeg como bibliotecas estáticas, omite la opción --enable-shared.

Para configurar FFmpeg para ser compilado con MSVC, especifica la cadena de herramientas además de las otras 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 finaliza sin errores, las bibliotecas de desarrollo de FFmpeg se instalarán en el directorio C:\FFmpeg\install. Si construyes Qt Multimedia, esta ruta se almacena en la variable FFMPEG_DIR utilizada 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.