A powerful OBS Studio script for automated multi-monitor projector management.
Perfect for streamers, content creators, and professional broadcasters.
- Multi-Monitor Detection:
- Automatic detection of all connected displays
- Support for multiple graphics cards
- USB monitor compatibility
- Resolution and position information
- Smart Monitor Selection:
- Primary monitor identification
- Detailed monitor information
- Test projection feature
- Monitor position awareness
- Multiple Projection Modes:
- Preview projector
- Scene projector
- Dynamic scene selection
- Real-time scene switching
- Automated Control:
- Auto-start with OBS
- Configurable startup delay
- Hotkey support
- Scene refresh functionality
- Reliability:
- Crash protection
- Resource cleanup
- Error logging
- Automatic recovery
- User Experience:
- Intuitive settings interface
- Grouped configuration options
- Project your stream preview on a secondary monitor
- Display different scenes on multiple monitors
- Quick switching between preview and scene modes
- Professional multi-display management
- Control multiple display outputs
- Dedicated preview monitors
- Scene distribution across displays
- Automated display management
- Multi-monitor recording setup
- Preview while recording
- Flexible scene distribution
- Automated display configuration
- Download the latest release from the releases page
- Place the script in your OBS scripts folder:
- Windows:
%APPDATA%\obs-studio\scripts - macOS:
~/Library/Application Support/obs-studio/scripts - Linux:
~/.config/obs-studio/scripts
- Windows:
- In OBS Studio:
- Go to Tools → Scripts
- Click the + button
- Select the downloaded script
- Configure your settings
- Python 3.9 or higher
- Windows 10/11
- Python 3.9 or higher
- macOS 11.0 (Big Sur) or higher
- XCode Command Line Tools (for Python)
- Python 3.9 or higher
- X11 or Wayland
- Required packages:
# Ubuntu/Debian sudo apt-get install python3-pip python3-tk # Fedora sudo dnf install python3-pip python3-tkinter # Arch Linux sudo pacman -S python-pip python-tk
-
Startup Options:
- Enable/disable automatic start
- Set startup delay time
- Configure default behavior
-
Display Options:
- Select target monitor
- Test monitor configuration
- View monitor details
-
Projector Options:
- Choose projection mode
- Select scene (if applicable)
- Configure refresh behavior
- Hotkey Configuration:
- Go to Settings → Hotkeys
- Find "Start Projector" under Scripts
- Set your preferred key combination
-
Quick Start:
- Select your target monitor
- Choose projection mode
- Click "Test" to verify
- Apply settings
-
Automated Setup:
- Enable "Start with OBS"
- Set appropriate delay
- Configure projection options
- Restart OBS to activate
-
Monitor Not Detected:
- Ensure monitor is connected
- Try reconnecting the display
- Check display settings:
- Windows: Windows display settings
- macOS: System Settings → Displays
- Linux: Check display settings in your desktop environment
-
Projection Issues:
- Verify monitor selection
- Check OBS Studio version
- Ensure sufficient system resources
- For Linux: Verify X11/Wayland compatibility
-
Performance Problems:
- Lower projection resolution
- Update graphics drivers
- Check system resources
- For macOS: Check Energy Saver settings
- For Linux: Verify compositor settings
- Update Windows display drivers
- Check Windows HDR settings
- Verify Windows scaling settings
- Check System Integrity Protection (SIP) settings
- Verify screen recording permissions
- Update macOS and OBS to latest versions
- Check display server (X11/Wayland) compatibility
- Verify desktop environment permissions
- Update graphics drivers and compositor
This project is licensed under the GNU General Public License v3.0 - see the LICENSE file for details.