skills.rest
perminder-klair
perminder-klairCOMMUNITY
Explore all skills by this author →
Website𝕏@pinku1GitHub

subwave-control

Starts or stops the SUB/WAVE radio stack with docker compose and verifies on-air streaming.

1.2k|104|Updated May 11, 2026
Search Tags:#health check#docker compose#icecast#subwave#stream control#next.js dev server#on-air verification
One-click install
npx skills add https://github.com/perminder-klair/subwave --skill subwave-control
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: subwave-control
Source: https://github.com/perminder-klair/subwave/tree/main/.claude/skills/subwave-control
Command: npx skills add https://github.com/perminder-klair/subwave --skill subwave-control

SYSTEM DOCUMENTATION & REQUIREMENTS

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.

Frequently Asked Questions about subwave-control

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I start and stop a Docker Compose radio stack on demand?▼

You can start or stop the radio stack by running docker compose up or down against the correct compose file. The process detects the active mode and verifies the stream is on-air using a health endpoint probe.

How do I verify my Icecast stream is actually on-air after starting it?▼

Verify the stream is on-air by probing the controller /health endpoint after starting the stack. This health check expects an on-air status response to confirm the radio is successfully streaming audio.

Why does my Next.js dev server fail to launch on port 7700 during development?▼

The Next.js dev server on port 7700 may fail due to port-collision issues, such as AirPlay receiver conflicts. The startup process handles these common port collisions by launching the dev server in the background.

Can I switch between development and production modes for a Docker Compose stream?▼

Yes, the mode-aware start and stop process detects which Docker Compose mode is currently running and applies the action to the correct stack. If neither mode is active, it prompts you to choose one.

What is the best way to shut down an internet radio stream after a demo?▼

The best way to shut down the stream is by running docker compose down against the active compose file. This safely stops the radio stack without performing any builds or configuration rendering.

Related Skills

Explore More Software Engineering Skills→
jholhewresjholhewres
3

docker-compose

Manage multi-container Docker applications with Docker Compose.

Community
Advanced
vZulinvZulin

circleci-automation

Trigger CircleCI pipelines and monitor workflows, artifacts, and test metadata.

Community
Intermediate
MacPhobosMacPhobos

Tauri Advanced Event System

Explain advanced event system patterns for Tauri applications.

Community
Advanced
zilliztechzilliztech
3

local-setup

Deploy local Milvus environments using Milvus Lite, Docker Standalone, or Docker Compose.

Official
Advanced