// Overlays
Free download
Guide

Connect your overlay to Streamer.bot

Winners get paid automatically, with no manual bookkeeping.

Without a bot the overlay only shows which command would have to be sent, and you type it yourself. With Streamer.bot that step disappears. That means your chat bot's own points, not Twitch channel points.

10 minutes Advanced OBS Browser Source

Step by step

// How it works

  1. 01

    Start the WebSocket server in Streamer.bot

    Streamer.bot ships a small server that lets other programs talk to it. That is exactly what the overlay uses. In Streamer.bot go to Servers/Clients, then WebSocket Server, set Auto-Start on, address 127.0.0.1 and port 8080. You do not need a password for this route.

  2. 02

    Create an action that passes messages along

    In Streamer.bot an action is a named sequence of steps you can trigger later. You need one that does nothing but send a supplied message to chat. In the Actions tab, right-click to add a new action and name it OverlayChat. In the panel on the right, right-click to add a sub-action: Twitch, then Send Message. As the message enter exactly %text%, percent signs included. That is the placeholder the overlay fills with its text. Save.

  3. 03

    Point the overlay at Streamer.bot

    In the Config Hub, pick Streamer.bot as your bot under Connection. Then enter the address ws://127.0.0.1:8080/ and below it the name of the action from step 2, so OverlayChat. Clicking Apply changes writes both into the config.js of every overlay in your folder, so you only do this once. If you would rather edit the file yourself, it is the same three values there: outputSource to streamerbot, plus streamerbotUrl and streamerbotChatAction.

    The connection form in the Config Hub: the Streamer.bot tile is selected, below it the fields Streamer.bot address and Streamer.bot chat action
    The Streamer.bot tile in the Config Hub reveals exactly those two fields, and ws://127.0.0.1:8080/ and OverlayChat are already filled in as defaults.
  4. 04

    Check the connection

    Refresh the overlay in OBS. If debug is set to true in config.js, the overlay shows a small status pill at the top. If it reads streamerbot: armed, the connection is live. A test round now pays out automatically, and you can switch debug back off afterwards.

Frequently asked

// In short

Why go through an action instead of just using a password?

Because the direct route is gated in Streamer.bot 1.0.x. That version no longer asks for a password when you connect, but still blocks sending chat messages directly. Entering a password does not help, because it is never requested. The action route needs no authentication and works.

It does not say armed, it says something else

Then the overlay cannot reach the server. Is Streamer.bot actually running, is the WebSocket server set to Auto-Start, and do address and port match what streamerbotUrl says in config.js? The most common case is a different port.

Does this work with StreamElements or Firebot too?

Yes, and there it is even more direct: StreamElements and Firebot book the points through their own interface, with no visible chat message at all. In config.js set outputSource to streamelements or firebot and fill in the matching credentials. Which service is good for what I compare in the article on the alternatives.

What happens with no bot at all?

The overlay shows a ready-made payout command, for example !addpoints name amount. Your existing loyalty bot can run it, or you type it yourself. Nothing is lost, it is just manual.

Last updated on August 1, 2026.

All overlays