Skip to content

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.

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.

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:

Terminal window
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}}'