Skip to content

Quick Start

Randy Northrup edited this page Nov 8, 2026 · 1 revision

Quick Start

From a fresh install to your first stream. Install first if you haven't: Install.

1. Try it without going live

Start menu → CrossChat → Try the demo (on a Mac or Linux, the Try the demo app entry).

It opens the chat app on a made-up live stream with fictional chatters, questions, subs, raids and moving viewer counts. Reply, moderate, star and feature messages as much as you like. Nothing is posted anywhere, and the demo runs on its own port, so it never mixes with your real chat.

2. Set your channels

Start menu → CrossChat → Open chat → the gear (Settings) → Channels & options.

Type the channels you stream to and press Save. A name, an @handle, a channel ID or a link all work. Changes to channels apply the next time CrossChat starts.

Some platforms need one more step. See Platforms:

  • Twitch and Kick: connect them once, to reply and moderate.
  • Rumble: paste your Live Stream API URL.
  • X, TikTok, Facebook, Instagram: stay signed in to them in the browser that has the extension.

3. Check CrossChat can see your streaming app

With OBS, nothing more is needed once the script is added: it starts CrossChat with OBS and stops it when OBS closes. If a message says CrossChat can't reach OBS, open Tools → WebSocket Server Settings in OBS and tick Enable WebSocket server.

For other apps, see Streaming Apps.

4. Add the widgets

Add each one to your scene as a Browser Source. See On-Stream Widgets.

Widget Address 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

5. Make it yours

Press ✎ in the chat window to open the Theme Studio. Pick one of eight looks, change anything, and save.

6. Test before you go live

  • In the Theme Studio, press the send-test button on any widget to put a made-up message or alert on it.
  • 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.

7. Go live

Start streaming as usual. CrossChat then:

  1. Opens the chat window. Keep it open: it does the work on the YouTube, X, TikTok, Facebook, Instagram and Rumble pages.
  2. Connects each platform's chat.
  3. Opens the live pages it needs, such as your own TikTok LIVE page.
  4. Starts your X livestream, if you turned that on.

Two minutes after you stop, it closes its windows.

Next: Chat Window.

Clone this wiki locally