GStreamer-SVT-HEVC

Overview

This plugin provides svthevcenc element to GStreamer in order to use the Scalable Video Technology for HEVC Encoder (SVT-HEVC).

Requirements

• GStreamer 1.8 or later
• Scalable Video Technology for HEVC Encoder (SVT-HEVC) 1.3.0 or later
  • SvtHevcEnc.dll or libSvtHevcEnc.so has to be in the PATH or next to the plugin's DLL/.so.
• Windows or Linux operating system
• A 64-bit CPU with AVX2 support

Usage

Make sure that the SvtHevcEnc library is in a path the OS looks for when loading dynamic libraries. If using default install locations, this means for example:

export LD_LIBRARY_PATH=/usr/local/lib:$LD_LIBRARY_PATH # Linux
set PATH=C:\svt-encoders\lib;%PATH% # Windows

Then a sample GStreamer pipeline is:

gst-launch-1.0 -e videotestsrc ! video/x-raw ! svthevcenc ! mpegtsmux ! filesink location=out.ts

If you're not familiar with GStreamer, gst-launch-1.0 is part of GStreamer tools, and mpegtsmux is part of GStreamer Bad plugins, -e option allows CTRL+C to translate to an EOS (end of stream) signal on the pipeline.

Compiling and Installing

Build Dependencies

• GStreamer and GStreamer-plugins-base dev 1.8 or later
  • on Debian/Ubuntu: apt-get install libgstreamer1.0-dev libgstreamer-plugins-base1.0-dev
  • on Windows: gstreamer-1.0-devel-x86_64-*.msi
• Scalable Video Technology for HEVC Encoder (SVT-HEVC) 1.3.0 or later
• meson 0.29 or later
  • install python3 and run pip3 install meson
• pkg-config
  • on Debian/Ubuntu: apt-get install pkg-config
  • on Windows, we recommend pkgconfiglite
• (optional on Windows) ninja
  • install python3 and run pip3 install ninja
  • or on Ubuntu: apt install ninja-build

This plugin uses meson build tools and the dependency on SVT-HEVC library is set-up using pkg-config.

Linux specific instructions

Make sure first that SVT-HEVC library is installed and can be found using pkg-config. You can do that using CMake:

cmake -P SVT-HEVC/Build/linux/release/Source/Lib/cmake_install.cmake

Then you can compile and install the plugin the following way:

meson -Dprefix=/usr build && ninja -C build && sudo ninja -C build install

Windows specific instructions

Make sure first that SVT-HEVC library is installed and can be found using pkg-config. You can do that using CMake:

cmake -P SVT-HEVC\Build\Windows\Source\Lib\cmake_install.cmake

The following commands should be run from a Visual Studio command prompt or another build environment like MinGW, not Windows built-in command prompt.

Specify the path to pkgconfig configuration files for GStreamer and SVT-HEVC, and installation prefix to %GSTREAMER_1_0_ROOT_X86_64%:

set PKG_CONFIG_PATH=%GSTREAMER_1_0_ROOT_X86_64%lib\pkgconfig;C:\svt-encoders\lib\pkgconfig

Then the plugin can be compiled and installed using Ninja:

meson -Dprefix=%GSTREAMER_1_0_ROOT_X86_64% build && ninja -C build && ninja -C build install

Or made available as a Visual Studio project:

meson -Dprefix=%GSTREAMER_1_0_ROOT_X86_64% build --backend=vs2017