Hymn Broadcast Console
Technology Radar
- Electron
- Python 3.12
- Bun
- Custom CSS
- Semantic Release
- Electron Builder
The 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.
Fig 1. User Interaction Flow
The 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.
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