Options & controls reference
Everything is driven by URL parameters plus a few on-screen controls. Add
parameters to a room URL with &, e.g.:
https://cre8stream.com/?room=ROOMID&bitrate=2500&quality=1&label=Jaro
If you omit room, you get the welcome page: pick a nickname (optional), set a
room password (optional), and it creates the room for you — the resulting URL is
instantly shareable. Add autostart to skip the page and auto-generate a room
straight into the address bar, like the old default.
Modes
| Param | Mode | Description |
|---|---|---|
(no room) |
Welcome page | Create a room, with an optional nickname and password. autostart skips it. |
| (none) | Studio | You publish camera/mic and see everyone. The default. |
recv=1 |
Director | You publish nothing, watch everyone, and get the local per-peer controls and the room panel. Good for a producer/monitor seat — the panel shows a ready-made Director link to share. |
view=PEERID |
OBS view | A clean, chrome-free page showing exactly one peer — for an OBS Browser Source. No controls, cursor hidden. |
board |
OBS whiteboard | A clean, chrome-free page showing just the shared 🎨 whiteboard — for an OBS Browser Source (the room panel offers a ready-made link). Blank until someone opens the board, then follows it live; builds no peer connections (zero decode cost). Ignored when view= is present. |
First-time guests opening a ?room= invite see a one-field nickname prompt
(optional — joining works with it empty). A label= param, a nickname remembered
from a previous visit, or autostart skips the prompt. Directors (recv=1) and
OBS view= pages never see it. Submitting this prompt or the welcome page with the
nickname field emptied forgets the remembered nickname (like clearing it with ✏️).
Password-protecting a room
| Param | Values | Effect |
|---|---|---|
password=SECRET |
text | Gates the room with a shared secret. room=abc&password=A and room=abc&password=B are entirely different rooms — only people with the same room and password ever meet. Same model as vdo.ninja. |
The password is folded into the signaling room name in your browser (a truncated
SHA-256), so the plaintext never travels over the signaling WebSocket — the relay
only ever sees the derived room name. Invite and OBS links generated in-app automatically
include &password= so they stay click-to-join.
Honest caveat: because the password rides in the page URL (exactly like vdo.ninja), the
HTTP request that loads the page carries it to your server (and Caddy, or any proxy in
front), and it can land in browser history and in an access log. The app logs no request
URLs and the shipped Caddyfile enables no access log, and you self-host, so any log is yours.
Having guests append &password= themselves does not avoid this — that is the
same page load. For stricter use, share the link without the password and give it out-of-band;
the join screen has no password field, so a guest still has to put it in the URL.
Publishing options
| Param | Values | Effect |
|---|---|---|
label=NAME / name=NAME |
text | Your display name — shown on your tile on every peer's screen and in the room panel. Also settable on the welcome/join screens; remembered by your browser for next time. |
push=ID |
1–32 of A–Z a–z 0–9 _ - | Claim a specific peer id instead of a random one — a personal, one-guest invite link. Accepted exactly or ignored. One id = one seat: a second person opening the same link takes over and the first is disconnected. Make these from the room panel's personal_invite /reserve --permanent-slot. |
bitrate=KBPS |
200–20000 | Caps your outbound video bitrate. Values outside the range are clamped. Also adjustable live via the vid ▾ select on the You row of the room panel. |
audiobitrate=KBPS |
6–512 | Caps your outbound audio (Opus) bitrate. Values outside the range are clamped. Also adjustable live via the aud ▾ select on the You row of the room panel. Best-effort — the browser maps it onto Opus's target bitrate. |
codec=... |
h264 vp8 vp9 av1 |
Preferred video codec. Defaults to h264. Preference only — it reorders, never removes, so peers without it still connect. |
relay |
flag, or 0 = off |
Relay-only connections. Every connection your browser makes goes through the server's TURN relay, so the other members see the relay's address, never yours (an OBS view= link can carry it too). Only your own side changes. It needs TURN on the server — ask whoever runs it. Without one it never falls back to connecting directly: your connections simply don't start, and the status line says ! relay-only: no TURN relay. Relayed video costs the server bandwidth, may not connect on a home-network-only server, and a page that loaded while the relay was unreachable takes about 20 seconds to connect once it is back. Not remembered. |
quality=N |
0 1 2 |
Capture preset: 0 = 1080p, 1 = 720p (default), 2 = 360p. |
width= height= |
pixels | Capture size (overrides quality). Treated as "ideal", so the camera never errors if it can't match exactly. |
fps= |
number | Capture frame rate ("ideal"). |
ec= |
0 1 |
Browser echo cancellation on your mic. Default on (that's every browser's own default — today's behaviour); set ec=0 to disable, e.g. for music. ⚠️ Without headphones, disabling it makes everyone else hear themselves echo through your speakers. Applied to the raw mic capture — zero added latency, best-effort ("ideal"), never blocks joining. Also a ⚙️ checkbox, remembered (a link param overrides the remembered choice for that visit). ec/ns/agc change your outbound mic — what others hear of you; you can't hear your own processing, so verify a change with a second participant (or a local recording). |
ns= |
0 1 |
Browser noise suppression on your mic. Default on; set ns=0 to let room sound through unprocessed (music, instruments). Same mechanics as ec=. |
agc= |
0 1 |
Browser auto mic gain (level riding). Default off — auto gain fights the input level you stage in your own hardware / OS / OBS, so that's left to you; set agc=1 to let the browser ride your level instead. Same mechanics as ec=; silently ignored (and the ⚙️ checkbox hides itself) on browsers without AGC support. One exception: a device that rejects every capture setting joins through a last-resort plain request, which gets the browser's own default — auto gain on in Chromium — and the ⚙️ checkbox then shows it ticked. |
noisegate |
flag, dB −90…−20, or 0 = off |
Noise gate on your outgoing mic: fully mutes it between words, so keyboard/fan/room noise never reaches the room. Optional value sets the open threshold in dBFS (default -50; lower = more sensitive); noisegate=0 explicitly turns it off, overriding a remembered ⚙️ opt-in. Also a ⚙️ checkbox ("mic noise gate"), remembered. Honesty note: unlike recording/stats/glow, this puts real processing on your outbound audio path — expect ~10–30 ms added to your own voice (Web Audio processing quanta + the leveler's fixed ~6 ms look-ahead). Your video and everyone else's audio are unaffected; that's within typical network jitter, but it's opt-in for a reason. On browsers without AudioWorklet the gate is skipped (the leveler still applies); its checkbox stays visible while a gate wish is on, because it is the only off-switch for that degraded chain. |
compressor |
flag, or 0 = off |
Leveler (compressor) on your outgoing mic: evens out your volume — quiet asides come up, sudden peaks come down (gentle 3:1 voice preset). compressor=0 explicitly turns it off, overriding a remembered ⚙️ opt-in. Also a ⚙️ checkbox ("mic leveler"), remembered. Same ~10–30 ms outbound-latency note as noisegate; combine both (&noisegate&compressor) for the full clean-up chain. |
mute / muted |
flag | Join with your mic muted (toggle it back on with 🎙️). |
layout= |
auto row col |
Tile layout direction, for the main grid and the ⧉ PiP window. auto (default) packs tiles into whatever column count fills the window best; row puts everyone in one horizontal row and col in one vertical column, so a new joiner extends the line instead of re-packing the grid. Purely local — it changes only what you see, nothing is sent and nobody else's view moves. Also a ⚙️ picker ("tile layout"), remembered. When a forced row/column can no longer fit at a usable tile size the direction is kept and the grid scrolls, rather than silently reverting to the packed layout you didn't ask for. An unrecognised value falls back to the choice remembered from ⚙️, then to auto. |
hud= |
0 1 |
Hide the HUD — the header, participant panel, chat panel and each tile's per-peer controls and &stats readout — leaving video and names. Default on (hud=0 to start hidden). Also the ▤ hud button; a ghosted ▤ in the top-right corner brings it all back, and the choice is remembered. Works inside the ⧉ PiP window too. Deliberately not hidden: each tile's name label (a nick is not chrome), the active-speaker glow, a raised hand shown on a tile, your own mute button, the 🎨 whiteboard's toolbar, and the PiP window's own mute/chat/grow buttons (hiding the mute would leave you no way to mute from that window). Local view only — nothing changes for anyone else, and nothing about what OBS receives. |
novideo |
flag | Join audio-only (no camera captured). |
noaudio |
flag | Join video-only (no mic captured). |
autostart |
flag | Skip the welcome/join screens: auto-creates a room when room is absent, joins instantly when it's present (an unnamed join shows as peer <id>). For kiosk/companion links. |
stats |
flag | Overlay a live diagnostics readout on each tile — inbound kbps + RTT on remote tiles, outbound kbps on your own. Read straight from WebRTC's own counters (no messages sent, media path untouched). Handy for verifying a bitrate cap: received kbps sits a little under a set bitrate=/force ceiling by design (the cap is a max, not a target; counters are payload-only; congestion control trims further). Off unless present. |
debug |
flag | Surface otherwise-swallowed runtime errors on the status line (the capability banner in the console at boot prints regardless). Use it to triage a browser that connects to nothing — especially a locked-down/enterprise Firefox. Off unless present. |
A flag is "on" simply by being present: ?muted and ?muted=1 both mute you.
Examples
# 720p, mic muted on join, capped at 2.5 Mbps
/?room=abc&quality=1&muted&bitrate=2500
# Audio-only guest (no camera)
/?room=abc&novideo&label=Podcast%20Guest
# Force VP9 instead of the H.264 default
/?room=abc&codec=vp9
# A clean OBS source for one specific peer
/?room=abc&view=PEER123
On-screen controls
Your controls (header, when publishing)
| Button | Action |
|---|---|
| 🎙️ | Mute / unmute your mic. The button shows the state (on / off, or lost when the device stopped delivering — unplugged, taken by another app), so a click always means "flip it", and the whole button is red only while the mic is actually capturing — and so are the mute button on your own tile and the floating mute in the picture-in-picture window, one red meaning one thing wherever you are looking. Your own tile's button has no room for a word, so it shows red for capturing, a dashed red ring when the device is dead, and a crossed-out microphone when you muted it. An unplugged device is re-captured once, at once, and again each time you return to the tab; one taken by another app is waited out. The glyph is crossed out too where the icon webfont loaded. Keyboard shortcut: M (except while typing in a text box). |
| 🎤 enable mic | Appears only if you joined without a mic (permission denied or the device was busy — see the Android note below). Grants and adds your microphone live, without a reload. Disappears once the mic is added. |
| 📷 | Turn your camera off / on. The button shows the state (on / off, or lost when the device stopped delivering), and the whole button is red only while the camera is capturing (including during a screen share, if the camera is still on). The glyph is crossed out while the camera is off where the icon webfont loaded; otherwise the word is the indicator. |
| 🖥️ | Share your screen (replaces your camera feed; stop to return to camera). The button turns red while you are sharing (icon and border, so it shows even without the icon webfont). Hidden on browsers that cannot capture the screen (phones); a capture that fails for any reason other than cancelling the picker says so in the status line. |
| ⏺ record | Record your own camera/mic/screen to this device — nothing is uploaded. It taps the tracks you already send (no latency; CPU only while recording). Click again to stop and download. Idle, only the ⏺ dot is red; while recording the whole button is red. See the note below. |
| ⚙️ settings | Opens the settings popup. Esc closes one thing per press, topmost first: this popup, then the 💬 chat panel, then a ⬛ enlarged whiteboard (which is shrunk back into the grid — the board itself is never closed that way, because closing it throws the drawing away for everyone). Switch your camera / microphone live (publishers), and pick a speaker / sound output for the room's audio where the browser supports it (Chromium; local playback only — it changes what you hear through, never what anyone sends). Choices are remembered for your next visit. The speaker row hides itself when there's no real choice (browsers expose outputs only after mic permission; Firefox not at all); directors always get ⚙️ — it holds the device-independent tile layout picker, and the speaker row inside it hides itself when there is no real output choice. An unplugged output falls back to the system default. Also holds a tile layout picker (&layout= above — auto / one row / one column, remembered) and a hide my own tile in PiP toggle that drops your self-view from the ⧉ PiP window so you can monitor just the others. Publishers with a mic additionally get three mic processing checkboxes — echo cancellation, noise suppression, auto mic gain (&ec=/&ns=/&agc= above) — applied live, remembered, each hidden where unsupported (a browser that can't change these live gets a one-shot mic re-capture instead — which, mid-recording, also starts a new -partN part unless clean-up is on) — plus the two mic clean-up toggles (noise gate / leveler, &noisegate/&compressor above): opt-in outbound processing (~10–30 ms on your own voice), remembered, hidden where unsupported; toggling one mid-recording starts a new -partN part, and while clean-up is on a mic switch no longer splits the recording at all. |
| ⧉ pip all | Pop the whole grid into a floating always-on-top window (Chrome/Edge 116+, Firefox 151+; Safari gets the per-tile ⧉ instead). The window opens sized for a near-square packing (4 tiles → 2×2, not one long strip). After that it never resizes itself — a window you dragged into a corner of your screen stays where you put it — it just re-picks the column count that makes the tiles as large as the window allows in both directions when someone joins or leaves and when you drag-resize it. To make it big in one click, press ⤢ in the bottom-right corner of the PiP window: it asks for 80% of your screen and never shrinks a window you already made larger. Browsers cap how large a page may make its own picture-in-picture window, so you may get less than you asked for. Both this and the per-tile ⧉ float above other apps at the OS level, so you can keep an eye on the room while working elsewhere — the active-speaker glow shows there too. Per-peer mute/volume, your self 🎙️, and the M key all work inside the PiP window; the first click there also unlocks audio. With "hide my own tile in PiP" on, a standalone 🎙️ mute button appears at the bottom of the PiP window so you can still mute yourself while your tile is hidden — it reads on / off / lost like the header one. |
| 🎨 board | Open a shared whiteboard (the button turns red for everyone while a board is open) — an extra tile everyone sees and everyone can draw on (directors too). Strokes travel over the signaling channel like 💬 messages: nothing touches the media path, and connection setup is unaffected. Toolbar: four pen colors, pen-width cycle, ↩ undo your last stroke, 🗑 clear all (for everyone), ⤢ enlarge, ✕ close for everyone (drawing discarded). The drawing keeps one 16:9 shape on every screen; an enlarged board (or a non-16:9 OBS source) shows dark bars around it. On a drawn board 🗑, ✕ and the 🎨 close need two presses: the first arms the button (dashed red ring, "Click again …"), a second within 3 seconds acts. Late joiners get the current drawing automatically; the board dies with the room and never shows on the clean view= OBS feed. To put the drawing on stream, add the panel's ready-made &board link as its own OBS Browser Source. In bigger rooms remote strokes update a few times a second (batched) — your own drawing is always instant. |
\o/ raise | Raise your hand. A small \o/ badge appears on your tile for everyone in the room, carrying the position you're in — \o/ 1 for whoever raised first, \o/ 2 next, and so on — and the panel lists the queue in order. Press again to lower it. A director (recv=1) publishes no video and so has no tile — their hand shows in the panel only, which means it is not visible to anyone running with the HUD hidden. Only you can lower your hand: there is no host override, on purpose (that would need a signed channel the relay deliberately doesn't have). Costs one tiny message per person, never touches video or audio, and never appears on an OBS view= feed. Honest limit on the numbers: members' clocks are never synchronised, so each raise is announced as "I raised this long ago" and every browser re-bases that onto its own clock. The order is accurate to network latency, not to the millisecond — two hands raised within a fraction of a second of each other can be numbered differently by different people; anything with real space between them is consistent for everyone. |
| ☀ theme | The sun in the header (on the welcome page, ☀ theme: dark). One press walks to the next theme: dark (the default terminal skin) → light (the light terminal: light green-grey paper with dark-green text, for bright rooms or anyone who finds the dark skin too dark) → black-red-white (a black page with white text and controls, where red marks what is live — your mic and camera while on air, a running recording, a shared screen, an open board — and what has gone wrong; the record button's dot is red at rest, as in every theme, and the welcome page's $ marks, cursor and title glow are red as decoration) → dark again. The switch names the theme that is on: the welcome page's in its label, the header's (a bare sun) in its tooltip and its screen-reader name. In the light theme only the page around the video changes: every tile, its controls, the whiteboard and anything over a picture stay dark. Black-red-white is itself a dark theme, so tiles and their controls take it too; the whiteboard's canvas and pen colours never change with a theme, because everyone has to see the same drawing. Warnings keep their amber in every theme (a middling ping, a private chat line, a log warning), and so does the orange >100 % volume mark. The choice is remembered on this device, other open tabs follow it at once (these help pages too), and the switch is also on the welcome page, beside tldr how to use. Local view only, with no URL parameter: it changes nothing for anyone else, and an OBS view= or &board source is never themed. Sits just left of ▤ hud. |
| ▤ hud | Hide the header, panel and per-tile controls and stats for a clean view of video and names (&hud= above). Sits just left of ⚙️ settings. A ghosted ▤ in the top-right corner restores it, and the choice is remembered. |
| 💬 chat | Opens the room chat panel: messages to everyone, or private ones to a chosen studio member (the private list holds studio members only: a director reports the same role as an OBS page, and OBS pages drop chat — a director still receives and sends room-wide messages). A nickname another member shares (or one that reads "you") shows its seat — Sam, seat <id> — in the recipient list, on lines and in toasts; your own lines are marked, and a private one names its recipient. History for this room stays in this tab for 5 hours / 500 messages; a short sound marks a new message while the panel is closed. Never on an OBS view= or board feed. |
| 🧾 log | Download a connection log for this tab — drops, reconnects, ICE failures, black tiles, device changes — as one .json file. Always recording from the moment you load the page, saved locally, redacted (no network addresses, no full room id, no password in any spelling an invite link gives it) so it is safe to paste into an issue — within the stated limits: matching is exact, and a secret shorter than 4 characters is not searched for inside error text (the full list: the connection log, below). |
| 🧾 log all | Ask everyone in the room for their connection log and save them as one bundle, with an automatic analysis of how the logs line up (who kept dropping, whose encoder stopped, which link kept failing). Each person is asked first — a prompt names you and your id, and only Send my log sends anything; Decline, Esc or 30 seconds of silence say no. What is sent is the same redacted log as 🧾 log, without the browser user agent, language or screen size — and it names the other members that person is connected to. Studio members only; once a minute. OBS pages answer “unsupported” (collecting everyone's log, below). |
| ♻ reconnect | Rebuild every eligible connection this tab holds — the escape hatch when a tile stays black despite the automatic recovery (which never stops: its rebuild interval backs off, to a ceiling of two minutes on one rung and just over five on the other). Rebuilds those links at once, skipping a member whose signaling socket the relay is holding after a drop (the status line counts those), a link younger than 2.5 seconds, and a link that is dark by design (a receive-only pairing). It turns red and reads reconnecting while the rebuilt links come back, and re-arms after a 30 s cooldown. |
| ✏️ nick | Change your nickname in-room (a small box under the header: Enter saves, Esc cancels). Everyone's tile label and the panel update at once, and the new name is remembered for next time. |
| 🔗 invite | Copy the room invite link. The button flashes ✓ for a moment; the hover hint keeps the verb the shorter label lost. |
| >_ cre8stream | The header title links back to the home page. In a live room it asks you to confirm before leaving. |
Recording (⏺): captures only your own camera/mic/screen to a file on your
device — no upload, no effect on what peers get, no added latency (CPU only while it runs). It's held in
memory until you stop or the source changes, so a tab crash loses the part in progress (the page warns before
an accidental close while recording). Each finished part is handed to your browser's downloads —
the page can't see whether the browser kept it, so the stop line names how many files to look for. Chrome may
ask once to allow multiple downloads: choose Allow; if it was blocked, later parts are dropped
silently, so re-allow automatic downloads for this site before a long recording. It records exactly what peers see (muted mic → silence,
camera off → black). Switching camera/mic, starting/stopping a screen share, adding a mic, toggling
mic clean-up (noise gate / leveler), or toggling a mic-processing checkbox on a browser that
can't apply it live starts a new -partN file — a browser can't record across a changing
source without freezing. (Exception: while mic clean-up is on, switching microphones does
not split the recording — peers and the recorder keep the same processed track.)
Active-speaker highlight: whoever is talking gets a green glow around their tile (your own tile too). It's driven purely by audio levels the browser already measures — nothing extra is sent and it adds no latency to the connection.
Hearing each other: browsers block autoplay-with-sound until you interact with the page, so a freshly-created room can look connected but silent. The first tap/click/keypress anywhere unlocks audio for every participant automatically — a muted peer tile shows 🔇, and clicking it (or anything) starts the sound. No browser "show controls" trick needed.
Phones / Android: if the mic was denied or held by another app at join, you'll come in video-only with a 🎤 enable mic button — grant the mic in the browser (and in the phone's app settings if needed), then tap it. If you switch away to another app the tab is suspended by the OS (a limit no web app can override); switching back re-plays video, re-gathers a dropped connection, and re-captures the camera automatically, so you shouldn't need to reload.
Per-peer controls (each remote tile, studio/director view)
These affect only what you see and hear — they send nothing to the other person
and never appear on a clean OBS view= page.
| Control | Action |
|---|---|
| 🔊 / 🔇 | Mute/unmute that peer for you. |
| Volume slider | Set that peer's playback volume, 0–200%. Above 100% boosts it via a local audio tap (with a limiter so a loud voice won't clip) — local playback only, nothing is sent to anyone. Double-click to reset to 100%. |
| ⧉ | Picture-in-picture that peer into a native, always-on-top floating window (where the browser supports it). |
| OBS | Copy that peer's chrome-free Browser Source link. |
Your own tile (framing aids)
Controls in the top-right of your own preview. The framing aids are display-only overlays — they are never encoded into your video, so they can't show up in OBS or on anyone else's screen.
| Control | Action |
|---|---|
| 🎙️ | Mute / unmute your mic (mirrors the header button and the M key). |
| ▦ | Toggle a rule-of-thirds grid over your preview to help you frame the shot. |
| ◧ | Toggle a false-color exposure check: clipped highlights turn pink, crushed shadows green, mid-tones grayscale — dial in exposure at a glance. |
The room panel (bottom bar)
Studio and director pages show a panel of copyable links plus per-participant tools. The panel prints no URL: each row is a label and one button that copies its link (if the browser refuses clipboard access, a small box under the header shows the link, selected, to copy by hand with Ctrl+C / ⌘+C; nothing pauses while it is open). From 900px wide (1300px with chat open) the buttons line up in one column of equal width; narrower, the rows wrap.
- invite_a_friend /random-sit --true — the room link (already carrying
&password=if the room has one). - director_view /watch_all --true — the invite plus
recv=1, for a producer/monitor seat. - personal_invite /reserve --permanent-slot — + new personal link mints a per-guest link with a fixed
&push=<id>(the guest's row, labelled with the name and--seat=<id>— copy, send it to the guest) and, on its own row just below, the matching └ obs_source link (copy obs — paste it into OBS), both valid before the guest joins. Don't send the obs link to the guest: it is the chrome-free OBS page, blank in a normal browser. In this panel, every button that copies an OBS page reads copy obs (on a tile it is the OBS button in the corner). Each tab also keeps a stable id, so a guest's refresh (F5) doesn't drop their seat and yourview=Browser Source keeps working. Ids aren't secrets — anyone with the link can take that seat (same trust model as the room link). - obs_browser_source /only-for-obs --true — one row per publisher, labelled by nickname
(two participants with the same nickname also show their
--seat=<id>— you included, if a guest shares yours), plus a whiteboard_obs_source row right below you for the shared 🎨 board. Directors and OBS views aren't listed (they have no feed to pull). Each row holds a copy obs button (plus, on a participant's row, the tools below). - ping (next to each participant) — one-shot round-trip time of your direct P2P link to them, read from WebRTC stats. No message is sent and the relay is not involved; green < 80 ms, yellow < 200 ms, red above.
- vid ▾ / aud ▾ on the You row — your own outbound
bitrate caps (video auto / 6.0 / 2.5 / 1.0 / 0.5 Mbps; audio auto / 512 / 256 / 192 / 128 /
96 / 64 / 32 kbps), in the same place, style, and descending order as the per-peer force
selects below — they rest on the same vid ▾ / aud ▾ label while no cap is set.
Seeded from
bitrate=/audiobitrate=(a non-preset value shows as its own entry) and updated live when a room member force-caps you. - vid ▾ / aud ▾ (next to each participant) — cap that participant's outbound video (auto / 6.0 / 2.5 / 1.0 / 0.5 Mbps) or audio (auto / 512 / 256 / 192 / 128 / 96 / 64 / 32 kbps — the same choices as your own aud ▾) bitrate. Use it when someone's weak uplink is degrading the room. The cap applies to everything they send, to every participant — one encoder feeds the whole mesh, so this isn't a "just for me" control. It's a cooperative request: their client applies the cap, mirrors it live on their own You row, and shows who set it — nothing is silent, and a modified client could decline. The request rides the normal signaling channel; the server is unchanged and never inspects it. A force is remembered in this tab, per room, and re-applied automatically when that participant reconnects — it survives a refresh on either side. Choose auto to lift the cap.
- 💬 (next to each participant) — opens the room chat panel with that person preselected as a private recipient (up to 500 characters a message; studio members only — a director reports the same role as an OBS page, which drops chat, so neither is listed; directors still get room-wide messages). Messages ride the signaling channel as opaque frames, never the media path. Messages typed while signaling reconnects wait in FIFO order; the finite outgoing backlog holds at most 100 messages / 32 KiB of text and visibly rejects the newest message when full.
Want to mute a guest for everyone? That needs a host-enforced control channel the dumb relay deliberately doesn't have — see the architecture doc. For now these are local-only, which is the honest, no-surprises behavior.
The BLAME button 🔥
Click 🔥 blame!!!11one to stress-test every connection at once and crown the participant whose uplink is most likely dragging the room down. It's fully passive — it only reads the quality counters (RTT, jitter, inbound loss) WebRTC already keeps, sends no probe traffic, and adds no latency.
- Only you see the chart. The person who clicked gets the results chart and the
loser gets a 10-second "LOOSER!!!" badge on their tile — on your screen only.
Everyone else just sees a one-line status, and the clean OBS
view=feed shows nothing. - Live monitoring (⟳ live). Toggle
⟳ liveon the card to re-measure every 8 seconds and watch the chart update in place — silent for everyone else (no badge, no status). - Cooperative & honest. It rides the same signaling payload as vid ▾ / aud ▾; the badge is cosmetic and self-applied. A party trick, not an audit.
- Browsers and encoders. Each row's badge tooltip names that member's browser
engine (
chromium 149,gecko,webkit— read from what the browser can do, never its user-agent string) and what its video encoder is doing:ok,idle(camera off),wait,n/a(not reported) ordead— a live camera sending no video, shown as no video with the fix spelled out. The per-link table marks a failed link (· failed) and a relay over TCP/TLS (relay/tcp).
The connection log 🧾
🧾 log saves what this tab's connections actually did — every drop, reconnect,
ICE failure, black or frozen tile, autoplay block and device change — as one .json file on
your device. Like ⏺ record, it saves a file and uploads nothing.
- It's already running. Recording starts when the page loads, so the log covers the problem you just had — there is no "start logging, now reproduce it" step. It only reads counters the browser already computes, so it costs nothing on the media path.
- Per tab, and it survives a refresh. A log saved after an F5 holds both page loads
(each load's clock starts at zero; the
segsblock gives each one's wall-clock start). Closing the tab discards it, and the server never stores it. - Bounded, and it says so. The newest ~2000 events are kept;
counts.evictedandcounts.priorDroppedsay how many were dropped. Nothing is silently truncated.
What the file holds — the redaction contract
This is what makes the file safe to attach to a public bug report:
- No network addresses. ICE candidates are reduced to their type and protocol
(
host/srflx/relayoverudp/tcp) before they leave the connection code — no IP, port, TURN URL or host name. In free text (an error message, a reason), anything that looks like a network address becomes<ip>and every link written with://becomes<url>. - No room secret and no password. The room id appears only as its first 8 characters — and not at all for a custom id shorter than 16 characters, or one whose start shares 4 characters in a row with the password. The room id and the password are removed in every spelling an invite link or the address bar gives them, percent-encoded copies included.
- No session descriptions. A failed negotiation contributes only an error name such as
InvalidStateError. - What it does contain: peer ids and scrubbed display names, each peer's role, connection
and ICE states, loss / round-trip / jitter / bitrate counters, the options in effect, your browser engine,
user agent and screen size, and your local network type (
wifi,cellular,ethernet,vpn— not an address, but it says something about you). If those are not acceptable to share, don't share the file: there is no half-redacted mode.
The stated limits. Matching is exact and case-sensitive. In free text, a secret shorter
than 4 characters is not searched for. An ICE server address quoted in an error keeps its host name
(turn:turn.example.com:3478 has no //, so the link rule does not see it; an IP in one is
still masked). An IPv6 address written in hex letters only and run straight into the next word
(cafe::beefy) can stay. A password that starts with a colon and is a piece of an address on the same
line can be put back into that address by whoever knows it.
Collecting everyone's log (🧾 log all)
When something went wrong between people, one log shows only one side. 🧾 log all asks every member of the room for their log and saves them as one bundle file, with an automatic first-pass analysis.
- Everyone is asked first. Each member sees a prompt naming the requester and their full id, and only Send my log sends anything. Decline, Esc or 30 seconds of silence say no; Decline — don't ask again lasts until the page is reloaded. A member is asked at most once every 50 seconds, and not again for five minutes after declining; someone with the HUD hidden (often a tab being captured into a stream) is never shown a prompt and answers with a plain decline.
- Who can ask. Any studio member, once a minute. A director (
recv=1) can answer but has no button; OBS pages answer unsupported; a member on an older version of the app shows as no answer. - What is sent. The same redacted log as 🧾 log, rebuilt field by field from a fixed list before it leaves the sender's tab, and without the user agent, language or screen size. It still names the other members that person is connected to, as their own log does — the prompt says so. The requester rebuilds every part again on arrival.
- What you get. The bundle downloads when the run finishes (a save again button stays). A card at the bottom-left shows each member's answer and the analysis — what the logs show first, any cause offered as a possibility. ▁ minimises it without cancelling; ✕ cancels while the run is live. A sender's status line says finished sending your connection log when the last part has left; nothing comes back to confirm it arrived.
OBS tips
- Use a separate Browser Source per guest (
…/?room=ROOM&view=PEERID). Each is independent and positionable; composite them with OBS scenes. - The view page prefers H.264 so CEF (the browser inside OBS) decodes it reliably — this matters on Linux where CEF may lack hardware VP9 decode.
- Guest audio: in the Browser Source properties, enable "Control audio via OBS" so the guest's audio becomes part of that source in your OBS mix (left off, it plays straight to your computer's speakers, outside the mixer).
- The cursor is hidden on the view page, so no stray pointer lands in your program.
- Every browser tab, director tab and OBS Browser Source occupies one
peer slot in the room (
MAX_PEERS_PER_ROOM, default 8). A 3-guest show with a source per guest plus a director already sits at 7–8 slots — if you hitroom-full, close a spare tab/source and use the ↻ retry button, or ask your operator to raise the cap. A refresh takes over its own seat (it never adds one), and an abruptly-closed context frees its seat within a few seconds (4 s after the drop is noticed; up to about 80 s if the socket just went silent). - Set the Browser Source resolution to match your scene (e.g. 1920×1080) and let
the guest's
quality/bitratecontrol the actual stream.