Radio

Radio turns the standalone WebRTC radio into an installable app section. When enabled it mounts the radio console as a tab inside the app: go on air from the mic, watch the live listener count, share a listener link / iframe embed, and mint on-demand subscribe-only listen tokens.

Plugin id	radio
Category	panel
UI slot	app-tab
Needs worker	No

No worker is needed: the master publishes mic audio straight over WebRTC (LiveKit fan-out) and listeners subscribe; the only server touch is minting the publish/subscribe-only tokens, which the existing app token and radio listen-token endpoints already cover.

Configuration

Field	Type	Default	Description
room	string	radio	LiveKit room the master publishes to and listeners subscribe from.
listenTokenTtlSeconds	number	3600	Lifetime (seconds) of generated subscribe-only listener tokens. Min 60, max 86400.
autoStartMonitor	boolean	true	Auto-start the listener monitor when the tab opens.

Enable and configure

Dashboard: open the app’s Plugins tab → Install Radio → toggle Active. A Radio tab then appears inside the app. Configure to set the room name and listen-token TTL.

API:

curl -X PATCH https://YOUR-DOMAIN/api/v1/apps/live/plugins/radio \
  -H "Authorization: Bearer sk_..." \
  -H "Content-Type: application/json" \
  -d '{"enabled": true, "config": {"room": "onair", "listenTokenTtlSeconds": 7200}}'

Note

The listener monitor in the console subscribes audio-only and itself counts as one listener while it is open.