rocDecode is a high-performance video decode SDK for AMD GPUs. Using the rocDecode API, you can access the video decoding features available on your GPU.

• H.265 (HEVC) - 8 bit, and 10 bit
• H.264 (AVC) - 8 bit
• AV1 - 8 bit, and 10 bit
• VP9 - 8 bit, and 10 bit

• Linux
  • Ubuntu - 22.04 / 24.04
  • RedHat - 8 / 9
  • SLES - 15-SP5

• GPU: AMD Radeon™ Graphics / AMD Instinct™ Accelerators

• Install ROCm 6.3.0 or later with amdgpu-install and usecase:rocm

• AMD Clang++ Version 18.0.0 or later - installed with ROCm

• CMake Version 3.10 or later

  sudo apt install cmake

• Video Acceleration API - libva-amdgpu-dev is an AMD implementation for VA-API

  sudo apt install libva-amdgpu-dev

• AMD VA Drivers

  sudo apt install libva2-amdgpu libva-amdgpu-drm2 libva-amdgpu-wayland2 libva-amdgpu-x11-2 mesa-amdgpu-va-drivers

• HIP

  sudo apt install hip-dev

• pkg-config

  sudo apt install pkg-config

• FFmpeg libraries and headers:

  • libavcodec - provides implementation of a wider range of codecs.
  • libavformat - implements streaming protocols, container formats and basic I/O access.
  • libavutil - includes hashers, decompressors and miscellaneous utility functions.

sudo apt install libavcodec-dev libavformat-dev libavutil-dev

sudo apt install libstdc++-12-dev

For your convenience, we provide the setup script, rocDecode-setup.py, which installs all required dependencies. Run this script only once.

python3 rocDecode-setup.py  --rocm_path [ ROCm Installation Path  - optional (default:/opt/rocm)]
                            --runtime   [ Setup runtime requirements - optional (default:ON) [options:ON/OFF]]
                            --developer [ Setup Developer Options - optional (default:OFF) [options:ON/OFF]]

The installation process uses the following steps:

• ROCm-supported hardware install verification

• Install ROCm 6.3.0 or later with amdgpu-install and --usecase=rocm:

  sudo amdgpu-install --usecase=rocm
  

To install rocDecode runtime, development, and test packages, run the line of code for your operating system.

• Runtime package - rocdecode only provides the rocdecode library librocdecode.so
• Development package - rocdecode-dev/rocdecode-devel provides the library, header files, and samples
• Test package - rocdecode-test provides CTest to verify installation

sudo apt install rocdecode rocdecode-dev rocdecode-test

sudo yum install rocdecode rocdecode-devel rocdecode-test

sudo zypper install rocdecode rocdecode-devel rocdecode-test

To build rocDecode from source and install, run:

git clone https://github.com/ROCm/rocDecode.git
cd rocDecode
python3 rocDecode-setup.py
mkdir build && cd build
cmake ../
make -j8
sudo make install

make test

sudo make package

The installer copies:

• Libraries into /opt/rocm/lib
• Header files into /opt/rocm/include/rocdecode
• Samples folder into /opt/rocm/share/rocdecode
• Documents folder into /opt/rocm/share/doc/rocdecode

To verify your installation using a sample application, run:

mkdir rocdecode-sample && cd rocdecode-sample
cmake /opt/rocm/share/rocdecode/samples/videoDecode/
make -j8
./videodecode -i /opt/rocm/share/rocdecode/video/AMD_driving_virtual_20-H265.mp4

To verify your installation using the rocdecode-test package, run:

mkdir rocdecode-test && cd rocdecode-test
cmake /opt/rocm/share/rocdecode/test/
ctest -VV

You can access samples to decode your videos in our GitHub repository. Refer to the individual folders to build and run the samples.

FFmpeg is required for sample applications and make test. To install FFmpeg, refer to the instructions listed for your operating system:

• Ubuntu:

  sudo apt install libavcodec-dev libavformat-dev libavutil-dev

• RHEL/SLES:

  Install ffmpeg development packages manually or use rocDecode-setup.py script

You can find rocDecode Docker containers in our GitHub repository.

• Linux
  • Ubuntu - 22.04 / 24.04
  • RHEL - 8 / 9
  • SLES - 15 SP7
• ROCm: 7.0.0
• libva-amdgpu-dev - 2.16.0
• mesa-amdgpu-va-drivers - 1:24.3.0
• FFmpeg - 4.4.2 / 6.1.1
• rocDecode Setup Script - V2.5.0