이 페이지에서

Windows에서 소스 코드를 사용하여 FFmpeg 빌드하기

이 페이지에서는 Windows에서 FFmpeg를 구성하고 빌드하는 방법을 설명합니다. 필요한 단계는 다음과 같습니다.

  • FFmpeg 소스 코드를 가져옵니다.
  • 필요한 종속성을 설치합니다.
  • 명령줄에서 FFmpeg를 구성합니다.
  • 개발용 라이브러리를 빌드합니다.

FFmpeg 소스 코드 구하기

다음과 같은 방법으로 FFmpeg 소스 코드를 구할 수 있습니다.

  • FFmpeg 다운로드 페이지에서 다운로드합니다.
  • Git에서 클론합니다. 예를 들어, 다음 명령어는 FFmpeg 소스 코드 버전 9.0.1을 C:\FFmpeg\ffmpeg 로 클론합니다.
    git clone --branch n9.0.1 https://git.ffmpeg.org/ffmpeg.git ffmpeg

Qt Multimedia 메인 페이지에 명시된 것과 동일한 FFmpeg 버전을 사용하는 것이 권장됩니다.

다음 내용에서는 FFmpeg 소스 코드를 C:\FFmpeg\ffmpeg 에 저장한 것으로 가정합니다.

필수 조건

FFmpeg를 빌드하려면 다음 도구와 패키지가 필요합니다:

  • Microsoft Visual Studio 컴파일러(MSVC) 또는 MinGW-w64.
  • MSYS2.
  • MSYS 패키지(make, yasm).

Qt에서도 지원하는 권장 컴파일러에 대해서는 ‘Windows용 Qt - 소스 코드로부터 빌드하기’를 참조하십시오. Qt Online Installer 를 사용하여 지원되는 MinGW-w64 컴파일러를 설치할 수 있습니다.

MSYS2 설치

MSYS2를 설치하려면 다음 방법을 사용할 수 있습니다.

  • MSYS2 설치 프로그램을 사용합니다.
  • winget 패키지 관리자를 사용합니다.
    winget install msys2.msys2

이 문서의 지침은 MSYS2가 C:\msys64\ 에 설치되어 있음을 전제로 합니다. 이는 winget 을 사용할 때의 기본 경로입니다.

설치가 완료되면 Windows 시작 메뉴에서 MSYS2 MINGW64 셸을 실행하고, 이를 사용하여 필요한 라이브러리를 설치하십시오.

pacman -S --noconfirm make yasm diffutils

FFmpeg를 빌드하기 전에, MSYS2의 PATH 에 컴파일러가 설치되어 있어야 합니다. MSVC와 MinGW-w64의 경우 설치 방법이 다릅니다. 사용하는 컴파일러에 맞게 MSYS2 환경을 준비하십시오.

Mingw-w64로 빌드하기 위한 MSYS 환경 준비

C:\Qt\Tools\mingw1310_64\bin 에 설치된 MinGW-w64의 경우, PATH 환경 변수를 설정하여 PATH 에 추가할 수 있습니다.

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

또한 pacman을 사용하여 MinGW-w64를 설치할 수도 있습니다.

pacman -S mingw-w64-x86_64-toolchain

MSVC용 MSYS2 환경 준비

MSYS2 환경에서 MSVC 컴파일러를 사용하여 FFmpeg를 빌드하려면, 경로에 적절한 C 및 C++ 컴파일러가 포함된 상태로 MSYS2를 시작해야 합니다. 64비트 빌드의 경우 다음을 수행할 수 있습니다:

  • Windows 시작 메뉴에서 Visual Studio x64 Native Tools 명령 프롬프트를 실행합니다.
  • 기존 명령 프롬프트에서 다음 명령을 실행하여 MSVC 컴파일러를 활성화합니다:
    "C:\Program Files\Microsoft Visual Studio\2022\BuildTools\VC\Auxiliary\Build\vcvarsall.bat" amd64

이 명령 프롬프트에서 MINGW64 환경을 선택하고 경로 상속을 활성화하는 옵션을 지정하여 MSYS2 셸을 실행합니다.

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

그러면 새로운 셸 창이 열리며, 여기서 MSVC 컴파일러를 사용할 수 있는지 확인할 수 있습니다.

which cl.exe

FFmpeg 구성 및 빌드

준비된 MSYS2 셸에서 /c/FFmpeg 디렉터리로 이동합니다. 이 디렉터리 내에 FFmpeg 빌드 결과물을 담을 build 디렉터리를 생성하고, 해당 디렉터리로 이동합니다.

cd /c/FFmpeg/build

FFmpeg을 구성하려면 다음 명령을 실행합니다:

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

--prefix 인수는 빌드 후 FFmpeg 개발 라이브러리가 설치될 경로를 지정합니다. 문서 옵션은 필요하지 않지만, 네트워크 기능은 활성화해야 합니다. FFmpeg를 정적 라이브러리로 빌드하려면 --enable-shared 옵션을 생략하십시오.

MSVC로 FFmpeg를 빌드하도록 구성하려면, 다른 명령줄 옵션 외에도 툴체인을 지정하십시오:

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

configure 명령이 완료되면, make 명령을 사용하여 FFmpeg를 빌드하고 설치하십시오.

make -j install

오류 없이 빌드가 완료되면 FFmpeg 개발 라이브러리가 C:\FFmpeg\install 디렉터리에 설치됩니다. Qt Multimedia 로 빌드하는 경우, 이 경로는 Qt Multimedia 를 구성할 때 사용되는 FFMPEG_DIR 변수에 저장됩니다.

© 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.