GriddleBot for Stream Deck

Your stream, your chat and your soundboard on physical keys.

The plugin talks only to the GriddleBot Software on your own PC, so it works while the Software is open and every key tells you when it cannot: Set token, Wrong token, Software not running or Update Software appear in place of the key's image. Windows only, because the GriddleBot Software is Windows only. Stream Deck app 7.1 or newer.

How to install it

  1. Elgato Marketplace: open https://marketplace.elgato.com/product/griddlebot-870f6605-36e0-4247-a662-6f01325176ea and press Install.
  2. Direct download from GriddleBot: https://griddlebot.com/downloads/tools/griddlebot-16bb81ab.streamDeckPlugin (245 KB, version 1.1.0.0). Download, then double-click the file; the Stream Deck app installs it.

Setting it up

  1. Install the plugin: from the Elgato Marketplace, or download the file from this page and double-click it. The Stream Deck app installs it.
  2. In the GriddleBot Software, open Macros, then the "Stream Deck & external control" card, then Advanced, and copy the Token.
  3. In the Stream Deck app, drag any GriddleBot key onto your deck and paste the token into the key's settings.
  4. Press Test. The token is shared by every GriddleBot key, so you only paste it once.

Stream & OBS

  1. Switch Scene: switches OBS to a scene. The key stays lit while that scene is live.
  2. Toggle Source: shows or hides a source in the current scene.
  3. Stream: starts or stops your stream, or start only / stop only. Lit while you are live.
  4. Recording: starts or stops recording. Lit while recording.
  5. Replay Buffer: arms or stops the OBS replay buffer. Lit while it is on.
  6. Save Replay: saves the replay buffer to a file.
  7. Toggle Mute: mutes or unmutes an OBS audio input. Lit while muted.
  8. Stream Marker: drops a marker on your Twitch VOD, with an optional note (Twitch, live only).
  9. Clip: makes a clip the way your own !clip does, with a clip length of your choice (Software 1.7.48 or newer).

Sound & music

  1. Play Sound: plays a sound from your soundboard.
  2. Play / Pause Songs: pauses or resumes the song player. Lit while a song plays.
  3. Skip Song Request: skips the song playing now.
  4. Clear Song Requests: clears the whole request queue. Hold the key for one second; a tap is ignored.
  5. Stop Media Share: stops the media share playing now.
  6. Skip TTS: skips the line being read. The rest of the queue carries on.

Chat & community

  1. Start Poll: starts a poll with your question, options (one per line) and length.
  2. Start Prediction: starts a channel prediction (Twitch only).
  3. Giveaway: starts, draws or closes a giveaway. Hold for one second to close.
  4. Shout Out Raider: runs your own !so for the last raider this stream.
  5. Post Scheduled Message: posts one of your timed messages now. Its schedule is untouched.

Moderation & monetization

  1. Shield Mode: turns Twitch Shield Mode on or off, or toggles it. Lit while it is on.
  2. Chat Mode: slow, followers-only or subscribers-only chat on Twitch or Kick. Lit while it is on.
  3. Run Ad: runs a Twitch ad break of 30 to 180 seconds.
  4. Snooze Ad: snoozes the next scheduled Twitch ad.

Keys & dials

  1. Volume: up, down, mute, set or show for the soundboard, TTS, songs, an OBS source or Windows. Hold to repeat, pair two keys as a slider, or turn a Stream Deck+ dial.
  2. Multi-Press: one key, several actions: a press, a double press, a triple press and a hold each run their own action.
  3. Run Macro: runs one of your Software macros, so anything a macro can do fits on a key.

When a key shows a message

  1. Set token: The key has no token yet. Paste the token from the Software into any GriddleBot key and press Test.
  2. Wrong token: The token does not match the Software. Copy it again from Macros, Stream Deck & external control, Advanced, and paste it into the key.
  3. Software not running: Start the GriddleBot Software on the same PC as the Stream Deck app. The plugin only talks to the Software on this PC.
  4. Update Software: The key needs a newer Software than the one running (a clip length needs 1.7.48 or newer). Update the Software and try again.
  5. A short reason after a press: When the Software refuses for a reason you can act on, the key shows it for a moment: not live, no raid yet, Twitch only.

Download the free GriddleBot Software  ·  Put a macro on a Stream Deck button  ·  Everything GriddleBot does

GriddleBot home  · Features  · Download  · Pricing  · Discover