Skip to content
StreamFX 0.12.0 Alpha 134 Pre-release
Pre-release
Compare
Choose a tag to compare
@Xaymar Xaymar released this
· 10 commits to master since this release
6853cc6

Preview Release not for Production!

This release is meant for testing in isolated conditions and early adopters only, and should never be used in production. If you use one of these releases, all promises of support, warranty, functionality, and similar are immediately void and if things break you are on your own. The latest production ready release can be found here.

Please read the Installation Guide and System Requirements!

The installation of StreamFX requires that you follow certain instructions, as well as fulfill a minimum hardware and software requirement. Please ensure that you have read and verified both before asking for help, as many issues can be fixed by reading both of them in their entirety.

Support StreamFX on Github Sponsors or Patreon!

GitHub Sponsors Patreon The StreamFX project is only possible through your support, either as a translator or as a Supporter on either Patreon or Github. Your support helps keep StreamFX free from Ads, even if it's just translating a few lines per month, or 1$ per month. If continuous support isn't your thing, maybe a one-time donation via PayPal is?

Overview of Changes

New Release process: Alpha -> Beta -> Candidate -> Release!

The old two stage system didn't work out quite as I'd have hoped: It didn't communicate the dangers of Testing well, and did not differentiate between different stability levels. To solve this I've adopted a new release process now available in StreamFX, which follows the usual development cycle of Software itself: Alpha -> Beta -> Candidate -> Release. The further right you go in that graph, the more stable software is supposed to be, at the cost of new features and changes. The further left you go, the more up-to-date things will be, but you sacrifice stability and safety.

Loadable Bundles on MacOS

With OBS Studio 28.0 came the introduction of Loadable Bundles, a variation of MacOS's Bundle format. This format offers a lot of advantages for almost no drawbacks, and StreamFX from now on uses this packaging format on MacOS. As a bonus, FFmpeg Encoders should now be available on MacOS too.

This change requires that you cleanly remove old versions of StreamFX first!

As the packaging and installation method has changed, please follow the Uninstallation guide to clean up any left over old files. Failure to do so will result in undefined behavior and may render OBS Studio entirely unusable. You have been warned.

Improved System-wide installation on Windows

Investigation into how OBS Studio actually loads plugins revealed a change that had gone under the radar entirely. Since OBS Studio v0.15.0 it is possible to load plugins from %ProgramData%\obs-studio\plugins, which is a much safer option and now the only supported System-wide installation mode for StreamFX. This functionality has been so hidden that even the official obs-plugintemplate doesn't make use of it. An added bonus is that this should support Steam users of OBS Studio.

This change requires that you cleanly remove old versions of StreamFX first!

As the packaging and installation method has changed, please follow the Uninstallation guide to clean up any left over old files. Failure to do so will result in undefined behavior and may render OBS Studio entirely unusable. You have been warned.

User-only installation on Windows

StreamFX can now be installed for individual users, instead of installing for everyone on the system! This is possible thanks to a PR by @abcdw, which allows us to set two environment variable to install and load plugins from %LocalAppData%\Programs\obs-studio\plugins in addition to all the other locations. These installations will conflict with a System-wide install and as such can't coexist, but may still work with the Steam release of OBS Studio.

Avid DNxHR Encoder (via FFmpeg) by @IceStormNG

A new contender for the visually lossless intermediate codec arrives: Avid DNxHR! Thanks to work done by @IceStormNG, it is now possible to use this encoder without configuration trickery and directly configure it with a proper user interface. As this encoder is based on the real codec specification, it may perform better than the Apple ProRes encoder while being way more compatible with video editing software.

Universal Binaries for x86 & ARM64 support on MacOS

Users on ARM64 devices can now enjoy native ARM64 binaries for less CPU usage, and as such more overall performance on CPU focused tasks. While StreamFX is mostly GPU workloads, some of the internal code does actually do very heavy lifting that benefits from this.

Deprecation of the AMD AMF (via FFmpeg) encoders

With OBS Studio 28.0 the old obs-amd-encoder project is finally laid to rest and a new AMD AMF integration is provided. This AMD AMF integration is technically and functionally superior to both the old obs-amd-encoder and FFmpegs AMD AMF integration. All users are urged to migrate as soon as possible, as no guarantees are made for how long this deprecated encoder will remain. Additionally, users on Linux should put their focus on the open Pull Requests for Linux support (1, 2).

Deprecation of the AV1 (via AOM) Encoder

With OBS Studio 27.2.4, the SVT-AV1 and AOM-AV1 encoders were integrated into OBS Studio directly. This integration is functionally identical, and as such replaces the StreamFX provided AOM-AV1 encoder. All users are urged to migrate as soon as possible, as no guaratees are made for how long this deprecated encoder will remain.

Split Framerate support for FFmpeg Encoders

All FFmpeg Encoders now support encoding a different framerate than OBS Studio itself is running at. This allows for streaming at 30 FPS while recording at 60 FPS, or even recording at 120 FPS, or other strange things. Note that this is quite literally breaking several specifications, so use at your own risk - if things break, be happy that at least they broke with a noticable impact!

Shader Texture Inputs no longer corrupt Scene Collections

For quite some time, Shader Texture Inputs were haunted by ghosts from the past, also known as work-arounds and deprecated code. This resulted in Shader Texture Inputs keeping stale references around and requiring an OBS Studio restart to actually update. Several code modernization cycles later, this is now fixed and Shader Texture Inputs immediately update as expected - while also no longer keeping stale references around, so your Scene Collections are safe again.

Detailed Changelog

0.12.0a134
  • cmake: Require nlohmann-json when building the front-end by @rmnvgr in #914
  • encoder/ffmpeg: Assume extra data and sei are present on first frame by @Xaymar in #919
  • encoder/ffmpeg: Add split framerate with integer fractions by @Xaymar in #921
  • encoder/ffmpeg: Improve software scaling quality by @Xaymar in #925
  • Add support for HDR formats by @Xaymar in #922
  • encoder/handler/prores_aw: Don't enable Key-Frame options by @Xaymar in #926
  • encoder/handler/dnxhd: Use endian-independent formats by @Xaymar in #927
  • New Crowdin updates by @Xaymar in #915
  • Improve Windows installer with proper System install location, Current User install method, and better UI by @Xaymar in #930
  • New Crowdin updates by @Xaymar in #928
0.12.0a117
0.12.0a106
0.12.0a77
0.12.0a45
  • Improve CMake build script(s) by @Xaymar in #813
  • ci: Add GCC back to the build by @Xaymar in #820
  • Add ClangCL, and update Windows SDK requirements by @Xaymar in #821
  • ci: Allow failures for experimental CI tests by @Xaymar in #824
  • ci: Use specific LLVM/Clang versions by @Xaymar in #825
  • project: Add support for multi stage release cycles by @Xaymar in #823
0.12.0a1

System Requirements

Windows
Windows
Linux
Linux
MacOS
MacOS
OS Minimum Windows 10 21H2 (or newer) Ubuntu 20.04 (or newer), (or equivalent Distro) MacOS 10.15 (or newer)
Recommended Windows 10 21H2 (or newer), Windows 11 (or newer) Ubuntu 22.04 (or newer), or equivalent Distro MacOS 12 (or newer)
CPU Minimum Any x86-64-v3 compatible: AMD Excavator Series, Intel Haswell Series
Required Instruction Sets: x86-64-v2, AVX, BMI1, BMI2, F16C, FMA, MOVBE
Any ARM64-v8.5-A compatible: Apple M1 Series
Recommended Any x86-64-v3 compatible: AMD Zen 2 Series, Intel Comet Lake Series
Required Instruction Sets: x86-64-v2, AVX, BMI1, BMI2, F16C, FMA, MOVBE
Any ARM64-v8.5-A compatible: Apple M1 Series
Memory (RAM) Minimum 4 GiB (free)
Recommended 8 GiB (free) 6 GiB (free)
Video (GPU) Minimum DirectX 11 / OpenGL 3 capable, Shader Model 4, 4 GiB VRAM (total)
Recommended DirectX 12 / OpenGL 4 capable, Shader Model 5, 6 GiB VRAM (total)
Disk Space Minimum ~50 MiB (free)
Recommended ~50 MiB (free)
OBS Version Minimum 28.0.0
Recommended 28.0.0 or newer
Other Microsoft Visual C/C++ Redistributable 2017-2022 Qt for obs-studio
FFmpeg for obs-studio