Skip to content

e00E/obs-amf

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

34 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Update: This plugin has become obsolete since OBS Studio version 28 which also ships an updated AMF implementation. This plugin is no longer being actively developed.

Introduction

This is an OBS encoder plugin leveraging hardware acceleration on AMD GPUs through AMF. It has the following features:

  • AVC (H264) support
  • HEVC (H265) support
  • ability to set almost all AMF encoder settings
  • texture based encoding

It was made because the existing plugin is mostly unmaintained and in a state of decay. I am very thankful for the original plugin. This would not have been possible without it.

It is in functioning condition but mostly motivated by my personal use case. I am unsure how much work I want to put into making it easy to use for non technical users.

Currently works on AMD driver "recommended" 22.3.1. The "optional" newer driver versions have caused the plugin to break in the past.

Installation

Releases are found on Releases page on the right.

Additionally every commit is automatically built by CI. To download an artifact (the plugin dll):

  • Go to the Actions tab.
  • Find the most recent master run and click on the title (first column, bold).
  • Click on win64 at the bottom of the page in the Artifacts card. This downloads a zip file. The download link is only available if you are logged into GitHub. As a workaround unregistered users can use https://nightly.link/. Paste the link to the run (the url contains the path /actions/runs/) and click Get links.

Regardless of how the plugin was downloaded the final step is to move the dll file into your OBS plugin folder. If you have a zip file you must extract the dll first.

Code

In contrast to other OBS related code I wanted to:

Building

  • Git clone obs-studio.
  • Place this folder into obs-studio/plugins/
  • Append add_subdirectory(amftest) to obs-studio/plugins/CMakeLists.txt.
  • Build OBS as you usually would and see that this plugin shows up as a project in Visual Studio.

I would like to:

  • Build as a standalone project instead of intrusively integrating with obs-studio.

TODOs

  • Set detailed (hover) descriptions for settings.
  • Query capabilities for some settings to determine maximum values.
  • Make settings easier to understand and prevent misconfiguration by grouping into related settings, disabling incompatible settings like different rate control methods), grouping into commonly used and expert settings.
  • Double check video format conversions.
  • Double check color space conversions. Are we using the right values for SRGB? Should we use the extra HDR settings in AMF?
  • Compare to obsproject/obs-studio#4538 which has advanced color settings and texture support.
  • Compare to jim-nvenc.c which has advanced color settings and texture support.