> For the complete documentation index, see [llms.txt](https://docs.vdo.ninja/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.vdo.ninja/guides/how-to-stream-transparent-video.md).

# How to stream transparent video

Send transparent avatars and graphics through Game Capture to a browser or OBS, or use WebP and chroma key for other sources.

For a transparent avatar or graphics feed on Windows, send the source app's Spout2 output through **Game Capture**. You can receive transparency in **Chrome**, an **OBS Browser Source**, or the **Ninja OBS Plugin**.

The source app must supply an alpha channel. Turning on alpha in Game Capture cannot restore transparency that was lost in a window capture or virtual camera.

## Spout2 through Game Capture (Windows)

Use [Game Capture 0.2.68 or later](https://github.com/steveseguin/game-capture/releases/latest). Enable Spout2 output with transparency in your avatar or graphics app, then select that sender in Game Capture.

![Choose Browser playback for a browser or OBS Browser Source, or OBS native receiver for the Ninja OBS Plugin.](https://2943598173-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MZHXv1G8N0MDxwotaT9%2Fuploads%2Fgit-blob-2601dcdec36bb08fec369cd018cfd5270dc0cabd%2Fgame-capture-alpha-paths.svg?alt=media)

### Browser or OBS Browser Source

1. Select **H.264 (Compatibility)**.
2. Set **Alpha Playback** to **Browser / OBS Browser Source (H.264)** and turn on **Enable browser alpha (H.264)**.
3. Go live and copy the generated viewer link.
4. Change its base to `https://vdo.ninja/alpha/`, preserving the full query after `?`, and add `&transparent`.
5. Open that link in Chrome or add it as an OBS **Browser Source**. In OBS, place another source below it to see through the transparent areas.

For example:

`https://vdo.ninja/alpha/?view=YOUR_STREAM_ID&transparent`

Keep the password and any other parameters from your generated link. Start at **720p30**; browser alpha supports even output dimensions up to **1920x1080 at 60 fps**. Clear custom FFmpeg options for this mode. Stop streaming and capture before changing alpha modes.

The [`&transparent`](https://docs.vdo.ninja/advanced-settings/design-parameters/and-transparent.md) option clears the page background. It does not create video transparency. You do not need an `&alpha` viewer flag for Game Capture.

### Ninja OBS Plugin

1. Set **Alpha Playback** to **OBS native receiver**.
2. Choose **H.264** or **VP9**, enable the alpha workflow, and publish.
3. In OBS, add the plugin's **VDO.Ninja Source** and enable **Use Native Receiver (Experimental)**.

This mode sends a separate VP9 transparency mask. Browser viewers of this mode receive color video only; use the Browser mode above for browser transparency.

Spout2 carries video only, so select audio separately in Game Capture. For detailed settings, recording advice, and fixes for black backgrounds or missing video, see [Using Game Capture and Spout2 with VDO.Ninja](https://docs.vdo.ninja/guides/using-game-capture-with-vdo.ninja.md).

## Webp-mode supports transparency

For a transparent local video file or a browser background-removal effect, [`&webp`](https://docs.vdo.ninja/advanced-settings/video-parameters/webp.md) sends a series of images with transparency. It uses substantial CPU and bandwidth, so start with a low resolution and frame rate.

### Sending a video file via webp-mode

1. Open this [WebP file sender](https://vdo.ninja/alpha/?webp\&push=YOUR_STREAM_ID\&fileshare\&alpha) with your own stream ID.
2. Select a video file with transparency, such as a WebM file with an alpha channel.
3. Open the [matching WebP viewer](https://vdo.ninja/alpha/?view=YOUR_STREAM_ID\&codec=webp\&transparent), using the same stream ID.

Here, `&alpha` on the sender preserves transparency and `&codec=webp` on the viewer selects image playback. These are WebP settings, separate from Game Capture's Browser alpha mode.

### Transparent webcam background via webp-mode

Use background removal with a transparent replacement image, then send the result as WebP images:

1. Open the [webcam background-removal sender](https://vdo.ninja/alpha/?webp\&push=rPJ5bEb\&effects=5\&alpha\&webcam\&imagelist=data%3Aimage%2Fpng%3Bbase64%2CiVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAQAAAC1HAwCAAAAC0lEQVR42mNkYAAAAAYAAjCB0C8AAAAASUVORK5CYII%3D) and replace the example stream ID with your own.
2. Open the [WebP viewer](https://vdo.ninja/alpha/?view=YOUR_STREAM_ID\&codec=webp\&transparent) with that same ID.

The sender combines [`&effects=5`](https://docs.vdo.ninja/advanced-settings/video-parameters/effects.md), `&alpha`, and `&webp` with a transparent pixel as the replacement background. Background removal and image encoding both use CPU; lower the resolution and frame rate if playback struggles.

## Green screening

Chroma key is useful when the sender or receiver cannot preserve an alpha channel.

1. Use a physical green screen, VDO.Ninja's [`&effects=4`](https://docs.vdo.ninja/advanced-settings/video-parameters/effects.md) green background, or Game Capture's **Alpha Background -> Chroma background** with alpha off.
2. Send the video normally.
3. Add a chroma-key filter in OBS or the receiving app to remove the green.

This works with ordinary video receivers, although fine edges may show green fringing.

<figure><img src="https://2943598173-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MZHXv1G8N0MDxwotaT9%2Fuploads%2FT7Oj9HDgxJRCMwmryUmA%2Fimage.png?alt=media&amp;token=b4d7845b-9b66-4c74-928e-444634e0966d" alt="Webcam feed with a green background" width="480"><figcaption><p>Before: send a green background.</p></figcaption></figure>

<figure><img src="https://2943598173-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MZHXv1G8N0MDxwotaT9%2Fuploads%2FFSGtsxovahwQNWD3Hkuv%2Fimage.png?alt=media&amp;token=9ec8edb9-1929-4ec6-94d6-ee3574876a06" alt="OBS Chroma Key filter removing the green background" width="480"><figcaption><p>After: remove green with the OBS Chroma Key filter.</p></figcaption></figure>

## Chunked mode - partially working

[`&chunked`](https://docs.vdo.ninja/advanced-settings/settings-parameters/and-chunked.md) with `&alpha` requests an alpha-capable recording codec from the browser. Support depends on the browser's encoder. If it cannot preserve alpha, use Game Capture, WebP, or chroma key instead.

### Browser capture limitations

Virtual cameras and browser screen sharing normally do not include alpha channels. Screen sharing the [Electron Capture app](https://docs.vdo.ninja/steves-helper-apps/electron-capture.md), for example, may turn transparent areas black. Use direct Spout2 output from the source app on Windows to preserve those pixels.

Game Capture's Browser alpha mode needs a compatible VDO.Ninja viewer to reconstruct transparency. An ordinary OBS WHIP output or raw forwarded video does not gain this behavior by adding `&transparent`.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.vdo.ninja/guides/how-to-stream-transparent-video.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
