# \&videodevice

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

## Aliases

* `&vdevice`
* `&vd`

## Options

Example: `&videodevice=BRIO_4K`

<table><thead><tr><th width="150">Value</th><th>Description</th></tr></thead><tbody><tr><td><code>0</code></td><td>disable the video camera automatically. No option to change it during setup is provided.</td></tr><tr><td><code>1</code> | (no value given)</td><td>auto-select the default video camera. No option to change it will be allowed.</td></tr><tr><td>(string value)</td><td>auto-select a video device that has a label containing that same string specified. Whitespaces in names can be replaced with underscores.<br><br>Device IDs can also be used; exact match only in that case.</td></tr></tbody></table>

## Details

It can be changed after the connection has been established.\
![](/files/sW2RlxbDKLXM4wJIIPTA)

Useful for helping a remote guest skip-past the complex setup of their camera/audio.

You can use this option to also disable a guest's camera, potentially allowing for guest connections that have no video or audio. This is a great option if you want to use midi-only transport, add some hidden IFRAME control, or just wanted to text chat.

For a device like an iPhone, you can pass a string value such as `&videodevice=back` to specify the back camera by default. For Android, you might try `rear` instead of `back`, but it will depend on the name the manufacture gave the camera.

When combined with [`&webcam`](/advanced-settings/setup-parameters/and-webcam.md) and [`&autostart`](/advanced-settings/setup-parameters/and-autostart.md), you can have the camera start publishing instantly, often without any user interaction at all. Keep in mind that some browsers will still need to ask for permissions or require a user-gesture for things to function correctly though.

{% hint style="info" %}
See [vdo.ninja/devices](https://vdo.ninja/devices) to see the device IDs and device names. DeviceIDs are specific to VDO.Ninja's domain, while device names are not. The page will also auto-create links for you, just by clicking on the respective device.
{% endhint %}

When using `&videodevice=videoDevice`, the name matching order sorts based on "NameStartsWith", then "ExactDeviceID", and then finally "NameIncludes". This should avoid the Streamlabs OBS Virtual Cam being selected when you actually want the OBS Virtual Camera being selected, as the two devices both contain `obs virtual camera` in their name.

#### Director's room toggles

Auto-selects the default camera of a guest by adding `&vd` to the guest's invite link.\
![](/files/qgN2ecpnPlarJu8uhFX3)

Disables the guest's camera by adding `&vd=0` to the guest's invite link.\
![](/files/kHvB9Iut5KyVUoUILh1f)

## Related

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

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

{% content-ref url="/pages/-MZXVHmvcjUdEV5-Ww3G" %}
[\&nosettings](/advanced-settings/buttons-and-control-bar-parameters/and-nosettings.md)
{% endcontent-ref %}

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

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

{% content-ref url="/pages/-MZXTGEy5qWnR7QAjOl3" %}
[\&device](/advanced-settings/setup-parameters/and-device.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/setup-parameters/videodevice.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.
