Download OverlayHub

Download the Windows beta, extract the complete folder, and launch the desktop app.

1. Click Download OverlayHub App above and wait for the ZIP download to finish.
2. In File Explorer, right-click the downloaded ZIP and select Extract All…. Choose a folder you want to keep and finish extracting.
3. Open the extracted folder and double-click OverlayHub.Desktop.exe. Run it from the extracted folder, not from inside the ZIP, and keep the app’s plugins, browser files, and assets together.
4. OverlayHub requires the Microsoft Edge WebView2 Evergreen Runtime. Install it if it is missing on your Windows PC, then launch OverlayHub again.
5. Leave OverlayHub running while you stream. Use the next section to connect your platforms and OBS.

For this setup, run OverlayHub and OBS Studio on the same Windows PC. The overlay and dock links supplied by the app use a local connection.

Connect Twitch, YouTube, and Kick

1. In OverlayHub, open Settings and find Installed plugins.
2. Make sure the platforms you want to use are Enabled, then click Connect beside each one.
3. When your browser opens, sign in to the streaming account you want OverlayHub to use. Review the requested permissions and approve access. Repeat for your other platforms.
4. Return to OverlayHub and check each platform’s Connection and Channel. Previously authorized accounts may reconnect without another sign-in. If you need to change accounts, use Disconnect, then connect with the correct account.
5. Open Home to view your combined chat. Start your broadcast when you are ready and send a test message from the platform’s live chat. For YouTube, make sure your live broadcast has live chat enabled. Use All platforms or a platform filter to check incoming messages.

Connect OBS through its WebSocket server

This connection lets OverlayHub control OBS scenes, sources, audio, and other supported actions. Browser sources are added separately in the next section.

1. Open OBS Studio. OBS Studio 28 and later include the WebSocket server.
2. Open Tools → WebSocket Server Settings, turn on Enable WebSocket server, and keep Enable Authentication checked.
3. Use Show Connect Info to find your server port and password. The default port is 4455. Apply your settings.
4. In OverlayHub, open Settings → OBS Connection. For Address, enter ws://127.0.0.1:4455 when both apps are on the same PC. If you changed the OBS server port, replace 4455 with that port.
5. Paste the OBS WebSocket password into Password, click Connect, and confirm the status changes to Connected.
6. Click Refresh Scenes & Sources after changing your OBS scene collection or adding sources so OverlayHub’s action selectors show your current setup.

Keep OBS and OverlayHub open while using OBS actions. Your OBS WebSocket password belongs in OverlayHub’s OBS Connection settings, not in an overlay URL.

OBS WebSocket documentation ↗

Chat overlay browser sources

1. Open Chat Overlay in OverlayHub. Select or create the overlay profile you want, customize its appearance, and use the sample chat preview to check your design.
2. Scroll to the bottom of the panel on the right and find OBS & browser dock links. Copy the OBS Browser Source: [profile name] link for the profile you want to display.
3. In OBS, choose your scene. Under Sources, click + → Browser, create a source, and give it a clear name such as OverlayHub Chat.
4. Leave Local file unchecked and paste the copied link into URL. Set the source’s width and height for your chat layout, then position it in the scene. You can start with 500 × 800 for a vertical chat area and adjust it to suit your stream.
5. Keep OverlayHub running and confirm a real message from a connected platform appears. The designer’s sample chat is a preview; it is not sent to your live overlay.

For different layouts in different scenes, create additional profiles in Chat Overlay and copy each profile’s own browser source link. To share one layout across scenes, add the existing OBS source instead of creating another copy.

Alert browser source

1. In OverlayHub, open Alerts and copy the OBS Alert Browser Source link at the top.
2. In OBS, add another Browser source named OverlayHub Alerts. Leave Local file unchecked and paste the alert link into URL.
3. Match the browser source dimensions to your alert canvas. The default alert canvas is 1920 × 1080. Place the source above the scene elements you want alerts to appear over.
4. Leave Shutdown source when not visible and Refresh browser source when scene becomes active unchecked so changing scenes does not unload or restart the alert page. Reuse this existing source in other scenes where alerts should appear.
5. Create and save your alerts in OverlayHub, enable the Alerts Master Toggle, and trigger an alert through your configured Macro or event to confirm it displays. If the alert’s Audio Device is OBS Browser Source, enable Control audio via OBS in the source properties to manage it in the OBS mixer.

Moderation dock

1. In OverlayHub, open Chat Overlay, scroll to OBS & browser dock links at the bottom of the right panel, and copy the Moderation Dock link.
2. In OBS Studio, open Docks → Custom Browser Docks….
3. Enter OverlayHub Moderation as the dock name, paste the copied link into URL, and click Apply.
4. Close the settings window, then drag and resize the dock beside your streaming controls. Keep OverlayHub running so the dock can connect.

The moderation dock is a control panel for you; add it as a dock rather than a scene source. Always copy the links shown by OverlayHub so they match your selected profiles and browser port.

OBS browser source documentation ↗

Pair once, then choose your Macros

1. Open OverlayHub and go to Settings → Stream Deck. Turn on Enable Stream Deck. Leave the port at 8183 unless you need a different one.
2. In the Stream Deck app, find OverlayHub → Run OverlayHub Macro in the action list and drag it onto a key. Select that key to open its settings.
3. In OverlayHub, click Pair Stream Deck. Enter its 10-character code in the key’s Pairing code field in Stream Deck and click Pair within two minutes. If you changed the port, enter the same Local port in the plugin and click Apply Port.
4. When the plugin shows Connected to OverlayHub, select an existing Macro from the Macro dropdown. If you have no Macros yet, create one in Engagements → Macros in OverlayHub and enable the Macros master toggle and the individual Macro.
5. Choose Ignore While Active or Queued to prevent repeated runs, or Queue Another Run to submit another run on each press. Press the key to test. The key highlights while the Macro is running, including while it waits for an Alert.

All OverlayHub keys share the paired connection. Keep both apps running. OBS is only required for Macros that use OBS actions; connect it through OverlayHub’s Settings first. Separate Alert-control buttons are not included—use a Macro that plays an Alert.