How to build QSVEnc

Windows
Linux

Windows

0. Requirements

To build QSVEnc, components below are required.

Visual Studio 2022
Avisynth SDK
VapourSynth SDK

Install Avisynth+ and VapourSynth, with the SDKs.

Then, "avisynth_c.h" of the Avisynth+ SDK and "VapourSynth.h" of the VapourSynth SDK should be added to the include path of Visual Studio.

These include path can be passed by environment variables "AVISYNTH_SDK" and "VAPOURSYNTH_SDK".

With default installation, environment variables could be set as below.

setx AVISYNTH_SDK "C:\Program Files (x86)\AviSynth+\FilterSDK"
setx VAPOURSYNTH_SDK "C:\Program Files (x86)\VapourSynth\sdk"

OpenCL header files will also be needed, and the include path shall be passed by environment variables "OPENCL_HEADERS".

git clone https://github.com/KhronosGroup/OpenCL-Headers.git <path-to-clone>
setx OPENCL_HEADERS <path-to-clone>

1. Download source code

git clone https://github.com/rigaya/QSVEnc --recursive
cd QSVEnc
curl -s -o ffmpeg_lgpl.7z -L https://github.com/rigaya/ffmpeg_dlls_for_hwenc/releases/download/20241102/ffmpeg_dlls_for_hwenc_20241102.7z
7z x -offmpeg_lgpl -y ffmpeg_lgpl.7z

2. Build QSVEncC.exe / QSVEnc.auo

Finally, open QSVEnc.sln, and start build of QSVEnc by Visual Studio.

	For Debug build	For Release build
QSVEnc.auo (win32 only)	Debug	Release
QSVEncC(64).exe	DebugStatic	RelStatic

Linux (Ubuntu 20.04 - 24.04)

0. Requirements

C++17 Compiler
Intel Driver
git
cmake
rust + cargo-c
libraries
- libva, libdrm
- ffmpeg 4.x - 7.x libs (libavcodec*, libavformat*, libavfilter*, libavutil*, libswresample*, libavdevice*)
- libass9
- [Optional] VapourSynth

1. Install build tools

Install build tools

sudo apt install build-essential git libtool pkg-config git cmake

Install rust + cargo-c (for libdovi, libhdr10plus build)

sudo apt install libssl-dev curl
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y --profile minimal \
  && . ~/.cargo/env \
  && cargo install cargo-c

2. Install Intel driver

Intel media driver can be installed following instruction on this link.

First, install required tools.

sudo apt-get install -y gpg-agent wget

Next, add Intel package repository.

# Ubuntu 24.04
# This step can be skipped.

# Ubuntu 22.04
wget -qO - https://repositories.intel.com/gpu/intel-graphics.key | sudo gpg --yes --dearmor --output /usr/share/keyrings/intel-graphics.gpg
echo "deb [arch=amd64 signed-by=/usr/share/keyrings/intel-graphics.gpg] https://repositories.intel.com/gpu/ubuntu jammy client" | \
  sudo tee /etc/apt/sources.list.d/intel-gpu-jammy.list

# Ubuntu 20.04
wget -qO - https://repositories.intel.com/graphics/intel-graphics.key | sudo gpg --yes --dearmor --output /usr/share/keyrings/intel-graphics.gpg
echo 'deb [arch=amd64 signed-by=/usr/share/keyrings/intel-graphics-keyring.gpg] https://repositories.intel.com/gpu/ubuntu focal client' | \
  sudo tee /etc/apt/sources.list.d/intel-graphics.list

Then install Intel Media driver.

sudo apt update
sudo apt install intel-media-va-driver-non-free intel-opencl-icd

3. Install required libraries

sudo apt install \
  libva-drm2 \
  libva-x11-2 \
  libva-glx2 \
  libx11-dev \
  libigfxcmrt7 \
  libva-dev \
  libdrm-dev \
  opencl-headers

sudo apt install ffmpeg \
  libavcodec-extra libavcodec-dev libavutil-dev libavformat-dev libswresample-dev libavfilter-dev libavdevice-dev \
  libass9 libass-dev

4. [Optional] Install VapourSynth

VapourSynth is required only if you need VapourSynth(vpy) reader support.

Please go on to [5. Build QSVEncC] if you don't need vpy reader.

How to build VapourSynth

4.1 Install build tools for VapourSynth

sudo apt install python3-pip autoconf automake libtool meson

4.2 Install zimg

git clone https://github.com/sekrit-twc/zimg.git --recursive
cd zimg
./autogen.sh
./configure
make && sudo make install
cd ..

4.3 Install cython

sudo pip3 install Cython

4.4 Install VapourSynth

git clone https://github.com/vapoursynth/vapoursynth.git
cd vapoursynth
./autogen.sh
./configure
make && sudo make install

# Make sure vapoursynth could be imported from python
# Change "python3.x" depending on your encironment
sudo ln -s /usr/local/lib/python3.x/site-packages/vapoursynth.so /usr/lib/python3.x/lib-dynload/vapoursynth.so
sudo ldconfig

4.5 Check if VapourSynth has been installed properly

Make sure you get version number without errors.

vspipe --version

4.6 [Option] Build vslsmashsource

# Install lsmash
git clone https://github.com/l-smash/l-smash.git
cd l-smash
./configure --enable-shared
make && sudo make install
cd ..
 
# Install vslsmashsource
git clone https://github.com/Mr-Ojii/L-SMASH-Works.git
cd L-SMASH-Works/Avisynth
meson build
cd build
ninja && sudo ninja install
cd ../../../

5. [Optional] Install AvisynthPlus

AvisynthPlus is required only if you need AvisynthPlus(avs) reader support.

Please go on to [7. Build QSVEncC] if you don't need avs reader.

How to build AvisynthPlus

5.1 Install build tools for AvisynthPlus

sudo apt install cmake

5.2 Install AvisynthPlus

git clone https://github.com/AviSynth/AviSynthPlus.git
cd AviSynthPlus
mkdir avisynth-build && cd avisynth-build 
cmake ../
make && sudo make install
cd ../..

5.3 [Option] Build lsmashsource

# Install lsmash
git clone https://github.com/l-smash/l-smash.git
cd l-smash
./configure --enable-shared
make && sudo make install
cd ..
 
# Install vslsmashsource
git clone https://github.com/Mr-Ojii/L-SMASH-Works.git
cd L-SMASH-Works/VapourSynth
meson build
cd build
ninja && sudo ninja install
cd ../../../

6. Add user to proper group

# QSV
sudo gpasswd -a ${USER} video
# OpenCL
sudo gpasswd -a ${USER} render

7. Build QSVEncC

git clone https://github.com/rigaya/QSVEnc --recursive
cd QSVEnc
./configure
make

Check if it works properly.

./qsvencc --check-hw

You shall get results below if Quick Sync Video works properly.

Success: QuickSyncVideo (hw encoding) available

Linux (Ubuntu 18.04)

In Ubuntu 18.04, you may additionally need to build libva, and media-driver yourself.

0. Requirements

C++17 Compiler
git
cmake
rust + cargo-c
libraries
- ffmpeg 4.x libs (libavcodec58, libavformat58, libavfilter7, libavutil56, libswresample3, libavdevice58)
- libass9
- [Optional] VapourSynth

1. Install build tools

Install build tools

sudo apt install build-essential meson automake libtool cmake pkg-config git cmake

Install rust + cargo-c (for libdovi build)

sudo apt install libssl-dev curl
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y --profile minimal \
  && . ~/.cargo/env \
  && cargo install cargo-c

2. Install libva

2.1 Install libva dependencies

sudo apt-get install  libdrm-dev libx11-dev libxext-dev libxfixes-dev

2.2 Build libva

git clone https://github.com/intel/libva.git
cd libva
./autogen.sh
./configure

You shall get output as below.

---------------------------------------------------------------
libva - 2.9.0 (VA-API 1.9.0)

Installation prefix .............. : /usr/local
Default driver path .............. : ${exec_prefix}/lib/dri
Extra window systems ............. : drm x11
Build documentation .............. : no
Build with messaging ............. : yes
---------------------------------------------------------------

Then, build and install.

make && sudo make install
cd ..

4. Install media driver

4.1 Build gmmlib

git clone https://github.com/intel/gmmlib.git
cd gmmlib
mkdir build && cd build
cmake -DCMAKE_BUILD_TYPE=Release ..
make && sudo make install
cd ../..

Files below will be installed.

-- Install configuration: ""
-- Installing: /usr/local/lib/dri/iHD_drv_video.so
-- Installing: /usr/local/lib/libigfxcmrt.so.7.2.0
-- Installing: /usr/local/lib/libigfxcmrt.so.7
-- Installing: /usr/local/lib/libigfxcmrt.so
-- Installing: /usr/local/include/igfxcmrt/cm_rt.h
-- Installing: /usr/local/include/igfxcmrt/cm_rt_g8.h
-- Installing: /usr/local/include/igfxcmrt/cm_rt_g9.h
-- Installing: /usr/local/include/igfxcmrt/cm_rt_g10.h
-- Installing: /usr/local/include/igfxcmrt/cm_rt_g11.h
-- Installing: /usr/local/include/igfxcmrt/cm_rt_g12_tgl.h
-- Installing: /usr/local/include/igfxcmrt/cm_hw_vebox_cmd_g10.h
-- Installing: /usr/local/include/igfxcmrt/cm_rt_def_os.h
-- Installing: /usr/local/include/igfxcmrt/cm_rt_api_os.h
-- Installing: /usr/local/include/igfxcmrt/cm_rt_extension.h
-- Installing: /usr/local/lib/pkgconfig/igfxcmrt.pc

4.2 Build media driver

sudo apt install libdrm-dev xorg xorg-dev openbox libx11-dev libgl1-mesa-glx libgl1-mesa-dev
git clone https://github.com/intel/media-driver.git
mkdir build_media && cd build_media
cmake ../media-driver
make && sudo make install
cd ..

5. Install Intel OpenCL runtime libraries

OpenCL driver can be innstalled following instruction on this link.

sudo apt-get install -y gpg-agent wget
wget -qO - https://repositories.intel.com/graphics/intel-graphics.key |
  sudo apt-key add -
sudo apt-add-repository \
  'deb [arch=amd64] https://repositories.intel.com/graphics/ubuntu bionic main'
sudo apt-get update
sudo apt-get install \
  intel-opencl \
  intel-level-zero-gpu level-zero
sudo apt install opencl-headers

6. Install ffmpeg 4.x libraries

sudo add-apt-repository ppa:jonathonf/ffmpeg-4
sudo apt update
sudo apt install ffmpeg \
  libavcodec-extra58 libavcodec-dev libavutil56 libavutil-dev libavformat58 libavformat-dev libavdevice58 libavdevice-dev \
  libswresample3 libswresample-dev libavfilter-extra7 libavfilter-dev libass9 libass-dev

7. [Optional] Install VapourSynth

VapourSynth is required only if you need VapourSynth(vpy) reader support.

Please go on to [5. Build QSVEncC] if you don't need vpy reader.

How to build VapourSynth

7.1 Install build tools for VapourSynth

sudo apt install python3-pip autoconf automake libtool meson

7.2 Install zimg

git clone https://github.com/sekrit-twc/zimg.git --recursive
cd zimg
./autogen.sh
./configure
make && sudo make install
cd ..

7.3 Install cython

sudo pip3 install Cython

7.4 Install VapourSynth

git clone https://github.com/vapoursynth/vapoursynth.git
cd vapoursynth
./autogen.sh
./configure
make && sudo make install

# Make sure vapoursynth could be imported from python
# Change "python3.x" depending on your encironment
sudo ln -s /usr/local/lib/python3.x/site-packages/vapoursynth.so /usr/lib/python3.x/lib-dynload/vapoursynth.so
sudo ldconfig

7.5 Check if VapourSynth has been installed properly

Make sure you get version number without errors.

vspipe --version

7.6 [Option] Build vslsmashsource

# Install lsmash
git clone https://github.com/l-smash/l-smash.git
cd l-smash
./configure --enable-shared
make && sudo make install
cd ..
 
# Install vslsmashsource
git clone https://github.com/HolyWu/L-SMASH-Works.git
# As the latest version requires more recent ffmpeg libs, checkout the older version
cd L-SMASH-Works
git checkout -b 20200531 refs/tags/20200531
cd VapourSynth
meson build
cd build
ninja && sudo ninja install
cd ../../../

8. Add user to proper group

# QSV
sudo gpasswd -a ${USER} video
# OpenCL
sudo gpasswd -a ${USER} render

9. Build QSVEncC

git clone https://github.com/rigaya/QSVEnc --recursive
cd QSVEnc
./configure --extra-cxxflags="-I/opt/intel/mediasdk/include" --extra-ldflags="-L/opt/intel/mediasdk/lib"
make

Check if it works properly.

LD_LIBRARY_PATH=/opt/intel/mediasdk/lib ./qsvencc --check-hw

You shall get results below if Quick Sync Video works properly.

Success: QuickSyncVideo (hw encoding) available

Linux (Fedora 32)

0. Requirements

C++17 Compiler
Intel Driver
git
cmake
rust + cargo-c
libraries
- libva, libdrm
- ffmpeg 4.x libs (libavcodec58, libavformat58, libavfilter7, libavutil56, libswresample3, libavdevice58)
- libass9
- [Optional] VapourSynth

1. Install build tools

Install build tools

sudo dnf install @development-tools cmake

Install rust + cargo-c (for libdovi build)

sudo apt install libssl-dev curl
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y --profile minimal \
  && . ~/.cargo/env \
  && cargo install cargo-c

2. Install required libraries

sudo dnf install https://download1.rpmfusion.org/nonfree/fedora/rpmfusion-nonfree-release-$(rpm -E %fedora).noarch.rpm
sudo dnf install https://download1.rpmfusion.org/free/fedora/rpmfusion-free-release-$(rpm -E %fedora).noarch.rpm

sudo dnf install libva-devel libX11-devel libdrm-devel
sudo dnf install ffmpeg ffmpeg-devel

3. Install Intel Media driver and OpenCL runtime

OpenCL driver can be innstalled following instruction on this link.

#Media
sudo dnf install intel-media-driver
#OpenCL
sudo dnf install -y 'dnf-command(config-manager)'
sudo dnf config-manager --add-repo https://repositories.intel.com/graphics/rhel/8.3/intel-graphics.repo
sudo dnf update --refresh
sudo dnf install intel-opencl intel-media intel-mediasdk level-zero intel-level-zero-gpu
sudo dnf install opencl-headers

4. [Optional] Install VapourSynth

VapourSynth is required only if you need VapourSynth(vpy) reader support.

Please go on to [5. Build QSVEncC] if you don't need vpy reader.

How to build VapourSynth

4.1 Install build tools for VapourSynth

sudo apt install python3-pip autoconf automake libtool meson

4.2 Install zimg

git clone https://github.com/sekrit-twc/zimg.git --recursive
cd zimg
./autogen.sh
./configure
make && sudo make install
cd ..

4.3 Install cython

sudo pip3 install Cython

4.4 Install VapourSynth

git clone https://github.com/vapoursynth/vapoursynth.git
cd vapoursynth
./autogen.sh
./configure
make && sudo make install

# Make sure vapoursynth could be imported from python
# Change "python3.x" depending on your encironment
sudo ln -s /usr/local/lib/python3.x/site-packages/vapoursynth.so /usr/lib/python3.x/lib-dynload/vapoursynth.so
sudo ldconfig

4.5 Check if VapourSynth has been installed properly

Make sure you get version number without errors.

vspipe --version

4.6 [Option] Build vslsmashsource

# Install lsmash
git clone https://github.com/l-smash/l-smash.git
cd l-smash
./configure --enable-shared
make && sudo make install
cd ..
 
# Install vslsmashsource
git clone https://github.com/HolyWu/L-SMASH-Works.git
# As the latest version requires more recent ffmpeg libs, checkout the older version
cd L-SMASH-Works
git checkout -b 20200531 refs/tags/20200531
cd VapourSynth
meson build
cd build
ninja && sudo ninja install
cd ../../../

5. Add user to proper group

# QSV
sudo gpasswd -a ${USER} video
# OpenCL
sudo gpasswd -a ${USER} render

6. Build QSVEncC

git clone https://github.com/rigaya/QSVEnc --recursive
cd QSVEnc
./configure
make

Check if it works properly.

./qsvencc --check-hw

You shall get results below if Quick Sync Video works properly.

Success: QuickSyncVideo (hw encoding) available

Intel Drivers for Linux

Please refer to Intel Media SDK Wiki for driver packages for Linux distributions and further infomation about Intel media stack on Ubuntu.

Files

Build.en.md

Latest commit

History

Build.en.md

File metadata and controls

How to build QSVEnc

Windows

0. Requirements

1. Download source code

2. Build QSVEncC.exe / QSVEnc.auo

Linux (Ubuntu 20.04 - 24.04)

0. Requirements

1. Install build tools

2. Install Intel driver

3. Install required libraries

4. [Optional] Install VapourSynth

4.1 Install build tools for VapourSynth

4.2 Install zimg

4.3 Install cython

4.4 Install VapourSynth

4.5 Check if VapourSynth has been installed properly

4.6 [Option] Build vslsmashsource

5. [Optional] Install AvisynthPlus

5.1 Install build tools for AvisynthPlus

5.2 Install AvisynthPlus

5.3 [Option] Build lsmashsource

6. Add user to proper group

7. Build QSVEncC

Linux (Ubuntu 18.04)

0. Requirements

1. Install build tools

2. Install libva

2.1 Install libva dependencies

2.2 Build libva

4. Install media driver

4.1 Build gmmlib

4.2 Build media driver

5. Install Intel OpenCL runtime libraries

6. Install ffmpeg 4.x libraries

7. [Optional] Install VapourSynth

7.1 Install build tools for VapourSynth

7.2 Install zimg

7.3 Install cython

7.4 Install VapourSynth

7.5 Check if VapourSynth has been installed properly

7.6 [Option] Build vslsmashsource

8. Add user to proper group

9. Build QSVEncC

Linux (Fedora 32)

0. Requirements

1. Install build tools

2. Install required libraries

3. Install Intel Media driver and OpenCL runtime

4. [Optional] Install VapourSynth

4.1 Install build tools for VapourSynth

4.2 Install zimg

4.3 Install cython

4.4 Install VapourSynth

4.5 Check if VapourSynth has been installed properly

4.6 [Option] Build vslsmashsource

5. Add user to proper group

6. Build QSVEncC

Intel Drivers for Linux