Customize panel

Choose the sections shown in your panel. Hiding a section only hides its controls.

No matching options found
Hide menu bar
Force Show menu bar (using MELD?)
Make chat input the full menu bar
๐Ÿ” Chat Output Scale 1.00x
โญ• Force transparent background (OBS Browser Source is already transparent by default)
Hide scrollbar
๐Ÿ‘ป Page opacity 0.30
โšช Translucent page background 40%
๐ŸŸข Green page background
โšช White page background
โšช Light mode - White page background
โšซ Dark mode - Black page background
๐ŸŒ‡ Fade out the top of the overlay
๐Ÿ”ข Show viewer count per source; top-right
Show like totals per source; top-right
โ†•๏ธ Reserve space for the viewer count bar
๐Ÿ“Š Show bitrate metadata if available; top-right [?]
๐ŸŽจ Custom viewer bar background color
๐Ÿšฅ Show current OBS scene in corner
Details on enabling the read-permissions for OBS scene state
๐Ÿž Debug mode (console logs on))
โฒ๏ธ Auto-hide message after ms
๐Ÿšซ๐Ÿคฌ๏ธ Delay showing messages for ms
๐Ÿ—‘๏ธ Only delete last message if unsure which to ๐Ÿ—‘๏ธ
๐Ÿ—‘๏ธ Show deleted messages
โฌ Messages start at bottom rather than top
๐Ÿ”ƒ Messages drop down (reversed order)
๐Ÿ”€ Reverse order (top down new messages)
๐Ÿ”€ Messages appear randomly on the screen
๐Ÿ”ฝ Enable auto-scrolling to the bottom by default
๐Ÿ›‘ Manual scroll mode (disable auto-scroll unless Force Scroll is enabled)
๐Ÿ‘‰๐Ÿงฑ Messages align to the right-side
๐Ÿ—จ๏ธ๐Ÿงฑ Force right-to-left text reading
๐Ÿšฌ Stream events fade up and away after 3s
๐Ÿ”” Beep when there is a new message
๐Ÿ””๐Ÿ›ก๏ธ Beep only for moderator messages
๐Ÿ””๐Ÿ†• Dock beep for first-time chatters
๐Ÿ””๐Ÿ”‰ Beep volume 30%
Custom beep URLs take priority.
๐Ÿ”ˆ Keep Bluetooth speaker awake with a near-silent ping
Allow overlapping beeps (experimental)
๐Ÿ”„๏ธ Reload last ~50-msgs when refreshing the page
๐Ÿ—„๏ธ Load last ~30-msgs from the database on load
๐Ÿ•ฐ๏ธ Enable history browsing (scroll up to load older messages)
Auto-feature queued messages
Show queued messages only
Keep featured message until cleared
๐Ÿ”– Automatically feature new messages โ€” all of them, unless limited by the options below (requires the dock to remain open)
๐Ÿ–ฑ๏ธ Must manually select via context-menu
โŒš Custom auto-select show time ms
๐Ÿฅ… Exclude filtered messages from auto-selecting
๐Ÿšซ Contains text or name
๐Ÿšซ Exact message
๐Ÿท๏ธ๐Ÿ—‘๏ธ Remove donation data from messages
๐Ÿท๏ธ๐Ÿฆ˜ Skip messages containing donations
๐Ÿท๏ธ Auto-feature donations
๐Ÿ‘‘ Auto-feature messages from members
๐Ÿ˜บ Auto-feature messages with a content image
๐Ÿ‘‘ Auto-feature YouTube monthly member chat
โ“๐Ÿ“Œ Auto-pin messages identified as questions
โ“โ›“๏ธ Auto-queue messages identified as questions
โ“ Track unanswered questions
๐Ÿ’ต๐Ÿ“Œ Auto-pin messages with donations
๐Ÿ’ต๐Ÿ”ข Auto-queue messages with donations
โ–ถ๏ธ๐Ÿ’ต Auto-queue YouTube Super Chats only
๐Ÿ‘‘ Auto-queue YouTube membership alerts
๐Ÿ” Multiple docks will stay in sync as to selected messages
๐ŸŒŸ Only receive featured messages from another dock
๐Ÿ“Œ Only see pinned messages (for use with &sync)
๐Ÿšฒ Guests can use !cycle to change the scene in OBS*
๐Ÿ‘๏ธ View-only mode. (Can't chat, pin, or feature)
๐Ÿ‘๏ธ View & Chat-only mode. (Can't pin or feature)
๐Ÿ‘๏ธ View, Pin, and Queue. (Can't chat or feature)
โŒš Use 24-hour time for timestamp
๐Ÿ–ฅ๏ธ๐Ÿ’ป P2P connections via LAN only

Enable Text to Speech in the Dock

๐Ÿšฆ๐Ÿ—ฃ๏ธ Text-to-speech all incoming messages
Check out the TTS help guide here!

TTS Behaviors

๐Ÿšซ๐Ÿ—ฃ๏ธ Do not say "says" or "someone says" with TTS
๐Ÿ—ฃ๏ธ Read out URLs rather than saying "link".
๐Ÿ—ฃ๏ธ Any message containing will be read out
Please note, you will want to disable the top "Text-to-speech all incoming messages" option if wanting to use this option

๐Ÿคด Only members can use the TTS command
๐Ÿšซโžฟ Do not read out reflections (your replies)

Read out only specific user/messages

๐Ÿค– Only bot marked users can have messages read
๐Ÿ‘ฉโ€๐Ÿซ Only specific mods can have messages read
๐Ÿคด Only members can have messages read
โญ Only VIP marked users can have messages read
๐Ÿ‘‘ Only privilleged users can have messages read
๐Ÿ•บ Only hosts can have messages read
๐Ÿ—ฃ๏ธ๐Ÿ’ฐ Only donations can have messages read out

Bots, hosts and events are excluded from TTS

๐Ÿค–โœ… Allow bot messages to be read out
๐Ÿ•บโœ… Allow host messages to be read out
๐Ÿ—ฃ๏ธ Include any stream events when using TTS

More TTS options

๐Ÿ—ฃ๏ธ If using TTS, only announce every 3rd message
๐Ÿ”ค Read only the first 100-characters
โฉ Send TTS as PCM audio to 127.0.0.1:5000 instead
๐Ÿ”‡ Next TTS message control via chat !pass
๐Ÿ”‡ Mod-only TTS message control via !pass
๐Ÿ”‰ Volume of speech

Text-to-Speech Service Provider

Local: speech runs on your computer; models may download first. Many languages: choose a matching voice or model. Online free tiers have usage limits.

Turn off for message-only speech.

Built-in System TTS Options

note: the free built-in TTS plays out via the default audio device. [LEARN MORE HERE]

โฉ Speaking rate
๐ŸŽต Pitch

Kokoro TTS Options

note: this free locally-running TTS needs a powerful computer to run well.

๐ŸŽญ Voice to use:

โฉ Speaking rate
๐Ÿ›ˆ Hide source icon (e.g, )
๐Ÿ”ฒ Make platform source icons square
๐Ÿ“ Show source name as text next to icon
๐Ÿšซ Hide Twitch messages (other sources allowed)
โœ… Only show Twitch messages (no other sources)
๐Ÿšซ Hide messages from Kick
๐Ÿšซ Hide messages from Kofi
๐Ÿšซ Hide messages from YouTube
๐ŸŒซ๏ธ Just blur messages from hidden sources
๐Ÿงผ Never blur hidden or timed-out messages
๐Ÿ“บ Show channel icon
๐Ÿ”Ž Use a larger channel icon
๐Ÿ“บ Show originating channel name
Freeze animated emotes
Show attachments only
Hide colon after names
๐Ÿ†” Hide avatars
๐Ÿ™ˆ Hide unknown avatar placeholder image
๐Ÿ•˜ Hide timestamp
๐Ÿ”ฐ Hide badges
๐Ÿ’› Hide membership labels
๐Ÿ”ฐ๐Ÿ”ฐ Show just the first 2 badges
๐ŸŽ† Show only stream events
Include private messages
Show private messages only
๐Ÿงฏ Hide all stream events
๐Ÿšจ Hide alert events (follows, subs, donations, bits, raids)
๐Ÿ”ค Use first names only
๐Ÿ…ฐ๏ธ Delete names entirely
๐ŸŒŒ Hide name/icons if sequential from same user
๐Ÿ“ฉ Strips 'Replying to @user' if present
๐Ÿ—ƒ๏ธ Limit total messages to
๐Ÿคฌ Filter out messages with bad karma
โ—๐Ÿ’ฌ Hide messages that start with: !
โ—๐Ÿ”‡ "Don't TTS/Beep if messages starts with !
Filter ALL CAPS messages
๐Ÿช™ Only show if includes a donation
๐Ÿคฉ Show only messages from members
โญ Treat TikTok fans/teamer as members
๐Ÿ›ก๏ธ Only show messages from moderators
๐Ÿ’Ž Only show messages from VIPs
๐Ÿ™Š Alt-keyword filter will match on name-only
โ“ Only show messages marked as questions
โ” Hide messages marked as questions
๐Ÿ”ข Hide messages that are numbers only
๐Ÿ—ƒ๏ธ Hide basic messages shorter than chars
๐Ÿ“ค Strip HTML/images from messages and donations
๐Ÿ˜ญ Strip text-based emojis from messages
๐Ÿ˜ถ Strip emojis from usernames
๐Ÿ˜’โŒจ๏ธ Ignore emoji-only messages
๐Ÿšซ๐Ÿ”— Replace links in messages with just '[Link]'
Allow links from bots
Allow links from hosts
Allow links from mods
Allow links from VIPs
๐ŸŸข๐Ÿ”— Make URLs in chat clickable links
๐Ÿค๐Ÿ”— Shorten long links ...
โณ Increase the minimum time messages auto-show for
โ†”๏ธ Inline name and message (keep normal spacing)
โ—ป๏ธ Compact mode (name & message on one line) Dense single-line layout for short messages โ€” not just spacing. For a full dense theme, pick a "Compact" style above.
๐Ÿค Padding between messages px
๐Ÿ’ต๐Ÿซฑ Align donations to the right-side
ใ€ฐ๏ธ No text outlining
โœ’๏ธIncrease text outline by 50%
โœ’๏ธDecrease text outline by 33%

Font Styling

100%

Text Glow

โœจ Enable text glow halo (pair with "No text outlining" to use glow only)
80%
Large avatar profile pic on left side
๐Ÿ˜Š Make emojis larger
โ• Message appears on its own line under name
โœ‚๏ธ Split mode (messages align relative to center)
๐Ÿƒ Show each message as a card
๐Ÿ’ญ Turn message portion into a rounded bubble
๐Ÿท๏ธ Add a rounded bubble behind the name
๐Ÿ’ง Bubble opacity (0-1)
โ†”๏ธ Horizontal scrolling messages
โ†”๏ธ Horizontal ticker slides left-to-right
โœ‚๏ธ Trim messages to 200 characters...
โœ‚๏ธ Trim names longer than chars...
๐Ÿ”  Diacritic folding / Accent normalization
โคต๏ธ Messages overlap on another
Font Family
note: Install custom fonts on your system (Windows: right-click .ttf/.otf → Install, then restart browser). Font detector & help
โญ•๐Ÿ‘ฅ No alternating background shading
โญ•๐Ÿ‘ค No background shading for members
โญ•๐Ÿ”ฆ No background shading for past-selected
โ›”๐Ÿ”ฆ No background shading for any selected
โ“๐Ÿ”ฆ No background shading for "questions"
โญ•๐ŸŒฟ No background shading for first-time chatters
โญ•๐Ÿ’ฐ No background shading for donations
Allow background shading for trivial events

Highlight Colors

Customize Donation Colors by Threshold


Messages fade in
Messages fade out when hiding
Slide in from the left
Slide in from the top
Messages slide in from the right
Messages smoothly scroll in
Messages get typed in char-by-char
๐Ÿšฆ Smooth message buffering (prevents message floods)
โšก Animation speed 1.0s

Advanced animation options can be set below.

These may override the basic transition options listed above.

For more details about these effects, visit here.


Animate in effects

Animate out effects
๐Ÿ’พ Save last message to a file
๐Ÿ’พ Save featured message to file
๐Ÿ’พ Auto-save messages to downloads folder
๐Ÿ˜ Include the user's avatar URL/Blob
๐Ÿ“› Use source-provided username colors
๐ŸŒˆ๐Ÿ‘ค Generate colors for uncolored names
๐ŸŒˆ๐ŸŒˆ Generate colors for every name
๐Ÿ”— jump to section to specify host/bot/privileged users..

Note: Bots referenced here are third-party stream bot and not in reference to our own local LLM bots.


๐Ÿค–๐Ÿ”ค Delete names for bots
๐Ÿ™๐Ÿ”ค Delete names for hosts
๐Ÿค–๐Ÿšซ Filter out messages for listed bots
๐Ÿ™๐Ÿšซ Filter out messages for listed hosts
๐Ÿค–๐Ÿ”‡ Do not trigger the beep for bot messages
Mute moderator beeps
๐Ÿ™๐Ÿ”‡ Do not trigger the beep for host messages
๐ŸŽฌ๐Ÿ”‡ Do not trigger the beep for events
โญ Give VIP marked users a special badge
โญ Auto-feature messages from VIP users
๐Ÿคด Auto-feature messages from privileged users
๐Ÿค–๐Ÿ’ช Allow privileged users to !start or !stop OBS
Note: Remote OBS control requires the dock.html to be added to OBS as a browser source, with full permissions enabled for it.
Want to design your own? Check out our AI-friendly starter templates.
Import StreamElements / Streamlabs chat skin ยท Setup guide
๐ŸŒ  Automatically feature new messages (no dock required)
By default, this overlay only shows messages selected from the dock. Enable this option to feature incoming messages automatically.
๐Ÿ” Scale multiplier 1.00x
๐ŸŸข Green page background
Force transparent background (Useful for standalone pop-out overlays)
โœ‚๏ธ Split mode (align overlay to center)
โฌ†๏ธ Raise overlay higher
โฒ๏ธ Auto-hide message after ms
โŒš Queue + Show messages for at least ms
๐Ÿ”„ Rotate last messages every ms
๐Ÿž Debug mode (console logs on))
๐Ÿ”” Beep when there is a new message
๐Ÿ””๐Ÿ’ต Beep when there is a new donation
๐Ÿ””๐Ÿ”‰ Beep volume 30%
๐Ÿ‘‰๐Ÿงฑ Messages align to the right-side
๐Ÿ—จ๏ธ๐Ÿงฑ Force right-to-left text reading
๐Ÿฅž Old messages stay and stack (WIP)
(I'd suggest you use the dock link instead for stacking multiple messages)
๐Ÿ–ฅ๏ธ๐Ÿ’ป P2P connections via LAN only
๐Ÿ’พ Save avatar image to disk (click on page to setup)
๐Ÿ–ผ๏ธ Use a custom fallback avatar when none is provided

Enable Text to Speech in Featured Chat

๐Ÿ—ฃ๏ธ Enable text-to-speech
Check out the TTS help guide here!

TTS Filters

๐Ÿ—ฃ๏ธ๐Ÿ’ฐ Enable text-to-speech for donations only
๐Ÿ—ฃ๏ธ๐Ÿ†• Enable text-to-speech for new members only
๐Ÿ—ฃ๏ธ๐Ÿ–ฑ๏ธ Enable text-to-speech for clicked messages only

More TTS options

๐Ÿšซ๐Ÿ—ฃ๏ธ Do not say "says" or "someone says" with TTS
๐Ÿ—ฃ๏ธ Read out URLs rather than saying "link".
๐Ÿ”‰ Volume of speech

Text-to-Speech Service Provider

Local: speech runs on your computer; models may download first. Many languages: choose a matching voice or model. Online free tiers have usage limits.

Turn off for message-only speech.

Built-in System TTS Options

note: the free built-in TTS plays out via the default audio device. [LEARN MORE HERE]

๐Ÿ“ฏ Pitch:
โฉ Custom speaking rate for the TTS
๐Ÿ›ˆ Show source icon (e.g, )
๐Ÿ”ฒ Make platform source icons square
๐Ÿšซ Hide Twitch messages (other sources allowed)
๐Ÿงฏ Hide all stream events
โœ… Only show Twitch messages (no other sources)
๐Ÿ“บ Show channel icon
๐Ÿ”Ž Use a larger channel icon
๐Ÿ“บ Show originating channel name
๐Ÿ†” Hide avatars
๐Ÿšซ๐Ÿ‘ค No placeholder avatars
๐Ÿ”ฐ Hide badges
๐Ÿ’ธ Hide messages with donations
๐Ÿ’ธ Strip out donations
๐Ÿ’› Hide membership labels
๐Ÿ“ƒ Strip out user sub-titles
๐Ÿ”ค Use first names only
๐Ÿ…ฐ๏ธ Delete names entirely
Use YouTube channel names (WebSocket)
๐Ÿช™ Only show if includes a donation
๐Ÿšซ๐Ÿ”— Replace links in messages with just '[Link]'
Allow links from bots
Allow links from hosts
Allow links from mods
Allow links from VIPs
๐ŸŸข๐Ÿ”— Make URLs in chat clickable links
๐Ÿค๐Ÿ”— Shorten long links ...
๐Ÿ” Align comment to top
โฌ›โžก๏ธโšซ Round edges
๐Ÿ†Ž Reduce font-size if message gets too long
๐Ÿ“› Prefer platform name colors over custom name color
๐ŸŽจ๐Ÿšซ Ignore platform and custom colors

Colors

Font Family
Slide out to the left
Fade in/out instead
Skip follow alerts
Skip subscription/member alerts
Skip donation alerts
Skip bits/cheer alerts
Skip raid/host alerts
Show auction winner alerts (Whatnot/eBay)
Show hype train level alerts (Twitch)
Like alerts

Exclude alert events from dock
When enabled, event messages (follows, subs, raids, etc.) are sent only to the multi-alert overlay and not to dock.html. Normal chat messages are unaffected.
โธ๏ธ Keep illustrated characters still
Flat cards (solid fills, no blur/glow)
โฌœ Corner radius 7px
Color alerts by platform instead of alert type
By default, each alert type keeps its own color. Enable platform colors to use each source platform's standard color across every alert from that platform. The remaining options apply on top of every preset.
Use &sources=youtubeshorts to limit by platform, or &sourceids=My Channel,UC123,video123 to limit by existing source/channel fields like sourceName, sourceId, channelId, or videoId.
Compact alert cards
Center align alert box
Right align alert box
Top align alert box
Vertically center alert box
๐Ÿ” Scale multiplier 1.00x
๐Ÿ”  Headline size 1.00x
๐Ÿ”Ž Detail text size 1.00x
๐Ÿ–ผ๏ธ Gift / media size 1.00x
Hide avatars
Hide GIF / media attachments
Place platform badge beside alert title
Hide source badges
Hide alert title
Hide message text
Hide progress bar
Hide subtitle row
Hide amount / value pills
Force transparent background (Useful for standalone pop-out overlays)
Solid page background
Green page background
Play alert sound

Choose a sound to enable audio. Listen previews it locally.

๐Ÿ”‰ Sound volume 35%
Per-type custom sounds (override above)
โฒ๏ธ Show each alert for ms
โณ Cooldown between alerts ms
Queue overlapping alerts
Debug mode (console logs)
Local preview ? ๐Ÿ“– Preview help

๐Ÿ› ๏ธ Global settings and tools

Global settings affect every overlay and source, including stream events, filters, highlights, and source behavior.
Override Twitch event wording from the selected language. Leave a field blank to use the translated default. Supported placeholders are shown in each label.
Use SDK transport (beta)
When enabled, background uses the Ninja SDK instead of a hidden iframe. You can also enable via URL with &sdk or &beta.

Opt-in options

These services require you to manually opt-in, for security purposes

Capture WhatsApp chat
Capture Telegram chat
Capture Instagram non-live comment
Capture Slack chat
Capture Teams chat
Capture Google Meet chat
Capture Chime chat
Enable X (Twitter) embedded page features
Capture OpenAI chat
Capture Discord chat

Opt-out options

Disable chat services or filter by specific channels

Disable YouTube chat
Disable Kick chat
Disable Riverside

*Note: These opt-out options don't disable sending messages to Youtube / Twitch; just capture

Miscellaneous options for sites

Features, tools, and other odd-ball enhancements

๐ŸŒŸ Automatically collect Twitch channel points
๐Ÿ”‡ Automatically mute Twitch video ads
๐Ÿ…ฐ๏ธ Announce when an ad plays/stops in Twitch
Use Twitter branding instead of X
๐Ÿคทโ€โ™‚๏ธ Do not auto-select Live Chat in YouTube Popout
๐Ÿ”ค Larger font for Youtube Popout chat
Disable YouTube Popout auto-scroll keeper
๐Ÿงช Streamlabs: only Cloudbot/Merch/Tips
๐ŸŽฅ Add view-links to live videos in Discord
Flip the Youtube watch page layout
๐Ÿ”Š Enable YouTube audio output picker (in-page)
Ignore existing Parti chat history (capture only new messages)
Experimental: Scout Kick chatroom IDs while browsing
Hide "Paid Promotion" banners in Youtube
Hide stream events (follows, likes, subs)
Show Twitch Watch Streaks
๐Ÿšซ๐Ÿ—„๏ธ Disable the local message database Chat history guide
๐Ÿ†• First-time chatter detection
🌿 Mark first-time chatters with a custom badge
๐Ÿ””๐Ÿ‘‹ Beep for new or returning chatters (8h+ quiet)
๐Ÿคฏ Override the DB's 30-day storage limit
๐Ÿ“ผ Replay Messages - Replay chat messages from the database as if they were live
๐Ÿšซ๐Ÿ”— Do not post links into TikTok's chat
๐Ÿšช Capture "joined" stream events
Show individual likes in main chat/events.
Send platform like totals
๐ŸŒน Do NOT treat roses/etc as donations on TikTok
๐Ÿšซ๐Ÿ‘† Disable TikTok keep-alive (prevents focus grab)
Block donos/memberships from Youtube Shorts
Delay Youtube to give mods/bots time to delete
Delay Kick to give mods/bots time to delete
Delay twitch to give mods/bots time to delete
๐Ÿฅต Add BTTV emotes (global+)
๐Ÿ˜ฑ Add 7TV emotes (global+)
๐ŸŒญ Add FFZ emotes (global+)
Identify PluralMind members in Twitch chat (looks up Twitch user ID/username; message matching stays local) via third-party
๐Ÿ‘จโ€๐Ÿ‘ฉโ€๐Ÿ‘งโ€๐Ÿ‘ฆ Add user pronouns (Twitch) via third-party
Show combined Twitch pronouns when available (example: She/They)
๐ŸŒ  Treat Discord roles as Memberships
Only monthly featured messages from a YouTube are marked as a membership
Only Twitch subscription/resub notifications are marked as a membership
๐Ÿ˜ˆ๐Ÿ˜‡ Add sentiment scores to messages
๐Ÿ“ˆ Multiply viewer count by 1.75x

Printer Control

Allow certain sites access to your session ID
๐Ÿš€ Disable relay message throttling
๐Ÿšซ๐Ÿ—จ๏ธ Disable the host chat and block functions
Enable remote API control of extension (required for inbound donation webhooks) Open OBS control dock · setup guide
Enable Dock to use and publish via API server
๐Ÿ“ก Send chat messages to API server (for external listeners)
Experimental/temporary: also send API-routed chat to normal dock/overlay connections
Dock sends its commands to Extension via server
Changing the three Dock/API transport toggles updates generated links only. Reopen active links and replace saved OBS Browser Source URLs after changing them.
๐Ÿ–ฅ๏ธ๐Ÿ’ป P2P connections via LAN only

๐Ÿ“ก Enable video stats polling

Sends event: "video_stats" as generic meta data. The stats URL/key is not sent to overlays.


Enable Streamer.bot websocket support

See the setup guide for step-by-step instructions on creating the required Action in Streamer.bot and finding its Action ID. Leave the password blank if you have not set one in Streamer.bot's WebSocket Server settings.


Use simple Discord webhook formatting
โฉ Relay incoming webhooks

General Settings

Enable loyalty points system
Points per engagement:
Engagement window (minutes):

Commands

Enable !points command
Enable !leaderboard command
Enable !rewards command

Management

Backup & Restore

๐Ÿ’ก Users can spend points through the Event Flow system. Configure custom rewards and actions in the Event Flow editor.
๐Ÿ‘‹ Auto-reply to "hi messages
๐Ÿ™ Announce donations across all chats
๐Ÿ”€ Relay all messages (!NOT RECOMMENDED!)
๐Ÿšซ๐Ÿ”€ Block channel point redemptions from relays
๐ŸŽฏ Pick relay destinations. (None implies all)
Only relay through these SSApp account roles
Do not relay through these SSApp account roles
Send bot replies through these SSApp account roles

๐Ÿ“›๐Ÿ”€ Do not include 'User Said:' with relays"
๐Ÿซ…๐Ÿ”€ Only relay if message is from a 'host'"
๐Ÿฅท Hide relayed reflections of 'hosts'
๐Ÿฅท Hide duplicate messages from 'hosts'
โฉ Forward chat !commands to Twitch
โฉ Forward chat !commands to Kick
โฉ Forward chat !commands to YouTube
๐Ÿคช Tell joke on !joke message
๐ŸŽฒ Respond with a random dice roll on !dice
โ“ Identify questions in chat messages
๐Ÿ”ฆ Mark @host messages as trivial events

Custom JavaScript

โš™๏ธ Enable custom JavaScript

GIFs and stickers ? Powered By GIPHY


Direct .gif links only (query parameters allowed). No API key needed. Images are not content-filtered.

For external GIF links in the dock and featured overlay. Keeps other message text and retains the link if loading fails.
Include a GIF when !giphy is used
Include a GIF when !tenor is used (legacy alias, powered by GIPHY)
Include a GIF when #keyword (GIF) or ##keyword (sticker) is used
Hide the GIF trigger word or sentence
Select random gif from top 10 results
Get a Giphy API key here

Tenor API search has retired. Enter a GIPHY API key above; old Tenor keys cannot be used. Existing !tenor commands use GIPHY when their toggle is enabled.


Trigger webhook URL by a !command

Have custom chat commands poke a custom API endpoint

๐Ÿ“ซ Use POST instead of GET for webhook calls
๐ŸŽฏ Trigger only if full message matches exactly

Send fixed messages at intervals

Specify frequency and starting offset of fixed messages

๐Ÿฆ— Skip auto-message if chat is too quiet

Auto-responder

Auto-respond to custom chat commands
๐ŸŽฏ Trigger only if full message matches exactly


๐ŸŽน Enable MIDI hotkeys

Trigger MIDI note on command

Default Output MIDI Device: MIDI Channel: โš™๏ธ
Enable MIDI hotkeys above to see available devices

Message doubling / echos / duplicates / relayed

If you're using the RELAY ALL function, you might find the following options helpful in controlling for duplicate responses. (I like to call relayed message echos "reflections")


๐Ÿ’ฌ๐Ÿšซ Do not capture / show any of your replies
๐Ÿ’ฌ๐Ÿ’ฌ๐Ÿšซ Hide duplicates; show your first reply only [RELAY]
๐Ÿ’ฌ๐ŸŽฏ Only show your replies from:
๐Ÿ’ฌ๐Ÿ’ฌ๐Ÿšซ Filter out messages that echo / double
โฉ๐Ÿšซ Filter out 3rd-party relayed messages

Other filters

๐Ÿคฌ๐Ÿšซ Replace common swear words with asterixis
๐Ÿคฌ๐Ÿšซ Block messages that contain swear words
๐Ÿ‘ค๐Ÿšซ Replace common bad words in user names
๐Ÿšซ๐Ÿ–ผ๏ธ Remove original content images from messages
๐Ÿ’ฌ๐Ÿšซ Exclude 'Replying to @user' from replies
๐Ÿ‘ผโœ… Allow only approved words
๐Ÿ‘ธ Filter out messages from non-members
โ—๐Ÿ’ฌ Filter out messages starting with: !
๐Ÿ“ค Strip HTML/images from messages and donations
๐Ÿ˜€๐Ÿšซ Keep only emotes; discard empty results
๐ŸŒˆ๐ŸŽฏ Set username color to match the site's branding
๐ŸŒˆ Featured messages have their background color match their source branding color
๐ŸŒˆ๐Ÿ‘ค Add a random color to uncolored names
Note: This needs to be used in conjunction with &color
๐ŸŒˆ๐ŸŒˆ Override all name colors with a random color
๐Ÿ“›๐Ÿ”ฐ Do not color names based on member status
โ˜€๏ธ Lighten and desaturate name colors
๐Ÿ“› Remove commonly unwanted badges

Blocked / Allowed Users:

Source type can be something like 'twitch', 'kick', or 'youtube'

๐Ÿค Show only the specified users (approved list)
๐Ÿ”ฎ Blocked users โ€” remove a username to unblock that user

Assign roles/classes to certain users

Source type can be something like 'twitch', 'kick', or 'youtube'

๐Ÿค– Identify by name who are bots
๐Ÿ‘ฉโ€๐Ÿซ Identify by name who are mods
โญ Identify by name who are VIPs

User display names

Show a preferred name in docks and overlays without changing the original message identity.

๐Ÿ‘‘ Privileged (admin) users
๐Ÿ•บ Identify the hosts' name

๐Ÿค–๐Ÿ”ค Delete names for specified bots
๐Ÿค–๐Ÿšซ Filter out messages for listed bots
๐Ÿ™๐Ÿšซ Filter out messages for listed hosts
๐Ÿค–๐Ÿšซ Hide moderator messages
@๐Ÿšซ Remove @ from display names

๐Ÿ’ฌ๐Ÿ—จ๏ธ Auto open all chat windows on dock connect or refresh

Usage examples
1. To open your chat pop-up(s) on start your OBS program, if you open/refresh the streaming chat as an OBS dock.
Note : This will not work for YouTube in this case, since you should first be live to Youtube to for there to be a chat link.
2. When you are away from your streaming PC and wants to open your chat pop-up(s), if you open/refresh the streaming chat with another PC or smartphone.

YouTube API

Opened in new tab







Opened in new window

Note: Do NOT minimize them!

Custom

Open custom URL 1 on new window
Open custom URL 2 on new window
Open custom URL 3 on new window
Open custom URL 4 on new window
Open custom URL 5 on new window
Open custom URL 6 on new window
Open custom URL 7 on new window
Open custom URL 8 on new window
Open custom URL 9 on new window

Save current settings as profile

Save all your current settings as a profile for easy switching

Manage profiles

Switch between your saved profiles

Save the last message to a file

An alterative method of saving the last message
No file selected

๐Ÿ“Š Save live stats snapshot to a file

Continuously save current viewers, likes, followers, subscribers, title, and live status by platform
No file selected

Save all messages to ๐Ÿ“— Excel file

An alterative method of saving all messages

Save all names seen in chat to a simple file

Just a unique list of names seen in chat; no messages
No file selected

Reset all settings to defaults

Make sure to export your settings first or lose them

Export/import settings

Backup and load your extension settings.

If using Brave, enable the File System API first to allow saving:
`brave://flags/#file-system-access-api`
๐Ÿ’€โ˜ ๏ธ PLEASE DO NOT CHANGE YOUR SESSION ID ๐Ÿ’€โ˜ ๏ธ
...unless you know exactly what you are doing.

Changing you session ID may break things

Set a password

It's okay to set a custom password.

Hide your links

๐Ÿ‘๏ธ๐Ÿ”— Obscure your links in this menu
Better safe than sorry.

Chat Bots and AI services

Using this section requires a bot service to be made available.

You can install one for free with Ollama: Installation Guide Here

Configure LLM API ๐Ÿฆ™

Ollama uses its own native API. For llama.cpp, LM Studio, vLLM, or other OpenAI-compatible servers, choose Custom API.
โฑ๏ธ Keep-alive model time (minutes)

Need help connecting a provider? Open the AI chat bot setup and troubleshooting guide.

🌐 Auto Translate

Enable auto translate
Translate outgoing messages before sending
Drop messages when translation fails or cannot keep up
Include context (AI provider only)
Translation timeout ms

Chat bot ๐Ÿค–๐Ÿ’ฌ

This bot has access to the live streaming chat and can either respond to users in chat or respond its own special chat overlay
Primary bot setup, safe testing, and troubleshooting guide

๐Ÿšฆ Enable the LLM AI chat bot

๐Ÿน Bot replies ONLY go to the bot overlay page
๐Ÿ“› Do not include the bot's name when responding
๐Ÿ—ฃ๏ธ๐Ÿ—ฃ Do not screen out any of the bot's replies
๐Ÿข Rate limit for responses per tab / source ms
Max parallel bot replies
๐Ÿ“ˆ Include chat summaries to chat bot
๐Ÿšซ๐Ÿ—„๏ธ Do not include past message context
๐Ÿ“ƒ Number of past user messages to include:
๐Ÿ“” Include detailed timestamps in the chat history
๐Ÿฅจ Include bot's replies with user's chat history
๐Ÿ“” Users can trigger an AI chat !summary
๐Ÿ‘ฉโ€๐Ÿซ Will respond to Moderators only
๐Ÿค–โ†ฉ๏ธ Allow replies to host reflections

๐Ÿค– Chat Bot - Primary

The overlay page for the chat bot is optional. While it can be used to show messages from the bot, and offers TTS support, you do not need it open to have the bot respond to users in chat, for example.

Enable Text to Speech

๐Ÿ—ฃ๏ธ Enable TTS for the chat bot Note: Text to Speech for the chat bot requires the bot's overlay page to be opened

TTS Behaviours

๐Ÿ—ฃ๏ธ Read out URLs rather than saying "link".
๐Ÿšซ๐Ÿ—ฃ๏ธ Do not say "says" or "The bot says" with TTS

More bot overlay page options

โฒ๏ธ Auto-hide after ms
๐Ÿ—ฃ๏ธ Hide after TTS finishes
๐Ÿ“ Auto-hide based on reply length
Minimum length-based time ms
Maximum length-based time ms
If multiple hide modes are enabled, Hide after TTS takes priority, followed by reply length, then the fixed time.
โฉ Send TTS as PCM audio to 127.0.0.1:5000 instead
๐Ÿ”‰ Volume of speech

Text-to-Speech Service Provider

Local: speech runs on your computer; models may download first. Many languages: choose a matching voice or model. Online free tiers have usage limits.

Turn off for message-only speech.

Built-in System TTS Options

note: the free built-in TTS plays out via the default audio device. [LEARN MORE HERE]

โฉ Speaking rate
๐ŸŽต Pitch

Censor bot options ๐Ÿค–๐Ÿšซ๐Ÿคฌ

Reviews incoming chat without replying. Choose the main AI model or a local model just for censoring.


๐Ÿšฆ
๐Ÿคš

Standalone one-on-one chat bot

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.
Do not save chat history


๐Ÿ’ฌ Enable private chat bot option

๐Ÿง  AI prompt page builder

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

โœจ AI Event Overlay

Custom layouts for featured messages and Event Flow. Setup guide

AI Event Overlay

A virtual co-host that can listen and talk back

The co-host can listen through the microphone you choose and respond by text or audio. Gemini and supported multimodal LLMs can also use a selected screen or webcam; OpenAI Realtime currently uses microphone and live-chat context only.

Voice input: OpenAI Realtime uses WebRTC and a short-lived client secret created from the ChatGPT API key configured above; the standard key never enters the co-host page. SSN Desktop can use local Whisper for text-response providers (about a 42 MB first-use download, then offline). Chrome Speech Recognition may be used as a fallback for other providers.

With a session link, it can also receive the SSN live chat feed. OpenAI Realtime defaults to keeping recent chat as silent context until you ask about it; automatic modes speak replies but do not post them into platform chat.

OpenAI Realtime uses the private capability in the popup-generated co-host link; it does not require the separate Private Chat Bot option.

AI co-host guide

OpenAI Realtime can optionally control Spotify, approved OBS scenes, and the featured chat overlay. SSN Configured LLM currently supports Spotify only. Each tool is blocked unless enabled here and armed on the co-host page.

Co-host tool permissions

Spotify controls Allow the co-host to pause, resume, skip, queue, and check songs when Spotify is enabled and connected.
OBS scene controls Allow the co-host to switch only the OBS scenes listed below.
Featured chat controls Allow the co-host to feature a recent message or clear the featured overlay.

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

🎭 AI stage overlay

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
Hide stage when idle
Hide speech bubble
Position
Scale

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

Feed style
Event overlay guide and gallery
Choose which events appear
๐Ÿ’ฐ Only show donations (hide other events)
๐Ÿ‘‘ Only show gift subs
๐Ÿค‘ Hide donations under $5
Category details and filter combinations

Sources to Monitor

Social Stream Event Reference
Row contents and behavior
Display and timed-removal options
๐Ÿ’ต Show USD conversion for all donations
โœจ Highlight high-value donations
๐Ÿ‘€ Show viewer count bar in the top-right
๐Ÿ—‚๏ธ Hide metadata details under messages
๐Ÿ•˜ Hide timestamp
Layout and motion
Maximum events to display:
Customize feed appearance
โ˜€๏ธ Use light theme instead of dark
Transparent background
๐Ÿ” Scale 1.00x
Feed styles and URL options
๐ŸŽจ Custom viewer bar background color
note: Install custom fonts on your system (Windows: right-click .ttf/.otf โ†’ Install, then restart browser). Font detector & help
History and operator controls

Release Area

๐Ÿ“ Align reactions to
๐Ÿช„ Layout style
Spawn reactions from the center
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
Every enabled control here is added to the reactions.html URL as a matching parameter.
๐Ÿ‘ฏ๐Ÿšซ Filter out duplicate emotes per message
๐Ÿ”ข Limit emotes shown:
๐ŸŽ‰ Minimum emotes per message:
โณ Show messages for 20s, rather than 5s.
โฉ Double the emotes' movement speed
๐Ÿ” Emoji scale 1.00x
Transparent background
Dark mode
Light mode
๐ŸŽจ Custom page background color
๐Ÿ‘‘ Only show emojis from members (paid subs)
๐Ÿ—ฃ๐Ÿšซ๏ธ Exclude message @replies emojies
๐Ÿค–๐Ÿšซ Hide emotes from bots
๐ŸŽˆ Emotes float up, rather than bounce around

Chat activity tracking

๐Ÿšฆ Track active chatters

Other customization options

โžก๏ธ Align overlay to the right-side
โ†”๏ธ Align overlay to the center
๐Ÿ‘๏ธ Show only viewer counts
๐Ÿ’ฌ Show only active chatters
๐ŸŽจ Custom viewer bar background color
๐ŸŽจ Custom page background color
๐Ÿ”ณ Disable text outlining
๐Ÿ” Scale multiplier 1.00x
โญ• Force transparent background (OBS Browser Source is already transparent by default)
๐Ÿ‘ป Page opacity 0.30
๐Ÿงน Do not show the title "current viewer count"
Dark mode
โšช Light mode - Black text, white outline
Font Family
note: Install custom fonts on your system (Windows: right-click .ttf/.otf → Install, then restart browser). Font detector & help

Source Combination Options

๐Ÿ”„ Combine YouTube and YouTube Shorts
๐Ÿ”„ Combine all sources into one global count

๐Ÿš‚ 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

Event Type Filters

๐Ÿ”จ Show auction updates
๐Ÿ›๏ธ Show commerce/catalog updates
๐Ÿ‘๏ธ Show viewer updates
Show Hype Train progress bar
๐Ÿงฉ Show other/debug meta events
Includes miscellaneous fields like index/profile data from non-auction meta payloads.

Display Controls

๐Ÿ™ˆ Hide icons
๐Ÿ™Š Hide labels
๐Ÿ™‰ Hide values
Align right
Align center
๐Ÿ“ Compact spacing
๐Ÿงน Hide auction extra fields (seller/category/shipping/tags/action/source)
๐Ÿงน Hide commerce extra fields (navigation/live/upcoming breakdowns)
๐Ÿ‘๏ธ Hide per-platform viewer rows (keep total only)
๐Ÿ› ๏ธ Hide technical/debug fields (index/profile/url/source-mode/image)
๐Ÿงน Hide header title


Layout and Appearance

๐Ÿ” Scale multiplier 1.00x
๐Ÿ‘ป Panel opacity 1.00
๐Ÿงผ Transparent chip backgrounds
๐Ÿ”ณ Disable text outlining
๐ŸŽจ Custom page background color

๐Ÿ”ง General Options

โžก๏ธ Align overlay to the right-side
๐Ÿ’พ Keep amount between sessions
๐Ÿ”Š Play sound on donation
๐ŸŽ›๏ธ Show control panel

๐Ÿ† Hype Cup Options

๐Ÿ† Count memberships, subscriptions, and donations as points
๐Ÿ’œ Follower goal (count new followers/subscribers)
Exclude from Hype scoring:
Donations and paid messages
New memberships and subscriptions
Renewals and resubscriptions
Gifted memberships and subscriptions
๐ŸŽ Count individual gift recipients too
โž• Carry extra points after completion
๐Ÿ™ˆ Hide completion count

๐ŸŽจ Style and Theme

Item that drops into the Jar and the physical jar styles.
Sticker text on the Glass Tip Jar, up to 12 characters.
๐Ÿ–ผ๏ธ Preview styles Uses sample totals without sending donations to your overlays.
โœจ Refresh classic styles Leave off to keep the original sizing, colors, and animation.
Hide dollar signs Only changes the goal display; amounts and donation units stay the same.

๐ŸŽฏ Goal Settings

Count goals take priority over Hype scoring.
Keep total and advance target after each goal
Exclude YouTube gifted memberships

๐Ÿ“Š Goal Bar Style

Hide title
Disable liquid animation
Stop jar rotation
Hide donation popups
Reset completed goals
Keep total after hype goals
Fluid Goal Bar: only show the bar, with text inside

Test Donations

Sends a fake donation to connected overlays.
Tip Jar and Goal Meter guide
๐Ÿ”‰ Media Volume 1.00
โฑ๏ธ Default media duration (ms)
๐Ÿ” Show OBS connection status badge on overlay
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

Text-to-Speech Service Provider

Local: speech runs on your computer; models may download first. Many languages: choose a matching voice or model. Online free tiers have usage limits.

Built-in System TTS Options

note: the free built-in TTS plays out via the default audio device.

โฉ Speaking rate
๐ŸŽต Pitch
๐Ÿ’ก Configure TTS settings for the Flow Actions overlay. API keys are stored locally and added to the overlay URL.

Entry setup

Only members can enter
Allow repeat winners

One free entry per viewer. Rules lock after the first entry; new rounds keep past winners in history.

Run giveaway

Announce in chat

Select Refresh status to check the current pool.

How to run your first giveaway Giveaway, points and recovery guide

Presentation

Advanced and integrations

Keep SSN running: the host owns the pool, so all open giveaway displays show the same result. Saved rounds remain after restarting SSN, with entries closed for review. Each session has its own giveaways. Preview uses sample names only.

API / Stream Deck actions: startgiveaway, closegiveaway, drawgiveaway, resetgiveaway, getgiveawaystate.

Giveaway setup and API guide · Existing Wait List / Winner Draw

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

Products & support links
Connected platforms
OBS overlays
Breaks

General Game Settings

๐ŸŸข Green screen background
โšซ Dark mode
Style preset

Timer mode

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

Spotify Setup & Configuration

Enable Spotify integration

Need to create a Spotify app? Open Spotify Dashboard โ†’

Input

Overlay input

Appearance

Style preset
Compact layout
Show Spotify request queue

Visibility toggles

Hide when paused
Hide when no song is playing
Hide when no song is active
Hide album art
Hide album title
Hide progress bar + timestamps
Hide device details
Hide status badge

Spotify Announcements

Now Playing Features

Polling interval (seconds): (3-60 seconds)
Announce new tracks in overlays (not sent to platform chat)

Spotify Chat Commands

Configure which Spotify commands are available and who can use them.

Use managed queue for song requests (enables !revoke)

Spotify does not allow removing items from its queue. Managed queue keeps only one request inside Spotify at a time so !revoke can work on pending requests.

๐Ÿ“‹ Info Commands
Show current track
Alias for !song
๐ŸŽฎ Playback Control
Skip to next track
Go to previous track
Pause playback
Resume playback
Set volume (0-100)
๐Ÿ“ Queue Commands
Add song to queue
Song request (alias)
Remove your last request

๐Ÿ’ก Note: Hosts and admins can always use all commands regardless of permission settings.

๐Ÿงฐ More free resources

Ready-made overlays that don't need a session. Pick one, customize it, and paste the link into OBS.


Terms of Service | Privacy Policy | YouTube's Terms of Service

Buy Me A Coffee

Visit us at Discord
Made with ๐Ÿ’– for the community.