This is different than the chat bot overlay. This allows for private 1 on 1 conversation with your bot on a dedicated page, just in case you want to talk privately. It does not have access to the RAG knowledge dataset currently or your other chat histories.

⚠️ Requires a properly configured LLM service provider in the "Configure LLM Service Provider" section above.

💬 Enable private chat bot option

🧠 AI Prompt Page Builder

🧠 AI prompt page builder

https://beta.socialstream.ninja/aiprompt.html

Requires the configured LLM provider above and the private chat bot option enabled.

🙂 Multimodal AI Co-Host

A virtual co-host that can both listen, see, and talk back

https://beta.socialstream.ninja/cohost.html

This work-in-progress AI co-host can view your screen or webcam, listen to your voice, and respond by text or audio.

Voice input: SSN Desktop uses local Whisper with the selected microphone (about a 42 MB first-use download, then offline). The Chrome extension link opens the hosted co-host page, where Chrome Speech Recognition uses the system-default microphone and may require internet. Other browsers can still use typed chat when voice recognition is unavailable.

With a session link, it can also receive the SSN live chat feed; it defaults to monitor-only, and the Live Chat panel can opt into answering questions.

For the SSN Configured LLM provider, enable the private chat bot option above.

AI co-host guide

Future tool permissions can add live chat, OBS, stream events, games, and other interactive controls.

Co-host tool permissions

Spotify controls Allow the co-host to pause, resume, skip, queue, and check songs when Spotify is enabled and connected.

Disabled tools are blocked by the background service even if the co-host asks for them.

🎭 AI Stage Overlay

🎭 AI stage overlay

https://beta.socialstream.ninja/cohost-overlay.html

Shows an AI avatar and speech bubble on stream. Co-host and chat bot services can send commands to it.

AI co-host and stage overlay guide

Also send primary chat bot replies to this overlay Not needed for dock right-click co-host actions.

Enable overlay TTS

> Overlay label / target

> Display name

> Avatar image URL

Position

Scale

The SSN Hosted Trial LLM uses llm.socialstream.ninja as a free simple option for testing while the trial is available.

Events Dashboard [copy link] [options] [?]

Real-time activity feed for stream events.

Monitor follows, subscriptions, raids, donations, and other platform events as they happen across all connected sources.

Track new followers and subscribers
See raids, hosts, and gift subs
Monitor donations and tips
Customize which events to display

💡 Tip: Great for keeping track of supporter activity during streams or for creating an on-stream event ticker.

A real-time dashboard displaying donations and stream events. Create a customized view for monitoring.

Reactions Overlay [copy link] [options] [?]

Reaction-only overlay for floating hearts and other quick reactions.

Use this when you want likes, hearts, thumbs-up, and similar reaction bursts on their own page instead of mixed into chat or the events dashboard.

Zoom reaction icons float up directly from the captured reaction graphic
TikTok like events become floating heart bursts
Transparent background so you can place it anywhere in OBS
Optional URL params: &align=right, &layout=fountain, &scale=1.2, &burst=8, &speed=1.1, &triple, &pagebg=%23000000

💖 Customize reactions overlay

Release Area

📍 Align reactions to

🪄 Layout style

3x reactions released for each reaction event

Motion & Density

🔍 Emoji scale 1.00x

⏩ Float speed 1.00x

Burst count per like event:

Maximum visible reactions:

Background

🎨 Custom page background color

> Page background color

Every enabled control here is added to the reactions.html URL as a matching parameter.

Emotes wall [copy link] [options] [?]

Animated emote display that reacts to chat.

When viewers send emotes in chat, they appear on screen bouncing and floating around. Creates an exciting visual effect when chat spams emotes.

Emotes bounce and animate across the overlay
Supports emotes from all connected platforms
Great for hype moments and celebrations
Customize physics, size, and behavior

💡 Tip: Add as a full-screen browser source in OBS for maximum impact during emote spam moments.

Viewer Count & Chat Activity Overlay [copy link] [options] [?]

Visual indicator of chat activity and audience size.

Shows how active your chat is and displays combined viewer counts from all connected platforms.

Hype meter rises with chat activity
Combined viewer count across all platforms
Tracks unique chatters per source
Customizable thresholds and appearance

💡 Tip: Use to encourage chat participation or create hype-based goals during streams.

When enabled, a tally score of unique names per chat source is tracked. Stop/start to reset the tally.

🚂 Hype Train Top Bar

Shows Twitch Hype Train and Treasure Train progress as a top bar using meta.html?hype.

Hype Train Top Bar guide

Layout and Appearance

➡️ Align overlay to the right-side

↔️ Align overlay to the center

🔍 Scale multiplier 1.00x

👻 Panel opacity 1.00

🧼 Transparent bar background

🔳 Disable text outlining

🎨 Custom page background color

> Page background color

Meta Data Bar [copy link] [options] [?]

Dedicated overlay for metadata-only events.

Shows live values such as current item, bidder, bids, timer, product availability, giveaway counts, viewer snapshots, and Twitch Hype Train progress.

Built for auction and commerce streams
Updates values in place as new meta events arrive
Renders Hype Train and Treasure Train events as a top progress bar
Toggle icon, label, and value visibility
Filter by event type (auction, commerce, viewers, hype trains, other meta)

💡 Tip: If no event filter is checked, the overlay defaults to auction + commerce + viewer + Hype Train meta.

Displays metadata-only events (no chat message required), such as auction status and catalog summaries.

Tip Jar and Goal Meter [copy link] [options] [?]

Track donations or build a mixed supporter goal.

Normal mode counts donations and paid messages. Enable Hype Cup scoring to also count memberships and subscriptions.

Running total of all donations
Optional membership and subscription scoring
Visual progress bar display
Supports multiple donation platforms

💡 Tip: Perfect for charity streams or setting up sub/donation goals for your community.

When enabled, a tally of donations receieved is kept.

🧰 General Controls

🔧 General Options

➡️ Align overlay to the right-side

💾 Keep amount between sessions

🔊 Play sound on donation

🎛️ Show control panel

Set current amount:

🔥 Hype Cup Scoring

🏆 Hype Cup Options

🏆 Count memberships, subscriptions, and donations as points

Sub/member points:

Gifted sub/member points:

Donation points per USD:

Point unit label:

Completion reset delay (ms):

🎁 Count individual gift recipients too

➕ Carry extra points after completion

🙈 Hide completion count

🎨 Style, Goal, and Filters

🎨 Style and Theme

Display Style

Theme:

Celebration Effect:

🎯 Goal Settings

Goal Amount ($):

Keep total and advance target after each goal

Custom Title:

Starting amount:

Donation type filter:

Source filter:

Exclude YouTube gifted memberships

📊 Goal Bar Style

Fill start color (empty/low):

Fill end color (full):

Track color (unfilled bar):

Fill behavior:

Recurring goal increment:

Bar text size (px):

Only show the bar, with text inside

Custom Jar Image URL:

🧪 Test Donations

Test Donations

Sends a fake donation to connected overlays.

Tip Jar and Goal Meter guide

Wait List / Winner Draw [copy link] [options] [?]

Queue management and random winner selection.

Let viewers join a waiting list by typing a command in chat. Perfect for viewer games, Q&A sessions, or randomly selecting winners.

Viewers join by typing a command (e.g., !join)
Display the queue on stream
Randomly draw winners from the list
Manage queue order and remove entries

💡 Tip: Great for viewer games, giveaways, or managing who gets to participate in activities.

When enabled, guests can type !join (or a custom command) in chat to be added to an ordered list of users. Stop/start to reset the queue/draw.

🔄 Flow actions [copy link] [options] [?]

Visual automation tool for chat-triggered actions.

Create custom automations using the Event Flow Editor. This overlay page displays the results of those automations (images, sounds, animations, etc.).

Trigger images, sounds, or animations from chat
Create custom command responses
Build complex event-driven workflows
No coding required - visual drag-and-drop editor

⚠️ Requires setup: Use the Event Flow Editor (in the extension menu) to create your automations first.

This page is the output for actions triggered by the Flow Editor page.
Note: To access the Event Flow Editor, click here.

⚙️ General Settings

🔉 Media Volume 1.00

⏱️ Default media duration (ms)

🎨 Custom CSS URL

🔍 Show OBS connection status badge on overlay

🎬 OBS WebSocket Settings

> OBS WebSocket URL

> OBS WebSocket Password

Flow Actions use OBS WebSocket v5 on OBS 28+ (default port 4455). Password is optional; leave it blank if OBS does not require one.
For a live status badge on the overlay itself, append &obsdebug=1 to the actions.html URL.
Open OBS WebSocket Tester · OBS Control Guide

💡 Configure your OBS WebSocket settings here to enable Flow Actions to control OBS. Make sure OBS WebSocket Server is enabled in OBS: Tools → WebSocket Server Settings

Giveaway Tool [copy link] [options] [?]

Run chat-based giveaways with automatic entry and winner selection.

Let viewers enter giveaways by typing a keyword in chat. Randomly select winners with visual animations.

Custom entry keywords
Automatic duplicate prevention
Animated winner selection
Multi-platform support

⚠️ Note: Community-contributed feature - may have occasional bugs.

A giveaway made by a community member -- ⚠️ it's not yet considered "stable", so I may avoid this for now.

Graphical Poll [copy link] [options] [?]

Create visual polls that viewers vote on via chat.

Viewers vote by typing hashtag keywords in chat (e.g., #option1, #yes). Results display as animated bars or charts.

Viewers vote with hashtags in chat
Real-time animated results
Customizable poll options
Works across all platforms

💡 Tip: Great for audience decisions, game choices, or just fun community engagement.

A graphic poll. Users can enter a hash-tagged word to vote it it.

📊 Poll Options

Poll Settings

Enable and customize the poll:

🚦 Enable Poll

📊 Poll Type:

Vote Matching:

🗳️ Allow multiple votes per user

✌️ Show number of votes instead of percent

💰 Donation-weighted voting (Dono Poll)

🎨 Poll Style/Theme:

❔ Poll Question:

Poll Presets

User Map [copy link] [options] [?]

Display a world map showing where your viewers are located.

Viewers can share their location by typing it in chat, and pins appear on the map showing your global audience.

Interactive world map visualization
Viewers type their city/country to place a pin
See your community's geographic spread
Great for international streams

💡 Tip: Fun way to show your community how global your audience is!

A graphical map. Users can enter their location to mark on it.

🗺️ Map Options

Map Settings

Enable and customize the map:

🚦 Enable Map

📊 Map Type:

🌎 Region filter:

🔍 Auto-fit map to votes (zoom when markers appear)

🗳️ Allow multiple votes per user

🎨 Map Style/Theme:

💡 Base map visibility:

🔢 Hide vote count numbers (show dots only)

🔴 Red color intensity (more votes = darker red)

📐 HUD Scale:

⌨️ Keyboard Shortcuts

Use these shortcuts while the popup or dock is focused:

`Ctrl+Shift+E`	End Poll
`Ctrl+Shift+R`	Reset Poll
`Ctrl+Shift+W`	Select Winner (Waitlist)
`Ctrl+Shift+S`	Stop Entries (Waitlist)
`Ctrl+Shift+X`	Reset Waitlist
`Ctrl+Shift+C`	Clear Dock

Credits roll [copy link] [options] [?]

Movie-style scrolling credits featuring your community.

Display scrolling credits at the end of your stream showing chatters, subscribers, donors, and anyone you want to thank.

Auto-populate from chat participants
Include donors and subscribers
Customizable sections and styling
Movie-style scrolling animation

💡 Tip: Great for ending streams with a thank-you to your community!

A credits roll overlay. Show appreciation to your chat participants and donors.

Leaderboard [copy link] [options] [?]

Rank and display your top community members.

Show rankings based on chat activity, points earned, donations, or custom metrics you define.

Track top chatters and contributors
Display donation/sub rankings
Custom scoring systems
Animated leaderboard updates

💡 Tip: Encourages engagement by showing viewers how they rank in your community!

An interactive leaderboard overlay. Track and display top contributors, chatters, or custom scores.

📊 Enable and customize

Layout Mode

Layout Style

Display Options

👤 Show user avatars

🌐 Show source platform

Maximum entries to show

⏱️ Update interval seconds (0 = disabled)

Top Bar Settings

These settings only apply when using the "Top Header Bar" layout
ℹ️ Animations and donation tracking are automatically enabled for this layout

Display Mode

When rotating, include:

📆 Include weekly stats (default: daily only)

🔄 Rotation interval seconds

Transition Style

💰 Show monetary value for gifts (instead of count)

📐 Compact mode (smaller height)

📜 Ticker scroll mode (continuous scrolling)

Scroll Speed

Theme & Data Settings

Theme Style

💾 Persist data between sessions (7 days max)

> Custom leaderboard title

Scoreboard [copy link] [options] [?]

Real-time points and score tracking display.

Display points, rankings, and engagement scores for your viewers. Perfect for gamified streams with rewards systems.

Real-time point updates
Customizable triggers and rewards
Viewer rankings display
Integration with chat activity

💡 Tip: Enable the global Points System above to show persistent loyalty points, or use the local fallback options below for temporary chat activity scores.

A real-time points tracking scoreboard for loyalty points, chat activity, donations, and custom Event Flow score payloads.

🎮 Interactive Games [copy link] [options] [?]

Mini-games your viewers can play through chat.

A collection of chat-controlled games for viewer engagement. Viewers participate by typing commands in chat.

Multiple game modes available
Chat-controlled gameplay
Works across all platforms
Great for breaks or viewer interaction

💡 Tip: Perfect for BRB screens or dedicated game segments!

Interactive chat-based games for viewer engagement. Choose from various mini-games.

🎯 Select Game: Note: Each game has unique commands and mechanics

Ticker [copy link] [options] [?]

Scrolling horizontal text banner.

Display scrolling text across your stream - perfect for announcements, recent events, or a news ticker-style chat display.

Scrolling horizontal text
Show chat messages, events, or custom text
Customizable speed and appearance
Great for announcements or alerts

💡 Tip: Use for stream announcements, social media handles, or a scrolling chat feed.

A ticker banner. Select the source for the ticker text messages

📊 Enable and customize

Must enable the trigger to use

🚦 Enable

No file selected.

Other customization options

⏲️ Speed (relative) x

🕒 FPS-independent speed (recommended for OBS)

Display Style

Font Family

> Specify a Google Font name

note: Install custom fonts on your system (Windows: right-click .ttf/.otf → Install, then restart browser). Font detector & help

Playback & rotation

Display style

⏱️ Hold each line for ms (rotate mode)

⏸️ Pause after a full loop for ms

Order when rotating

Spacing & separators

↔️ Extra padding per item px

> Separator symbol (optional)

🧱 Preserve spaces & blank lines from the text file

Word Cloud [copy link] [options] [?]

Real-time word cloud generated from chat.

Displays a dynamic word cloud that grows based on what your chat is saying. Popular words appear larger.

Real-time word frequency visualization
Single-word messages contribute by default
Customizable appearance and filters
Great for polls or seeing chat trends

💡 Tip: Ask your chat a question and watch the most popular answers grow in the cloud!

A wordcloud overlay. Chat messages that contain a single word are counted by default.

📊 Enable and customize

Must enable the trigger to use

🚦 Enable

Count words from all chat messages

Other customization options

Font Family

> Specify a Google Font name

note: Install custom fonts on your system (Windows: right-click .ttf/.otf → Install, then restart browser). Font detector & help

🔍 Word cloud scale 1.00x

Coloring and basic styling option

Custom GIF Commands [copy link] [options] [?]

Trigger GIFs and images on screen via chat commands.

Set up custom commands that display specific GIFs, images, or animations on your stream when viewers type them in chat.

Define custom trigger commands (e.g., !hype, !gg)
Display GIFs, images, or videos
Customizable display duration and position
Multiple command support

💡 Tip: Create fun reactions for your community - like a celebration GIF when someone says !party.

When enabled, custom commands will trigger specific GIFs or media in the overlay.

📊 Enable and customize

Custom GIF Commands Settings

🚦 Enable Custom GIF Commands

⏲️ Minimum default playout time ms

Timer [copy link] [options] [?]

A focused stage timer with optional operator controls.

Use this as a countdown or count-up overlay, then control it from the page itself, from the popup, or through the API.

Single timer with overtime and warning states
Optional operator controls with start, pause, reset, and +/-30s
Three built-in looks: stage, compact, ring
Works with the &server API path for remote control

A focused timer overlay for breaks, interviews, countdowns, and on-stream pacing.

⏳ Timer Options

Style preset

Timer mode

> Timer label

Default time s

Warn at s

Danger at s

Show operator controls on the page

Start automatically when the page loads

Play a sound when the timer completes

> Custom timer sound URL

Spotify Integration [copy link] [?]

Display currently playing Spotify tracks on stream.

Connect your Spotify account to show what song is playing as an overlay, or announce tracks to chat automatically.

"Now Playing" overlay widget
Optional upcoming song-request queue
Auto-announce songs to chat
Chat commands for song info (!song, !np)
Customizable overlay appearance

⚠️ Requires setup: You need to authorize your Spotify account in the setup section below.

Connect your Spotify account to create a widget overlay or announce to chat the current song.

🎵 Spotify Setup & Configuration

Spotify Setup & Configuration

Enable Spotify integration

Need to create a Spotify app? Open Spotify Dashboard →

> Spotify Client ID

> Spotify Client Secret

💬 Spotify Dock Announcements

Spotify Announcements

Now Playing Features

Polling interval (seconds): (3-60 seconds)

Announce new tracks in overlays (not sent to platform chat)

> Announcement format

> Bot name for messages

👉 Looking for the Global settings? It was moved further up the page. Click here to JUMP to it.

Visit us at Discord
Made with 💖 for the community.

💬Main chat overlay & control dock [copy link] [edit link] [options] [?]

Enable Text to Speech in the Dock

TTS Behaviors

Read out only specific user/messages

Bots, hosts and events are excluded from TTS

More TTS options

Text-to-Speech Service Provider

Built-in System TTS Options

Kokoro TTS Options

Kitten TTS Options

ElevenLabs TTS Options

Google Cloud TTS Options

Gemini TTS Options

Speechify TTS Options

OpenAI / Custom TTS Endpoint Options

Piper TTS Options

eSpeak TTS Options

Font Styling

Text Glow

Highlight Colors

Customize Donation Colors by Threshold

Advanced animation options can be set below.

🎨Pre-styled chat overlays [copy link]

🌟Featured chat overlay [copy link] [options] [?]

Enable Text to Speech in Featured Chat

TTS Filters

More TTS options

Text-to-Speech Service Provider

Built-in System TTS Options

Kokoro TTS Options

Kitten TTS Options

ElevenLabs TTS Options

Google Cloud TTS Options

Gemini TTS Options

Gemini TTS Options

Speechify TTS Options

OpenAI / Custom TTS Endpoint Options

Piper TTS Options

eSpeak TTS Options

Colors

Style Options

Animation Options

3D Effect Options

Particle Effect Options

🚨Multi-Stream Alert Box [copy link] [options]

🛠️ Global settings and tools [options]

Opt-in options

Opt-out options

Miscellaneous options for sites

Custom Injection

Printer Control

General Settings

Commands

Management

Backup & Restore

Custom JavaScript

Giphy/Tenor support

Trigger webhook URL by a !command

Send fixed messages at intervals

Auto-responder

Trigger MIDI note on command

Message doubling / echos / duplicates / relayed

Other filters

Blocked / Allowed Users:

Assign roles/classes to certain users

YouTube API

Opened in new tab

Opened in new window

Custom

Save current settings as profile

Manage profiles

Save the last message to a file

📊 Save live stats snapshot to a file

Save all messages to 📗 Excel file

Save all names seen in chat to a simple file

Reset all settings to defaults

Export/import settings

Set a password

Hide your links

🤖Chat Bots and AI services [options]

Main chat overlay & control dock [copy link] [edit link] [options] [?]

Pre-styled chat overlays [copy link]

Featured chat overlay [copy link] [options] [?]

Multi-Stream Alert Box [copy link] [options]

Chat Bots and AI services [options]

Events Dashboard [copy link] [options] [?]

Reactions Overlay [copy link] [options] [?]

Emotes wall [copy link] [options] [?]

Viewer Count & Chat Activity Overlay [copy link] [options] [?]

Meta Data Bar [copy link] [options] [?]

Tip Jar and Goal Meter [copy link] [options] [?]

Wait List / Winner Draw [copy link] [options] [?]

This page is the output for actions triggered by the Flow Editor page.
Note: To access the Event Flow Editor, click here.