# \&scene

Viewer-Side Option! ([`&room`](/advanced-settings/setup-parameters/room.md))

## Aliases

* `&scn`

## Options

Example: `&scene=2` or `&scene=choosethename`

| Value                   | Description                                             |
| ----------------------- | ------------------------------------------------------- |
| `0` \| (no value given) | auto-add all videos to the scene; they can't be removed |
| `1`                     | empty by default; manually add videos in                |
| (string)                | like `&scene=1`, but videos are not preloaded           |

## Details

{% hint style="info" %}
Must be used in conjunction with the [`&room`](/advanced-settings/setup-parameters/room.md) parameter.
{% endhint %}

By adding `&scene` to a room URL, it tells VDO.Ninja that this is no [`&push`](/advanced-settings/setup-parameters/push.md) connection.

`&scene=0` by default has all videos in the room automatically added to the scene. They cannot be removed.

* `&scene=1` by default has no videos added to the scene. Videos need to be added manually by the director. Videos not yet added to the scene are connected, and streaming at around 400-kbps, so when they become active they appear immediately. Bitrate will ramp up after a second to the target bitrate of, normally, 2500-kbps or whatever is set via the URL.\
  ![](/files/1F6MjB5DG3XhhvHaG3RS)
* `&scene=2` is like `&scene=1`, except the video streams that are not yet added to the scene are disabled with 0-bitrate used. They are connected, but not actively streaming any video data, so it takes a moment longer for videos to appear once added.
* `&scene=N`, where `N` is a string or integer - it's just like `&scene=2`. There are buttons marked S3, S4, .. S8 in the director's room to control these scene types. If they are not already there, new buttons for them will be created automatically when used. See the video below.\\

  <img src="/files/pxgfRmnWV8zNFfq0KGnL" alt="" data-size="original">
* When using a scene, if you manually specify a video via the [`&view`](/advanced-settings/mixer-scene-parameters/view.md) parameter, it automatically is added to the scene.
* Audio of videos in scenes can be controlled by the director: volume and mute are options.
* In [v17.2](https://github.com/steveseguin/vdo.ninja/blob/gitbook/advanced-settings/view-parameters/broken-reference/README.md) of VDO.Ninja, if using [`&view`](/advanced-settings/mixer-scene-parameters/view.md) in a scene link, the director won't be able to remotely control the scene. This applies to solo links.
* In [v18](/releases/v18.md), you can create custom scenes, as per the video below.

### Let guests auto-join scenes

* `&joinscene=` / `&joinscenes=` (guest link) lets a guest request one or more scene IDs to join automatically (comma separated). Scene names are sanitized before use.
* The director side must allow this with `&openscene` on the scene link; otherwise the request is ignored.

{% embed url="<https://www.youtube.com/embed/axgIqPcHExQ>" %}

### Optimize scene performance using \&optimize=0

If using a normal manual scene, such as \&scene=3, you can add [\&optimize=0](#alternative-using-and-optimize-0) to the scene URL to enable a mode that is similar to \&solo. It's one of a few different ways to have permanent generic scene links that you can place specific guests into with varying stream IDs. There's also slots, however \&optimize=0 is tweaked for low CPU and network usage, at the cost of a slight added delay in adding a guest to the scene

## Related

{% content-ref url="/pages/-MZX1ErXldKpl6308TzB" %}
[\&room](/advanced-settings/setup-parameters/room.md)
{% endcontent-ref %}

{% content-ref url="/pages/0B2hIACeLpYnQexPND6Z" %}
[\&solo](/advanced-settings/mixer-scene-parameters/and-solo.md)
{% endcontent-ref %}

{% content-ref url="/pages/-MZdvM97l9MTgi44JRKW" %}
[\&optimize](/advanced-settings/video-bitrate-parameters/optimize.md)
{% endcontent-ref %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.vdo.ninja/advanced-settings/mixer-scene-parameters/scene.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.