Stream Deck Key → SB-Action

Stream Deck → Action Trigger

Einsteiger

Eine Taste am Deck triggert eine ganz normale SB-Action: mit optionalen Argumenten aus dem Deck heraus.

Patterns

Steps: 3
Cooldown: 0s/User
Cooldown: 0sglobal
Zugriff: Broadcaster

Pattern: SB hat eine Action mit Trigger Streamer.bot → External Action (also ohne Twitch-/OBS-Trigger), Deck schickt per WebSocket den Action-Namen oder die Action-ID, optional mit Argumenten. Die Action läuft, als hätte sie ein interner Trigger ausgelöst.

Beispiel-Action: `[Deck] Be Right Back`

Klassischer Deck-Use-Case: eine Taste schaltet auf BRB-Szene + spielt Sound + postet im Chat.

Set Active Scene. BRB

OBS Studio Scenes Set Active Scene

Scene	`BRB`

Play Sound

Core Sounds Play Sound

File	`C:\sounds\brb-jingle.mp3`
Volume	`50`

Send Message to Channel

Twitch Chat Send Message to Channel

Message	`🚶 Bin gleich wieder da: bleibt dran.`

Action-Tree

1 Set Active Scene: BRB
2 Play Sound: brb-jingle.mp3 (Volume 50)
3 Send Message: "🚶 Bin gleich wieder da..."

Trigger-Setup in SB

Die Action selbst braucht keinen Trigger: sie wird vom Deck per WebSocket aufgerufen. Aber: die Action muss in einer Group liegen, die nicht disabled ist.

Optional: Streamer.bot → General → Action Run als Trigger nutzen wenn diese Action auch von anderen Actions aus aufgerufen werden soll.

Stream-Deck-Seite einrichten

Mit Bitfocus Companion

Companion Web-UI öffnen → Button-Slot wählen
Add Step → Add Action
In der Action-Liste: Streamer.bot satellite → Trigger Action
Felder:

Feld	Wert
Connection	`Streamer.bot` (die vorher angelegte)
Action	`[Deck] Be Right Back` aus dem Dropdown
Arguments	leer

Save → Button-Layout (Text/Icon) optional

Mit Elgato Stream Deck Plugin

Stream-Deck-Software öffnen → Profile auswählen
Aus der Action-Liste rechts Streamer.bot → Do Action auf eine Taste droppen
Felder:

Feld	Wert
Action	`[Deck] Be Right Back` (Plugin holt die Liste live aus SB)
Arguments	leer (oder JSON, siehe unten)
Title	`BRB`

Eigenes Icon oben drauflegen via Drag & Drop

Taste drücken → SB-Action läuft.

Mit Argumenten

Wenn die SB-Action Argumente erwartet (z. B. eine Scene als Variable), kannst du sie aus dem Deck mitgeben:

Argument	Wert
`sceneName`	`BRB`
`chatMessage`	`🚶 Bin gleich wieder da`

Im Companion-Modul gibt es ein Arguments JSON Feld, im Elgato-Plugin ein JSON-Args Feld. Format:

{
  "sceneName": "BRB",
  "chatMessage": "🚶 Bin gleich wieder da"
}

In der SB-Action greifst du die Werte als Argument %sceneName% Argument vom externen Trigger, hier vom Stream-Deck-Button. Variablen-Doku und Argument %chatMessage% Argument vom externen Trigger. Variablen-Doku ab. Wenn du das gleiche Set-Active-Scene-Pattern hast, könntest du eine generische [Deck] Switch Scene Action mit sceneName als Argument bauen: und 5 Deck-Tasten triggern die gleiche Action mit unterschiedlichen Scene-Namen.

Multi-Action pro Taste

Companion erlaubt mehrere Steps pro Button. Step 1 startet die BRB-Action, Step 2 (nach Doppel-Tap) startet die [Deck] Back from Break Action. Pro Step ein eigener Trigger-Action-Aufruf.

Im Elgato-Plugin via Multi-Action Tile: 2× Trigger-Action hintereinander.

Verwendungsbeispiele

Deck-Taste	SB-Action	Kontext
`BRB`	`[Deck] Be Right Back`	Pause-Szene + Jingle
`Back`	`[Deck] Back from Break`	Stream-Szene + Welcome-Message
`Clip`	`[Deck] Quick Clip`	Erstellt Clip + postet URL
`So`	`[Deck] Shoutout Last Raider`	Wandelt `%lastRaider%` in Shoutout

Edge-Cases

Action ist disabled: Button funktioniert nicht, Deck zeigt keinen Fehler. Action in SB auf Enabled prüfen
Action-Name geändert: Deck-Button referenziert nach Action-ID (Companion) oder Action-Name (Plugin, je nach Version). Bei Rename: Button neu zuordnen
Spam-Taps: Deck schickt jeden Tap. Wenn die Action 5 s läuft, queue’t sich der zweite Tap. Lösung: Queue: Blocking in der Action-Einstellung, oder Cooldown-Pattern via Global
Argument-Tippfehler im JSON: Companion erkennt Syntax-Errors meist, Elgato-Plugin manchmal nicht. Bei „funktioniert nicht“: JSON in einem Validator gegenchecken

Erweiterungs-Ideen

Page-Switch: Deck auf eine andere Page schalten direkt aus der SB-Action heraus (z. B. nach Stream-Start auf die „Live“-Page); Companion-Modul hat dafür Set Page Action
Variable-Bridge: Deck zeigt einen Live-Wert von SB an (Sub-Count, HR, etc.); siehe LED-Feedback
OBS-Macro statt SB: wenn die Action nur OBS-Steuerung ist, kann Companion auch direkt das OBS-Modul nehmen. Aber SB als Layer drüber gibt Logging + Logik gratis