Repository navigation
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.