Stream Deck Plugin

Introduction

The Viewbot.tv Stream Deck plugin lets you control your instances directly from your Elgato Stream Deck. Start viewers, chatbots and followbots, fire off a Chat Burst, or monitor your autostart status with a single button press, without ever opening the dashboard mid-stream.

Buttons stay in sync with your live instances: they show real-time progress, switch between start and stop states, and reconnect automatically if you close and reopen the Stream Deck app.

Requirements

•Elgato Stream Deck software 6.4 or newer (works with any Stream Deck hardware)
•macOS 10.15+ or Windows 10+
•A Viewbot.tv account and an API key

Installation

Download the plugin and double-click the .streamDeckPluginfile. The Stream Deck app installs it automatically. You'll find the Viewbot.tv actions under the "Viewbot.tv" category in the actions list.

Download the plugin

Direct link: https://downloads.viewbot.tv/tv.viewbot.streamdeck.streamDeckPlugin

Connecting your API key

The plugin talks to Viewbot.tv using an API key, so it never needs your password.

Click your username in the top-right of the navbar to open the account menu, then click Settings.
In the Settings window, open the API Keys tab.
Click Create Key, give it a name (for example "Stream Deck"), then click Create.
Copy the key right away. For security it is only shown once.
Drag any Viewbot.tv action onto your Stream Deck, open its settings, and paste the key into the API Key field.

One key for every button

The API key is saved globally, so you only enter it once and every action then shares it.

Actions

The plugin ships with five actions. Each works on both Twitch and Kick.

Start Viewers

Launch a viewbot with a configured amount and join delay. Press again to stop; the button shows the live viewer count as it ramps up.

Start Chatbot

Start a chatbot using one of your saved chatlists, with a configurable amount, delay and per-bot or per-message delay mode.

Start Followbot

Launch a followbot with a target amount and delay. The button resets to idle automatically once the target is reached.

Chat Burst

Fire a short, fast burst of chat messages for a set duration, then auto-stop. Perfect for hype moments.

AutoStart Status

Monitor your autostart configuration at a glance: LIVE, startup progress, READY, or OFF.

Chat Burst mode

Chat Burst is built for those big moments like a clutch play, a giveaway, or a raid. Set the number of chatters, a fast delay (for example 1-2 seconds) and a burst duration between 5 and 60 seconds. Hit the button and the plugin floods chat for that window, showing a live countdown, then stops itself automatically, so there is nothing to remember to turn off.

Next Steps

Want to fine-tune what each button does? The bot guides cover every setting in detail:

Viewer Bot Chat Bot Follower Bot API Reference