Skip to content

Releases: TheThirdRail/scene-tree-view

Release v0.2.0

Choose a tag to compare

@github-actions github-actions released this 28 Jan 22:09

What's Changed

  • feat: Add cross-platform support (Linux and macOS) by @TheThirdRail in #1

New Contributors

Full Changelog: v0.1.8...v0.2.0

v0.1.9 - Dock Visibility & Content Sizing Fixes

Choose a tag to compare

@TheThirdRail TheThirdRail released this 25 Nov 03:10

πŸŽ‰ 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

Scene Tree View for OBS Studio (Windows x64)

Choose a tag to compare

@TheThirdRail TheThirdRail released this 04 Nov 00:51

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