# Setup Parameters

They are separated in two groups: [general options](#general-options) (push and view) and [source side](#source-side-options) (push) options.

## General options

You can add them to both, source ([`&push`](/advanced-settings/setup-parameters/push.md)) and viewer ([`&view`](/advanced-settings/mixer-scene-parameters/view.md), [`&scene`](/advanced-settings/mixer-scene-parameters/scene.md) or [`&solo`](/advanced-settings/mixer-scene-parameters/and-solo.md)) sides.

<table><thead><tr><th width="234.57142857142856">Parameter</th><th>Explanation</th></tr></thead><tbody><tr><td><a href="/pages/-MZXP2U7678vEPo5Yxms"><code>&#x26;push</code></a></td><td>The stream ID that you are publishing with will be the defined value</td></tr><tr><td><a href="/pages/-MZX1ErXldKpl6308TzB"><code>&#x26;room</code></a></td><td>Sets a room ID for the session to join</td></tr><tr><td><a href="/pages/-MZWzGOLIUtPZii0Lxn1"><code>&#x26;password</code></a></td><td>Sets a password to view a stream or to join a room</td></tr><tr><td><a href="/pages/k6AsOaepG52xJtUNY59W"><code>&#x26;hash</code></a></td><td>Checks the password</td></tr><tr><td><a href="/pages/oD2fTliAMnICFeyGTb37"><code>&#x26;e2ee</code></a>*</td><td>Support for something called "end to end encryption" using "insertable streams"</td></tr><tr><td><a href="/pages/-MZNYhxR_5-Ep_h_N74w"><code>&#x26;label</code></a></td><td>Sets a display name label</td></tr><tr><td><a href="/pages/8c2pVSgEgoXiOb2xe8ox"><code>&#x26;labelsuggestion</code></a></td><td>The same as <a href="/pages/-MZNYhxR_5-Ep_h_N74w"><code>&#x26;label</code></a>, except it asks the user still for a user name</td></tr><tr><td><a href="/pages/nflQf8jCCEjl8n8TWEcm"><code>&#x26;permaid</code></a></td><td>Will save that stream ID to local storage and reuse it every time <code>&#x26;permaid</code> is used without a stream ID</td></tr><tr><td><a href="/pages/hnwXUVoyx9yg44EUT3LO"><code>&#x26;group</code></a></td><td>Puts guests into sub-groups, so they only see others in the same group</td></tr><tr><td><a href="/pages/Xqngwbf2TfmyyoOtACG3"><code>&#x26;groupaudio</code></a></td><td>Tells the system to not filter out audio streams when using <a href="/pages/hnwXUVoyx9yg44EUT3LO"><code>&#x26;group</code></a></td></tr><tr><td><a href="/pages/CIK9xx91mLs0kfYMcnXI"><code>&#x26;groupview</code></a></td><td>The same as <a href="/pages/hnwXUVoyx9yg44EUT3LO"><code>&#x26;group</code></a>, except it lets you see those groups without actually needing to join them with your mic/camera</td></tr><tr><td><a href="/pages/acjtjHvgaNcPh7fv5bye"><code>&#x26;datamode</code></a></td><td>Combines a bunch of flags together; no video, no audio, GUI, etc.</td></tr><tr><td><a href="/pages/-MZdvYpyDqaqSeEaku3T"><code>&#x26;audiooutput</code></a></td><td>Like <a href="/pages/-MZdvsGDAdvNIID-8cwb"><code>&#x26;sink</code></a>, but selects the audio output device</td></tr><tr><td><a href="/pages/-MZdvsGDAdvNIID-8cwb"><code>&#x26;sink</code></a></td><td>Outputs the audio to the specified audio output device, rather than the default</td></tr></tbody></table>

\*NEW IN [VERSION 24](/releases/v24.md)

## Source side options

You have to add them to the source side ([`&push`](/advanced-settings/setup-parameters/push.md)).

<table><thead><tr><th width="150">Parameter</th><th>Explanation</th></tr></thead><tbody><tr><td><a href="/pages/-MZXM_RawjQL1mNBXnhD"><code>&#x26;audiodevice</code></a></td><td>Pre-configures the selected audio device</td></tr><tr><td><a href="/pages/-MZXSgRkt23F9uqG-Wsf"><code>&#x26;videodevice</code></a></td><td>Pre-configures the selected video device</td></tr><tr><td><a href="/pages/1TvTglBeBlsjXnXWGuDr"><code>&#x26;vdo</code></a></td><td>Like <a href="/pages/-MZXSgRkt23F9uqG-Wsf"><code>&#x26;videodevice</code></a> for selecting a default video device, but you can still choose to change the camera</td></tr><tr><td><a href="/pages/-MZXTGEy5qWnR7QAjOl3"><code>&#x26;device</code></a></td><td>Same as <a href="/pages/-MZXM_RawjQL1mNBXnhD"><code>&#x26;audiodevice</code></a> or <a href="/pages/-MZXSgRkt23F9uqG-Wsf"><code>&#x26;videodevice</code></a>, but applies to both</td></tr><tr><td><a href="/pages/-Mj8OvJjkCAAcIuEKZln"><code>&#x26;miconly</code></a></td><td>Share audio-only; no video publishing allowed</td></tr><tr><td><a href="/pages/axAuhrDyyMGpoHebr6dW"><code>&#x26;miconlyoption</code></a></td><td>A mic only button shows if a guest joining a room</td></tr><tr><td><a href="/pages/aOoM1xKXC9kktjTTNPpi"><code>&#x26;safemode</code></a></td><td>Tries to load the camera/audio with as little possible complexity as possible</td></tr><tr><td><a href="/pages/-MZXNQGhMPvyI3Tm5jq0"><code>&#x26;autostart</code></a></td><td>Skips the camera/audio device or screenshare selection</td></tr><tr><td><a href="/pages/-Mj8Ppo_daVVkBVNiDnq"><code>&#x26;easyexit</code></a></td><td>Won't ask the user to confirm that they wish to exit or leave the page</td></tr><tr><td><a href="/pages/-MZOLOZq04PnT1tVxWyo"><code>&#x26;webcam</code></a></td><td>Disables screen-sharing as an option</td></tr><tr><td><a href="/pages/XueNVvQLR9l3bCQjn5bh"><code>&#x26;webcam2</code></a></td><td>Will show the "Share your Camera" button before asking the user to select camera options</td></tr><tr><td><a href="/pages/-M_oRQSkAJFpidl8B7xd"><code>&#x26;screenshare</code></a></td><td>Disables camera-sharing as an option</td></tr><tr><td><a href="/pages/XpXJXr1fVUai9CCQvidv"><code>&#x26;screenshare2</code></a></td><td>Will show the "Share your Screen" button before asking the user to select screenshare options</td></tr><tr><td><a href="/pages/-MZXgGBiKGpyTf36XDV8"><code>&#x26;website</code></a></td><td>Only shares a website with viewers</td></tr><tr><td><a href="/pages/-MZXd6QJpdum7zQhBaVK"><code>&#x26;fileshare</code></a></td><td>Allows the user to select a video or audio file as a source for streaming</td></tr><tr><td><a href="/pages/-Mj8IMwKqGYNb7u8Bbae"><code>&#x26;intro</code></a></td><td>When combined with the either <a href="/pages/-MZOLOZq04PnT1tVxWyo"><code>&#x26;webcam</code></a> or <a href="/pages/-M_oRQSkAJFpidl8B7xd"><code>&#x26;screenshare</code></a>, this option won't auto-load the camera/mic selection page</td></tr><tr><td><a href="/pages/8cAG36TzDKvdGMXtEECh"><code>&#x26;host</code></a></td><td>Shows a pop up to invite more guests to the room</td></tr><tr><td><a href="/pages/-Mb8_bEheqJDsaVUIGgX"><code>&#x26;tips</code></a></td><td>Shows a help-screen on the guest joining</td></tr><tr><td><a href="/pages/wvUrNwsy7K1dQAoulug1"><code>&#x26;welcome</code></a></td><td>Adds a message the guest will see when joining the room</td></tr><tr><td><a href="/pages/Do4DlNatmfIle3aD7I5c"><code>&#x26;welcomeb64</code></a>*</td><td>The same as <a href="/pages/wvUrNwsy7K1dQAoulug1"><code>&#x26;welcome</code></a>, except this takes an input as a base64 encoded string</td></tr><tr><td><a href="/pages/Cwy2zLa706rYTOG9K3Ke"><code>&#x26;welcomeimage</code></a></td><td>Lets you specify an image that appears for a few seconds once a guest joins</td></tr><tr><td><a href="/pages/CbKoEWEFlHpHuHJyKpQy"><code>&#x26;hangupmessage</code></a>*</td><td>Option for a custom hang-up message</td></tr><tr><td><a href="/pages/bjsdltP1Q6kZTqWWX5Cu"><code>&#x26;humb64</code></a>*</td><td>The same as <a href="/pages/CbKoEWEFlHpHuHJyKpQy"><code>&#x26;hangupmessage</code></a>, except this takes an input as a base64 encoded string</td></tr><tr><td><a href="/pages/2iac4NY4V7Y8NiGh2Ocn"><code>&#x26;groupmode</code></a></td><td>Added to the URL, when not assigned to a group, you don't hear or see anything</td></tr></tbody></table>

\*NEW IN VERSION 24


---

# 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.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.
