# Chat Lite

Chat Lite is a lightweight social activity overlay UI that can run standalone or embedded inside VDO.Ninja.

Current provider cards include YouTube, Twitch, Kick, and Social Stream WebSocket relay mode.

In plain terms: it lets VDO.Ninja show live chat messages from supported services inside the app, so you can keep chat on screen without opening a separate dashboard.

## Sources

Chat Lite can ingest from native provider cards (YouTube/Twitch/Kick) or from the Social Stream WebSocket relay source:

* `wss://io.socialstream.ninja` with a matching session ID

This relay mode can carry additional platform events through the same activity feed workflow.

## Links

* App: <https://vdo.ninja/chat-lite/>
* Activity/embed mode example: <https://vdo.ninja/chat-lite/index.html?view=activity&embed=1&session=demo>

## VDO.Ninja integration

You can enable Chat Lite integration in VDO.Ninja using URL parameters like:

* `&chatlite=1`
* `&chatlitebutton=1`
* `&chatlitesession=YOURSESSION`

See the full parameter reference:

{% content-ref url="/pages/NBB1gJqxfZ1UxkygHLrF" %}
[\&chatlite](/advanced-settings/settings-parameters/and-chatlite.md)
{% endcontent-ref %}

## What it is good for

* Showing YouTube, Twitch, Kick, or SSN-fed activity directly inside a VDO.Ninja page
* Opening a local pop-out/activity view from the same browser profile
* Keeping chat visible for the director or host without needing the full Social Stream app

## Current limitations

* The built-in activity overlay is primarily a local browser feature. The copied overlay link is best treated as a same-browser pop-out, not a standalone OBS/browser-source overlay for another machine or browser profile.
* If you need a standalone overlay fed by Social Stream WebSockets, use the Social Stream theme overlays instead.
* Windows opened from the same VDO.Ninja page stay paired together. Standalone Chat Lite pages opened manually still use the default browser-level session behavior.

### Control-strip behavior

When enabled inside VDO.Ninja:

* Normal click toggles the Chat Lite activity overlay
* `SHIFT` + click opens Chat Lite setup
* `ALT` / `CTRL` + click toggles TTS mode

The activity/embed view is intended as display-only output, so overlays do not auto-connect providers in the background.

## Related

{% 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/steves-helper-apps/chat-lite.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.