&room

Sets a room ID for the session to join

General Option! (&push, &scene, &solo)

Aliases

  • &roomid

  • &r

Options

Example: &room=RoomID

Value
Description

(string)

1 to 49-characters long: aLphaNumEric-characters; case sensitive.

Details

Rooms broadcast to all participants who have joined.

Rooms are complemented by the &director=roomname function. Directors can have oversight of a room.

Rooms limit the viewing bitrate that guests of a room can request. OBS does not have these viewing limits though.

On the official hosted service, claimed rooms support admission controls:

  • default claim-time room cap is 80 guests

  • use &roomcap to set a cap (hard max 80)

  • use &requireapproval for manual director approval

Practically, CPU/network limits usually become the bottleneck before hard server limits.

Adding &showonly=xxx and &roombitrate=0 to the guest's URL can be used to help increase the capacity of rooms to 30 or more.

An alternative to a &room is a faux-room, which can be done with: https://vdo.ninja/?push=aaa&view=bbb,ccc,ddd

Additional info

There's a documentation page dedicated to rooms here.

There's also a video below looking at what sort of performance and system load there is when using an unoptimized group room.

You can reduce CPU load using the &broadcast flag, if hosting a larger room.

You can also transfer guests between group rooms, using the transfer function that the director has.

Roomschevron-rightHow to transfer guests to other roomschevron-right&directorchevron-right

Last updated

Was this helpful?