# Screen-share Parameters

Screen-share Parameters are separated in [general options](#general-options), [source side](#source-side-options) (push) options and [viewer side](#viewer-side-options) (view) 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) or [`&scene`](/advanced-settings/mixer-scene-parameters/scene.md)) sides.

<table><thead><tr><th width="150">Parameter</th><th>Explanation</th></tr></thead><tbody><tr><td><a href="/pages/0bOnZGndLnY4vmmL2QZI"><code>&#x26;screensharestereo</code></a></td><td>Sets the audio mode for screen-shares to stereo and changes default audio settings to improve audio quality</td></tr></tbody></table>

## Source side 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) or [`&scene`](/advanced-settings/mixer-scene-parameters/scene.md)) sides.

<table><thead><tr><th width="150">Parameter</th><th>Explanation</th></tr></thead><tbody><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/8c31Okh6sYPWaoHhjhpr"><code>&#x26;screenshareaec</code></a></td><td>Turns automatic echo-cancellation filter for screen-shares ON or OFF</td></tr><tr><td><a href="/pages/25A6gjUvf2R7YONkTLO0"><code>&#x26;screenshareautogain</code></a></td><td>Turns audio auto-normalization filter for screen-shares ON or OFF</td></tr><tr><td><a href="/pages/-Mf5stcsPf7utMBccxHC"><code>&#x26;screensharecursor</code></a></td><td>Attempts to show the mouse cursor on screen shares</td></tr><tr><td><a href="/pages/6o1tUNs7KaIml30krNbz"><code>&#x26;screensharedenoise</code></a></td><td>Turns audio noise reduction filter for screen-shares ON or OFF</td></tr><tr><td><a href="/pages/-Mbr56fel2ZCyWjWNfuq"><code>&#x26;screensharefps</code></a></td><td>Set a target FPS for your screenshare (secondary stream)</td></tr><tr><td><a href="/pages/vMtdopywMm1mYb9GEm85"><code>&#x26;screensharehide</code></a></td><td>Hides the local screen-share sub-window that appears when screen sharing in a room</td></tr><tr><td><a href="/pages/-MZXcdoEcsFtTudaolWn"><code>&#x26;screenshareid</code></a></td><td>Pre-sets the screenshare stream id for a screen share if its a secondary stream</td></tr><tr><td><a href="/pages/j6bf8UYNd5T0JtBA7AVR"><code>&#x26;screensharelabel</code></a></td><td>The screen-share of the guest will have the same label as the guest</td></tr><tr><td><a href="/pages/-MbrBM0_6rweLjhZuPpP"><code>&#x26;screensharequality</code></a></td><td>Set a custom screenshare quality</td></tr><tr><td><a href="/pages/LrQ5O5HCU7DjLUVj4JIB"><code>&#x26;screensharecontenthint</code></a></td><td><code>=motion</code> prioritizes screen-share frame rate; <code>=detail</code> prioritizes screen-share resolution</td></tr><tr><td><a href="/pages/tCBgdFWQwSR8m0QTZNjd"><code>&#x26;screenshareaspectrati</code></a></td><td>Changes the screen-share aspect ratio on the publisher side</td></tr><tr><td><a href="/pages/0bOnZGndLnY4vmmL2QZI"><code>&#x26;screensharestereo</code></a></td><td>Sets the audio mode for screen-shares to stereo and changes default audio settings to improve audio quality</td></tr><tr><td><a href="/pages/CGcri2JHEp7BuaSi6gXN"><code>&#x26;screensharetype</code></a></td><td>Defines how webcam and screenshare of a guest in a room interacts which each other</td></tr><tr><td><a href="/pages/I2GSm6Xh0GJki6ZRttd0"><code>&#x26;smallshare</code></a></td><td>Makes the screen share behave like a webcam share</td></tr><tr><td><a href="/pages/Wvoh9KXT0Wi03gqulB8N"><code>&#x26;screensharevideoonly</code></a></td><td>Lets you disable the option to select audio when screen sharing</td></tr><tr><td><a href="/pages/-MZXVbt2YZUq6TaXHWPp"><code>&#x26;screensharebutton</code></a></td><td>Forces the screen-share button to appear for guests</td></tr><tr><td><a href="/pages/hqr4nT0W6Y89xOjhCN80"><code>&#x26;suppresslocalaudio</code></a></td><td>Will disable local audio playback of a Chrome tab while screen-sharing it</td></tr><tr><td><a href="/pages/j9WWZr0a4fS6ItNqEVSG"><code>&#x26;prefercurrenttab</code></a></td><td>Will have the current tab as the default screen-share source</td></tr><tr><td><a href="/pages/GTscofsnSiq4Go8U8zEp"><code>&#x26;selfbrowsersurface</code></a></td><td>Excludes the current tab as a screen-share source option</td></tr><tr><td><a href="/pages/idGNDKViC1KLYX2NQX8u"><code>&#x26;systemaudio</code></a></td><td>Excludes the system-audio as an audio source when display sharing</td></tr><tr><td><a href="/pages/1pUiWqp0q2rTNi0GmFK2"><code>&#x26;displaysurface</code></a></td><td>Will pre-select display-share, rather than tab-share, when screen-sharing</td></tr><tr><td><a href="https://github.com/steveseguin/vdo.ninja/blob/gitbook/advanced-settings/screen-share-parameters/and-screenwhep.md"><code>&#x26;screenwhep</code></a></td><td>Choose whether screen-shares prefer WHEP relays or stay P2P</td></tr><tr><td><a href="https://github.com/steveseguin/vdo.ninja/blob/gitbook/advanced-settings/screen-share-parameters/and-screensharestyle.md"><code>&#x26;screensharestyle</code></a></td><td>Select a screen-share layout style preset (numeric; 1 is default)</td></tr></tbody></table>

## **Viewer side options**

You have to add them to the viewer side ([`&view`](/advanced-settings/mixer-scene-parameters/view.md) or [`&scene`](/advanced-settings/mixer-scene-parameters/scene.md)).

<table><thead><tr><th width="150">Parameter</th><th>Explanation</th></tr></thead><tbody><tr><td><a href="/pages/ryAJzNkbwYkuLGIWH2jK"><code>&#x26;screensharebitrate</code></a></td><td>Lets you manually set the video bitrate for screen-shares</td></tr><tr><td><a href="/pages/rsXRpk3mFF0tZQS4Dahr"><code>&#x26;sharperscreen</code></a></td><td>Sets <a href="/pages/-MZdvi1ReqWtZ6G80iMX"><code>&#x26;scale=100</code></a>, but only for screen-shares</td></tr><tr><td><a href="/pages/06h6BXmuZkJ2heW9yMNG"><code>&#x26;sspaused</code></a></td><td>Starts any screen-share paused</td></tr></tbody></table>

<table><thead><tr><th width="150">Parameter</th><th>Explanation</th></tr></thead><tbody><tr><td><a href="/pages/ryAJzNkbwYkuLGIWH2jK"><code>&#x26;screensharebitrate</code></a></td><td>Lets you manually set the video bitrate for screen-shares</td></tr><tr><td><a href="/pages/rsXRpk3mFF0tZQS4Dahr"><code>&#x26;sharperscreen</code></a></td><td>Sets <a href="/pages/-MZdvi1ReqWtZ6G80iMX"><code>&#x26;scale=100</code></a>, but only for screen-shares</td></tr><tr><td><a href="/pages/06h6BXmuZkJ2heW9yMNG"><code>&#x26;sspaused</code></a></td><td>Starts any screen-share paused</td></tr><tr><td><a href="https://github.com/steveseguin/vdo.ninja/blob/gitbook/advanced-settings/screen-share-parameters/and-allowscreenmedia.md"><code>&#x26;allowscreenvideo</code></a><br><a href="https://github.com/steveseguin/vdo.ninja/blob/gitbook/advanced-settings/screen-share-parameters/and-allowscreenmedia.md"><code>&#x26;allowscreenaudio</code></a></td><td>Force-enable or block screen-share video/audio tracks on a viewer link</td></tr></tbody></table>


---

# 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/screen-share-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.