QSVEncCのインストール方法

September 10, 2026 · View on GitHub

Windows
Linux
- Linux (Ubuntu 20.04 - 24.04)
- Linux (Fedora 32)
- その他のLinux OS
  その他のLinux OS向けには、ソースコードからビルドする必要があります。ビルド方法については、こちらを参照してください。

Windows

1. Intelグラフィックスドライバをインストールします。

2. Windows用実行ファイルをダウンロードして展開します。

実行ファイルはこちらからダウンロードできます。QSVEncC_x.xx_Win32.7z が 32bit版、QSVEncC_x.xx_x64.7z が 64bit版です。通常は、64bit版を使用します。

実行時は展開したフォルダからそのまま実行できます。

64bit版の配布archiveにはlibvmaf.dllとNVIDIA backend版のlibvship.dllが含まれます。VMAF評価はCPUで実行できますが、同梱のlibvshipによる評価にはNVIDIA GPUと対応ドライバが必要です。評価を使用しない通常のエンコードにはこれらのDLLは不要です。

公式配布パッケージではlibvmafを静的リンクするため、VMAF評価にlibvmaf.soは不要です。libvship評価を使用する場合は、実行時ローダーがlibvship.soと、選択したbackendが必要とする共有ライブラリを検索できる場所へ配置します（システムのライブラリ検索パス、またはLD_LIBRARY_PATH）。ソースから通常設定でビルドした場合はlibvmafを動的ロードするため、VMAF評価にはlibvmaf.soも必要です。評価を使用しない通常のエンコードには、これらのライブラリは不要です。

1. Intel Media ドライバ用のリポジトリの登録

:::note warn
Gen11以前のGPUを含む環境の場合、この工程をスキップし、2. に進んでください。

Intel repositoryは最新のuser mode driverを提供しますが、intel-opencl-icd 24.35以降はGen12以降向けとなっているため、OpenCLデバイスを検出できない場合があります。Gen11以前のGPUを含む環境では、Ubuntu標準repoを使用してください。

Gen11以前: Broadwell, Skylake, Kaby Lake, Coffee Lake, Apollo Lake, Gemini Lake, Ice Lake, Elkhart Lake
Gen12以降: Tiger Lake, Rocket Lake, Alder Lake, Raptor Lake, Arc dGPU など ::

こちらのリンクに沿って、ドライバをインストールします。

まず、必要なツールを導入します。

sudo apt-get install -y gpg-agent wget

次に、Intelのリポジトリを追加します。

# 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. QSVとOpenCLの使用のため、ユーザーを下記グループに追加

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

3. qsvenccのインストール

qsvenccのdebファイルをこちらからダウンロードします。

その後、下記のようにインストールします。"x.xx"はインストールするバージョンに置き換えてください。

# 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. 追加オプション

下記機能を使用するには、追加でインストールが必要です。

avs読み込み
AvisynthPlusのインストールが必要です。
vpy読み込み VapourSynthのインストールが必要です。

--vpp-onnx OpenVINO Runtimeのインストールが必要です。UbuntuではIntel公式APTリポジトリから導入します。

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

# 使用しているUbuntuのバージョンに合わせて、下記のいずれか1行のみ実行します。

# 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. その他

qsvencc実行時に、"Failed to load OpenCL." というエラーが出る場合
/lib/x86_64-linux-gnu/libOpenCL.so が存在することを確認してください。 libOpenCL.so.1 しかない場合は、下記のようにシンボリックリンクを作成してください。
```
sudo ln -s /lib/x86_64-linux-gnu/libOpenCL.so.1 /lib/x86_64-linux-gnu/libOpenCL.so
```
qsvenccでFixedFunction(FF)モードが使用できない
Arc GPU / JasperLake 等でエンコードできない

原因として、HuCファームウェアがロードされていないことが考えられます。詳細

FixedFunction(FF)モード(別名 Low Powerモード)を使用するには、HuCファームウェアがロードされている必要があります。

Arc GPU / JasperLakeでは、FFモードしか対応していないため、HuCファームウェアがロードされていないとQSVエンコードできません。

HuCがロードされているかは、下記で確認できます。
```
sudo cat /sys/kernel/debug/dri/0/i915_huc_load_status
```
HuCのモジュールが存在するかは、下記で確認できます。
```
sudo modinfo i915 | grep -i "huc"
```
ご使用のCPUの世代に該当するモジュールがあれば、HuCファームウェアのロードを有効にすれば FixedFunctionモードを利用可能です。

HuCファームウェアのロードを有効にするには、ファイル/etc/modprobe.d/i915.confにカーネルパラメータを追加し、システムを再起動します。
```
options i915 enable_guc=2
```

Linux (Fedora 32)

1. Intel Media ドライバとOpenCLランタイムのインストール

#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