▮ Operate

Guests (WebRTC)

Bring a remote guest into the studio with nothing but a link. They open it in a browser, share camera and mic, and appear as an ordinary source you can cut to, scenes, overlays, recording and fan-out all work exactly as they do for any other input.

Invite a guest

  1. Open the Guests section in the studio.
  2. Enter a name and create the invite.
  3. Copy the join link, it looks like https://your-host/guest/<token>, and send it to your guest.

Joining

The guest opens the link, allows camera and mic, sees a preview, and presses Join. Their browser publishes to your instance over WebRTC (WHIP). Once media arrives, the guest shows up as a live source in the switcher, cut to them like anything else. Their status moves from invited to connected, and back to left when they leave.

Connectivity (STUN / TURN)

Guests on the same network connect over STUN, which is on by default. Guests behind strict or symmetric NAT need a TURN relay. Configure one under Guests → Connectivity (URL, username, credential), the same ICE servers are handed to the guest's browser, so the two never drift.

An optional coturn service ships with the Docker compose file under the turn profile:

docker compose --profile turn up

Then point the Connectivity form at turn:<your-host>:3478 with the configured credentials. Change the default guest:changeme in the compose file for production.

WebRTC ingest needs ffmpeg with the VP8 decoder and libx264, both are present in the bundled Docker image. Test end-to-end with a real second device (a phone works well).