# \&effects Sender-Side Option! ([`&push`](https://docs.vdo.ninja/advanced-settings/setup-parameters/push)) ## Aliases * `&effect` ## URL Shortcut Aliases Each effect also has a dedicated URL parameter alias that can be used instead of `&effects=N`: | Alias | Effect | Equivalent | | ------------------------------------------------------------------------------------------------------------------------ | ------------------------- | ------------------ | | [`&backgroundblur`](https://docs.vdo.ninja/advanced-settings/video-parameters/effects/and-backgroundblur) / `&bgblur` | Background blur | `&effects=3` | | [`&greenscreen`](https://docs.vdo.ninja/advanced-settings/video-parameters/effects/and-greenscreen) | Digital greenscreen | `&effects=4` | | [`&virtualbackground`](https://docs.vdo.ninja/advanced-settings/video-parameters/effects/and-virtualbackground) / `&vbg` | Virtual background | `&effects=5` | | [`&transparentbg`](https://docs.vdo.ninja/advanced-settings/video-parameters/effects/and-transparentbg) | Transparent background | `&effects=16` | | [`&facemesh`](https://docs.vdo.ninja/advanced-settings/video-parameters/effects/and-facemesh) | Face mesh | `&effects=6` | | `&digitalzoom` | Digital zoom | `&effects=7` | | [`&chromakey`](https://docs.vdo.ninja/advanced-settings/video-parameters/effects/and-chromakey) | Chroma key (remove green) | `&effects=14` | | [`&chromakeybg`](https://docs.vdo.ninja/advanced-settings/video-parameters/effects/and-chromakeybg) | Chroma key + background | `&effects=15` | | [`&facetracker`](https://docs.vdo.ninja/advanced-settings/video-parameters/effects/and-facetracker) / `&facetracking` | Face tracker | `&effects=1` | | [`&overlayfx`](https://docs.vdo.ninja/advanced-settings/video-parameters/effects/and-overlayfx) | Overlay image | `&effects=overlay` | | [`&anonymousmask`](https://docs.vdo.ninja/advanced-settings/video-parameters/effects/and-anonymousmask) / `&anonmask` | Anonymous mask | `&effects=anon` | | [`&dogface`](https://docs.vdo.ninja/advanced-settings/video-parameters/effects/and-dogface) / `&dogears` | Dog ears and nose | `&effects=dog` | Aliases that accept a value (e.g. `&backgroundblur=5`, `&chromakey=30`, `&digitalzoom=2.5`) will set the effect value directly without needing a separate [`&effectvalue`](https://docs.vdo.ninja/advanced-settings/video-parameters/and-effectvalue) parameter. ## Options Example: `&effects=7` or `&effects=zoom`
ValueDescription
(no value given)Shows a "Digital Video Effects" panel when setting up devices
0 | false | offDisables effects
1 | facetrackingFace tracker
-1Flip image
2Mirror image
-2Flip + mirror image
3Background blur
4Virtual Greenscreen
5Background replacement
6Face mesh
7 | digitalzoomZoom (software-based zoom)
8#and-effects-8
9Face tracking
10Face tracking
11 | anonAnonymous face mask
13New experimental background blur effect; it's not supported by most browsers/systems and its in origin trial
14Chroma key (remove green)
15Chroma key with background image
16Background transparent
overlayOverlay image
dogDog ears and nose
## Details Adding `&effects` to a guest link enables the drop-down menu for Digital Video Effects. The guest can then choose the digital video effect via the drop-down menu.\ ![](https://2943598173-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MZHXv1G8N0MDxwotaT9%2Fuploads%2FVXHwfMVuvebWn3tjCyOg%2Fimage.png?alt=media\&token=ae345698-f90c-4b37-8df1-0fb48246e42f) This is on by default when using a basic push link outside of a room. You can pre-select the digital video effect by adding `&effects=X` (see [Options](#options) above) to a guest/push link. The guest can change the digital video effect dynamically via the video settings panel if you have added `&effects` to the guest's URL. You can also pre-select the effect value by adding [`&effectvalue`](https://docs.vdo.ninja/advanced-settings/video-parameters/and-effectvalue) to the URL. ie: the amount of blur. ### Effect value memory When a user manually adjusts an effect's value via the slider (blur amount, zoom level, chroma threshold, etc.), that value is automatically saved to localStorage and tied to the current room and streamID. The password is hashed before being used as part of the storage key, so it is never stored in plaintext. On the next visit to the same room or stream, the saved value is restored automatically. This means different rooms can have different preferred effect settings. Explicitly setting [`&effectvalue`](https://docs.vdo.ninja/advanced-settings/video-parameters/and-effectvalue) in the URL will override any saved value. ### Greenscreen performance `&effects=4` enables a virtual Greenscreen on the publisher side. Green screen doesn't require SIMD support to work, although it won't work as well without it on. There's a little warning info icon (!) if SIMD is not enabled. Please do enable Webassembly-SIMD support under `chrome://flags/` if you'd like to see a large reduction in CPU load when using this feature. ### Important Note for `&effects=1` {% hint style="warning" %} `&effects=1` requires the use of the Chromium experimental face detection API, as I'm using the built-in browser face-tracking model for this. You can enable the API flag here: `chrome://flags/#enable-experimental-web-platform-features`\ My hope is that this feature will eventually be enabled by default within Chromium, as loading a large ML model to do face detection otherwise is a bit heavy; you may need to enable this within the OBS CLI if wishing to use it there? {% endhint %} ### `&effects=8` Added `&effects=8`, which might be useful if using a Camlink or simple HDMI capture device and [`&record`](https://docs.vdo.ninja/advanced-settings/recording-parameters/and-record) mode. The current `&record` mode doesn't seem to always scale down the video before recording (browser issue it seems), so local file recordings might be 4K in size, despite the target resolution being set much lower. `&effects=8` will use a canvas to first resize the video though, and then recordings will be based on that, making smaller recording sizes possible. (You could also use `&effects=7`, which then provides digital zooming controls and is otherwise the same thing). This `&effects=8` mode might also be helpful in solving issues with cameras disconnecting or having their frame rate change while recording, causing issues with the recording. The canvas acts as a reliable middle man between the camera and output video stream, so if the camera's input stream fails, the recording stream will not be impacted, other than perhaps skipping some frames. The canvas is sensitive to CPU load or browser throttling though, so frame rates may fluctuate more often when using it, so I can't suggest using it unless the guest/user is known to have a problematic camera. ### `&effects=7` (Zoom) [`&effectvalue=1.2`](https://docs.vdo.ninja/advanced-settings/video-parameters/and-effectvalue) will now work with `&digitalzoom` (`&effects=7`), so you can trigger the camera to digitally zoom in on load. This works regardless of whether the camera supports zooming or not, as it is software based. Software zoom offers lower quality than hardware-based or driver-based zoom, but the zoom effect itself is often quite smooth in comparison to hardware based zoom. ## Related {% content-ref url="and-effectvalue" %} [and-effectvalue](https://docs.vdo.ninja/advanced-settings/video-parameters/and-effectvalue) {% endcontent-ref %} {% content-ref url="effects/and-backgroundblur" %} [and-backgroundblur](https://docs.vdo.ninja/advanced-settings/video-parameters/effects/and-backgroundblur) {% endcontent-ref %} {% content-ref url="effects/and-greenscreen" %} [and-greenscreen](https://docs.vdo.ninja/advanced-settings/video-parameters/effects/and-greenscreen) {% endcontent-ref %} {% content-ref url="effects/and-virtualbackground" %} [and-virtualbackground](https://docs.vdo.ninja/advanced-settings/video-parameters/effects/and-virtualbackground) {% endcontent-ref %} {% content-ref url="effects/and-transparentbg" %} [and-transparentbg](https://docs.vdo.ninja/advanced-settings/video-parameters/effects/and-transparentbg) {% endcontent-ref %} {% content-ref url="effects/and-chromakey" %} [and-chromakey](https://docs.vdo.ninja/advanced-settings/video-parameters/effects/and-chromakey) {% endcontent-ref %} {% content-ref url="effects/and-chromakeybg" %} [and-chromakeybg](https://docs.vdo.ninja/advanced-settings/video-parameters/effects/and-chromakeybg) {% endcontent-ref %} {% content-ref url="effects/and-facemesh" %} [and-facemesh](https://docs.vdo.ninja/advanced-settings/video-parameters/effects/and-facemesh) {% endcontent-ref %} {% content-ref url="effects/and-facetracker" %} [and-facetracker](https://docs.vdo.ninja/advanced-settings/video-parameters/effects/and-facetracker) {% endcontent-ref %} {% content-ref url="effects/and-overlayfx" %} [and-overlayfx](https://docs.vdo.ninja/advanced-settings/video-parameters/effects/and-overlayfx) {% endcontent-ref %} {% content-ref url="effects/and-anonymousmask" %} [and-anonymousmask](https://docs.vdo.ninja/advanced-settings/video-parameters/effects/and-anonymousmask) {% endcontent-ref %} {% content-ref url="effects/and-dogface" %} [and-dogface](https://docs.vdo.ninja/advanced-settings/video-parameters/effects/and-dogface) {% endcontent-ref %} {% content-ref url="../settings-parameters/and-chunked" %} [and-chunked](https://docs.vdo.ninja/advanced-settings/settings-parameters/and-chunked) {% endcontent-ref %}