How to install QSVEncC

June 22, 2026 · View on GitHub

Windows 10
Linux
- Linux (Ubuntu 20.04 - 24.04)
- Linux (Fedora 32)
- Other Linux OS
  For other Linux OS, building from source will be needed. Please check the build instrcutions.

Windows 10

1. Install Intel Graphics driver

2. Download Windows binary

Windows binary can be found from this link. QSVEncC_x.xx_Win32.7z contains 32bit exe file, QSVEncC_x.xx_x64.7z contains 64bit exe file.

QSVEncC could be run directly from the extracted directory.

Linux (Ubuntu 22.04 - 24.04)

1. Add repository for Intel Media driver

:::note warn
Please skip this section and proceed to section 2.

Intel repository will provide the latest user mode driver, but intel-opencl-icd 24.35 supports only Gen12 or later, resulting failure when detecting Gen11 iGPU or before. Please use standard Ubuntu repo which provides intel-opencl-icd 23.43 (Ubuntu 24.04) or 22.14 (Ubuntu 22.04).

Gen11 or before: Broadwell, Skylake, Kaby Lake, Coffee Lake, Apollo Lake, Gemini Lake, Ice Lake, Elkhart Lake
Gen12 or later: Tiger Lake, Rocket Lake, Alder Lake, Raptor Lake, Arc dGPU など ::

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
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,i386 signed-by=/usr/share/keyrings/intel-graphics.gpg] https://repositories.intel.com/gpu/ubuntu noble unified" | \
  sudo tee /etc/apt/sources.list.d/intel-gpu-noble.list

# 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 unified" | \
  sudo tee /etc/apt/sources.list.d/intel-gpu-jammy.list

2. Add user to proper group to use QSV and OpenCL

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

3. Install qsvencc

Download deb package from this link, and install running the following command line. Please note "x.xx" should be replaced to the target version name.

# Ubuntu 24.04
sudo apt install ./qsvencc_x.xx_Ubuntu24.04_amd64.deb

# Ubuntu 22.04
sudo apt install ./qsvencc_x.xx_Ubuntu22.04_amd64.deb

4. Addtional Tools

There are some features which require additional installations.

Feature	Requirements
avs reader	AvisynthPlus
vpy reader	VapourSynth
--vpp-onnx	OpenVINO Runtime from the Intel official APT repository

To install OpenVINO Runtime from the APT repository:

sudo apt-get install -y gnupg wget
wget https://apt.repos.intel.com/intel-gpg-keys/GPG-PUB-KEY-INTEL-SW-PRODUCTS.PUB
sudo gpg --output /etc/apt/trusted.gpg.d/intel.gpg --dearmor GPG-PUB-KEY-INTEL-SW-PRODUCTS.PUB

# Run only one of the following lines, matching your Ubuntu version.

# Ubuntu 24.04
echo "deb https://apt.repos.intel.com/openvino ubuntu24 main" | sudo tee /etc/apt/sources.list.d/intel-openvino.list

# Ubuntu 22.04
echo "deb https://apt.repos.intel.com/openvino ubuntu22 main" | sudo tee /etc/apt/sources.list.d/intel-openvino.list

sudo apt update
sudo apt install openvino

5. Others

Error: "Failed to load OpenCL." when running qsvencc
Please check if /lib/x86_64-linux-gnu/libOpenCL.so exists. There are some cases that only libOpenCL.so.1 exists. In that case, please create a link using following command line.
```
sudo ln -s /lib/x86_64-linux-gnu/libOpenCL.so.1 /lib/x86_64-linux-gnu/libOpenCL.so
```
Fixed Function(FF) mode not supported
Unable to encode on Arc GPUs or JasperLake

The problem might be caused by HuC firmware being not loaded. See also

It is required to load HuC firmware to use FF mode (or Low Power mode). Therefore, it is essential to load HuC firmware in oreder to encode on such GPUs which support FF mode only, like Arc GPUs or JasperLake.

Please check whether HuC firmware is loaded.
```
sudo cat /sys/kernel/debug/dri/0/i915_huc_load_status
```
Check also Huc Firmware module is available on your system.
```
sudo modinfo i915 | grep -i "huc"
```
If the module for the CPU gen you are using is available, you shall be able to use FF mode by loading HuC Firmware module.

By adding option below to /etc/modprobe.d/i915.conf, HuC Firmware will be loaded after reboot.
```
options i915 enable_guc=2
```

Linux (Fedora 32)

1. Install Intel Media and OpenCL driver

#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

2. Add user to proper group to use QSV and OpenCL

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

3. Install qsvencc

Download rpm package from this link, and install running the following command line. Please note "x.xx" should be replaced to the target version name.

sudo dnf install ./qsvencc_x.xx_1.x86_64.rpm

4. Addtional Tools

There are some features which require additional installations.

Feature	Requirements
avs reader	AvisynthPlus
vpy reader	VapourSynth

5. Others

Error: "Failed to load OpenCL." when running qsvencc
Please check if /lib/x86_64-linux-gnu/libOpenCL.so exists. There are some cases that only libOpenCL.so.1 exists. In that case, please create a link using following command line.
```
sudo ln -s /lib/x86_64-linux-gnu/libOpenCL.so.1 /lib/x86_64-linux-gnu/libOpenCL.so
```