subwave-control
CommunityStart or stop your Subwave radio safely
Software Engineering#health check#docker compose#icecast#subwave#stream control#next.js dev server#on-air verification
Authorperminder-klair
Version1.0.0
Installs0
System Documentation
What problem does it solve?
It solves the problem of quickly powering up or shutting down the SUB/WAVE personal internet radio stack without performing builds, rebuilds, or configuration rendering.
Core Features & Use Cases
- Mode-aware start/stop (dev vs prod): Detects which docker compose mode is already running and starts or stops the correct stack, or asks which mode to use if neither is up.
- Guaranteed on-air verification: After starting, verifies the radio is actually streaming by probing the controller health endpoint (expecting on-air status).
- Dev-only web startup: In dev mode, launches the Next.js web dev server on port 7700 in the background and handles common port-collision issues (e.g., AirPlay receiver conflicts).
Use cases include: restarting the station during development, shutting down the stream after a demo, or turning the radio on for listeners without touching deployment/config changes.
Quick Start
Ask the AI to start subwave in dev mode.
Dependency Matrix
Required Modules
None requiredComponents
Standard package💻 Claude Code Installation
Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.
Please help me install this Skill: Name: subwave-control Download link: https://github.com/perminder-klair/subwave/archive/main.zip#subwave-control Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
Agent Skills Search Helper
Install a tiny helper to your Agent, search and equip skill from 471,000+ vetted skills library on demand.