# 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`](https://docs.vdo.ninja/advanced-settings/setup-parameters/push)) and viewer ([`&view`](https://docs.vdo.ninja/advanced-settings/mixer-scene-parameters/view) or [`&scene`](https://docs.vdo.ninja/advanced-settings/mixer-scene-parameters/scene)) sides.

<table><thead><tr><th width="150">Parameter</th><th>Explanation</th></tr></thead><tbody><tr><td><a href="screen-share-parameters/and-screensharestereo"><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`](https://docs.vdo.ninja/advanced-settings/setup-parameters/push)) and viewer ([`&view`](https://docs.vdo.ninja/advanced-settings/mixer-scene-parameters/view) or [`&scene`](https://docs.vdo.ninja/advanced-settings/mixer-scene-parameters/scene)) sides.

<table><thead><tr><th width="150">Parameter</th><th>Explanation</th></tr></thead><tbody><tr><td><a href="setup-parameters/screenshare"><code>&#x26;screenshare</code></a></td><td>Disables camera-sharing as an option</td></tr><tr><td><a href="setup-parameters/and-screenshare2"><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="screen-share-parameters/and-screenshareaec"><code>&#x26;screenshareaec</code></a></td><td>Turns automatic echo-cancellation filter for screen-shares ON or OFF</td></tr><tr><td><a href="screen-share-parameters/and-screenshareautogain"><code>&#x26;screenshareautogain</code></a></td><td>Turns audio auto-normalization filter for screen-shares ON or OFF</td></tr><tr><td><a href="screen-share-parameters/cursor"><code>&#x26;screensharecursor</code></a></td><td>Attempts to show the mouse cursor on screen shares</td></tr><tr><td><a href="screen-share-parameters/and-screensharedenoise"><code>&#x26;screensharedenoise</code></a></td><td>Turns audio noise reduction filter for screen-shares ON or OFF</td></tr><tr><td><a href="screen-share-parameters/screensharefps"><code>&#x26;screensharefps</code></a></td><td>Set a target FPS for your screenshare (secondary stream)</td></tr><tr><td><a href="screen-share-parameters/and-screensharehide"><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="screen-share-parameters/screenshareid"><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="screen-share-parameters/and-screensharelabel"><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="screen-share-parameters/screensharequality"><code>&#x26;screensharequality</code></a></td><td>Set a custom screenshare quality</td></tr><tr><td><a href="screen-share-parameters/and-screensharecontenthint"><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="screen-share-parameters/and-screenshareaspectratio"><code>&#x26;screenshareaspectrati</code></a></td><td>Changes the screen-share aspect ratio on the publisher side</td></tr><tr><td><a href="screen-share-parameters/and-screensharestereo"><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="screen-share-parameters/and-screensharetype"><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="screen-share-parameters/and-smallshare"><code>&#x26;smallshare</code></a></td><td>Makes the screen share behave like a webcam share</td></tr><tr><td><a href="screen-share-parameters/and-screensharevideoonly"><code>&#x26;screensharevideoonly</code></a></td><td>Lets you disable the option to select audio when screen sharing</td></tr><tr><td><a href="buttons-and-control-bar-parameters/and-screensharebutton"><code>&#x26;screensharebutton</code></a></td><td>Forces the screen-share button to appear for guests</td></tr><tr><td><a href="screen-share-parameters/and-suppresslocalaudio"><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="screen-share-parameters/and-prefercurrenttab"><code>&#x26;prefercurrenttab</code></a></td><td>Will have the current tab as the default screen-share source</td></tr><tr><td><a href="screen-share-parameters/and-selfbrowsersurface"><code>&#x26;selfbrowsersurface</code></a></td><td>Excludes the current tab as a screen-share source option</td></tr><tr><td><a href="screen-share-parameters/and-systemaudio"><code>&#x26;systemaudio</code></a></td><td>Excludes the system-audio as an audio source when display sharing</td></tr><tr><td><a href="screen-share-parameters/and-displaysurface"><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`](https://docs.vdo.ninja/advanced-settings/mixer-scene-parameters/view) or [`&scene`](https://docs.vdo.ninja/advanced-settings/mixer-scene-parameters/scene)).

<table><thead><tr><th width="150">Parameter</th><th>Explanation</th></tr></thead><tbody><tr><td><a href="screen-share-parameters/and-screensharebitrate"><code>&#x26;screensharebitrate</code></a></td><td>Lets you manually set the video bitrate for screen-shares</td></tr><tr><td><a href="screen-share-parameters/and-sharperscreen"><code>&#x26;sharperscreen</code></a></td><td>Sets <a href="video-parameters/scale"><code>&#x26;scale=100</code></a>, but only for screen-shares</td></tr><tr><td><a href="screen-share-parameters/and-sspaused"><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="screen-share-parameters/and-screensharebitrate"><code>&#x26;screensharebitrate</code></a></td><td>Lets you manually set the video bitrate for screen-shares</td></tr><tr><td><a href="screen-share-parameters/and-sharperscreen"><code>&#x26;sharperscreen</code></a></td><td>Sets <a href="video-parameters/scale"><code>&#x26;scale=100</code></a>, but only for screen-shares</td></tr><tr><td><a href="screen-share-parameters/and-sspaused"><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>
