• 📹 Multi-Camera Support - Detect and use multiple camera devices
• 🎛️ Real-time Controls - Adjust FPS, blur strength, and effects live
• 🖼️ Background Effects - Blur, image, or video backgrounds
• 🔄 Virtual Camera Output - Stream to other applications

• 📱 Responsive Design - Works on desktop and mobile devices
• 🎨 Modern UI - Clean, intuitive glassmorphism design
• ⚡ Real-time Updates - Live status and device management
• 🔧 Easy Configuration - Simple web-based controls

• 🚀 FastAPI Backend - High-performance async API
• 🎬 OpenCV Processing - Professional video processing
• 📡 RESTful API - Clean API endpoints for integration
• 🔒 Error Handling - Robust error management and logging

Before you begin, ensure you have the following installed:

• 🐍 Python 3.8+
• 📹 Camera/Webcam (built-in or USB)
• 🌐 Modern Web Browser (Chrome, Firefox, Safari, Edge)

git clone https://github.com/KunjShah01/video-broadcaster.git
cd video-broadcaster

python -m venv venv
# Windows
venv\Scripts\activate
# macOS/Linux
source venv/bin/activate

pip install -r requirements.txt

python main.py

Open your browser and navigate to:

http://localhost:8080

1. 🎥 List Devices: Click "List Devices" to scan for available cameras
2. 📹 Select Camera: Choose your preferred camera from the dropdown
3. ⚙️ Configure Settings:
   • 🎛️ FPS: Set frame rate (1-60)
   • 🌫️ Blur Strength: Adjust background blur (1-52)
   • 🖼️ Background: Choose effect type
4. ▶️ Start Streaming: Click "Start Streaming" to begin broadcast
5. ⏹️ Stop Streaming: Click "Stop Streaming" to end session

graph TB
    A[🌐 Web Interface] --> B[📡 FastAPI Server]
    B --> C[🎥 Stream Utils]
    C --> D[📹 OpenCV Engine]
    D --> E[🎬 Video Processing]
    E --> F[📺 Virtual Camera Output]
    
    B --> G[📁 Static Files]
    G --> H[🎨 HTML/CSS/JS]
    
    style A fill:#e1f5fe
    style B fill:#f3e5f5
    style C fill:#e8f5e8
    style D fill:#fff3e0
    style E fill:#fce4ec
    style F fill:#f1f8e9

• 📱 Responsive UI: Modern glassmorphism design
• ⚡ Real-time Updates: Live status and controls
• 🎨 Interactive Elements: Buttons, sliders, dropdowns

• 🚀 High Performance: Async request handling
• 📡 RESTful Endpoints: Clean API design
• 🔒 Error Handling: Comprehensive error management

• 📹 Camera Management: Device detection and control
• 🎬 Video Processing: Real-time effects and filters
• 🔄 Stream Management: Input/output handling

📦 video-broadcaster/
├── 📄 main.py              # FastAPI application entry point
├── 🛠️ stream_utils.py      # Video processing utilities
├── 📋 requirements.txt     # Python dependencies
├── 📖 README.md           # Project documentation
├── 🤝 CONTRIBUTING.md     # Contribution guidelines
└── 📁 static/             # Web assets
    ├── 🎨 index.html      # Main web interface
    ├── 🖼️ logo.png        # Application logo
    └── 🖼️ image.png       # Background image

// 🔍 Get available devices
fetch('/devices')
  .then(response => response.json())
  .then(devices => console.log(devices));

// ▶️ Start streaming
fetch('/start?source=0&fps=30&blur_strength=21&background=blur')
  .then(response => response.json())
  .then(result => console.log(result));

# Error: [Errno 10048] Only one usage of each socket address is permitted
# Solution: Change port in main.py or kill existing process
netstat -ano | findstr :8080
taskkill /PID <PID_NUMBER> /F

# Ensure camera permissions are granted
# Check if camera is used by another application
# Restart the application

# Check if server is running on correct port
# Verify static files are in place
# Clear browser cache

• 🎨 Advanced Effects - Green screen, color filters
• 📱 Mobile App - Native iOS/Android applications
• 🌍 Multi-language - Internationalization support
• 📊 Analytics - Usage statistics and monitoring
• 🔐 Authentication - User accounts and security
• ☁️ Cloud Integration - Remote streaming capabilities

This project is licensed under the MIT License - see the LICENSE file for details.

• 🎥 OpenCV Community - For excellent computer vision libraries
• 🚀 FastAPI Team - For the amazing web framework
• 🎨 Design Inspiration - Modern glassmorphism trends
• 👥 Contributors - Everyone who helps improve this project

Need help? 🤝

• 📚 Documentation: Check our Wiki
• 🐛 Bug Reports: Create an Issue
• 💬 Discussions: Join our Community
• 📧 Email: [email protected]