Quick Start Guide

1. Add Videos: Paste any supported video URL (YouTube, Vimeo, Twitch, etc.) in the input field and click 'Add Video'. Repeat to add multiple videos.
2. View Your Grid: Click the blue link in the main window to open the grid. Your default browser opens with all videos playing simultaneously.
3. Configure Settings: Click ⚙️ Settings to access calculation settings. All settings automatically save when you click 'Save All Settings'.

Supported Video Platforms

• YouTube: Watch URLs, Live streams, and Channel URLs (requires API key)
• Twitch: Live channels and VODs
• Others: Vimeo, Dailymotion, TikTok, Instagram, Rumble, Odysee
• Streaming: RTSP, HLS (M3U8), and direct video file URLs

Quick Tips

• Tabs: Create multiple tabs for different video collections (Sports, News, Monitoring)
• Recording: Use 🔴 Rec for browser-based capture or OBS Studio for professional output
• Audio: In OBS Settings, use the 'Control audio via OBS' checkbox for Browser Sources
• Themes: Toggle light/dark mode instantly with the theme button

🎬 Professional OBS Integration

• Direct Control: Start/Stop recording and streaming in OBS from MultiTube
• Automation: Automatically create 'Browser Sources' or 'Window Captures' in OBS
• Audio Routing: Optional 'Control audio via OBS' for browser sources
• Scene Management: Seamlessly switch scenes and update source properties
• Live Sync: Synchronize stream status and buttons between applications

📡 Advanced Integrations

• Twitch OAuth: Secure login to retrieve stream keys and channel data
• YouTube Analytics: Integration for live performance monitoring
• Broadcast Management: Configure YouTube titles, privacy, and thumbnails from MultiTube
• RTMP Custom: Support for specialized ingestion URLs (RTMPS) for stable streaming

📹 Monitoring & Alert Systems

• Floating Camera Window: Dedicated preview for monitoring your own feed
• Banner Overlays: Custom text and banners for stream branding
• Sound Notifications: Audio alerts for status updates (Success, Error, Info)

🎛️ Responsive Grid System

• Intelligent Wall: Auto-calculates optimal layout based on stream count
• Manual Override: Specify exact rows and columns (up to 10x10)
• Local Server: Encrypted HTTPS server for secure grid hosting
• WebRTC Signaling: Built-in support for low-latency P2P streaming

🎞️ FFmpeg Processing

• High-Quality Recording: Advanced FFmpeg integration for local capture
• Multi-Format: Support for WebM, MP4, and more
• Job Management: Background recording and format conversion
• Custom Path: Ability to specify local FFmpeg binary path

🔧 Integration Setup (YouTube & Twitch)

1. Go to ⚙️ Settings → Integrations tab
2. YouTube: Enter your API key (see section below) to enable live detection and titles
3. Twitch: Click Login with Twitch for secure OAuth authentication. Your default browser will open the Twitch authorization page. Click 'Authorize'.
4. OAuth: Authenticate with YouTube to enable professional broadcasting features

🔑 API Configuration Guide

For those setting up their own keys:

YouTube API & OAuth Setup

1. Go to the Google Cloud Console.
2. Create a new project (e.g., 'MultiTube Stream').
3. Navigate to APIs & Services > Library and enable YouTube Data API v3.
4. Go to APIs & Services > Credentials to create an API Key and OAuth client ID.

Twitch API Setup

1. Go to the Twitch Developer Console.
2. Register a new Application (Category: Broadcaster Suite).
3. Copy the Client ID and Client Secret.

Using the Intelligent Wall

1. Enable Intelligent Wall (checkbox next to grid size)
2. The grid will automatically adjust its rows/columns as you add videos
3. If you need a specific layout, disable the checkbox and enter manual values

Configuring OBS Audio

1. In ⚙️ Settings → OBS Studio tab
2. Look for the Browser Capture Settings section
3. Check Control audio via OBS
4. Now, your MultiTube grid audio will appear as a separate source in the OBS Mixer

OBS Connection Issues

• Check Port/Password: Default port is 4455. Password is optional but must match.
• Enable WebSocket: In OBS, ensure 'Enable WebSocket server' is checked in Tools menu.
• Firewall: Grant permission for MultiTube (and Python) to communicate on local ports.

YouTube Streaming Errors

• "Invalid Ingestion URL": MultiTube uses rtmp_custom for YouTube. Ensure your stream key is fresh.
• "Broadcast not starting": Verify your YouTube account is enabled for live streaming and your API quota is not exceeded.

Media & FFmpeg

• FFmpeg Not Found: If recording fails, verify FFmpeg is in your Windows PATH or manually set the path in Settings → Media & Recording.
• Black Screen: Disable 'Hardware Acceleration' in your browser if window capture shows a black screen.

🔒 SSL & 'Not Secure' Warnings

• Fix "Not Secure": Go to Settings → General & Network → Click 🛡️ Install Certificate.
• Admin Prompt: You must click 'Yes' on the Windows Admin (UAC) prompt to trust the local grid.
• Browser Restart: If the lock doesn't appear, close ALL Chrome/Edge windows and restart the browser.

Twitch Auth Issues

• Redirect Failed: Ensure no other application is using port 17563 during Twitch login.
• Invalid Token: If data doesn't load, click 'Clear Twitch' and login again.