# \&cutscene

Viewer-Side Option! ([`&view`](https://docs.vdo.ninja/advanced-settings/mixer-scene-parameters/view), [`&scene`](https://docs.vdo.ninja/advanced-settings/mixer-scene-parameters/scene), [`&room`](https://docs.vdo.ninja/advanced-settings/setup-parameters/room))

## Aliases

* `&lowbitratescene`

## Options

Example: `&cutscene=ObsSceneName`

| Value            | Description               |
| ---------------- | ------------------------- |
| (OBS scene name) | The name of the OBS scene |

## Details

You can use the IRL-related command called `&cutscene` to specify an OBS cut scene to switch to when the bitrate drops below a threshold and return to the original scene when the bitrate recovers. (assuming the cut scene is active; it won't switch back from a scene that isn't the cut away scene)

The default bitrate threshold is 300-kbps, but you can use the existing [`&bitratecutoff=N`](https://docs.vdo.ninja/advanced-settings/settings-parameters/and-bitratecutoff) option to specify a custom one. Using `&cutscene` with [`&bitratecutoff`](https://docs.vdo.ninja/advanced-settings/settings-parameters/and-bitratecutoff) will override the behaviour of [`&bitratecutoff`](https://docs.vdo.ninja/advanced-settings/settings-parameters/and-bitratecutoff)'s other features. It won't start triggering until the bitrate has hit at least the threshold once. to use:

```
https://vdo.ninja/?push=XXX
https://vdo.ninja/?view=XXX&controlobs&bitratecutoff=300&cutscene=FML&remote
```

You can of course use this with [`&controlobs`](https://docs.vdo.ninja/advanced-settings/settings-parameters/and-controlobs)[`&remote`](https://docs.vdo.ninja/advanced-settings/settings-parameters/remote), to have the publisher change the scenes dynamically, and see what the current OBS scene is (if still connected).

{% hint style="warning" %}
Note that the OBS browser source needs the permissions to be set to high, to give VDO.Ninja permissions to change scenes.
{% endhint %}

{% hint style="warning" %}
Do not set the OBS browser source to "Shutdown" when not visible, as this will prevent things from being able to switch back.
{% endhint %}

When using `&cutscene` on a room scene, it won't trigger due to a director being in the room with no video, unless they are using [`&showdirector`](https://docs.vdo.ninja/advanced-settings/director-parameters/and-showdirector). `&cutscene` wasn't intended really for a group scene; just a solo link or view link, but this fix makes it at more usable with a group scene.

## Related

{% content-ref url="and-bitratecutoff" %}
[and-bitratecutoff](https://docs.vdo.ninja/advanced-settings/settings-parameters/and-bitratecutoff)
{% endcontent-ref %}

{% content-ref url="and-controlobs" %}
[and-controlobs](https://docs.vdo.ninja/advanced-settings/settings-parameters/and-controlobs)
{% endcontent-ref %}

{% content-ref url="remote" %}
[remote](https://docs.vdo.ninja/advanced-settings/settings-parameters/remote)
{% endcontent-ref %}
