MusicFlow Requirements

System & Architectural Requirements

Real-time diagnostic verification of all runtime dependencies, audio transcoding engines, MariaDB schemas, Go background daemons, and cloud streaming relays across the MusicFlow ecosystem.

100%
System Readiness
✓ 20 Passed

🖥️ Server & Host Runtime Environment

Nginx Web Server
Reverse proxy, SSL termination & WebSocket/stream passthrough
✓ Satisfied
Requirement: Nginx 1.20+
Detected: nginx/1.30.6
PHP Hypertext Preprocessor
Core backend application runtime and API processor
✓ Satisfied
Requirement: PHP 8.2+
Detected: PHP 8.5.4
Required PHP Extensions
8 mandatory modules for database, audio tags and REST communication
✓ Satisfied
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)
✓ Satisfied
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
✓ Operational
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
✓ Operational
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
✓ Operational
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
✓ Operational
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
✓ Operational
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
✓ Online & Indexed
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)
✓ Active
Requirement: Go 1.22+
Status: Go go1.26.8
Go Broadcaster Daemon
Autonomous audio pacer, playlist cycler and multi-endpoint Icecast streamer
✓ Active
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
✓ Configured
Requirement: Python 3.10+
Detected: Python 3.14.4
pychromecast & zeroconf
Google Cast mDNS discovery library for smart speakers and Cast Groups
✓ Configured
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
✓ Configured
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
✓ Online
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
✓ Online
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
✓ Online
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
✓ Connected
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)
✓ Connected
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