Overview:
This robust Lua script offers a powerful set of tools to dynamically manage and organize your scenes within OBS Studio. It integrates four core functionalities: Grid Layout, Reaction Layout and Highlight Layout, all with multi-language support.
Key Features:
Dynamic Grid Layout:
Technical Details:
This robust Lua script offers a powerful set of tools to dynamically manage and organize your scenes within OBS Studio. It integrates four core functionalities: Grid Layout, Reaction Layout and Highlight Layout, all with multi-language support.
Key Features:
Dynamic Grid Layout:
- Organize multiple video sources into a customizable grid pattern. Ideal for multi-participant presentations, team gaming streams, or varied content displays.
- Flexible Settings: Adjust spacing, margins, and X/Y offsets to tailor the grid to your scene design.
- Split-Screen Mode: A special mode for exactly two cameras optimizes the view, perfect for interviews or paired reactions.
- Create engaging reaction layouts with your cameras intelligently positioned relative to the main content (window capture).
- Camera Distribution: Choose between having all reaction cameras on a single side or symmetrically distributed on both sides of the screen.
- Custom Positioning: Control spacing and X/Y offsets for a perfect fit with your content window.
- Adjust Spacing: Change the spacing between cameras and the main content at will.
- Dedicated Prefixes: Define prefixes for your reaction camera sources (Reaction Prefix) and for the main content window capture (Reaction Window Prefix), ensuring the script identifies and positions elements correctly.
- This layout is designed to highlight a specific source while other reaction cameras are positioned relative to it.
- Flexible Settings: Define prefixes for the lateral cameras (Highlight Camera Prefix) and for the main source (Highlight Main Source Prefix).
- Camera Distribution: Option to distribute highlight cameras on both sides of the screen.
- Fine Adjustments: Control spacing and X/Y offsets for optimal positioning.
- The script provides support for several languages for a more accessible and intuitive user experience.
- Available Languages: English, Portuguese, Spanish, Chinese (中文), Russian (Русский), Japanese (日本語), and German (Deutsch).
- All settings are easily accessible and adjustable via a dedicated user interface in the OBS script properties panel.
- Intuitive Controls: Enable/disable each feature independently and adjust parameters with sliders and checkboxes.
- Real-time Updates: Changes to settings are applied dynamically, allowing you to see the results instantly.
Technical Details:
- When no screen share link or highlighted user is found, the Screen Share and the Highlight layouts fall back to the Grid Layout, so it's recommended that you configured spacing, margins and choose between normal or split screen mode in the Grid Section, even if you don't plan to use it.
- The script is configured to treat your OBS and the sources as if they're 1920x1080, but you can always change the resolution in the script (line 333). Just remember to always give the browser sources the same base resolution defined in Settings > Video.
- 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.
- Recommended Integration: While you can add and name your sources manually, this script works best with tools that offer automatic creation, deletion and dynamically renaming of sources with specific prefixes, such as VDO.Ninja in conjunction with the modified OBS Controller page by Morse: VDO.Ninja OBS Controller. You can find this script and the source code of the controller here. The original version of the controller can be found here, in case it interests you.
- OBS Studio (version 27.0 or higher recommended).
- Lua scripting support (included with OBS Studio).