A zero-install, browser-only chat overlay for Kick.com streamers
Drop a URL into your broadcasting software's browser source β get live chat, badges, 7TV emotes, pinned messages, stacking alerts, and moderation visibility on stream. No backend. No accounts. No build step.
- Highlights
- Screenshots
- Quick start
- Features
- Why chat-dock?
- FAQ β Integrating with your streaming software
- How do I add it to OBS Studio?
- How do I add it to Meld Studio?
- Can I use it with Streamlabs Desktop / XSplit / vMix?
- How do I use it while streaming from my iPhone?
- How do I use it while streaming from Android?
- Why isn't an alert firing for sub/gift/raid events on my channel?
- Can I change the look of the alerts / chat?
- Does it support Twitch?
- Project layout
- Documentation
- Roadmap
- Known issues
- Contributing
- License
π Drop-in URL β point
?kick=<channel>at any Kick streamer; no per-user config.π‘οΈ Moderation visibility β AI-mod, manual delete, timeouts, and bans get distinct color-coded tags so you see what got nuked instead of messages silently vanishing.
π¨ Compact zebra chat + marquee alerts styled to feel native to Kick, not bolted on.
| Live chat β compact zebra rows, mod messages highlighted | Stacking marquee alerts above chat |
|---|---|
![]() |
![]() |
Moderation visibility β every action gets its own tag (AI MOD, TIMED OUT, BANNED, DELETED) plus a stacking alert at the top:
The setup screen rendered when no ?kick= channel is supplied:
The fastest path is GitHub Pages (instructions below) β you get a public HTTPS URL for free in about two minutes. If you'd rather not host it at all, you can also open index.html straight from disk:
file:///path/to/chat-dock/index.html?kick=yourchannelname
If you open the page without ?kick=, you'll get a setup screen telling you what's missing.
GitHub will host this overlay on a free *.github.io subdomain at no cost β perfect for OBS / Meld / vMix browser sources because you get a stable HTTPS URL with no install or backend.
-
Fork this repo on GitHub (top-right Fork button). You'll end up with
https://github.com/<your-username>/chat-dock. -
In your fork, go to Settings β Pages (left sidebar).
-
Under Build and deployment β Source, pick Deploy from a branch.
-
Under Branch, pick
mainand folder/ (root), then click Save. -
Wait ~1β2 minutes. Refresh the Pages settings page β you'll see a green banner with your live URL:
https://<your-username>.github.io/chat-dock/ -
Append
?kick=<your-channel-name>and you're done:https://<your-username>.github.io/chat-dock/?kick=yourchannelname -
Paste that URL into OBS / Meld / Streamlabs as a Browser Source (see the FAQ).
π‘ Updating the overlay: every time you push (or sync your fork from upstream), GitHub Pages auto-rebuilds within a minute. No deploy step.
π‘ Custom domain: if you own a domain, you can point it at your GitHub Pages site via Settings β Pages β Custom domain. Same overlay, your own URL.
β οΈ Repo must be public for GitHub Pages on a free GitHub account. If you want the source private, you'll need GitHub Pro or a different static host (Netlify, Cloudflare Pages, Vercel β all free tiers also work, same drag-and-drop flow).
| Param | Default | What it does |
|---|---|---|
kick |
(required) | Your Kick.com channel name, lowercase, no @. |
minKicks |
0 |
Minimum Kicks-tip amount that fires an on-screen alert. Set higher to suppress small tips. Example: &minKicks=100. |
fade |
off |
Set to on to fade old messages out as they're trimmed. |
fadeTime |
1000 |
Fade duration in ms (used when fade=on). |
Full URL example:
https://your-host.example/chat-dock/index.html?kick=yourchannelname&minKicks=50&fade=on
Chat rendering
- Live chat via Kick's public Pusher WebSocket β no auth, no API key.
- Compact single-line zebra-striped rows so dense chat stays readable.
- 7TV emotes β your channel set and the global set.
- Kick's native emotes & emojis, plus auto-linkification of URLs.
- Pinned messages with a thumbtack icon; auto-removed when the streamer un-pins.
Badges & identity
- Subscriber tiers (uses your channel's actual sub-badge tiers from the Kick API).
- Moderator, VIP, founder, verified, staff, OG.
- Tiered sub-gifter icons (1-24, 25-49, 50-99, 100-199, 200+).
- Kick staff get a distinctive magenta username so you notice when an official Kick employee is in chat.
- Mods get a cyan-highlighted row + accent border so the streamer sees a real human mod typing.
Moderation visibility (new)
- π΄
DELETEDβ manual mod or streamer delete - π£
AI MODβ Kick's AutoMod removed the message - π
TIMED OUTβ user was timed out; affected messages get tagged - π₯
BANNEDβ user was permanently banned - Tagged messages linger for 10 seconds (strikethrough + red tint + reason tag) before they leave the DOM β no more "wait, what just disappeared?"
- Stacking alert fires for every ban and timeout, showing the moderator's name and duration.
Stacking alerts at the top of the overlay for:
- π£ New subscriptions (and resubs with month count)
- πΈ Gifted subs (single or bulk)
- π’ Raids / hosts (with incoming viewer count)
- π‘ Kicks tips (with configurable minimum threshold)
- π΅ Front-page features (when your channel gets featured)
- π΄ Bans & timeouts (with moderator name)
Alerts marquee right-to-left like Kick's native ticker, stack when multiple events arrive close together, and fade after ~12 seconds.
Reliability & polish
- Auto-reconnect β a dropped WebSocket retries with exponential backoff (1s β 15s, reset once chat resubscribes); you never need to refresh the browser source.
- Hidden scrollbar so the overlay stays clean even when chat is mid-flight.
!nightmode/!daymodechat command (moderator or broadcaster only).- Graceful badge fallback chain β unknown badge types fall back to a generic SVG instead of broken-image icons.
| chat-dock | StreamElements / Streamlabs widgets | A custom Node app | |
|---|---|---|---|
| Works with Kick.com | β | β (Twitch/YouTube focus) | Whatever you build |
| Zero install / zero account | β | β requires login + widget setup | β |
| Free public HTTPS hosting | β via GitHub Pages | β but locked to their domain | DIY |
| 7TV emotes out of the box | β | β | DIY |
| Stackable alerts for subs/gifts/raids/Kicks tips | β | Partial | DIY |
| Moderation visibility (AI mod / ban / timeout tags) | β | β | DIY |
| Customise via CSS variables | β | Limited | β |
| Total bytes shipped | ~30 KB | several MB | Whatever you ship |
If you stream on Kick and want a polished overlay without spinning up infrastructure or signing up for yet another SaaS, chat-dock is the path of least resistance.
- In your scene, click + in the Sources panel β Browser.
- Name it "Chat Dock" and click OK.
- In the source properties:
- URL: point at where you're hosting
index.html, with?kick=yourchannelname(and&minKicks=β¦if you want).- Hosted: e.g.
https://yourname.github.io/chat-dock/?kick=you(see Host it for free on GitHub Pages) - Local file: drop the full
file:///path, or use OBS's "Local File" checkbox and browse toindex.html, then put?kick=youin the URL bar that appears.
- Hosted: e.g.
- Width / Height: match the region of the screen you want chat to occupy (e.g.
400 Γ 800for a vertical sidebar). - Custom CSS: leave blank β
style.cssalready handles everything. If you want to override, seedocs/design-guidelines.md. - Refresh browser when scene becomes active: β recommended. Forces a clean WebSocket connect every time you switch to the scene.
- Shutdown source when not visible: β optional. Saves resources when the overlay isn't on screen.
- URL: point at where you're hosting
- Position and resize the source in your scene. Done.
If chat doesn't appear, open OBS's View β Docks β Browser Source Interaction, or hit the source's "Refresh cache of current page" button. Browser console output (visible via the Interact panel's right-click β Inspect on Windows OBS) will tell you whether the WebSocket connected.
Meld Studio supports web overlays through its Web Source layer.
- In Meld, add a new Web Source to your scene.
- Paste in the same URL you'd use for OBS, including
?kick=yourchannelname. - Set the source dimensions to match the overlay region you want.
- Pin the source on top of your camera / game layer.
Meld's Web Source uses a Chromium engine identical (in capability) to OBS's browser source, so the overlay behaves the same way β alerts, emotes, and WebSocket reconnection all work without changes.
Meld doesn't expose a "refresh on scene activate" toggle in the same place OBS does. If your overlay ever desyncs, simply right-click the Web Source β Reload.
Yes. They all expose a browser-source equivalent:
- Streamlabs Desktop β Sources β Browser Source. Identical flow to OBS.
- XSplit Broadcaster β Add source β Webpage. Set the URL with
?kick=. - vMix β Add input β Web Browser. Set the URL with
?kick=. For vMix, tick "Use OpenGL" if alerts animate jerkily.
This is the tricky one. Mobile streaming apps generally don't have a "browser source" concept, because the overlay is rendered into the broadcast on-device.
You have three realistic options, ordered by quality:
Option A β Stream from your phone, composite the overlay on a desktop relay (best quality).
- Stream from the iPhone using an app like Larix Broadcaster or Prism Live Studio configured to send RTMP to a local PC running an RTMP server (NGINX-RTMP, OBS Studio's built-in RTMP listener via the WHIP plugin, or Restream).
- On the PC, pull that RTMP into OBS as a Media Source (URL).
- Add chat-dock as a Browser Source in OBS on top of the camera feed.
- Stream the composited result from OBS to Kick.
This adds 2-4 seconds of latency but gives you the full overlay quality.
Option B β Camera-link app + desktop OBS (lowest latency).
Use Camo or EpocCam to expose the iPhone's camera as a webcam to your PC. Then build the whole stream in desktop OBS with chat-dock as a browser source. The phone is just a camera, not the encoder.
Option C β Screen recording on a second device (poor person's overlay).
Open index.html?kick=you on a tablet or second phone. Use a small mobile-friendly window. In Streamlabs Mobile / Prism Live, add the tablet's HDMI output (via a USB capture adapter) as a video source. Crop down to just the chat region. Works, but adds hardware cost.
β οΈ The Kick mobile apps themselves do not support custom overlays. The overlay is something you composite before you hit "go live."
Same three options as iPhone. The recommended path is still a desktop relay because Android mobile streaming apps share the same limitation β no browser source.
Android-specific notes:
- Prism Live Studio has the most flexible overlay support of any mobile app, but it expects PNG/GIF overlays, not live web content. You'd need to "fake" chat-dock by piping it through a desktop OBS instance and re-encoding.
- Streamlabs Mobile lets you composite Streamlabs widgets, but custom HTML/JS browser sources aren't accepted. chat-dock is a custom browser source, so this won't work directly.
- Mobcrush / OmletArcade β chat-dock isn't natively supported. Same desktop-relay workaround applies.
If you stream from Android, the most popular setup is: phone β USB capture β laptop running OBS β laptop streams to Kick. chat-dock then slots into the laptop's OBS exactly like a desktop streamer.
Kick's WebSocket event names aren't officially documented and occasionally shift. chat-dock listens for the best-known names and logs everything it doesn't recognise to the browser console as Unknown event: <name>. To investigate:
- Open the browser source's DevTools (in OBS: right-click the source β Interact, then F12 / right-click β Inspect on Windows).
- Trigger the event (have a friend gift a sub, or wait for one in the wild).
- Look for
Unknown event: ...in the console. - Copy that event name into the matching
if (messageData.event === "...")branch injs/ws.js.
This is a known limitation of building on an unofficial WebSocket β flagged in docs/system-architecture.md.
Yes. All styling lives in css/style.css. Look for the --font-*, --chat-*, and --transparent-color CSS variables near the top, plus the .alert, .alert-subscription, .alert-gift, .alert-raid, .alert-kicks, and .alert-moderation rules further down. See docs/design-guidelines.md.
No β Kick.com only. The WebSocket endpoint, badge schema, and emote API are all Kick-specific.
chat-dock/
βββ index.html # Entry β loads CSS + 4 ES modules
βββ css/
β βββ style.css # Base styles, CSS variables, alert styling
β βββ night.css # Night-theme overrides (loaded by default)
βββ js/
β βββ alerts.js # Stacking alert UI + setup screen
β βββ ws.js # Kick WebSocket + REST channel lookup + event router
β βββ chat.js # DOM rendering for messages, badges, pins
β βββ 7tv.js # 7TV emote-set fetcher
βββ assets/ # Badge SVGs + screenshots + pin icon
| Doc | Purpose |
|---|---|
| Project overview / PDR | Goals, scope, constraints |
| Codebase summary | File-by-file inventory |
| System architecture | Module graph, data flow, Mermaid diagrams |
| Code standards | Conventions used in this repo |
| Design guidelines | Visual styling and CSS structure |
| Configuration guide | URL params, CSS variables, theme switching |
| Changelog | Notable commits |
Open ideas β PRs welcome:
- Make alert duration / marquee speed configurable via URL params
- Optional polls / prediction overlays (Kick is rolling these out)
- Channel-points / loyalty-reward redemption alerts
- Theme presets you can pick via
?theme= - First-class Twitch backend (separate file, same overlay layer)
- Kick's WebSocket event names for subscriptions, gifts, raids, Kicks tips, and front-page features are not officially documented. The handlers in
js/ws.jsuse best-guess names; if an alert never fires, check the browser console forUnknown event:lines and copy that event name into the matching handler. - AI-mod vs. manual-delete detection on
MessageDeletedEventis a heuristic (we readdeleted_bywhen present and fall back to "AI MOD"). If you see the wrong tag in the wild, check the raw event in DevTools and tighten the check injs/ws.js.
Found a bug? Got a Kick event name we're missing? PRs and issues welcome. The codebase is intentionally small β four ES modules, no bundler, no framework β so it should be easy to drop in.
If you're using chat-dock in production and like it, a GitHub star is the cheapest way to let me know. π
No license file is committed. Treat as "all rights reserved" until the owner adds one.



