Get Started

Initial Setup Guide

Let's get you up and running with Streamer.bot!

Overview

This guide covers the basics of the following initial setup of Streamer.bot:

  1. Connect to your streaming platform, such as Twitch or YouTube
  2. Connect your broadcaster software, such as OBS Studio or Streamlabs Desktop

Platforms

Connect your streaming platform account(s) to enable Streamer.bot to receive events and perform actions such as sending messages to your chat.

Streamer.bot supports both Twitch and YouTube as streaming platforms.

Twitch

Connect your Twitch account to Streamer.bot

YouTube

Connect your YouTube account to Streamer.bot


Twitch Setup

Connect your Twitch account to Streamer.bot

Navigate to Platforms > Twitch > Accounts

Twitch Accounts Configuration

Broadcaster Account

The Broadcaster Account is your primary Twitch account where you host your stream. This connection is required for Streamer.bot to monitor your chat and receive Twitch events.

  1. Press Login to launch the Twitch OAuth screen
  2. Review all permissions granted to Streamer.bot and allow access
Streamer.bot will automatically connect to this account on startup.

Bot Account

The Bot Account is an optional second connection if you wish to send chat messages from another account.

  1. Press Login to launch the Twitch OAuth screen
  2. Review all permissions granted to Streamer.bot and allow access
The Bot Account has limited permission scope and can only send chat messages or whispers.
Explore the full Twitch Configuration Guide to learn more about all available options.

YouTube Setup

Connect your YouTube account with Streamer.bot

Navigate to Platforms > YouTube > Accounts

YouTube Account Configuration

If asked, you must click I Agree to continue to the YouTube configuration screen.

Broadcaster Account

The Broadcaster Account is your primary YouTube account where you host your stream. This connection is required for Streamer.bot to monitor your chat and receive YouTube events.

  1. Click Sign in with Google to launch the Google OAuth screen
  2. Review all permissions granted to Streamer.bot and allow access
  3. Enable Auto Connect to automatically connect to your YouTube account when Streamer.bot starts up
The username field is read-only. Your authenticated username will display here once you have signed in.
If you stream from a brand account: the proper permissions will not be granted if you select the brand account on the first screen. You must first sign in to the primary YouTube account which has ownership of the brand account. You will then be able to select from owned brand accounts on the following screen.

Bot Account

The Bot Account is an optional second connection if you wish to send chat messages from another account.

  1. Click Sign in with Google to launch the Google OAuth screen
  2. Review all permissions granted to Streamer.bot and allow access
  3. Enable Auto Connect to automatically connect to your YouTube account when Streamer.bot starts up
Explore the full YouTube Configuration Guide to learn more about all available options.

Broadcasters

Set up your broadcasting software to work with Streamer.bot

OBS Studio

Take control of your OBS Studio instance(s) with Streamer.bot

Streamlabs Desktop

Control Streamlabs Desktop with Streamer.bot

OBS Studio is highly recommended and provides the most functionality

OBS Studio

Configure Streamer.bot to remotely control your OBS Studio instance(s).

This guide assumes you are running OBS Studio version 28.0.0 or later

Enable OBS WebSocket Server

In OBS Studio, navigate to Tools > WebSocket Server Settings from the menu bar

OBS Studio WebSocket Settings

If you don't see the WebSocket settings, and you have verified you are on version 28.0.0 or later, navigate to Help > Verify Files from the menu bar.
  1. Ensure the Enable WebSocket server setting is enabled (checked)
  2. Change the Server Settings as desired
    • You will enter these values in Streamer.bot in the next steps

Configuration

Set up your OBS Studio connection in Streamer.bot

Navigate to Stream Apps > OBS

OBS Studio Configuration

To add a new connection, Right-Click anywhere in the panel area and select AddOBS Studio Add Connection

  1. Enter a name for this OBS connection
  2. Select version v5.x
  3. If OBS Studio is running on the same machine, keep 127.0.0.1 for the Host field
    • For multi-pc setups you can configure this with another LAN IP address
  4. Configure Port and Password to match the WebSocket Server Settings setup in OBS Studio
  5. Click OK when you have finished configuration
  6. Right-Click the new instance and select Connect to force an immediate connection attempt
If you are having trouble connecting, double-check the Host, Port, Password, and Version to ensure it matches your OBS Studio instance.
Explore the full OBS Studio Configuration Guide to learn more about all available options.

Streamlabs Desktop

Set up Streamer.bot to remotely control your Streamlabs Desktop instance

Prerequisites

Obtain your API Token and Port from your Streamlabs Desktop settings.

Navigate to Settings > Remote Control in Streamlabs Desktop

Streamlabs Desktop Remote Control

Save these settings for the next steps.

Configuration

Set up your Streamlabs Desktop connection in Streamer.bot

Navigate to Stream Apps > Streamlabs Desktop

Streamlabs Desktop Configuration

To add a new connection, Right-Click anywhere in the panel area and select Add

Explore the full Streamlabs Desktop Configuration Guide to learn more about all available options.