Skip to content

Releases: stoatworks-labs/obs-ffgl

Release list

v0.1.0

Choose a tag to compare

@github-actions github-actions released this 07 Aug 02:09

First release.

Run FreeFrame (FFGL) video plugins natively inside OBS Studio — in OBS's own
OpenGL context, with no network round trip, no second render and no extra frame
of latency.

Registers FFGL Effect (a filter) and FFGL Source (an input, for
generators), with the plugin's own parameter groups and dropdowns.

What is verified

Twenty-two FFGL bundles driven through a real OBS 32.1.2 and compared per pixel:

  • 17 render correctly.
  • 2 need a file parameter set first (a ROM, a sprite sheet).
  • 2 fail identically under a different host, so they are the plugins' own bugs.
  • 1 is a shell correctly refusing to load with no guest inside it.

The three generators in the set all render as OBS sources. The release artefact
itself was downloaded, installed and confirmed to load.

What is not

  • macOS only, and only on OBS's OpenGL renderer. FFGL is an OpenGL format;
    on the Metal or Direct3D backends the module logs why and registers nothing
    rather than quietly producing black.
  • Audio-reactive FF_TYPE_BUFFER parameters are not fed.
  • Windows and Linux are not built.

Installing

Unzip obs-ffgl.plugin into ~/Library/Application Support/obs-studio/plugins/
and restart OBS. Universal binary.

Licence

The source is MIT. A binary linking libobs is subject to OBS Studio's GPL-2.0
terms, so the plugin you install is GPL.