Skip to content

Install.en.md

Latest commit

 

History

History
133 lines (93 loc) · 4.81 KB

Install.en.md

File metadata and controls

133 lines (93 loc) · 4.81 KB

How to install VCEEncC

Windows

1. Install AMD Radeon Graphics driver

2. Download Windows binary

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

VCEEncC could be run directly from the extracted directory.

Linux (Ubuntu 24.04)

Warning

On some Ubuntu 24.04 + RADV environments, installing the latest AMF userspace causes encoder initialization failures such as Pal::IPlatform::EnumerateDevices() or luid not found in devices returned by Pal::IPlatform::EnumerateDevices().
Related information: AMF issue #575, workaround comment
By replacing only the AMF userspace packages (amf-amdgpu-pro, libamdenc-amdgpu-pro) with the 6.4.4 / 25.10 generation seems to workaround this issue.

1. Install AMD Graphics driver

Download AMD Graphics driver packages for Ubuntu 24.04 from the webpage of AMD.

Extract and run amdgpu-install to install the All-Open stack.

wget https://repo.radeon.com/amdgpu-install/25.35.1/ubuntu/noble/amdgpu-install_7.2.1.70201-1_all.deb
sudo apt-get install ./amdgpu-install_7.2.1.70201-1_all.deb
sudo apt-get update
sudo amdgpu-install -y --opencl=rocr

2. [Workaround] Replace AMF userspace with the 6.4.4 / 25.10 generation

Instead of the latest AMF userspace, install amdgpu-pro-core, libamdenc-amdgpu-pro, and amf-amdgpu-pro from the 6.4.4 / 25.10 generation.

mkdir -p ~/amf-6.4.4
cd ~/amf-6.4.4

wget https://repo.radeon.com/amdgpu/6.4.4/ubuntu/pool/proprietary/a/amdgpu-pro-core/amdgpu-pro-core_25.10-2203192.24.04_all.deb
wget https://repo.radeon.com/amdgpu/6.4.4/ubuntu/pool/proprietary/liba/libamdenc-amdgpu-pro/libamdenc-amdgpu-pro_25.10-2203192.24.04_amd64.deb
wget https://repo.radeon.com/amdgpu/6.4.4/ubuntu/pool/proprietary/a/amf-amdgpu-pro/amf-amdgpu-pro_1.4.37-2203192.24.04_amd64.deb

sudo apt remove --purge -y amf-amdgpu-pro libamdenc-amdgpu-pro

sudo apt install -y --allow-downgrades \
  ./amdgpu-pro-core_25.10-2203192.24.04_all.deb \
  ./libamdenc-amdgpu-pro_25.10-2203192.24.04_amd64.deb \
  ./amf-amdgpu-pro_1.4.37-2203192.24.04_amd64.deb

sudo apt-mark hold amdgpu-pro-core libamdenc-amdgpu-pro amf-amdgpu-pro

3. Add user to proper group to use OpenCL

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

4. Check GPU Recognition Status

Check if your GPU is properly recognized.

sudo apt install vulkan-utils clinfo

Check GPU recognition status using clinfo and vulkaninfo. Especially with vulkaninfo, confirm that your target AMD GPU is recognized as "GPU0".

# Check GPU recognition status with OpenCL
clinfo

# Check GPU recognition status with Vulkan
vulkaninfo --summary

5. Install VCEEncC

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.

sudo apt install ./VCEEncC_x.xx_Ubuntu24.04_amd64.deb

6. Check VCEEncC hardware support

Verify that the encoder is actually usable from VCEEncC. If Supported Codecs lists H.264/HEVC, AMF initialization succeeded.

vceencc --check-hw

7. Addtional Tools

There are some features which require additional installations.

Feature Requirements
avs reader AvisynthPlus
vpy reader VapourSynth

8. Others

  • Error: "Failed to load OpenCL." when running VCEEncC
    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