subwave-deploy

What problem does it solve?

Automates setting up, deploying, and safely updating the SUB/WAVE internet radio stack while verifying it is truly broadcasting audio rather than silently failing.

Core Features & Use Cases

• Fresh bootstrap with credentials seeding: runs the project setup flow, seeds operator-facing config, and boots the stack for first-time installs.
• Change-aware updates: pulls the latest code and rebuilds/recreates only the Docker services affected by changed paths, avoiding common “restart without rebuild” mistakes.
• Audio-level verification: confirms /api/health and /api/now-playing and also measures stream audio level from /stream.mp3 to detect the “on-air but silent” Liquidsoap wedge; includes log scanning for recent errors.

Use case: after pulling a commit that changes liquidsoap/radio.liq or controller/web code, run the deploy workflow to rebuild the correct services, bring the station back up, and ensure the stream actually carries sound.

Quick Start

Run the subwave-deploy skill to pull and redeploy the SUB/WAVE stack in your current repo and confirm it is live by checking container health, API endpoints, and non-silent audio from the stream.