# \&chatlite

General Option! ([`&view`](/advanced-settings/mixer-scene-parameters/view.md), [`&room`](/advanced-settings/setup-parameters/room.md), [`&scene`](/advanced-settings/mixer-scene-parameters/scene.md), [`&director`](/advanced-settings/director-parameters/director.md))

## Aliases

* `&ssnlite`
* `&socialstreamlite`

## Details

`&chatlite` enables the built-in Social Stream Lite activity overlay integration. It can show an in-page chat overlay and expose a control-bar button that toggles the overlay.

This feature is URL-gated and opt-in.

Chat Lite can use native provider cards (YouTube/Twitch/Kick) and Social Stream WebSocket relay mode for broader event inputs.

In simple terms: this adds a chat drawer/overlay inside VDO.Ninja so you can see supported chat feeds without leaving the page.

### Companion flags

Use these optional parameters with `&chatlite`:

<table><thead><tr><th width="255">Parameter</th><th>Description</th></tr></thead><tbody><tr><td><code>&#x26;chatlitebutton</code> (alias: <code>&#x26;ssnchatbutton</code>)</td><td>Show/hide the Chat Lite control button</td></tr><tr><td><code>&#x26;chatlitesession</code> (alias: <code>&#x26;ssnsession</code>)</td><td>Set the session ID used by the overlay</td></tr><tr><td><code>&#x26;chatliteprofile</code></td><td>Apply a profile preset in the Chat Lite UI</td></tr><tr><td><code>&#x26;chatliteposition</code></td><td>Set overlay position behavior for activity mode</td></tr><tr><td><code>&#x26;chatlitemax</code></td><td>Set max retained/visible activity messages</td></tr><tr><td><code>&#x26;chatlitetransparent</code></td><td>Toggle transparent embed background</td></tr><tr><td><code>&#x26;chatlitenoavatar</code> (alias: <code>&#x26;chatlitehideavatar</code>)</td><td>Hide source avatars in activity view</td></tr><tr><td><code>&#x26;chatliteconfig</code></td><td>Auto-open the Chat Lite setup window</td></tr><tr><td><code>&#x26;chatlitetts</code></td><td>Set TTS mode (for example <code>on</code>, <code>all</code>, <code>donations</code>)</td></tr></tbody></table>

### UI shortcuts

When the Chat Lite button is visible:

* Click: toggle overlay visibility
* `SHIFT` + click: open configuration popup
* `ALT`/`CTRL` + click: toggle TTS mode

## Notes and limits

* The built-in Chat Lite overlay works best inside the same browser profile that opened VDO.Ninja.
* The "copy overlay link" flow should be treated as a local pop-out/activity view, not a guaranteed cross-browser or cross-machine OBS overlay link.
* If you want a true standalone Social Stream overlay over SSN WebSockets, use the Social Stream theme overlays instead of the built-in Chat Lite activity page.
* Pop-outs and setup windows opened from the same VDO.Ninja page stay paired to that page; manually opened standalone Chat Lite pages still use the default browser-level session behavior.

## Examples

Enable overlay and button:

`https://vdo.ninja/?view=stream123&chatlite=1`

Set a specific session and transparent mode:

`https://vdo.ninja/?view=stream123&chatlite=1&chatlitesession=myshow&chatlitetransparent=1`

Auto-open setup UI:

`https://vdo.ninja/?room=myroom&chatlitebutton=1&chatliteconfig=1`

## Related

{% content-ref url="/pages/1P2KMlrjFb7FX57poS1I" %}
[Chat Lite](/steves-helper-apps/chat-lite.md)
{% endcontent-ref %}

{% content-ref url="/pages/2pGU9TxBaXEy72kvDG33" %}
[Social Stream Ninja](/steves-helper-apps/social-stream-ninja.md)
{% endcontent-ref %}


---

# 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/settings-parameters/and-chatlite.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.