🖥️ Server & Host Runtime Environment
Nginx Web Server
Reverse proxy, SSL termination & WebSocket/stream passthrough
Requirement:
Nginx 1.20+
Detected:
nginx/1.30.6
PHP Hypertext Preprocessor
Core backend application runtime and API processor
Requirement:
PHP 8.2+
Detected:
PHP 8.5.4
Required PHP Extensions
8 mandatory modules for database, audio tags and REST communication
Requirement:
mysqli, pdo_mysql, curl, mbstring, json, gd, session, openssl
Detected:
8/8 Active (mysqli, pdo_mysql, curl, mbstring, json, gd, session, openssl)
php-getid3 Metadata Engine
Audio file tag extractor (ID3v1, ID3v2.3/v2.4, FLAC Vorbis, Ogg)
Requirement:
getID3 1.9.20+ (/usr/share/php/getid3/getid3.php)
Detected:
v1.9.24-202509040923 (/usr/share/php/getid3/getid3.php)
🎧 Audio Transcoding & Broadcast Infrastructure
FFmpeg Audio Transcoder
High-fidelity audio normalization and 256 kbps MP3 stream encoding
Specification:
FFmpeg 6.0+ with libmp3lame
Active State:
FFmpeg 8.0.1-3ubuntu2+esm5
FFprobe Duration Analyzer
Non-blocking precise audio stream frame and duration measurement
Specification:
FFprobe 6.0+
Active State:
FFprobe 8.0.1-3ubuntu2+esm5
Cinema Video Streaming Engine
Direct MP4 byte-range streaming + Real-Time Ultrafast FFmpeg DivX/AVI Transcoder
Specification:
HTML5 Native Playback & FFmpeg fMP4 live streaming
Active State:
Operational (1316 titles indexed in Cinema)
Local Icecast 2 Server
Local network streaming server receiving audio from Go Broadcaster
Specification:
Icecast 2.4.x / 2.5.x on port 8000
Active State:
Online & Listening (127.0.0.1:8000)
Cloud Relay Icecast Stream
DigitalOcean cloud stream relay endpoint for public listeners
Specification:
HTTPS Stream Proxy at stream.prometheandesigns.com
Active State:
Online & Broadcasting (65ms latency)
🗄️ MariaDB Database & Playback Scrobbler
MariaDB RDBMS Server
Tracks library catalog, playback scrobbling history, and user authentication
Schema Specification:
Database `musicflow` with tables `tracks`, `users`, `playbacks`, `system_config`
Active Version:
MariaDB 11.8.6-MariaDB-5ubuntu0.1 from Ubuntu (82 tracks, 2 users)
🛰️ Go Broadcaster Satellite (`musicflow-satellite`)
Go Compiler & Runtime
Compilation toolchain for Go Broadcaster (Linux & Windows amd64)
Requirement:
Go 1.22+
Status:
Go go1.26.8
Go Broadcaster Daemon
Autonomous audio pacer, playlist cycler and multi-endpoint Icecast streamer
Requirement:
Systemd service (musicflow-satellite.service) & Web UI on :8085
Status:
Active & Listening (:8085)
🎙️ Autonomous AI DJ & Gemini Voice Engine
Python 3 Runtime
Executes the Autonomous AI DJ script, Humboldt News desk, and mDNS Cast discovery
Requirement:
Python 3.10+
Detected:
Python 3.14.4
pychromecast & zeroconf
Google Cast mDNS discovery library for smart speakers and Cast Groups
Requirement:
pychromecast Python package
Detected:
Installed in site-packages
Google Gemini API Key
Powers Gemini 3.8 Flash radio script writing and Gemini Flash TTS voiceovers
Requirement:
Gemini API Key configured in Satellite AI engine
Detected:
Configured & Active (AQ.Ab8RN...)
☁️ Cloud APIs & Metadata Services
wttr.in Weather API
Live meteorological conditions and multi-day precipitation forecasts
Endpoint:
HTTPS access to wttr.in
Network Health:
Operational (534ms)
ip-api.com Geolocation
Client IP city and region resolution for dynamic listener weather chips
Endpoint:
HTTP access to ip-api.com
Network Health:
Operational (102ms)
LRCLIB Synchronized Lyrics
Timed .lrc lyric line lookup fallback for real-time karaoke scrolling
Endpoint:
HTTPS access to lrclib.net
Network Health:
Operational (344ms)
🏠 Smart Home & Multi-Room Audio
Home Assistant OS (HAOS VM)
Webhook receiver at 192.168.1.209:8123 for Now Playing metadata sync
Device Target:
HAOS KVM VM reachable on port 8123
Network Status:
Online (192.168.1.209:8123)
Lenovo Smart Clocks / Sendspin
Cast endpoints for Upstairs clock (192.168.1.242) & Bathroom clock (192.168.1.125)
Device Target:
Google Cast ports (8009) open on local subnet
Network Status:
Both Clocks Online (Port 8009)
⚡ Quick Host Provisioning Commands (Ubuntu / Debian)
# 1. Install System Web, Database & Audio Packages sudo apt-get update && sudo apt-get install -y \ nginx mariadb-server ffmpeg libmp3lame0 php-fpm \ php-mysqli php-curl php-mbstring php-gd php-getid3 icecast2 # 2. Install Python Cast & mDNS Discovery Tools pip3 install --break-system-packages pychromecast zeroconf # 3. Compile & Start Go Broadcaster Satellite cd /home/wiyot/musicflow-satellite go build -o musicflow-satellite . sudo systemctl enable --now musicflow-satellite.service