For the complete documentation index, see llms.txt. This page is also available as Markdown.

Chat Lite

Lightweight Social Stream Ninja activity overlay integrated into VDO.Ninja

Social Stream Ninja 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

Social Stream Ninja 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.

VDO.Ninja integration

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

  • &chatlite=1

  • &chatlitebutton=1

  • &chatlitesession=YOURSESSION

  • &chatlitetts=all

  • &chatlitetts=donations

See the full parameter reference:

&chatlite

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

  • Basic native browser TTS for incoming text messages, or donation/member-style events only

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.

  • This is not a full Social Stream Ninja replacement. Extension-only capture behavior, advanced TTS providers, and full emote-provider support should still use Social Stream Ninja directly.

  • Incoming HTML is sanitized before display and before TTS text is built. Executable markup, JavaScript URLs, event handlers, style blocks, and iframe content are removed.

Control-strip behavior

When enabled inside VDO.Ninja:

  • Normal click toggles the Social Stream Ninja Lite activity overlay

  • SHIFT + click opens Social Stream Ninja Lite setup

  • ALT / CTRL + click toggles native browser TTS

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

TTS notes

Native TTS uses the browser/system speechSynthesis voices. This can work on Android, iOS, and desktop browsers, but some browsers require a user gesture before speech can start. OBS Browser Source may not capture native system TTS audio; use the main Social Stream Ninja app if you need a richer OBS-focused TTS pipeline.

Social Stream Ninja

Last updated

Was this helpful?