Hymn Broadcast Console
- Electron
- Python
- WebSocket
- OBS
- Broadcast
- Live Streaming
- Bun
A professional desktop broadcast controller that bridges a Python-based state engine with Electron UI to manage live overlays, lyrics, and stage displays for OBS and vMix for SDA Hymns.
Challenge
In live worship and broadcast environments, operators need a simple way to control complex visual overlays (lower thirds, lyrics, stage notes) without fumbling through manual file edits or complex OBS scenes. The system needed to be stable enough to run locally without internet while allowing real-time updates across multiple display outputs.
Solution
I engineered a hybrid architecture using a Python backend as the "source of truth" for state management and Electron for the operator's dashboard. By serving overlays via WebSockets on a local loopback address, the console provides sub-millisecond latency for live style changes and visibility toggles in professional streaming software like OBS and vMix.
| Features |
|---|
| Dual-process architecture: Python backend for logic, Electron for UI |
| Real-time state synchronization via WebSocket + HTTP |
| Automated CI/CD pipeline for Windows (.exe), macOS (.dmg), and Linux (.deb) |
| Dynamic port selection (detects busy ports to prevent startup crashes) |
| Token-based authentication for secure local overlay URLs |
| Integrated icon generation and automated semantic versioning |
| Tech Stack | Electron, Python 3.12, Bun, Custom CSS, Semantic Release, Electron Builder |
|---|