Skip to content

Releases: TheThirdRail/scene-tree-view

v0.1.9 - Dock Visibility & Content Sizing Fixes

25 Nov 03:10
@TheThirdRail TheThirdRail
v0.1.9
eda13ec

Choose a tag to compare

View all tags
v0.1.9 - Dock Visibility & Content Sizing Fixes Latest
Latest

🎉 What's New in v0.1.9

This release includes two critical fixes that resolve persistent UI issues with the Scene Tree View dock in OBS Studio 32.x.

🐛 Bug Fixes

1. Dock Visibility Fix (Empty Dock Issue)

Problem: The Scene Tree View dock would appear empty (showing only the title bar with no content) after closing and reopening OBS in specific configurations:

  • When positioned to the left of the video preview/viewer area
  • When tabbed with another dock and the Scene Tree View was in a hidden/inactive tab

Root Cause: Double QDockWidget wrapping (both the plugin class and .ui file root were QDockWidget) combined with a widget detachment pattern that broke Qt's state restoration.

Solution:

  • Refactored ObsSceneTreeView from QDockWidget to QWidget inheritance
  • Updated .ui file root widget from QDockWidget to QWidget
  • Removed broken widget detachment pattern
  • Now uses direct registration via obs_frontend_add_dock_by_id()
  • OBS creates and manages the QDockWidget wrapper automatically

Result: ✅ Dock contents now appear correctly in all positions and tab states, including the previously problematic left/hidden-tab cases.

2. Content Sizing Fix (Layout Issue)

Problem: After the visibility fix, a new issue emerged where the dock's content widget did not fill the entire dock area. The tree view and toolbar appeared smaller than the dock boundary, leaving visible empty margins/gaps.

Root Cause: The .ui file defined STVDock (root widget) with a fixed geometry but no layout. The stvContents child widget had a layout, but since it wasn't managed by a layout on the parent STVDock, it didn't resize to fill the parent when the dock was resized by OBS.

Solution:

  • Added a top-level QVBoxLayout to the STVDock root widget in forms/scene_tree_view.ui
  • Ensured stvContents widget is managed by that parent layout
  • Set all layout margins to 0 for seamless appearance

Result: ✅ Content now properly fills the entire dock area when the dock is resized or repositioned, with no unexpected gaps.

📦 Installation

Windows x64

  1. Download obs-scene-tree-view-windows-x64.zip from the Assets section below
  2. Verify integrity (optional but recommended): 
    # Compare with SHA256 checksum in .sha256 file
Get-FileHash obs-scene-tree-view-windows-x64.zip -Algorithm SHA256
  3. Extract the ZIP file
  4. Copy the extracted folder structure to: 
    C:\Program Files\obs-studio\
    This will place:
    • obs_scene_tree_view.dll → C:\Program Files\obs-studio\obs-plugins\64bit\
    • Locale files → C:\Program Files\obs-studio\data\obs-plugins\obs_scene_tree_view\locale\
  5. Restart OBS Studio
  6. Enable the dock via Docks → Scene Tree View in the OBS menu

✅ Verified Configurations

Both fixes have been tested and verified on Windows x64 with OBS Studio 32.0.1 in all dock configurations:

  • ✅ Dock positioned left of viewer
  • ✅ Dock positioned right of viewer
  • ✅ Dock positioned top of viewer
  • ✅ Dock positioned bottom of viewer
  • ✅ Dock tabbed with another dock (visible tab)
  • ✅ Dock tabbed with another dock (hidden tab)
  • ✅ Dock floating as separate window
  • ✅ OBS restart persistence in all configurations
  • ✅ Content fills entire dock area with no gaps in all configurations

🔧 System Requirements

  • OBS Studio: 32.0.1 or later (built against libobs 32 and Qt 6.8.3)
  • Operating System: Windows 10/11 x64
  • Note: This build is not ABI-compatible with older OBS releases due to libobs 32 and Qt 6.8.3 dependencies

📝 Additional Changes

  • Updated README.md with OBS 32.0.1+ requirement note
  • Enhanced package-windows.ps1 to generate SHA256 checksums automatically
  • Added OBS_Forum_Writeup.txt to .gitignore (local draft content)

🙏 Acknowledgments

Both fixes follow the proven pattern from Exeldro's obs-source-dock plugin. Special thanks to the OBS community for their support and testing.

📊 Full Changelog

Commits:

  • d492e50 - fix: resolve dock visibility and content sizing issues
  • 00a0503 - chore: bump version to 0.1.6 for release (corrected to 0.1.9)
  • 3b97969 - docs: update version to v0.1.9 and remove OBS 32+ warning from forum writeup

Files Changed:

  • forms/scene_tree_view.ui - Root layout addition + QDockWidget → QWidget conversion
  • obs_scene_tree_view/obs_scene_tree_view.h - Class inheritance change
  • obs_scene_tree_view/obs_scene_tree_view.cpp - Registration refactor
  • README.md - Documentation updates
  • scripts/package-windows.ps1 - Checksum generation
  • .gitignore - Local draft exclusion
  • CMakeLists.txt - Version bump to 0.1.9
Assets 4
Loading

Scene Tree View for OBS Studio (Windows x64)

04 Nov 00:51
@TheThirdRail TheThirdRail
v0.1.8
a5a75e7

Choose a tag to compare

View all tags
Scene Tree View for OBS Studio (Windows x64)

Scene Tree View for OBS Studio (Windows x64)

Overview

Scene Tree View adds a hierarchical tree to the OBS UI so you can organize sources into folders and manage complex scenes faster.
Key capabilities:
Folder support inside scenes (nesting allowed)
Drag-and-drop reordering and re-parenting of sources/folders
Toolbar controls (move up/down), context menu actions, and selection sync with OBS
Locale support (en-US, pt-BR, ru-RU)
Installation (Windows)

Close OBS Studio.
Extract the ZIP so the included obs-studio folder merges into:
C:\Program Files
After extracting, you should have:
C:\Program Files\obs-studio\obs-plugins\64bit\obs_scene_tree_view.dll
C:\Program Files\obs-studio\obs-plugins\64bit\obs_scene_tree_view.pdb (optional for debugging)
C:\Program Files\obs-studio\data\obs-plugins\obs_scene_tree_view\locale*.ini
Launch OBS Studio. The Scene Tree View dock appears under View → Docks (enable if hidden).
Requirements

OBS Studio: 32.x (built against libobs 32)
Platform: Windows 10/11, x64 only
Notes

If OBS does not show the dock: check View → Docks → “Scene Tree View”.
If you previously installed an older version, overwrite the same paths above.
Changelog (highlights)

Initial public Windows x64 package for OBS 32.x
Folder-based scene organization with drag-and-drop
Move Up/Down toolbar improvements and selection stability

Full Changelog: v0.1.7...v0.1.8

Verification

To verify the Windows x64 ZIP integrity, compute the SHA256 hash and compare:

  • PowerShell: Get-FileHash -Algorithm SHA256 .\\scene-tree-view-windows-x64.zip
  • CMD: certutil -hashfile scene-tree-view-windows-x64.zip SHA256

SHA256 checksum:

1f9b37b386fa0f3286293f9eeb3bb05e819797fed3861beb6e7c8baf3ea24dca  scene-tree-view-windows-x64.zip
Loading