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

🙂 Multimodal AI Co-Host

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

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

This is a work-in-progress virtual AI co-host. It can currently view your screen, webcam, and listen to your microphone/audio. It will respond by text or audio, as you desire.

Down the road this will be able to access your live chat, start/stop your OBS stream, change scenes in OBS, handle events and interactive games with your audience, and participate in your stream as a virtual co-host.

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

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.

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

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.

Hype Meter and Viewer Count [copy link] [options] [? help]

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.

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

Track donations and display fundraising progress.

Keep a running total of donations received and display progress toward goals like charity drives, equipment upgrades, or subscriber milestones.

Running total of all donations
Set custom fundraising goals
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.

📊 Enable and customize

General Options

➡️ Align overlay to the right-side

💾 Keep amount between sessions

🔊 Play sound on donation

🎛️ Show control panel

Style and Theme

Display Style

Theme:

Celebration Effect:

Goal Settings

Goal Amount ($):

Custom Title:

Custom Jar Image URL:

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

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] [? help]

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.

🎬 OBS WebSocket Settings

> OBS WebSocket URL

> OBS WebSocket Password

💡 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] [? help]

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] [? help]

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:

🗳️ 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] [? help]

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:

🔢 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] [? help]

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] [? help]

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 (🚧 Work in Progress) [copy link] [options] [? help]

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

⚠️ Work in Progress: This feature is still being developed and may have limited functionality.

A real-time points tracking scoreboard. Display user points, rankings, and engagement scores with customizable triggers and rewards.

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

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

Battle Royal [copy link] [options] [? help]

Viewer vs viewer elimination game.

Viewers join by typing !join in chat, then battle each other in an automated elimination-style game until one winner remains.

Viewers type !join to enter
Automated battle rounds
Last viewer standing wins
Fun visual battle animations

💡 Tip: Great for giveaways or just fun viewer engagement!

A battle royal mini game. Users can enter !join to play

📊 Options and actions

🚦 Host Starts

🚫🤖 Disable computer players

⌚ Increase lobby wait time to 30s

Ticker [copy link] [options] [? help]

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

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] [? help]

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 to the cloud
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 allowed.

📊 Enable and customize

Must enable the trigger to use

🚦 Enable

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] [? help]

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

Spotify Integration [copy link] [setup] [dock] [chat] [overlay] [? help]

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
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 Overlay Options

Appearance

Style preset

Accent color (hex or CSS color)

Compact layout

Visibility toggles

Hide when paused

Hide when no song is active

Hide album art

Hide album title

Hide progress bar + timestamps

Hide device details

Hide status badge

💬 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.

💬Streaming chat (dock & overlay) [copy link] [options] [? help]

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 TTS Options

Font Styling

Text Glow

Background Shading for Messages

Customize Donation Colors by Threshold 🌈💰

Advanced animation options can be set below.

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

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 TTS Options

Piper TTS Options

eSpeak TTS Options

Colors

Style Options

Animation Options

3D Effect Options

Particle Effect 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 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]

Configure LLM API 🦙

Chat bot 🤖💬

Give the above chat bot access to additional custom knowledge that you can provide

Custom knowledge-base - File Management

🤖 Chat Bot - Primary

Streaming chat (dock & overlay) [copy link] [options] [? help]

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

Chat Bots and AI services [options]

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

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

Hype Meter and Viewer Count [copy link] [options] [? help]

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

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

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

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

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

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

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

Leaderboard [copy link] [options] [? help]