Repository navigation
Releases
v1.1.2
This release fixes plugin loading on OBS Studio 33 while retaining compatibility with OBS 31 and 32. The Windows installer has also been updated to support both the legacy plugin layout and the new layout introduced in OBS 33.
本リリースでは、OBS Studio 33でプラグインを読み込めなくなる問題を修正しました。OBS 31・32との互換性も維持しています。また、Windowsインストーラーを更新し、従来のプラグイン配置とOBS 33で導入された新しい配置形式の両方に対応しました。
Bug Fixes
-
Fix plugin loading on OBS Studio 33
- The plugin previously depended on image-loading APIs removed in OBS 33, preventing the entire plugin from loading even when no warning image was displayed.
- Warning images now use texture-loading APIs available across OBS 31, 32, and 33.
- Localized warning artwork and existing Adjustment Layer behavior are preserved.
Installation
- Download the installer or plugin package for your platform from the Assets section below
- Install it like any other OBS plugin
Notes
- Compatibility with OBS 31 and 32 is retained; upgrading to OBS 33 is not required to use this release
- Adjustment Layers must be placed directly in a scene and cannot be used inside groups
- Do not reuse the same Adjustment Layer source across multiple scene items or scenes
- Nesting a scene that contains an Adjustment Layer is supported
- Per-source show/hide transitions are supported
- This is a third-party, unofficial plugin and is not affiliated with the OBS Project
Feedback and bug reports are welcome via GitHub Issues.
v1.1.1
This release fixes an issue where an Adjustment Layer could be incorrectly detected as being reused when its scene was nested inside another scene. This false detection displayed the shared-use warning and disabled the Adjustment Layer even though only one instance had been created.
本リリースでは、調整レイヤーを含むシーンを別のシーンに入れ子で配置した際、調整レイヤーが複数箇所で使い回されていると誤検出される問題を修正しました。この誤検出により、実際にはひとつしか作成していない場合でも共有使用の警告が表示され、機能が停止することがありました。
Bug Fixes
-
Prevent false shared-use detection in nested scenes
- A scene containing an Adjustment Layer can also be used as a source inside another scene. In this configuration, the same underlying scene item could be discovered more than once and mistaken for separate placements.
- Scene traversal now tracks visited containers and compares the identity of the actual scene items, ensuring that the same item reached through a nested-scene path is counted only once.
- Genuinely reusing the same Adjustment Layer source in multiple scene items or scenes is still detected and disabled safely with the existing localized warning.
Installation
- Download the installer or plugin package for your platform from the Assets section below
- Install it like any other OBS plugin
Notes
- Adjustment Layers must be placed directly in a scene and cannot be used inside groups
- Do not reuse the same Adjustment Layer source across multiple scene items or scenes
- Nesting a scene that contains an Adjustment Layer inside another scene is supported
- Per-source show/hide transitions are supported
- This is a third-party, unofficial plugin and is not affiliated with the OBS Project
Feedback and bug reports are welcome via GitHub Issues.
v1.1.0
This release improves the stability and safety of Adjustment Layer rendering across scene lifecycle changes, nested rendering, and unsupported placements. It also adds support for per-source show/hide transitions.
本リリースでは、シーンの破棄や切り替え、入れ子になった描画、未対応の配置方法によって発生するクラッシュやデッドロックを防ぐため、調整レイヤーの描画処理を大幅に強化しました。また、ソースの表示・非表示トランジションに対応しました。
New Features
-
Add support for per-source show/hide transitions
- Sources below the Adjustment Layer now retain their configured show and hide transitions in the adjusted output.
- During a show transition, the plugin renders the OBS-managed
show_transitionsource instead of immediately displaying the original source. - During a hide transition, the plugin continues rendering the OBS-managed
hide_transitionsource until the transition finishes. - Transition timing, state, and rendering remain managed by OBS, allowing built-in transitions such as Fade, Swipe, and Slide—as well as compatible third-party transitions—to work through the standard OBS transition pipeline.
Bug Fixes
-
Prevent crashes caused by stale scene and source references
- Scene or source removal could invalidate objects while the Adjustment Layer was still preparing or performing its render pass.
- Parent containers are now cached using weak references and temporarily promoted to strong references only while they are actively being used.
- Scene items and child sources are also retained with strong references while their render state is being processed, preventing use-after-free access during scene destruction or rapid scene changes.
-
Prevent deadlocks when rendering filtered or scripted sources
- Rendering child sources or Lua-based filters while holding an OBS scene mutex could cause lock inversion with other rendering or UI operations.
- The plugin now snapshots scene-item state while the scene is locked, then releases the lock before rendering child sources and filters.
- This keeps third-party and Lua filter rendering outside scene traversal locks and reduces the risk of application-wide deadlocks.
-
Prevent reentrant rendering crashes and excessive nested rendering
- Nested scenes, filters, and stacked Adjustment Layers could cause the Adjustment Layer render callback to be entered recursively.
- Added explicit reentrancy protection to prevent the same Adjustment Layer from starting another render pass while it is already rendering.
- Completed Adjustment Layer output is now reused within the same video frame, preventing repeated or exponentially increasing rendering when multiple layers are stacked.
-
Safely handle unsupported Adjustment Layer placements
- Reusing the same Adjustment Layer source across multiple scene items or scenes is now detected and disabled safely.
- Adjustment Layers placed inside groups are also disabled because the current overlay-based rendering method cannot safely preserve group transparency with alpha-changing effects such as blur or distortion.
- Instead of silently failing or risking unstable rendering, the source displays a localized in-canvas warning.
- Warning artwork is available in English, Japanese, Korean, Simplified Chinese, and Traditional Chinese.
Installation
- Download the installer or plugin package for your platform from the Assets section below
- Install it like any other OBS plugin
Notes
- Adjustment Layers must be placed directly in a scene and cannot be used inside groups
- Do not reuse the same Adjustment Layer source across multiple scene items or scenes
- Create a separate Adjustment Layer source for each scene or intended use
- Per-source show/hide transitions are now supported
- This is a third-party, unofficial plugin and is not affiliated with the OBS Project
Feedback and bug reports are welcome via GitHub Issues.
v1.0.6
This release fixes critical freezing and crashing issues that occurred when creating or deleting the Adjustment Layer, particularly on Windows and when used alongside specific other plugins.
本リリースは、特定の環境下(Windowsや他のプラグインとの併用時)において、調整レイヤーの作成・削除の際にOBS全体がフリーズまたはクラッシュする問題を修正するバグフィックスリリースです。
Bug Fixes
-
Fix GPU driver crashes and freezes on layer removal (especially on Windows/D3D11)
- Deleting the adjustment layer sometimes caused OBS to freeze completely, especially on Windows (including UTM virtual machines) using Direct3D 11.
- Root cause: Texture resources were being destroyed asynchronously without properly locking the graphics context, leading to concurrent D3D11 immediate context access and driver hangs.
- Fixed by delegating resource destruction to the graphics thread and explicitly locking the graphics context (
obs_enter_graphics()).
-
Fix application deadlocks during scene traversal
- Removing the adjustment layer while certain other plugins (e.g., Lua scripts with heavy rendering like HoraikenHorizonLens) were active caused OBS to deadlock.
- Root cause: The plugin searched for its parent scene during
video_render, which locked thesources_mutexwhile the graphics thread already held thevideo_mutex. This caused a lock inversion against the UI thread when removing items. - Fixed by caching the parent scene pointer during
video_tick(where it is safe to lock) to completely eliminate the lock inversion risk.
Installation
- Download the installer or plugin package for your platform from the Assets section below
- Install it like any other OBS plugin
Notes
- This is a third-party, unofficial plugin and is not affiliated with the OBS Project
- Per-source show/hide transitions are not supported in the current version
Feedback and bug reports are welcome via GitHub Issues.
v1.0.5
This release fixes rendering issues with transparent and sRGB-aware sources when used with the Adjustment Layer.
本リリースは、調整レイヤー使用時に透過ソースおよびsRGBブレンドが正しく処理されない問題を修正するバグフィックスリリースです。
Bug Fixes
-
Fix transparent source rendering (WebM, Spout, etc.)
- Transparent pixels in sources like WebM and Spout were rendered as opaque when the Adjustment Layer was enabled
- Root cause: the plugin used premultiplied alpha blending (
ONE, INVSRCALPHA) for source capture, but some sources output straight (non-premultiplied) alpha - Changed to use straight alpha blending (
SRCALPHA, INVSRCALPHA) to match OBS's default scene rendering behavior
-
Fix sRGB blending method being ignored
- Sources with the default blending method (sRGB) were incorrectly rendered as "sRGB Off" when the Adjustment Layer was enabled
- Added proper
gs_set_linear_srgbhandling so that OBS selects the correct gamma-aware rendering technique
Installation
- Download the installer or plugin package for your platform from the Assets section below
- Install it like any other OBS plugin
Notes
- This is a third-party, unofficial plugin and is not affiliated with the OBS Project
- Per-source show/hide transitions are not supported in the current version
Feedback and bug reports are welcome via GitHub Issues.
What's Changed
- docs: minor documentation fixes by @HoraiChan in #3
- docs: minor documentation fixes (#4) by @HoraiChan in #4
- chore: add Ko-fi funding configuration by @HoraiChan in #5
- docs: add Ko-fi link by @HoraiChan in #6
- fix: use straight alpha blending for source capture by @HoraiChan in #7
Full Changelog: v1.0.4...v1.0.5
v1.0.4 – Adjustment Layer (Initial GitHub Release)
This is the first public release of the Adjustment Layer plugin on GitHub.
The Adjustment Layer source allows effect filters applied to it to affect all sources placed behind it, similar to adjustment layers in video editing software.
Previous versions (v1.0.0–v1.0.3) were released outside GitHub before this repository was made public.
本リリースは GitHub 上での初回公開版です。
v1.0.0〜v1.0.3 は GitHub 公開前に別の場所で配布されていました。
調整レイヤーは、背面にあるすべてのソースに対して一括でエフェクトフィルターを適用できるソースです。
Features
- Adds an "Adjustment Layer" source to OBS Studio
- Effect filters applied to this source affect all sources below it
- Compatible with existing OBS effect filters
Installation
- Download the installer or plugin package for your platform from the Assets section below
- Install it like any other OBS plugin
Notes
- This is a third-party, unofficial plugin and is not affiliated with the OBS Project
- Per-source show/hide transitions are not supported in the current version
Feedback and bug reports are welcome via GitHub Issues.