aquilo.gg
Sign in
All docs
StreamFusion docs

Get up and running with StreamFusion

Windows desktop multi-chat suite. Twitch, YouTube, TikTok, Kick, every message and event in one window.

Install

  1. 1

    Download the signed installer

    Grab StreamFusion-Setup-x.y.z.exe from download.aquilo.gg/streamfusion (auto-redirects to the latest release on GitHub).

  2. 2

    Run it

    It's signed, Windows SmartScreen may still flash once on the very first install because the publisher is new. Click More info → Run anyway.

  3. 3

    Launch StreamFusion

    First run drops you straight into the unified chat feed. The auto-updater takes over from here, every future update installs silently in the background.

Auto-updates are silent

Since 1.4.5 there's no install modal, updates apply on next launch. If you want to pin a specific version, disable updates in Settings → Updates.

Connect Streamer.bot

StreamFusion pulls Twitch + YouTube + Kick chat through Streamer.bot's WebSocket server. Set this up once and StreamFusion auto-reconnects every launch.

  1. 1

    Enable the WebSocket server in Streamer.bot

    Streamer.bot → Servers/Clients tab → WebSocket Server: Enable. Note the host (127.0.0.1), port (default 8080), endpoint (/), and password (set one).

  2. 2

    Paste those into StreamFusion

    StreamFusion → Settings → Connections → Streamer.bot. Host, port, endpoint, password. Hit Connect.

  3. 3

    Confirm the bridge

    The LIVE bar lights up the platforms Streamer.bot is connected to. If Twitch is grey, your SB Twitch login expired, re-auth there, not in StreamFusion.

Don't share the WebSocket password

Anyone who can hit your machine on that port can fire SB actions if the password is weak. Pick a long random string; treat it like any other secret.

Add TikTok via TikFinity

TikTok doesn't expose a public chat API. TikFinity scrapes TikTok LIVE on your behalf and exposes a local WebSocket, StreamFusion treats it like another chat source.

  1. 1

    Install TikFinity + log in

    Get TikFinity from tikfinity.zerody.one. Sign in with your TikTok creator account.

  2. 2

    Enable TikFinity's WebSocket

    TikFinity → Settings → Developer → WebSocket Server: ON. Default port 21213.

  3. 3

    Auto-detect in StreamFusion

    StreamFusion polls localhost:21213 on launch, if TikFinity is running, TikTok chat appears in the feed within seconds. Manually re-detect from Settings → TikTok if needed.

Pop-out chat overlay

The pop-out is a frameless transparent window you drop on top of your OBS game capture. Same chat as the main window, no chrome, fits into the corner of any layout.

  1. 1

    Open the pop-out

    Top bar → Pop Out. A new window appears, drag it onto your stream-side monitor and position over the gameplay area you want chat to live on.

  2. 2

    Toggle click-through

    The unlock button on the pop-out title bar = click-through OFF (you can drag / resize). The lock button = click-through ON (mouse passes through, gameplay still captured).

  3. 3

    Capture in OBS

    OBS → + → Window Capture → pick the pop-out window. Use the 'Windows 10' capture method for transparent backgrounds. Crop with Alt-drag if needed.

Banners and raid splashes are a separate window

Big events (subs, gift bombs, raids, hype-train level-ups) fire from a separate transparent banner window that floats centered over the canvas. Capture it with a second Window Capture source if you want it on stream.

Patreon link

Every StreamFusion feature is free for everyone. Linking Patreon is optional, it gives Patrons early access to brand-new features before they roll out to the public. The app checks your patron status automatically every launch, no token typing.

  1. 1

    Sign in

    Settings → Patreon → Sign in. Browser opens, you authorize on Patreon's site, app picks up the token automatically.

  2. 2

    Wait for the patron-status check

    First sign-in takes a few seconds while the Worker validates. The Patreon chip turns green when your patron status is confirmed.

  3. 3

    Early-access features turn on

    Patrons get brand-new features early, they appear right inside the same build, no separate install. Every feature still rolls out free to everyone shortly after.

Troubleshooting

Chat panel is empty

Check Streamer.bot is running + WebSocket Server is enabled. The LIVE bar in StreamFusion should show platforms in color, not grey. If grey, SB isn't connected; re-auth the platform inside SB.

TikTok stopped flowing

TikFinity occasionally drops its WebSocket when TikTok's API rate-limits. Restart TikFinity; StreamFusion auto-reconnects within ~5 seconds.

Pop-out is invisible in OBS

OBS's Window Capture needs to use the 'Windows 10 (1903 and up)' method for transparent windows. Right-click source → Properties → switch capture method.

App says 'Update failed'

Usually a transient GitHub rate-limit. Wait an hour and try again, or download the latest installer manually from download.aquilo.gg/streamfusion.

Still stuck?

The Discord #support channel is the fastest way to get unstuck. Live help during streams.

Open Discord