Zum Inhalt

Stream Deck Integration

Elgato Stream Deck mit Streamer.bot zusammen. Stream-Deck-Tasten triggern SB-Actions, SB updated Stream-Deck-Buttons mit Live-Status.

Doku: https://docs.streamer.bot/api/sub-actions/elgato/stream-deck

Voraussetzungen

  • Stream Deck Hardware (Mini/Standard/XL/Plus) oder Stream Deck Mobile App
  • Stream Deck Software installiert
  • Stream Deck Streamer.bot Plugin installiert (via Plugin-Store in Stream Deck App)

Plugin installieren

  1. Stream Deck App öffnen
  2. Rechts oben Marketplace (oder via Settings → Plugin Store)
  3. Suche "Streamer.bot"
  4. Install
  5. Nach Install im Plugins-Bereich verfügbar

Verbindung

Das Stream-Deck-Plugin verbindet sich automatisch mit Streamer.bot via Local-WebSocket. Wenn beides auf gleichem PC läuft: zero-config.

Bei Multi-PC: - Stream Deck Plugin → Settings (in der Stream Deck App) - Host: 192.168.x.x (IP des Streaming-PCs) - Port: 8080 (Default SB Web Server)

Stream Deck → SB triggern

In der Stream Deck App:

  1. Eine Taste anklicken
  2. Rechts unter Plugin-Liste: Streamer.bot → Trigger Action Drag&Drop auf die Taste
  3. Action auswählen aus SB-Liste
  4. Save

Drückst du jetzt die Taste, läuft die SB-Action.

SB → Stream Deck updaten

Stream Deck hat Sub-Actions zum dynamischen Updaten:

Sub-Action Pfad Was sie tut
Item Set Title Elgato → Stream Deck → Set Title Text auf Button
Item Set Value Elgato → Stream Deck → Set Value Wert (z.B. Counter)
Item Set Background Elgato → Stream Deck → Set Background Hintergrund-Farbe
Item Set Icon Elgato → Stream Deck → Set Icon Custom Icon
Toggle State Elgato → Stream Deck → Toggle State Multi-State Button
Show Alert Elgato → Stream Deck → Show Alert Warn-Symbol
Show OK Elgato → Stream Deck → Show Ok Häkchen-Symbol

Use-Case A: Live-Heart-Rate auf Stream Deck

[Event] Heart Rate Pulse
└── Set Title:
     Item: HR-Display
     Title: %heartRate% BPM

Stream Deck zeigt live deine BPM auf einer Taste.

Use-Case B: Sub-Count Live

[Event] Subscription
├── 1. Get Subscriber Count
└── 2. Set Title:
       Item: SubCount-Display
       Title: %subscriberCount% Subs

Bei jeder neuen Sub updated der Stream-Deck-Button.

Use-Case C: Multi-State Button (BRB/Live)

Stream Deck unterstützt Multi-State-Buttons. Klick wechselt State.

[Cmd] !brb-toggle
├── 1. Get State (Toggle State Sub-Action)
├── 2. If/Else: %currentState% Equals 0
│   ├── OBS Set Active Scene: BRB
│   ├── Toggle State: Item = "BRB-Toggle", State = 1
│   └── Break
├── 3. OBS Set Active Scene: Main
└── 4. Toggle State: Item = "BRB-Toggle", State = 0

Ein Tap = BRB. Nächster Tap = Back to Main. Sichtbarer State-Wechsel auf dem Button (z.B. unterschiedliche Icons für an/aus).

Use-Case D: Status-Indikator

[Event] OBS Recording Started
└── Set Background:
     Item: Recording-Indicator
     Background: #FF0000 (Rot = aktiv)

[Event] OBS Recording Stopped
└── Set Background:
     Item: Recording-Indicator
     Background: #808080 (Grau = inaktiv)

Visuelles Feedback: roter Stream-Deck-Button = Recording läuft.

Use-Case E: Stream-Deck-Page-Switch via Action

Item Set State als Sub-Action erlaubt Switching zwischen Pages oder Profilen:

[Cmd] !game-mode
├── 1. Stream Deck → Page Set: GameProfile
└── 2. OBS Set Active Scene: GameScene

So wechselst du im einen Klick zwischen "Streaming-Layout" und "Just-Chatting-Layout".

Variante: Stream Deck Mobile App

Wenn keine Hardware: Stream Deck Mobile App auf Tablet/Phone — gleicher Workflow, gleiche Integration. Zugriff auf SB-Actions identisch.

Häufige Fallen

  • Plugin lädt nicht — Stream Deck App neu starten. Plugin im Manager checken
  • SB-Verbindung disconnected — Plugin-Settings → Reconnect. Host/Port prüfen
  • Multi-Profile-Verwirrung — Stream Deck hat eigene Profile, du musst pro Profile die Buttons separat zuweisen
  • Title-Update lagt — wenn pro Sekunde aktualisiert (Heart Rate), kann Stream Deck überfordert sein. Throttling auf z.B. alle 2 Sekunden
  • Stream-Deck-Sub-Actions ohne Item-ID — du musst dem Item in Stream Deck App einen Namen geben + den exakt in SB referenzieren

Quellen