Getting Started

MultiBotLabs is a small, always-on-top HUD bar. Each tile is one bot — click to turn it on or off, right-click a bot with more settings to open its manager window.

Requirements

  • Windows, macOS (Apple Silicon), or Linux
  • A Twitch account to connect the app to your channel

Install

Head to the download page and grab the installer for your platform. There’s no separate account or license step — the app authenticates directly against your Twitch account.

Windows

We are investigating a service to sign the windows app to reduce the windows defender warnings that may appear. The current windows defender security model looks at both signed code and a reputation score based partly on the number of downloads an app has. As a small project defender will likely flag the app as suspecious. For the time being you can click past the windows defender warnings.

macOS

As a free app, we are not part of the $100/year Apple developer program. As such, MultiBotLabs is not currently signed and macOS Gatekeeper will block running it. After copying the app to Applications, you need to open the terminal app and run the following to mark the app as safe for Gatekeeper.

xattr -cr /Applications/multibotlabs.app

First run

  1. Launch MultiBotLabs. The HUD bar appears, always on top of everything else.
  2. Open Settings and sign in with Twitch under Integrations. MultiBotLabs uses Twitch’s OAuth implicit grant flow, so it never needs — or stores — a client secret.
  3. In Available Bots, choose which bots show up on the HUD, and drag to reorder them.
  4. Click a bot’s tile on the HUD to enable it. Right-click a bot that has a manager window (Command, Emote, Media, TTS, and others) to configure it.

Overlay bots and OBS

Media, Celebration, and Coinks render on your stream through OBS Browser Sources rather than by capturing an application window — see Overlays & OBS setup for how to add them to a scene.

Building from source

MultiBotLabs is open source. To run it from source instead of an installer:

git clone https://github.com/jodosh/multibotlabs.git
cd multibotlabs
npm install
npm run dev

See the repository README for the full developer setup.