An SBO Twitch Bot

Mar 2026

Requirements:

SBO, configured and functional

Have the SBO installation guide complete

That's it. Let's get started

-

Part 1 - Twitch Dev Console:

1. Head over to the Twitch Developer Console and login

2. Register an application

Name it as you wish, add " http://localhost:4343/oauth/callback " as the Redirect URL

Select "Chat Bot" as the category and select "Confidential" as the client type

Click the create button

3. Client IDs

You'll be returned to the main dev console page, just click the "Manage" next to your new application

Inside, you'll find a Client ID - copy this and save somewhere (ideally inside the config.ini file next to "dev_Client_ID")

In the dev console, you'll also find a button that says "New Secret", click this

You'll be granted a Client Secret token, place this in the same place as your Client ID (inside config.ini, next to "dev_Client_Secret")

-

Part 2 - The Bot:

1. A Twitch account for the bot

If you already have a spare Twitch account you'd like to use (not the same as your main account), you can use that

Otherwise, go ahead and make one - there's no specifications, but keep it logged in somewhere

This isn't like other Twitch bots that run on a server and interact with your chat, this is a fully locally hosted bot

That also means that if you have the know-how, you can grab the raw .py file from my GitHub and add custom commands ;)

2. Getting the IDs

Head over to a website that can find your Twitch IDs, if you don't know them already

For example; StreamWeasels.com

Do this for both your main account and the bot account

Once you have both, place the IDs and names inside the config.ini file, each in their respective field (twitch_Username, twitch_ID, bot_Username, bot_ID)

-

Part 3 - Configuration:

1. Choose whether to run the bot yourself or let SBO manage it

In the config.ini file, you'll find 2 options relating to the bot's operation

"enable_Twitch_Bot" tells SBO to enable the localhost connection required to pass commands between SBO and the bot

"sbo_Runs_Bot" tells SBO to run the connection AND start the bot program along itself

At least one of these must be on for the bot to function at all

If you prefer total control, you can disable the "sbo_Runs_Bot" part, so the bot is only active when you run it separately (still requires SBO to be running)

2. Peruse the other options

Now's a good time to scroll through the other [Twitch-Bot] section options:

Choose a prefix for your commands (I'd recommend just the standard "!" for ease of use and compatibility)

You can also pick if you want to have the bot send the "this command is on cooldown" messages

-

Part 4 - Running the bot:

1. Launch SBO.exe

If you enabled "sbo_Runs_Bot", it'll launch the bot for you

If you didn't, navigate to SBO/Bot/ and launch SBO-Bot.exe manually

2. Main account authentication

Once the console has settled, head over to the config.ini file once more

Under "twitch_Username" and "bot_Username", you'll find 2 different localhost links

Copy the shorter link under "twitch_Username" and paste it into the browser where your main account is logged in ! IMPORTANT !

You'll get a prompt asking you to authenticate, click yes

This will allow the Application you created earlier to enter your chat via API

3. Bot account authentication

Now you need to do the same for the bot account

Copy the longer link under "bot_Username" and paste it into the browser where your bot account is logged in

You'll once again get a prompt to authenticate, do so

4. Final steps

In the program's console, you should see the status - on the first time, there may be a lot of text, as long as no errors pop up, just let it run

Once ready, the console should say "Successfully logged in as (yourbot)"

Once you see that, the bot is ready

You can run a simple test to check if the bot is good by typing !sbo in your main account's chat

If you see a response from your bot account, great! That's it!

If not, well, try to see if there's any errors in the console - if not, don't hesitate to reach out, I'll help as fast as I can :)

-

Part 5 - Commands:

1. Basics

You can customise the user levels and cooldowns as well as disable each command individually in the "commandConfig.ini" file inside the Bot folder

Each command will have its own section, organised by the command types

-

That's it

At least for now, that's all there is

Check the commands page to see if any new commands have popped up

Otherwise, you're all set

Again, if you run into any bugs, found a better way to do something or just have a question/suggestion, don't hesitate to shoot a message on Discord

I'm always "online" thanks to the nature of DSI, but I'll get back to you as soon as I can!

Any issues? Ideas? Stupid block of code I probably should've fixed?

Make a bug report on GitHub or shoot me a message on Discord: LilPiffer :)