Desktop Application20261 week

Hymn Broadcast Console

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.

Hymn Broadcast Console

Project Details

Role

Full Stack Architect

Client

Client

Duration

1 week

Year

2026

Tech Stack

ElectronPython 3.12BunCustom CSSSemantic ReleaseElectron 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.

The Approach

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.

Key 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
Hymn Broadcast Console - approach
Hymn Broadcast Console - result
Hymn Broadcast Console - additional