Skip to content

Getting started

boing_bot is a Twitch chat bot for musicians. Its website is boingbot.com. This page is for broadcasters and walks you through setting up your channel, from your first sign-in to a working bot in your chat.

boing_bot is invite-only. Your channel has to be added by andy_boing, who runs boing_bot, before you can use it. If you’re interested, contact andy_boing on Twitch.

A newly added channel starts like this:

  • the bot is turned off,
  • it uses the shared bot account boing_bot,
  • song requests are off,
  • the time zone is “No time zone (UTC)”.

If you sign in before your channel has been added, the start page says “You don’t have a boing_bot channel yet.”, and your dashboard address only shows “boing_bot isn’t set up for <your-channel>.”

  1. Open boingbot.com and click Sign in to your dashboard. The Sign in button at the top right of any channel page works as well.
  2. Twitch shows a confirmation page. As the owner of a channel, you are asked to allow boing_bot to read channel data such as your subscribers, VIPs, moderators, editors, followers and bits, and to change your stream title. Confirm it.
  3. You land on your dashboard at boingbot.com/<your-channel>/dashboard.

Twitch remembers your confirmation, so later sign-ins usually go straight through. boing_bot never sees your password.

Your moderators and editors sign in with the same button. Twitch asks them for no extra permissions; it only confirms who they are.

To sign out, open the menu under your avatar at the top right and choose Sign out. This ends the sign-in in this browser only; your other devices stay signed in.

The bot stays silent until you turn it on.

  1. On the dashboard’s Overview, find the Bot card.
  2. Click Activate.

The card now says Active, and the Bot page (sidebar group Channel) says “boing_bot is active and in your chat.” You can turn the bot off again with Deactivate in the same places. Only the broadcaster can do this.

While the bot is off, nothing happens in your chat: no commands, moderation, timers or chat notifications. The bot also sends no chat messages or whispers for things done on the website; for example, opening song requests on the song queue page changes the queue but isn’t announced.

The bot can read and send chat messages without being a moderator, because you allowed that when you signed in. It does need the moderator role to time out and ban users, delete messages, post announcements and see who is in your chat. The moderator badge also shows your viewers that the chat is moderated automatically.

To make the bot a moderator, type this in your Twitch chat (with the name of your own bot account if you use one, see below):

/mod boing_bot

If the bot isn’t a moderator when you activate it, it whispers you:

Hey, I'm not a moderator in your channel yet. Please type '/mod boing_bot' to fix this.

The Overview also shows the notice “boing_bot is not a moderator in your channel!” until Twitch reports the bot as a moderator. You don’t have to dismiss it; it disappears by itself.

The bot speaks in chat under a Twitch account, its bot account. You have two options:

  • The default bot account boing_bot, shared by all channels. Nothing to set up.
  • Your own bot account, for example one with your channel’s name in it. You need a separate Twitch account for it. boing_bot doesn’t take the account over; you only allow it to chat under that name, and you can withdraw that permission at any time in Twitch’s connection settings while signed in as the bot account.
  1. In the dashboard, open Channel > Bot and click Register bot account under “Chat bot account”.
  2. The dialog contains a registration link. It is hidden so it doesn’t show on stream; click Copy (or Show to read it).
  3. Open the link in a private browser window, or in a browser where you are signed in to Twitch as the bot account. Don’t open it in the tab where you are signed in as yourself.
  4. Sign in to Twitch as the bot account. Twitch always shows the authorization page, so check that the right account is named, then authorize boing_bot.
  5. The page says “Almost done!”. Go back to the dashboard and click The bot account authorized, reload in the dialog (or reload the Bot page).
  6. Under “Bot account waiting for your confirmation”, click Use <bot account> as my bot account. If you don’t know the account shown there, click Reject instead.

The bot keeps speaking as before until you confirm. Afterwards, make the new account a moderator with /mod <bot account>.

Your own bot account should follow your channel. If it doesn’t and your channel has follower emotes, they appear as plain text in the bot’s messages, and the Bot page warns you about it. Sign in to Twitch as the bot account, follow your channel and reload the page.

  • To go back to boing_bot, click Use default bot account on the Bot page.
  • To switch to a different own account, go back to the default account first, then register the new one.
  • If you only renamed your bot account on Twitch, you don’t need to do anything.

The dashboard has a sidebar with these groups. On a phone, the Dashboard button opens it as a drawer. The sidebar also appears on your public channel pages (song queue, song list, quotes and the rest), so the dashboard is always one click away.

Group Pages
Overview Overview, Activity
Chat Commands, Timers, Welcome messages, Moderation
Song requests Settings, Song queue, Song list
Notifications Notifications
Widgets Widgets
Integrations Discord, Streamlabs
Channel Bot, Settings, Subscribers

The Overview opens first and shows three cards:

  • Bot: whether the bot is active, the Activate / Deactivate button and a link to the Bot settings.
  • Song requests: Open, Closed or Off, the slots left or the requests still waiting, a Song queue button and a link to the Song request settings.
  • Stream: Live or Offline.

Below them, Recent activity lists the latest five changes to your channel, with who made them and when. Show all opens the Activity page, where you can filter the full list by person and area.

When something needs your attention, the Overview shows it under Needs your attention, each notice with a link to where you fix it. The number of notices also appears as a badge on the Dashboard link in the top bar and on Overview in the sidebar, and it updates live.

Notice What to do
boing_bot lost access to your Twitch account. Click Re-authorize and confirm on Twitch.
boing_bot needs additional permissions. Click Re-authorize and confirm on Twitch.
boing_bot is not a moderator in your channel! Type /mod <bot account> in your chat.
Your bot account <name> needs to be registered again. Register the bot account again on the Bot page.
boing_bot lost access to your Streamlabs account. Disconnect Streamlabs and connect it again.
A text that failed, such as a command response, a timer, a welcome message, a notification or a widget text Follow the link to its editor and fix the text. The notice stays until you save the text or it works again.

If boing_bot loses access to your Twitch account, every boing_bot page you open also shows a dialog with a button to re-authorize. Not now hides it for the current page; it comes back on the next one.

Notices about your Twitch account and the bot account are shown to you only. Notices about failing texts are shown to everyone who can use your dashboard, because moderators and editors fix texts too.

Your moderators and Twitch channel editors can use parts of the dashboard. boing_bot reads these roles from Twitch, so there is nothing to set up: moderator changes arrive right away, and a new editor appears within an hour, or as soon as you open the dashboard.

Who Can use
You (broadcaster) Everything
Moderators and lead moderators Overview, Activity, Commands, Timers, Welcome messages, Moderation, Song request settings, and the moderator functions of the song queue
Editors Overview, Activity, Notifications, Discord settings, Widgets, and managing the song lists on the song list page

The Bot page, the channel settings, Streamlabs and the subscriber list are for you alone.

Open Channel > Settings:

  • Your time zone: choose your city, or click Try auto-detect. The time zone is used for !time, the date of quotes, the subscriber e-mail and the goal widgets. Dates and times on the website are always shown in each visitor’s own time zone.
  • Page access levels: who may see the pages of your channel. Song requests covers the song queue, the song list and the song and user detail pages; Commands and Quotes cover their pages. The levels are Everyone (the default), Signed in, Subscribers, VIPs, Moderators, Lead moderators and Broadcaster.
  • Public song queue API: lets third-party tools with an API key read your song queue while you are live.

Changes are saved with Save settings in the bar that appears at the bottom.

  • Song requests: set up your song list and let viewers request songs.
  • In the dashboard: create your own chat commands under Chat > Commands, add Timers, set up Moderation and Welcome messages, choose your Notifications, and add Widgets to your streaming software.