Skip to content

About

Every stream chat in one window for OBS, Streamlabs, vMix, XSplit or Meld, on Windows, Mac and Linux: read and reply to Twitch, YouTube, Kick, X, TikTok, Facebook, Instagram and Rumble; moderate 5 of them. On-stream chat, alerts, viewer counts, custom logos, read-aloud, Discord posts, phone companion. Signed installer. Runs on your PC, no account.

Topics

Resources

Security policy

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

CrossChat: every stream chat in one window. Reply everywhere. Theme it on stream.

Latest release Chrome Web Store Downloads Checks Windows 10 and 11 macOS 15 and 26, tested on Intel and Apple-silicon Macs Linux: tested on Ubuntu 24.04 and 25.10 Tested with OBS Studio 33.0.1 License: MIT Sponsor on GitHub Donate with PayPal

CrossChat is a free companion for OBS Studio, Streamlabs Desktop or any other streaming app when you stream to several platforms at once. It reads Twitch, YouTube, Kick, X, TikTok, Facebook, Instagram and Rumble chat into one window, lets you answer everyone with one message (or one person on their own platform), moderates Twitch, YouTube, Kick and Rumble (and deletes Facebook comments), puts themeable chat, featured messages, viewer counts and alerts on your stream, and starts and ends your X livestream together with OBS. Pair your phone or another PC to read, answer and moderate chat from there. Everything runs on your own PC and home network.

CrossChat in action: a question from YouTube is put on stream, then one reply goes out to Twitch, YouTube and X at once
Left: what viewers see. Right: your CrossChat window. Made-up chat from the built-in demo. ▶ Watch the full 48-second tour (MP4)

Features

One chat window for every platform

  • Twitch, YouTube, Kick, X, TikTok LIVE, Facebook Live, Instagram Live and Rumble chat in one list, each line tagged with where it came from.
  • Viewer counts per platform and in total.
  • Subs, raids, cheers, Super Chats, memberships, Rumble Rants and TikTok gifts, follows and shares are marked in the list.
  • Viewer cards: click a name to see their messages this stream and in earlier streams, and act on them.
  • Deleted messages and timed-out viewers are struck through.
  • 7TV, BetterTTV and FrankerFaceZ emotes, as well as each platform's own.
  • First-time chatters stand out, and each platform's connection health is a glance away.
  • Filters hide words, viewers, chat commands and bots from your stream without deleting anything.
  • Read chat aloud: questions, everything, alerts or a !tts command, with your computer's own voices.
  • Chat history: every stream kept on your PC for 90 days, to search and export as CSV or HTML.
  • Light, dark, or follows Windows.
  • Opens by itself when your stream starts, and closes two minutes after you stop.

Reply and moderate from one place

  • Type once to post to every live platform, as you.
  • Use only: to post to a single platform, or open a message and press reply to answer that person on their own platform. On Twitch that's a threaded reply.
  • Quick replies: one-tap lines and emoji you edit yourself.
  • Moderation: delete a message, time out or ban, on Twitch, YouTube and Kick; delete or mute on Rumble; delete comments on Facebook.
  • Answer later: star messages to come back to. Questions are picked out for you.
  • Twitch and Kick through their official APIs. Connect once in Settings.
  • YouTube, X, TikTok, Facebook, Instagram and Rumble go out through your signed-in browser and the CrossChat extension.
  • Test mode (?dry) walks through the whole path without posting anything.

Companion on your phone or another PC

  • Pair with a QR code (phone) or a link and a 6-digit code (another PC's browser). The full chat app then runs on any phone, tablet or PC on your home network, with no install and no logins on that device. A second PC can give it its own app window.
  • Read, reply, use quick replies, moderate, star, put messages on stream, and send test alerts.
  • Only paired devices get in, and you can remove one at any time. See docs/COMPANION.md.
  • Away from home too, with Tailscale: one switch in Settings, pairing still required.

Discord

  • Post to a channel of your Discord server while you're live: a going-live notice with your channel links, the messages you show on stream, or all chat. You pick.
  • Through a webhook you make in Discord: no bot, no sign-in. Chat can't ping anyone there, and hidden messages never go.

Four on-stream widgets (Browser Sources in OBS, Streamlabs or anything that shows a web page)

  • Your own platform logos and names: one picture for every platform, one per platform, or none at all. One button hides which platform a message came from.
  • Chat feed: the merged chat, or only the platforms you choose.
  • Featured message: hover any message in the CrossChat window, press show, and it appears big on stream.
  • Viewer counter: everyone watching, in total and per platform.
  • Alerts: subs, resubs, gifts, raids, cheers, memberships, Super Chats and Super Stickers, Rumble Rants, and TikTok follows and shares, with an optional chime. Likes and joins too, if you turn them on.

Theme Studio

  • Eight built-in looks, and full control over fonts, colours, layout, animation, platform icons and custom CSS.
  • Live preview over your own screenshot, and one-click test events to the sources already in your scenes.
  • A different theme per scene.

X Live started with OBS

  • X only goes live when you press Go Live on its Live Studio page. The CrossChat browser extension does that for you when your stream starts, and ends the livestream when you stop.
  • X's chat and viewer count join the CrossChat window.

Follows OBS, stays local

  • The OBS script starts CrossChat with OBS and stops it when OBS closes.
  • CrossChat reads its OBS WebSocket settings from OBS itself, and portable OBS works too.
  • No account, server or telemetry. Update checks only if you switch them on: then CrossChat asks GitHub once a day and shows a link to the new release (it never downloads anything itself).

How it compares with Restream, Streamlabs, StreamElements, Social Stream Ninja, Casterlabs and Streamer.bot, every claim linked to its source: docs/COMPARISON.md.

See it in action

The tour (48 s): a question put on stream, one reply to every platform, a message deleted, Answer later and Questions, an alert on stream. ▶ overview.mp4
Phone companion (29 s, vertical): a question tapped onto the stream, a quick reply, a timeout, the Questions view. ▶ companion-vertical.mp4
Theme Studio (35 s): six of the built-in looks in a row, then the accent colour, the text size and the layout changed live. ▶ theme-studio.mp4
Recorded in OBS 33.0.1 (32 s): the four widgets running in a real OBS scene. ▶ obs-recording.mp4

The Theme Studio cycling through the built-in themes on a stream-sized preview

Screenshots

The CrossChat window

Live chat Reply to one person, message on stream Moderate
The CrossChat window: viewers per platform and chat from Twitch, YouTube, Kick and X Replying to a YouTube viewer while their question is featured on stream A message's actions: reply, show on stream, answer later, delete, timeouts, ban, quick replies
Questions Quick replies Settings
The Questions view: only messages that look like questions Editing quick replies Settings: light or dark, Twitch connected, pair a device, test events
Read chat aloud Filters Chat history Connection health
Text-to-speech settings: what to read, voice, speed and volume Filters: hidden words, viewers, commands and bots, with hidden messages dimmed in the chat A past stream's chat: search, platform filter, questions, CSV and HTML export Connections: how long each platform has been connected, last message and reconnects, and Twitch and Kick sign-in

The companion on a phone or another PC

On a phone Pairing On another PC
The CrossChat companion on a phone Pairing a device: QR code, 6-digit code and paired devices The CrossChat companion in a browser window on a second PC

On stream

Alerts
Alert: a Twitch subscription Alert: a Twitch raid with 37 viewers
Alert: a YouTube Super Chat Alert: a Twitch cheer of 500 bits
Featured message Viewer counter
A viewer's question shown big on stream Everyone watching, in total and per platform

Theme Studio: change any part of the look and watch all four widgets update over a stream-sized preview.

The Theme Studio: theme list, settings and a live preview of all four widgets

Your own logos and names: one logo for every platform, a different one for Twitch here, and YouTube renamed "Main stream".

The Theme Studio's Platform logos and names section, with custom logos on all four widgets in the preview

Inside OBS 33.0.1: the four widgets added as Browser Sources.

OBS Studio 33.0.1 with the CrossChat chat, featured, viewers and alerts sources in a scene

Built-in themes

Classic Minimal outline Glass Bubbles
Classic theme Minimal outline theme Glass theme Bubbles theme
Compact Neon Paper High contrast
Compact theme Neon theme Paper theme High contrast theme

Every setting, the CSS hooks and how to share themes are in docs/THEMES.md.

What you need

PC Windows 10 or 11, 64-bit (tested on Windows 11), or a Mac with macOS 15 or newer (tested with OBS on Intel and Apple-silicon Macs; see Mac), or 64-bit Linux (tested on Ubuntu 25.10 and 24.04; see Linux)
A streaming app OBS Studio 28 or newer, with its built-in WebSocket server (tested with 33.0.1, obs-websocket 5.7.6); or Streamlabs Desktop; or any app that can show a web page as a source. See Other streaming apps.
Browser Google Chrome, or Microsoft Edge (on a Mac or Linux also Chromium; on Linux also Brave). Needed for replying (except on Twitch and Kick), and for X, TikTok, Facebook and Instagram chat.
Python Nothing to install: the setup program brings its own (python.org's embeddable Python). The zip's Install.cmd needs Python 3.10 or newer, and offers to install it. On a Mac or Linux, Python 3.10 or newer.
X Live (optional) X Premium with access to X Live Studio, and OBS sending video to X (see X Live).
TikTok LIVE (optional) Signed in to TikTok in the same browser, and OBS sending video to TikTok (see TikTok LIVE).
Facebook Live, Rumble (optional) Signed in to them in the same browser (see Facebook Live and Rumble).
Instagram Live (optional) Signed in to Instagram in the same browser, and OBS sending video to Instagram (see Instagram Live).

CrossChat doesn't send your video anywhere. Your streaming app does that. To stream to several platforms at once, use what you already use for that: an OBS multi-output plugin such as obs-multi-rtmp, or a restreaming service.

Install

  1. Download CrossChat-Setup-<version>.exe from Releases and run it. It does the following:

    • installs CrossChat for your Windows account in %LOCALAPPDATA%\CrossChat, with its own Python, and needs no administrator rights;
    • turns on OBS's WebSocket server if it's off (it asks first);
    • adds a CrossChat folder to the Start menu, and CrossChat to Settings → Apps.

    Running a newer one later updates CrossChat and keeps your settings, themes, sign-ins and chat history. The extension from the Chrome Web Store updates by itself. If you loaded it unpacked instead, press its reload arrow in chrome://extensions (or edge://extensions) after an update: the browser keeps running the old extension until you do, and the chat window says so if it's too old to work. From 1.7.2 the setup program is code-signed by Randy Northrup (Azure Artifact Signing). A newly signed program can still get a "Windows protected your PC" notice until Windows has seen enough downloads of it: choose More info, check the publisher says Randy Northrup, then Run anyway. Details, silent install and how it's built: docs/INSTALLER.md.

  2. Set your channels: Start menu → CrossChat → Open chat → Settings.

  3. Add the script to OBS: Tools → Scripts → +, then pick %LOCALAPPDATA%\CrossChat\obs\crosschat.lua. Setup puts this path on your clipboard.

  4. Add the extension: open CrossChat on the Chrome Web Store in Chrome and press Add to Chrome. In Edge, press Allow extensions from other stores on that page first, then add it the same way. It updates by itself from then on.

    Without the store: chrome://extensions (or edge://extensions) → switch on Developer mode → Load unpacked → pick %LOCALAPPDATA%\CrossChat\extension. That copy matches the app you installed, and needs its reload arrow pressed after each update.

    Twitch, YouTube, Kick and Rumble chat and the on-stream widgets work without the extension. Reading X, TikTok, Facebook and Instagram needs it, as do replies everywhere except Twitch and Kick, and X Live.

  5. Add the widgets you want to your scenes as Browser Sources:

    Widget URL Size
    Chat feed http://127.0.0.1:4466/overlay/chat 450 × 800
    Featured message http://127.0.0.1:4466/overlay/featured 900 × 260
    Viewer counter http://127.0.0.1:4466/overlay/viewers 600 × 120
    Alerts http://127.0.0.1:4466/overlay/alerts 800 × 300

    Add ?theme=neon (or any theme name) to give one source its own look. The Theme Studio's Copy address buttons build these addresses for you.

Tip

Use the http://127.0.0.1:4466/... addresses rather than local files. OBS 33's browser blocks pages opened as local files from reaching anything on 127.0.0.1.

To check everything without going live, press Send test in the Theme Studio, or start OBS streaming to a test server on your own PC. CrossChat sees that a stream to rtmp://127.0.0.1 is a test and doesn't start anything public.

Prefer a zip? CrossChat-<version>-windows.zip is still on every release. Extract it and double-click Install.cmd: it uses a Python 3.10+ already on your PC (or offers to install one), sets up its own environment, and asks for your channels in a console window. Then follow steps 3–5 above.

Other streaming apps

CrossChat needs to know one thing from your streaming app: when you are live. Choose how in Settings → Channels & options → Streaming app ("broadcaster" in config.json).

Streaming app What to do
OBS Studio Nothing: the Install steps above.
Streamlabs Desktop Choose Streamlabs Desktop. Nothing else to set up: no token, and its Remote Control setting can stay off. CrossChat follows it from then on, and closes when it closes.
Anything else (XSplit, vMix, Meld Studio...) Choose Another app: I press Start stream. A Start stream button appears at the top of the chat window: press it when you go live and End stream when you stop. A Stream Deck or hotkey can do the same with control.py stream-start and control.py stream-end.

Without OBS there is no script to start CrossChat, so open it before you stream: CrossChat → Open chat in the Start menu (on a Mac or Linux, the CrossChat app entries). Skip step 3 of Install. Add the widgets in your app the way it adds a web page (in Streamlabs: Sources → + → Browser Source). When CrossChat follows Streamlabs or nothing, Settings → Channels & options → Close CrossChat stops it, or control.py leave.

The top of the chat window with Another app chosen: OFF AIR with a Start stream button, then LIVE with an End stream button

Tested on real installs, on Windows, on 8 November 2026:

App Version What was checked
Streamlabs Desktop 1.21.9 CrossChat found it, whether it was open first or after CrossChat. A real stream, sent to a private receiver on the same PC, from start to stop. All four widgets and custom logos in the video it sent. CrossChat closed when it closed.
vMix 29.0.0.49 (trial) All four widgets as Browser inputs, in vMix's output, with custom logos.
XSplit Broadcaster 4.6.2609.2802 All four widgets as Webpage sources, in its preview.
Meld Studio 0.10.8.2 All four widgets as Browser layers over a scene, in its preview.

With vMix, XSplit and Meld, Start stream and End stream were pressed in the chat window of an installed CrossChat; no video was sent from them. No real platform was used with any of the four. See Known limits.

Streamlabs Desktop, the video it sent vMix, its output
CrossChat's chat feed, featured message, alert and viewer counter in the video Streamlabs Desktop sent CrossChat's four widgets in vMix's output
XSplit Broadcaster Meld Studio
CrossChat's four widgets as Webpage sources in XSplit Broadcaster CrossChat's four widgets as Browser layers in Meld Studio

These pictures use a test theme: an orange square as Twitch's logo, the plain bubble for the others, and MyTube as YouTube's name.

The hotkeys, the buttons in Tools → Scripts and the docked chat are OBS's own. In other apps, use the chat window and control.py. With Another app, X can only go live on your word: CrossChat can't see whether your video is really going out.

Mac

There is a Mac download too. It was checked with OBS Studio 33.0.1 (installed from Homebrew, brew install --cask obs) on two real Intel Macs in October 2026, and on an Apple-silicon Mac on every change:

Checked macOS 15.7.4, Intel Mac mini (2018) macOS 15.7.9, Intel MacBook Pro (2018) macOS 26.6.2, Apple silicon (GitHub's, every change)
The 1.7.1 download matches its .sha256 (its GitHub attestation checks out too); Finder's Archive Utility unpacks it with Install.command still runnable ✅ ✅ checksum
The installer, with Homebrew's or another Python ✅ 3.14, every question answered ✅ 3.13, --quiet ✅ 3.10 and 3.14, --quiet
OBS starts the hub with CrossChat's own Python; the hub follows the stream starting and stopping, sees a stream to this Mac as a test, and leaves when OBS closes ✅ ✅ ✅
The four widgets in OBS's browser sources; the chat docked in OBS (Custom Browser Dock) showing chat; featuring a message ✅ ✅ ✅
The sign-in key in the login Keychain: stored, read back, removed ✅ ✅
The extension in Chrome 156: the chat window recognises it, and the hub takes that window as the one that posts replies ✅
Read-aloud in the chat window (Chrome 156): the Mac's voices are listed (191 on this Mac), the hub sends the line to the chat window that reads aloud and to no other, and the line is spoken from start to end, in the voice picked in Settings ✅
The phone companion: pairing started from Settings; a Windows PC pairs over the home network with the code (with OBS starting the hub), gets the chat, sends a test reply (nothing posted) through the Mac's chat window and its extension, and has a line read aloud on the Mac; the MacBook's Chrome pairs through the pairing page and shows the chat. Refused before pairing, with a wrong code, from another website, and once removed in Settings ✅ ✅ as the paired browser
The uninstaller removes CrossChat, its Applications folder and its Keychain key ✅ ✅ the folders
CrossChat's windows, by the extension (scripts/window_e2e.py, Chrome 156, a throwaway profile): the chat window and a platform page placed where config.json says, the chat window moved by Open chat, both closed after the stream; the Mac's own window server has each window exactly there; the chat in a tab, the same page in a tab and other --app windows left alone. Also with OBS 33.0.1 starting the hub (--obs): X Live Studio's page (a dry run of Go live on X), the chat window moved back to "auto", both closed when OBS quits, and then the hub leaves ✅ ✅ Chrome 156, without OBS starting the hub
The hub's and the OBS script's tests ✅ all 158 ✅ 142; the 11 that use the Keychain can't run over SSH there ✅ 161; the one Tailscale test is for Windows

On a Mac the extension places, moves and closes CrossChat's windows (the chat window, and the X, TikTok, Facebook, Instagram and Rumble pages it opens). CrossChat's own way of doing that, the browser's AppleScript, is refused to programs that OBS starts, without asking anyone: OBS 33 isn't entitled to control other apps (macOS's log says kTCCServiceAppleEvents requires entitlement com.apple.security.automation.apple-events but it is missing for OBS), so there is no permission to give in System Settings. The extension uses the browser's own window API instead, which needs no permission. Without the extension, a new window opens where Chrome puts it (a Chrome that is already running ignores the place CrossChat asks for: in the check above it opened every new window over the first one) and stays open after the stream: close it yourself.

Tell us what works and what doesn't in Issues.

You need macOS 15 (or a recent macOS), OBS Studio 28 or newer, Chrome, Edge or Chromium, and Python 3.10 or newer from python.org or Homebrew (brew install python@3.13). The python3 that comes with macOS is 3.9, too old. The installer tells you if Python is missing; it doesn't install it for you.

  1. Download CrossChat-<version>-mac.zip from Releases and double-click it to unpack it.
  2. Run Install.command from Terminal. macOS won't open it with a double-click, because the download isn't signed by Apple. Open Terminal (Applications → Utilities → Terminal), type bash with a space after it, drag Install.command from the unpacked folder into the Terminal window and press Return. It installs to ~/Library/Application Support/CrossChat, sets up its own Python environment with checksum-verified packages, asks the same questions as on Windows, and makes a CrossChat folder of small apps (Open chat, Theme Studio, Try the demo, Go live on X, Uninstall) in the Applications folder of your home folder: in Finder, Go → Home, then Applications → CrossChat.
  3. Add the script to OBS: Tools → Scripts → +, press Cmd+Shift+G, paste the path the installer put on your clipboard (~/Library/Application Support/CrossChat/obs/crosschat.lua) and press Return.
  4. Add the extension: CrossChat on the Chrome Web Store → Add to Chrome (Chrome, Chromium, or Edge after Allow extensions from other stores). Or load it unpacked: chrome://extensions → Developer mode → Load unpacked → Cmd+Shift+G → ~/Library/Application Support/CrossChat/extension.
  5. Widgets: the same Browser Source addresses as on Windows.

What's different on a Mac:

  • Sign-ins (Twitch, Kick, Rumble, Discord) are encrypted under a key CrossChat keeps in your login Keychain, instead of Windows' DPAPI. The uninstaller removes the key. macOS lets only programs started in your own session at the Mac use that Keychain (OBS is one): a hub started over SSH can't save sign-ins.
  • The chat window and the platform pages are placed, moved and closed by the extension (see above). Without it they stay where Chrome opens them, and open after the stream. Opening a window also brings the browser to the front.
  • Hotkeys (OBS's, the CrossChat ones included) work while another app is in front only once OBS has the Input Monitoring permission (System Settings → Privacy & Security). Without it, OBS's log says "No event permissions, could not add global hotkeys".
  • The phone companion stays off until you choose the address. macOS doesn't tell apps whether a network is a private one, so CrossChat won't guess: on your home network, set "remote": {"bind": "<your Mac's address>"} in config.json (System Settings → Wi-Fi → Details shows the address). The Tailscale switch is Windows-only.
  • Read-aloud uses the Mac's own voices. Chrome reads aloud only once you've clicked in the chat window after it opened; until then the window says it's waiting to read.
  • Uninstall: Applications (in your home folder) → CrossChat → Uninstall CrossChat. It offers to keep your settings and themes in Documents/CrossChat backup.

Linux

There is a Linux download too: CrossChat-<version>-linux.tar.gz. It was checked on a real computer with Ubuntu 25.10 (x86_64) in October 2026, with two OBS builds, Ubuntu's own OBS Studio 30.2.3 and OBS Studio 33.0.1 from Flathub, and with Google Chrome 153. Everything ran on a virtual display there (Xvfb, an X11 display), in a session of its own:

Checked on Ubuntu 25.10 Ubuntu's OBS 30.2.3 OBS 33.0.1 from Flathub
OBS starts the hub with CrossChat's own Python; the hub follows the stream starting and stopping, sees a stream to this computer as a test, and leaves when OBS closes; OBS's WebSocket port is free at once, and an OBS started again 3 s later works ✅ ✅ the hub runs outside OBS's sandbox
The four widgets in OBS's browser sources this OBS has no Browser Source ✅
The chat docked in OBS (Custom Browser Dock): on screen in OBS's window, showing chat; when the dock opened before CrossChat answered (most starts), its Click here to retry brings the chat this OBS has no Browser Source ✅
The installer from the built download (in a stand-in home folder): packages checked against their checksums, the folder readable by your account only, app-menu entries, OBS's WebSocket server switched on; the uninstaller removes it all and keeps your settings ✅
The extension in Chrome 153: the chat window the hub opens (Open chat) recognises it, and the hub takes that window as the one that posts replies: a test reply goes from the hub through the window and the extension, which answers for X and YouTube (nothing posted) ✅ OBS started the hub
Read-aloud in that window: with speech-dispatcher (Ubuntu's, with the espeak-ng voices) and Chrome started with --enable-speech-dispatcher, the computer's voices are listed (14,824), the hub sends the line to the chat window that reads aloud and to no other, Chrome wants one click in the window first (as on a Mac), then the line is spoken from start to end (with no voice picked in Settings, in the first English one, "English (America) espeak-ng") ✅
The phone companion ("remote": {"bind"} set to the computer's address): a Windows PC on the home network is refused before pairing, with a wrong code and from another website; it pairs with the code, gets the chat, sends a test reply (nothing posted) through the Linux chat window and its extension, and has a line read aloud on the Linux computer; Chrome 156 on that PC (headless) pairs through the pairing page and shows the chat. Once removed in Settings, the PC is refused; with nothing paired, the companion port closes ✅

Also checked there: the sign-in key in the desktop keyring (GNOME Keyring 48, in a D-Bus session of its own): stored, read back, removed by the uninstaller; the chat window opened, placed, moved and closed in Chrome 153 on an X display, with and without a window manager; the Tailscale address taken from a tailscale0 interface only while it's up; and the hub's and the OBS script's tests (182 pass; the other 5 are for Windows or macOS, or open a real browser window). Without --enable-speech-dispatcher, Chrome 153 listed only Google's online voices, and CrossChat read nothing aloud (it never picks an online voice by itself).

CrossChat's windows, by the extension (scripts/window_e2e.py, Chrome 153, a throwaway profile, in a home folder and D-Bus session of its own): the chat window and a platform page placed where config.json says, the chat window moved by Open chat, both closed after the stream, all by the extension, with the chat in a tab, the same page in a tab and other --app windows left alone. Checked on three desktops: an X11 display (Xvfb; the X server has each window exactly there), Wayland, with KWin 6.4.5 on a virtual screen (kwin_wayland --virtual) and the browser as a Wayland program (KWin has each window at exactly the size asked for; where a window goes is KWin's choice: Wayland lets no program place a window, the browser included), and KWin's XWayland (the X server has each window exactly there). All at a display scale of 100 %. GitHub's Ubuntu machines run the same check on an X11 display on every change.

On every change, GitHub's Ubuntu 24.04 machines run the tests with a real keyring, the window checks, an install and uninstall from the download, and OBS end to end on a virtual display, with OBS from the OBS Project's PPA and from Flathub (32.2.0 and 33.0.1 at the end of October 2026): the hub following OBS, the widgets and the docked chat inside OBS's browser, and OBS started again.

Not seen yet: CrossChat on a Linux desktop someone sits at; everything above ran on virtual displays (X11, and KWin's virtual Wayland screen for the windows). That includes the chat window on a desktop you're sitting at (X11 or Wayland, see below), and the windows at a display scale other than 100 %. Browsers other than Google Chrome (Chromium, Edge, Brave, and Snap or Flatpak browsers) and distributions other than Ubuntu are untested. Tell us what works and what doesn't in Issues.

You need a 64-bit Linux desktop, Python 3.10 or newer with its venv module (Ubuntu and Debian: sudo apt install python3-venv), Chrome, Chromium, Edge or Brave, and OBS Studio 28 or newer. For the on-stream widgets and the dock, OBS needs its Browser Source: OBS from Flathub has it, and so does OBS from the OBS Project's PPA on Ubuntu (ppa:obsproject/obs-studio); Ubuntu's and Debian's own obs-studio package doesn't. To keep sign-ins, you need a desktop keyring (GNOME Keyring, KWallet or another Secret Service) and secret-tool (Ubuntu and Debian: sudo apt install libsecret-tools; Fedora and Arch: libsecret). To read chat aloud, you need speech-dispatcher with a voice (Ubuntu and Debian: sudo apt install speech-dispatcher speech-dispatcher-espeak-ng), and Google Chrome started with --enable-speech-dispatcher. The installer tells you what's missing; it doesn't install system packages for you.

  1. Download CrossChat-<version>-linux.tar.gz from Releases and unpack it: tar -xzf CrossChat-<version>-linux.tar.gz
  2. Run the installer in a terminal: cd CrossChat-<version>-linux and bash scripts/install.sh. It installs to ~/.local/share/CrossChat (readable by your account only), sets up its own Python environment with checksum-verified packages, asks the same questions as on Windows, and adds CrossChat: Open chat, Theme Studio, Try the demo, Go live on X and Uninstall CrossChat to your desktop's app menu.
  3. Add the script to OBS: Tools → Scripts → +, press Ctrl+L, type or paste ~/.local/share/CrossChat/obs/crosschat.lua (the installer puts the full path on your clipboard when wl-copy, xclip or xsel is there) and press Enter. OBS from Flathub sees that folder too; there the script starts the hub outside OBS's sandbox with flatpak-spawn (the OBS Flatpak is allowed to).
  4. Add the extension: CrossChat on the Chrome Web Store → Add to Chrome (Chrome, Chromium, Brave, or Edge after Allow extensions from other stores). Or load it unpacked: chrome://extensions → Developer mode → Load unpacked → Ctrl+L → ~/.local/share/CrossChat/extension.
  5. Widgets: the same Browser Source addresses as on Windows.

What's different on Linux:

  • Sign-ins (Twitch, Kick, Rumble, Discord) are encrypted as on a Mac (AES-256, sealed with HMAC-SHA256) under a key CrossChat keeps in your desktop keyring, through the Secret Service. If no keyring answers, CrossChat keeps no sign-in at all and says why: never one in plain text. A locked keyring asks you to unlock it. The uninstaller removes the key.
  • CrossChat's windows (the chat window and the platform pages) are placed, moved and closed by the extension, on X11 and on Wayland. On Wayland no program may choose where a window goes, the browser included: the desktop places them, and the extension sets their size and closes them. Without the extension, CrossChat does it through X11, which on a Wayland desktop reaches the browser only when it runs through XWayland; a browser running as a Wayland program then opens the window where the desktop puts it, and CrossChat can't move or close it (it doesn't open a second one while one is open). With several screens, "auto" uses the right edge of the whole desktop: set "window" in config.json to put it somewhere else. Opening a window can bring the browser to the front.
  • Message boxes use zenity or kdialog, whichever your desktop has.
  • Read-aloud uses the computer's own voices, through speech-dispatcher. Google Chrome offers them only when it was started with --enable-speech-dispatcher; otherwise it has only Google's online voices, which send the text to Google, and CrossChat uses one of those only if you pick it in Settings. Chrome reads aloud only once you've clicked in the chat window after it opened; until then the window says it's waiting to read.
  • The phone companion stays off until you choose the address, as on a Mac: Linux doesn't tell apps whether a network is a private one. Set "remote": {"bind": "<your computer's address>"} in config.json on your home network.
  • Tailscale works as on Windows: only the address of Tailscale's own interface (tailscale0) counts, and only while it's up.
  • Uninstall: app menu → Uninstall CrossChat (it opens in a terminal), or bash ~/.local/share/CrossChat/scripts/uninstall.sh. It offers to keep your settings and themes in Documents/CrossChat backup.

Try it without going live

Start menu → CrossChat → Try the demo, or python hub\control.py demo. It opens the chat app on a made-up live stream with fictional chatters on all eight platforms, including questions, subs, raids, Super Chats and moving viewer counts.

Reply, moderate, star and feature messages as much as you like: in the demo everything "works", and nothing is posted anywhere. Try the demo runs on its own port (4477), so it never mixes with your real chat.

Using it

To Do this
Open the chat window Start OBS streaming (it opens by itself), or Start menu → CrossChat → Open chat, or the OBS hotkey
Answer everyone Type in the box and press Enter
Answer one platform or one person only: buttons, or hover a message → reply
Put a message on stream Hover it → show. Hide in the window, or the hotkey, takes it off.
Restyle the widgets ✎ in the chat window, or Start menu → CrossChat → Theme Studio
Go live on X now Start menu → Go live on X, the OBS script's button, or the hotkey
Moderate Open a message → Moderate (Twitch and Kick need Connect Twitch / Connect Kick in Settings once)
Use your phone Settings (⚙) → Pair a device, then scan the QR code
Use another PC Settings (⚙) → Pair a device, then open the address it shows in that PC's browser (enter the 6-digit code if asked)

Hotkeys (OBS → Settings → Hotkeys, search "CrossChat"):

  • Open chat window
  • Go live on X
  • Hide featured message

A Stream Deck can trigger them with a Hotkey action, or open the Start-menu shortcuts with System → Open.

The OBS script panel (Tools → Scripts → crosschat.lua) has buttons for all of the above, plus a dry run for X and Start the hub again.

CrossChat's windows (the chat window, and the X, TikTok, Facebook, Instagram and Rumble pages it opens when you go live) close by themselves two minutes after the stream ends (close_window_seconds_after_stream), the pages first. With the extension, the extension closes them, and on a Mac and on Linux it also puts them in their place; on Windows, Windows' own way does the placing (it puts the visible edges exactly in place). The extension never moves or closes a browser window of yours, even one with the chat open in a tab. Without it, CrossChat does all of it the system's way, which a Mac refuses to programs OBS starts (see Mac).

Dock the chat inside OBS. In OBS: Docks → Custom Browser Docks, name it CrossChat, URL http://127.0.0.1:4466/ (4466 is the port setting), then Apply and drag the dock where you want it. Use 127.0.0.1, not localhost: localhost is the overlays' address and only serves the widgets. The dock reads chat, replies, puts messages on stream and moderates Twitch and Kick. Keep the CrossChat window in Chrome or Edge open as well (it opens by itself when you go live): it does the work on the YouTube, X, TikTok, Facebook, Instagram and Rumble pages, and it is the one that reads chat aloud. OBS opens the dock a moment after it starts CrossChat and doesn't try again by itself: if CrossChat wasn't ready yet (it happened once in our tests at the first start after installing, and at most starts with OBS on Linux), the dock says "Couldn't load that page!", and Click here to retry in it brings the chat.

What each platform supports

Read chat Reply Moderate Viewer count Alerts
Twitch ✅ ✅ (official API once connected) delete, timeout, ban, unban ✅ subs, resubs, gifts, raids, cheers
YouTube ✅ ✅ remove, 5-minute timeout, hide user ✅ Super Chats, Super Stickers, members, gifted memberships
Kick ✅ ✅ (official API once connected) delete, timeout, ban, unban ✅ subs, gifts, hosts (see Known limits)
X ✅ ✅ — ✅ —
TikTok LIVE ✅ (your own LIVE page) ✅ in TikTok ✅ gifts, follows, shares; likes and joins if you turn them on (see Known limits)
Facebook Live ✅ (Live Producer) ✅ delete (the rest in Facebook) ✅ —
Instagram Live ✅ (Live producer) ✅ in Instagram ✅ —
Rumble ✅ (official API) ✅ delete, mute 5 minutes, mute for the stream, mute forever ✅ Rants, subs, gifted subs

X Live

X has no stream key that starts a livestream by itself: someone has to press Go Live on X Live Studio. CrossChat does it for you.

  1. In X Live Studio, create a source (CrossChat expects it to be called OBS; change x.source if yours has another name) and send OBS's video to it with your multistream setup.

  2. In Settings → Channels & options, switch on X livestreams and Go live on X by itself, or set "x": {"enabled": true, "auto_go_live": true} in config.json. (The zip, Mac and Linux installers also ask.)

  3. When your stream starts, CrossChat waits a few seconds, opens Live Studio next to the chat window, and the extension:

    • checks the source shows Connected;
    • fills in the title;
    • sets the audience to Public;
    • presses Go Live.

    A banner at the top of the X page shows each step. The chat window says X: live., or where it stopped.

  4. When OBS stops, the X livestream is ended about 15 seconds later, so a quick stop and start in OBS doesn't end it.

The extension only acts in the two minutes after the hub asks it to, so opening or reloading the X page yourself never starts a stream. To rehearse:

  • Test X (never goes live) fills in the form without pressing Go Live.
  • hub\control.py x-private (in the CrossChat folder) goes live visible to you only.

Turn off the automatic start with "auto_go_live": false and use Go live on X when you want it.

TikTok LIVE

TikTok has no public chat API. Tools that connect to TikTok LIVE chat directly usually do it through an outside "signing" service (Euler Stream is the common one), which learns which live you're reading; you only hand it your TikTok session if you sign in through it to send messages. CrossChat uses no outside service: it reads your own LIVE page in your own browser.

  1. Enter your TikTok @name in Settings → Channels & options, or set "tiktok": "@yourname" in config.json.

  2. Stay signed in to TikTok in Chrome or Edge, the browser with the CrossChat extension.

  3. When your stream starts, CrossChat opens your own TikTok LIVE page in a small window under the chat window. Keep it open while you stream.

  4. The extension passes on the chat lines shown there and types your replies into TikTok's own chat box, as you. Replies are up to 150 characters.

  5. Gifts, follows, shares and likes shown on that page become CrossChat alerts:

    • Gifts show the gift's name and how many, such as "Rose ×5". A combo counts as one alert with its final count. TikTok's page doesn't show what a gift costs, so CrossChat doesn't make up a money value.
    • Follows show once a stream per viewer, and shares at most once a minute per viewer.
    • Likes are added up per viewer and shown once they stop liking. When many viewers' likes come in at once, they show as one line, such as "12 viewers liked the LIVE ×340". Likes stay off the on-stream alerts unless you turn them on in the Theme Studio, and are never read aloud automatically.
    • Joins are off. To see who joins, turn on Settings → Filters → Show who joins your TikTok LIVE.

    Only rows TikTok itself marks as gifts, follows and the like count. A viewer who types "followed the host" or "×99" in chat can't fake an alert.

The extension first asks CrossChat which TikTok account is yours. On every other TikTok page, someone else's LIVE included, it reads nothing. Moderate TikTok chat in TikTok itself.

Facebook Live and Rumble

Facebook Live. Switch on Facebook Live in Settings → Channels & options, or set "facebook": true. When your stream starts, CrossChat opens Facebook's Live Producer, where you press Go live as usual. While your live runs, the extension passes on the comments shown there and types your replies into its comment box, as you. Live Producer only ever shows your own broadcasts, and the extension may touch no other part of Facebook.

Rumble. In Settings → Connections → Rumble, paste your Live Stream API URL from rumble.com/account/livestream-api. CrossChat reads Rumble chat, Rants, subs, gifted subs and the viewer count through Rumble's official API, and keeps the URL encrypted on this PC. When your Rumble live starts, CrossChat opens Rumble's chat window for it, and replies are typed there as you (sign in to Rumble in the same browser). The extension never presses Rumble's Rant button.

Deleting Facebook comments. In the CrossChat window, a Facebook comment's menu has Delete comment. The extension opens that comment's own menu in Live Producer, picks Delete and confirms Facebook's question, as you. It finds the comment by the id Facebook gave it, so it can't delete a different one. Hiding comments and banning people are still done in Facebook itself.

Moderating Rumble chat. A Rumble message's menu in the CrossChat window has Delete message, Mute 5 minutes, Mute for this stream and Mute forever: the same choices Rumble gives the streamer. The extension uses Rumble's own "Moderate this comment" menu in the chat window CrossChat opened, as you. Rumble's API gives chat lines no id, so the extension picks the newest line with that sender's name and those exact words. To answer Rumble's "delete this message?" question, a few lines of the extension run inside Rumble's chat page and say yes to that one question, once, right after CrossChat asks; every other question is left to you. Unmute people under Muted users in Rumble's chat.

Discord

CrossChat can post to one channel of your Discord server while you're live. It only posts: nothing is read from Discord.

  1. In Discord: Server Settings → Integrations → Webhooks → New Webhook. Pick the channel, then Copy Webhook URL.
  2. In CrossChat: Settings → Connections → Discord, paste it and press Connect Discord. CrossChat checks it with Discord and keeps it encrypted on this PC; it's never shown again.
  3. Pick what goes there: a going-live notice (with links to your channels), messages you show on stream, and all chat (off at first). Send a test post checks the channel.

Only what viewers already see on stream is posted, never messages your filters hid. Chat can't ping anyone there (@everyone included), and links in chat show as text that can't be clicked. Posts are spaced at least 2 seconds apart, chat lines are grouped into one post, and CrossChat waits whenever Discord asks it to. Nothing is posted during a test stream to this PC.

The companion away from home (Tailscale)

The companion is for your home network. To use it from anywhere, for example on your phone while streaming IRL or from a friend's place, use Tailscale: a private, encrypted network between your own devices, free for personal use.

  1. Install Tailscale on the streaming PC and sign in.
  2. Install the Tailscale app on your phone and sign in to the same account. Leave it on.
  3. In CrossChat: Settings → Paired devices → switch on Away from home too, with Tailscale. It shows your PC's Tailscale address, or says what's missing.
  4. Press Pair a device and scan the QR code. With Tailscale on, the code uses the PC's Tailscale address, so it works at home and away. A phone you paired before needs pairing once more.

Pairing is still required, and the companion listens only on the address Windows has on Tailscale's own adapter (on Linux, the address of Tailscale's own interface, tailscale0, while it's up). When Tailscale stops, the companion stops listening there; it comes back with Tailscale.

Instagram Live

Instagram takes a stream from OBS through its Live producer on instagram.com (Create → Live video), which gives you a stream URL and key.

  1. Switch on Instagram Live in Settings → Channels & options, or set "instagram": true in config.json, and stay signed in to Instagram in Chrome or Edge, the browser with the CrossChat extension.
  2. In the Live producer, use a persistent stream key (Manage Persistent Key) in OBS, so the same key works every time you go live.
  3. When your stream starts, CrossChat opens instagram.com in a small window under the chat window. Open Create → Live video there, add a title and pick the audience, press Next, and press Go live once the preview shows.
  4. While the live runs, the extension passes on the comments and viewer count the Live producer shows, and types your replies into its comment box, as you.

Start the live in the window CrossChat opens (or any tab opened at instagram.com's home page): the extension works only there. The Live producer only ever shows your own live, and the extension reads nothing else on Instagram: no feed, messages or profiles. To rehearse, pick the Practice audience, which only you can see. Moderate Instagram comments in Instagram itself.

Settings

Your settings are in %LOCALAPPDATA%\CrossChat\config.json (start from config.example.json). Restart OBS after changing them (with Streamlabs or another app, close CrossChat and open it again).

Key Default
twitch, youtube, kick "" Your channels. A name, an @handle, a channel ID or a link all work.
tiktok "" Your TikTok @name. Its LIVE page opens in your browser when you go live (see TikTok LIVE).
tiktok_window "auto" Where that page goes: under the chat window, or {"x", "y", "width", "height"}.
facebook false true: Facebook Live comments from Live Producer (see Facebook Live and Rumble).
instagram false true: Instagram Live comments from its Live producer (see Instagram Live).
facebook_window, instagram_window, rumble_window "auto" Where Live Producer, instagram.com and Rumble's chat window go.
port 4466 The hub's port on 127.0.0.1. The extension expects 4466.
broadcaster "auto" How CrossChat knows you are live: "obs", "streamlabs", "manual" (a Start stream button), or "auto": the OBS that started it, else a Streamlabs Desktop that is already running, else OBS. See Other streaming apps.
browser "auto" "auto" (Chrome, else Edge), "chrome", "edge" or a full path. On a Mac also "chromium"; on Linux also "chromium" and "brave" (after Edge), or a program on your PATH. It must be the browser that has the extension.
window "auto" "auto" docks the chat at the right edge of the main screen, or {"x", "y", "width", "height"}. Put it where OBS doesn't capture.
open_window_on_stream_start true Open the chat window when your stream starts.
close_window_seconds_after_stream 120 How long it stays after the stream ends.
overlay.platforms "all" Which platforms the on-stream chat shows, for example ["twitch"]. A theme that names its own platforms, or ?platforms= on one source, comes first.
overlay.theme "classic" The theme sources use without ?theme= (the Theme Studio's Set as default overrides it).
obs.host, obs.port, obs.password from OBS Only if OBS's WebSocket isn't on this PC or you want to override what OBS has saved.
remote.enabled, remote.port true, 4467 The companion for paired devices. It only starts listening once you pair a device, and never on a network Windows calls Public.
remote.tailscale false Also listen on your PC's Tailscale address, for the companion away from home (see above). The switch in Settings → Paired devices sets it.
remote.bind "auto" Where the companion listens on the home network. "auto" is your PC's home-network address.
updates.check false true: ask GitHub once a day whether a newer CrossChat is out, and show a link to it. Nothing about you is sent. The switch in Settings → About sets it.
twitch_client_id CrossChat's Use your own Twitch app instead (a Public client from dev.twitch.tv).
kick_client_id, kick_client_secret CrossChat's Use your own Kick app instead (redirect URL http://localhost:4466/kick/callback).
emotes all on {"bttv": true, "ffz": true, "7tv": true}: third-party emotes in the chat and widgets.
logs.enabled, logs.keep_days true, 90 Keep each stream's chat on this PC, and for how long.
custom_overlays "" A folder of your own overlay pages, served at http://localhost:4466/custom/<file> (see below).
x.enabled false Use X Live.
x.auto_go_live false (the template the installers write sets true) Go live on X when your stream starts.
x.title "Live now" Livestream title.
x.title_file, x.title_prefix "" Use the first line of a text file as the title instead (handy with a "now building" file).
x.source "OBS" The source name in X Live Studio.
x.delay_seconds 12 How long after your stream starts to go live on X.
x.post "" Text for the post that announces the livestream.
x.end_with_obs true End the X livestream when your stream stops.
x.end_seconds_after_obs 15 How long after your stream stops to end it on X, in case the stream comes straight back.
x.window "auto" Where X's page opens: "auto" or {"x", "y", "width", "height"}.

Your own overlays

Hand-made overlay pages can read CrossChat's live feed: /events (Server-Sent Events) and /settings.

Since OBS 33, a page added as a local file can't reach 127.0.0.1, so let CrossChat serve it:

  1. Set "custom_overlays": "C:\\path\\to\\your\\overlays" in config.json.
  2. Use http://localhost:4466/custom/your-page.html as the Browser Source URL. (http://127.0.0.1:4466/custom/... is sent there.)

These pages get their own address, which the browser keeps apart from the CrossChat window, so an overlay you downloaded can show chat but can't reply, moderate or change anything as you.

Subfolders, images, fonts, video and audio work. Nothing outside that folder is served. To build your own, see the API.

How it works

flowchart LR
  OBS["OBS Studio<br/>crosschat.lua"] -- starts --> HUB
  OBS -- "stream started / stopped<br/>(obs-websocket)" --> HUB
  subgraph PC["Your PC (127.0.0.1 only)"]
    HUB["CrossChat hub<br/>hub.py"]
    WIN["Chat window"]
    WID["Widgets in OBS<br/>chat · featured · viewers · alerts"]
    EXT["Browser extension"]
  end
  TW["Twitch chat"] --> HUB
  YT["YouTube chat"] --> HUB
  KI["Kick chat"] --> HUB
  RU["Rumble API"] --> HUB
  PH["Phone or other PC<br/>(paired, home network)"] <-- "chat app, port 4467" --> HUB
  HUB -- live feed --> WIN
  HUB -- live feed --> WID
  WIN -- "replies, mod jobs" --> EXT
  HUB -- "Twitch and Kick replies, moderation<br/>(official APIs)" --> TW & KI
  EXT -- posts as you --> YT & XS["X Live Studio"] & PG["TikTok, Facebook,<br/>Instagram, Rumble"]
  XS -- "X chat, viewers" --> EXT --> HUB
  PG -- "chat they show" --> EXT
  HUB -- "go live / end" --> EXT
Loading

When you pair a device, Windows asks once whether Python may use the network. Choose Allow for private networks.

  • The hub (hub/hub.py) is a small Python program. It reads each platform's chat and follows OBS through its WebSocket server, Streamlabs Desktop through its local port, or your Start stream button. It serves the chat window, the widgets and the Theme Studio, on 127.0.0.1 only.
  • The OBS script (obs/crosschat.lua) starts the hub with OBS and gives you buttons and hotkeys.
  • The extension (extension/) does what only your signed-in browser can do: post your replies on YouTube, X, TikTok, Facebook, Instagram and Rumble, moderate YouTube, Facebook and Rumble, read X, TikTok, Facebook and Instagram chat, and work X Live Studio. It also places and closes CrossChat's own windows. It reads no logins and has no Chrome permissions.

Privacy and security

CrossChat has no server and no account. Everything runs on your PC and talks straight from it to the platforms you set up, plus a few named helpers: decapi.me as a fallback for the Twitch viewer count (it's sent your channel name), the 7TV, BetterTTV and FrankerFaceZ emote services unless you turn them off, and, only if you switch them on, Discord and GitHub's update check. SECURITY.md lists every connection it makes and what is sent.

  • The hub listens on 127.0.0.1 only and answers only under 127.0.0.1 or localhost. Other websites get nothing from it, not even the chat, and can't put the CrossChat window in a frame.
  • Your own overlay pages run at their own address and get only the public chat: they can't reply, moderate or change anything as you.
  • Anything that does something (opening windows, going live, featuring a message, changing settings) is refused when another website asks for it.
  • Reading chat: Twitch, YouTube and Kick are read from their public, signed-out feeds, Rumble through your API URL, and X, TikTok, Facebook and Instagram from your own live pages in your browser.
  • Twitch and Kick replies and moderation use their official APIs once you connect them in Settings.
    • The tokens are encrypted for your Windows account (DPAPI), or on a Mac under a key in your login Keychain, or on Linux under a key in your desktop keyring (with no keyring, Linux keeps no sign-ins at all). Disconnecting deletes them and revokes them at Twitch or Kick.
  • The extension reads no logins. It has no Chrome permissions; it only reads your own live pages, types your replies into those sites' own chat boxes, carries out the moderation you ask for, and places and closes the windows CrossChat opened (never a window of yours).
  • The companion port (4467) only opens after you pair a device, and only on a network Windows calls Private, or on your own Tailscale address if you switch that on.
    • It answers paired devices only: an HttpOnly cookie per device, of which only a hash is stored.
    • Pairing codes are 6 digits, last 5 minutes and allow 5 tries.
    • Use it on your home network only.
  • Chat history stays in %LOCALAPPDATA%\CrossChat\logs and is removed after 90 days. Spreadsheet exports can't run formulas a viewer typed.
  • Text-to-speech uses your computer's own voices unless you pick one marked online.
  • CrossChat reads OBS's WebSocket password from OBS's own settings file. It doesn't copy it anywhere.
  • No telemetry and no analytics. Update checks only if you switch them on (Settings → About): then CrossChat asks GitHub once a day and sends nothing about you.
  • Every release has a signed build provenance attestation: gh attestation verify <zip> --repo RandyNorthrup/crosschat-obs. The installer installs the exact Python packages CrossChat was tested with, checked against their checksums.

More detail, and how to report a problem privately: SECURITY.md.

Troubleshooting

Problem What to check
A message box says CrossChat can't reach OBS's WebSocket server OBS → Tools → WebSocket Server Settings → tick Enable WebSocket server. CrossChat connects by itself once it's on.
Widgets show nothing Is OBS open with crosschat.lua loaded? Press Start the hub again in Tools → Scripts. Use the http://127.0.0.1:4466/... address, not a local file.
The CrossChat dock in OBS says "Couldn't load that page!" OBS opened it before CrossChat was ready. Press Click here to retry in the dock.
"Replies to YouTube, X, TikTok, Facebook, Instagram and Rumble go out through the CrossChat window in Chrome or Edge with the extension" Load the extension (Install step 4), then close the chat window and open it again.
A reply to one platform failed The chat window says why (not signed in, message too long, chat not open). YouTube replies need you signed in to YouTube in the same browser.
X stopped at a step The X page banner and the chat window name the step. Finish by hand; if it keeps happening, X may have changed its page, so open an issue.
Anything else %LOCALAPPDATA%\CrossChat\crosschat.log, and the OBS log (Help → Log Files, lines with crosschat.lua).

Known limits

  • Streamlabs Desktop: checked on Windows with Streamlabs Desktop 1.21.9, signed out, from the setup program and the Open chat shortcut, streaming to a private RTMP receiver on the same PC: CrossChat finds it whether it opens first or after CrossChat, follows a real stream from start to stop, all four widgets and custom logos show in the video it sends, and CrossChat closes when it closes. Its Mac version, and going live to a real platform through it, aren't tested yet.
  • vMix, XSplit and Meld Studio: checked on Windows (vMix 29.0.0.49, XSplit Broadcaster 4.6.2609.2802, Meld Studio 0.10.8.2): all four widgets and custom logos show in each app, and Start stream and End stream work in the chat window of an installed CrossChat. No video was sent from these three, and no real platform was used. Other streaming apps haven't been tested; the widgets are ordinary web pages, so one that can show a web page should work.
  • Mac: checked with OBS 33.0.1 on Intel Macs (macOS 15.7.4 and 15.7.9), read-aloud and the phone companion included, and on every change with OBS on an Apple-silicon Mac (macOS 26.6.2); see Mac for exactly what. Without the extension, CrossChat can't move or close its windows on a Mac (macOS refuses that to programs OBS starts, and doesn't ask); with it, it can. Away from home with Tailscale is Windows-only.
  • Linux: checked on Ubuntu 25.10 with Ubuntu's OBS 30.2.3 and OBS 33.0.1 from Flathub, the extension, read-aloud, the docked chat and the phone companion included, and on every change on Ubuntu 24.04 with OBS from the OBS Project's PPA and from Flathub; all of it on a virtual X11 display, with Google Chrome (see Linux for exactly what). Not seen yet on a desktop someone sits at: the chat window there. With the extension, CrossChat's windows were placed, moved and closed on X11, XWayland and Wayland (KWin, on a virtual screen), at a display scale of 100 % only; on Wayland the desktop chooses where they go. Without the extension, on Wayland CrossChat can move and close them only when the browser runs through XWayland. Other distributions, and browsers other than Google Chrome (Snap and Flatpak browsers too), are untested. Read-aloud needs speech-dispatcher, and Google Chrome started with --enable-speech-dispatcher. Ubuntu's and Debian's own OBS package has no Browser Source, so the widgets and the dock need OBS from Flathub or the OBS Project's PPA.
  • CrossChat's windows on Windows are placed Windows' own way, as before, whenever it can see them: the browser's window API counts Windows' invisible resize borders in (asked for a place, a browser window's visible edges were 7 px in at the left, right and bottom, on GitHub's Windows machines). The extension's part on Windows (closing the windows, and placing one Windows can't see) hasn't been run on a real Windows desktop: scripts/window_e2e.py runs on macOS and Linux.
  • Kick replies and moderation use Kick's documented API. On 31 October 2026, with a second Kick account in the chat, delete, timeout, ban and unban worked from the CrossChat window, and timeout also from the CrossChat dock inside OBS; each showed on Kick, in the viewer's chat and the streamer's. Unban also lifts a timeout. Kick chat is read from Kick's public feed, whose key Kick changes now and then; CrossChat asks Kick for the current one. Kick alerts come from that feed and haven't been checked against a real Kick stream yet.
  • Facebook Live (new in 1.6) is read from Live Producer, so a redesign by Facebook can break it until CrossChat is updated. It was built and tested on a real "Only me" Facebook live.
  • Instagram Live (new) is read from Instagram's Live producer, so a redesign by Instagram can break it until CrossChat is updated. Reading comments was built against a real "Practice" Instagram live; replies are typed into the same comment box and were tested on a copy of that page, not yet on a real live. The extension recognises the live, the viewer count and your own comments by Instagram's English labels.
  • Rumble is read through Rumble's official API, which gives the latest 50 messages; CrossChat asks every 5 seconds, so a very busy Rumble chat can miss lines. Replies and Delete were tested on a real (unlisted) Rumble live, on the streamer's own message; the mutes reached Rumble's server, which refused the only test possible (muting yourself). Deleting or muting someone else hasn't been seen working yet: a second Rumble account for the test couldn't be made (on 31 October 2026 Rumble's sign-up stopped at Cloudflare's "Verify you are human" check, which answered "Verification failed"). Rumble's chat window has to stay open while you're live.
  • Facebook comment delete works on someone else's comment: on 31 October 2026 a comment posted by a Facebook Page on a short public test live was deleted from the CrossChat window, and was gone both in Live Producer and for the Page.
  • TikTok LIVE is read from TikTok's own LIVE page, so a redesign by TikTok can break it until CrossChat is updated. Gift, follow, share and join rows were checked against a real public TikTok LIVE; the whole path hasn't run on a streamer's own TikTok LIVE yet (TikTok lets accounts go LIVE from 1,000 followers).
  • X Live depends on X Live Studio's page and needs X Premium. CrossChat clicks through it like a person would, so a redesign by X can break it until CrossChat is updated.
  • YouTube chat is read the same way YouTube's own chat pop-out reads it.
  • YouTube moderation clicks through YouTube's own chat menu, so the signed-in account must own the channel or moderate it. YouTube offers the channel owner Remove, timeout and Hide user only on its own chat page, not in the chat embedded in the CrossChat window, so CrossChat opens YouTube's chat pop-out for your live in a background tab of the browser (never in front) and moderates there. It keeps that one tab for the whole live and closes it once the live is over or CrossChat has closed; a pop-out you opened yourself is used but never closed. On 31 October 2026, in an unlisted live with a second channel in the chat, remove, 5-minute timeout and hide user worked from the CrossChat window, and remove also from the CrossChat dock inside OBS; each showed in YouTube's chat (hide user also in Studio's Hidden users), and the pop-out tab closed itself after CrossChat was closed. YouTube still shows a removed message to the person who wrote it. CrossChat finds your YouTube live on your channel's public live page, which doesn't list unlisted lives, so an unlisted live's chat doesn't show up in CrossChat (the test above gave CrossChat the live's id by hand).
  • Twitch and Kick moderation and replies use their documented APIs. Sign-in and token handling were verified against Twitch and Kick. Twitch delete, timeout, ban and unban were checked on 31 October 2026 on a real second account in the chat, from the CrossChat window in Chrome; timeout and unban also from the CrossChat dock inside OBS. Each showed on Twitch, in the viewer's chat and the streamer's. Kick delete, timeout, ban and unban were checked the same day the same way (see Kick above). A reply typed once in the CrossChat window reached Twitch, YouTube and Kick chat.
  • The companion uses plain http on your home network, like a router's own page. Don't forward its port. For away-from-home use, switch on Tailscale.
  • Twitch and merged chat on stream: Twitch's written simulcasting rules still say not to show other platforms' chat on a Twitch stream, but in February 2026 Twitch's CEO said Twitch won't take enforcement action against creators for showing combined chat. Until the written rules change, the choice is yours: "overlay": {"platforms": ["twitch"]} (or ?platforms=twitch on one source) shows Twitch chat only. Reading every chat in the CrossChat window yourself is fine either way.

Uninstall

Start menu → CrossChat → Uninstall CrossChat, or Settings → Apps → CrossChat → Uninstall (on a Mac: Applications → CrossChat → Uninstall CrossChat; on Linux: Uninstall CrossChat in your app menu). It offers to keep your settings and themes in Documents\CrossChat backup.

Then remove the two pieces it can't:

  • the script in OBS (Tools → Scripts, select it, −);
  • the extension in your browser.

Development

python -m pip install -r hub/requirements.txt pytest ruff
python hub/hub.py --test --twitch <any live channel>     # run the hub without OBS, against real chat
ruff check hub scripts tests
python -m pytest                                         # config, platforms, web server, obs-websocket, companion, features and safety rules
node --test "tests/js/*.test.mjs"                        # theme engine, chat app, widgets, emotes, extension and chat delay
python scripts/obs_e2e.py --obs <portable OBS folder>    # end to end against a real OBS (see the file); on a Mac: python3 scripts/obs_e2e.py
pwsh scripts/package.ps1                                 # builds dist\CrossChat-<version>-windows.zip
python scripts/package_mac.py                            # builds dist/CrossChat-<version>-mac.zip (any system)
python scripts/package_linux.py                          # builds dist/CrossChat-<version>-linux.tar.gz (any system)

pip install lupa (on a Mac: brew install luajit) adds the OBS script tests (tests/test_obs_script.py): they run obs/crosschat.lua in LuaJIT with a stand-in for OBS and check that it starts the hub and restarts a crashed one, on Windows, on a Mac and on Linux. On a Mac or Linux, bash scripts/install.sh installs from a checkout.

python3 scripts/window_e2e.py (macOS and Linux) checks CrossChat's windows with the extension in a real browser: Chrome with a throwaway profile and this checkout's extension (loaded over DevTools, as branded Chrome no longer takes --load-extension), the hub with a stand-in for OBS, and decoy windows of yours that must stay where they are; where the windows really are is asked of the desktop too (macOS's window server, the X server, or KWin). Nothing from the internet loads. On Linux it runs in a home folder, runtime folder and D-Bus session of its own, on an Xvfb display, or with --wayland on KWin's virtual screen (--xwayland for the browser through XWayland). On a Mac, --obs has OBS itself start the hub (OBS's settings in a stand-in home folder, as obs_e2e.py does). The window-control job runs it on every change on GitHub's Ubuntu and macOS machines.

On Linux, the tests that keep a secret need a desktop keyring and are skipped where none answers. To run them without touching your own keyring, give them one of their own: dbus-run-session -- bash -c 'printf test | gnome-keyring-daemon --unlock --components=secrets >/dev/null; python -m pytest'. CROSSCHAT_WINDOW_TESTS=1 xvfb-run python -m pytest tests/test_linux.py adds a check with a real browser window (a throwaway Chrome or Chromium profile).

scripts/obs_e2e.py sets up a throwaway OBS profile with the script, the four widgets and the chat docked in OBS. It streams to an RTMP receiver on your computer (ffmpeg) and checks 27 things (one more on a Mac, one more with OBS from Flathub, one more on Linux with no desktop), from the script starting the hub, through the widgets and the dock inside OBS's own browser, to OBS's WebSocket port being free and the hub leaving once OBS closes. The dock is on screen: the test gives OBS a window layout with it docked (without one, OBS's first start hides every Custom Browser Dock), checks the layout OBS saves as it closes, and presses the dock's Click here to retry when the dock opened before CrossChat answered. It never touches your own OBS: on Windows it uses a portable OBS; on a Mac it runs /Applications/OBS.app with a stand-in home folder (CFFIXED_USER_HOME) and only OBS's own plugins; on Linux it runs obs with its settings in a throwaway folder (XDG_CONFIG_HOME), or with --obs flatpak OBS from Flathub (whose own settings folder it sets aside and puts back), on an Xvfb display of its own when there's no desktop. --crosschat <folder> tests an installed copy instead of the checkout. Version 1.0.0 passed all 19 checks of that time on OBS 33.0.1 on Windows; 1.7.2's 24 passed on OBS 33.0.1 on macOS 15.7.4 and 15.7.9. Three more came with Linux (an OBS started again 3 s after closing has its WebSocket server, starts the hub again, and that hub leaves with it); on Ubuntu 25.10 every check passed with Ubuntu's OBS 30.2.3 (without the browser ones: it has no Browser Source) and with OBS 33.0.1 from Flathub. Until the window layout came, the dock was hidden on every system (OBS's saved layout said "hidden, floating" with OBS 33.0.1 on Windows, macOS and Flathub and with 32.2.0 from the PPA), though its page loaded out of sight. The checks workflow runs it on every change with OBS from Homebrew on GitHub's Apple-silicon Mac (the obs-mac job), against CrossChat installed from the Mac download; with Linux OBS from the OBS Project's PPA and from Flathub (the obs-linux job); and with the portable OBS 33.0.1 on Windows (the obs-windows job), its download checked against the SHA-256 in OBS's release notes and ffmpeg's against gyan.dev's.

Code signing policy

From 1.7.2, the Windows setup program is signed with Azure Artifact Signing under the maintainer's Microsoft-verified identity (publisher Randy Northrup). Every download, signed or not, can also be checked with its GitHub build provenance attestation (see SECURITY.md).

  • Committers and reviewers: Randy Northrup
  • Approvers: Randy Northrup
  • Every release is built by GitHub Actions from this repository's source. Nobody signs anything built elsewhere.
  • Signing happens inside the release workflow, from a GitHub environment only v* tags can use. No signing password or key is stored anywhere: Azure accepts GitHub's short-lived sign-in token from that environment only, and that identity can do nothing but sign. The workflow checks the signature and its timestamp before publishing.

Privacy policy: CrossChat will not transfer any information to other networked systems unless specifically requested by the user or the person installing or operating it. It talks only to the chat platforms you set up, to decapi.me as a fallback for the Twitch viewer count (with your channel name) and, unless you turn them off in Settings, to 7TV, BetterTTV and FrankerFaceZ for emote pictures. Only if you switch them on: Discord, through the webhook you connect, and GitHub, once a day, for the update notice. The full list of connections and what each one sends is in SECURITY.md.

Credits

CrossChat isn't affiliated with or endorsed by OBS Project, Streamlabs, X Corp., Twitch, YouTube, Kick, TikTok, Meta or Rumble.

License

MIT © 2026 Randy Northrup

About

Every stream chat in one window for OBS, Streamlabs, vMix, XSplit or Meld, on Windows, Mac and Linux: read and reply to Twitch, YouTube, Kick, X, TikTok, Facebook, Instagram and Rumble; moderate 5 of them. On-stream chat, alerts, viewer counts, custom logos, read-aloud, Discord posts, phone companion. Signed installer. Runs on your PC, no account.

Topics

Resources

Security policy

Stars

1 star

Watchers

0 watching

Forks

Releases

Used by

Contributors

Languages