🏏 Live Cricket Score API & OBS Broadcast Overlay

A high-performance FastAPI backend and OBS Broadcast Graphics Overlay package designed for live cricket streaming and real-time score tracking. Powered by CREX real-time socket streams, it delivers live ball-by-ball score data, dynamic player profiles, win probability gauge meters, customizable broadcast overlays, and on-screen producer watermarks.

---

✨ Features

• ⚡ Fast Async API: Built with FastAPI & HTTPX for sub-second live score retrieval.
• 🎨 OBS Broadcast Overlay: Transparent, 1080p responsive glassmorphic overlay with dynamic producer watermarking.
• 🏷️ Customizable Watermark: Features built-in producer watermark (PRODUCER: CHILUVERU S NOHITH), customizable via URL query parameter (?watermark=Your+Name).
• 📊 Win Probability Gauge: Real-time interactive SVG arc gauge dial tracking match win probabilities.
• 🎛️ Hotkey Control Engine: Live layout state toggling directly on-screen or via web controller interface.

---

📁 Repository Structure

LiveBroadcast/
├── app.py                  # Main FastAPI Server & WebSocket Handler
├── crex_score.py           # CREX Real-Time Socket Stream Scraper Engine
├── stream_manager.py       # Live Stream Manager & Overlay Controller
├── index_broadcast.html    # 1080p Glassmorphic OBS Graphics Overlay
├── index.html              # Web Dashboard & Scorecard Controls
├── requirements.txt        # Python Dependencies
└── tests/                  # API Test Suite

---

🚀 Quick Start

Prerequisites

• Python: v3.9 or higher

1. Installation

git clone https://github.com/Snohith/LiveBroadcast.git
cd LiveBroadcast
pip install -r requirements.txt

2. Start the FastAPI Server

python run.py

The server will run on http://localhost:8000.

3. Add to OBS Studio

1. Open OBS Studio.
2. Add a new Browser Source.
3. Set the URL to: http://localhost:8000/index_broadcast.html?watermark=Chiluveru+S+Nohith
4. Set dimensions to 1920 x 1080.

---

📄 License

This project is licensed under the MIT License. See LICENSE for details.

---

Created by Chiluveru Snohith