Dynamic Source Grid Organizer

OBS Lua Dynamic Source Grid Organizer 1.1

Overview: The Dynamic Source Grid Organizer is a powerful Lua script designed for OBS Studio to enhance the management of your sources within scenes. This script provides automatic alignment, spacing, and organization of browser sources in a grid or split-screen layout, offering flexibility and customization for your streaming or recording setups.

Features:
  1. Multi-Language Support:
    • Fully localized for multiple languages, including English, Portuguese, Spanish, Chinese, Russian, Japanese, and German. Simply select your preferred language, reload the script, and the menu adapts instantly.
      Language support.gif
  2. Dynamic Scene Management:
    • Automatically detects scenes and allows you to select the active scene for source organization. The script updates in real-time as sources are added or removed.
      Scene Detection.gif
  3. Source Filtering by Prefix:
    • Organize only specific sources by setting a prefix filter, making it easier to focus on the sources you need.
      Prefix Definition.gif
  4. Flexible Layout Options:
    • Support for split-screen layouts when exactly two sources are active.
      Split Screen.gif
  5. Customization Parameters:
    • Adjust source spacing, margin, and offsets along both the X and Y axes for complete control over source placement.
      Spacing.gif
      Margin.gif
      Offset.gif
  6. Real-Time Updates:
    • Calculates the number of rows and columns dynamically based on the number of active sources.
    • Sources are automatically arranged whenever changes occur, such as visibility toggles or adding/removing sources.
      Rearrangement.gif
Usage Instructions:
  1. Install the Script:
    • Download the script file and add it to OBS Studio through the "Tools > Scripts" menu.
  2. Configure Settings:
    • Open the script settings and select your desired language.
    • Choose a scene, set a source prefix, and adjust spacing, margins, and offsets as needed.
    • To deactivate the script, simply erase the source prefix and save it.
  3. Enable Split Screen (Optional):
    • For two active sources, toggle the "Split Screen for 2 Sources" option for a side-by-side layout.
Technical Details:
  • Since it was made to work mostly with external sources, like browser sources, the script adjusts sources aspect ratio to 16:9 by default, so it's recommended that you configure your sources for a 16:9 resolution so their image don't get distorted.
  • Sources are cropped, scaled, and positioned dynamically to ensure they fit perfectly into the layout.
  • Inactive sources are hidden from view but can be re-enabled at any time.
Requirements:
  • OBS Studio (version 27.0 or higher recommended).
  • Lua scripting support (included with OBS Studio).
GitHub Download: Click here to download the Dynamic Source Grid Organizer script from GitHub.
Contribute: Feel free to fork this script, change it, improve it. Do whatever you want.

Enjoy seamless source management with the Dynamic Source Organizer and take your OBS Studio setup to the next level!
Author
Morse
Downloads
21
Views
153
First release
Last update
Rating
0.00 star(s) 0 ratings
Top