Stream Deck LED-/Icon-Feedback aus SB

~7 Min

Was du lernst

• Live-Werte (Sub-Count, BPM, Mute-State) auf dem Stream Deck anzeigen
• Push aus Streamer.bot heraus via Companion-Variable

Voraussetzungen

• Setup (Companion vs Plugin)
• Globals Pattern

Stream Deck → Feedback

Fortgeschritten

SB pusht Live-Werte ans Deck. Title-Text, Icon-Wechsel, Hintergrund-Farbe. Beide Wege gezeigt.

Patterns

Globals If/Else

Steps

2

Cooldown

0s/User

Cooldown

0sglobal

Zugriff

Broadcaster

Voraussetzungen

WebSocket-Server in SB läuft und Stream Deck ist verbunden: siehe Stream-Deck-Setup. Für Companion zusätzlich das Stream-Deck-Modul aktiv (nicht nur das Streamer.bot-Modul).

Pattern: SB hat eine Action die per Event (Sub, Mute-Toggle, HR-Update, etc.) feuert. Sub-Action Broadcast Custom WebSocket Event schickt den neuen Wert an alle verbundenen Clients. Companion oder das Elgato-Plugin empfangen das Event und updaten die Button-Anzeige.

Beispiel-Action: [Deck] Push Sub-Count

Bei jedem neuen Sub aktualisiert SB einen Persisted Global und pusht den Wert ans Deck.

Trigger: Twitch > Channel > Subscription (alle Tiers, alle Sub-Typen).

1

Global Set. Sub-Count erhöhen

Core ›Globals ›Global (Set)

Inkrementiert die laufende Sub-Zahl für die aktuelle Stream-Session.

Global Name	streamSubCount
Value	$inc(streamSubCount,1)$
Persisted	aktiv

2

Broadcast Custom WebSocket Event

Streamer.bot ›Broadcast Custom WebSocket Event

Pusht den aktuellen Wert an alle verbundenen Clients (Companion, Plugin, Browser-Overlay).

Event Name	subCountChanged
Data (JSON)	{"count": %streamSubCount%}

Action-Tree

1. 1 Global Set: streamSubCount = $inc(streamSubCount,1)$ (Persisted)
2. 2 Broadcast Custom WS Event: subCountChanged { count: %streamSubCount% }

Companion-Seite. Variable empfangen

1. Companion Web-UI öffnen → Variables Tab
2. Streamer.bot-satellite-Connection zeigt nach jedem Event die letzte Payload unter Custom Variables
3. Button anlegen
4. Add Action → Set Title
5. Title-Feld: Subs: $(streamerbot:custom_event_subCountChanged_count)

Companion ersetzt die $(...)-Expression bei jedem Event durch den neuen Wert. Bei Sub-#5 zeigt der Button Subs: 5. Reload des Buttons passiert automatisch.

Icon-Wechsel via Feedback

1. Im Button Feedback Tab
2. Add Feedback → Streamer.bot satellite → Custom Variable Compare
3. Felder:

Feld	Wert
Variable	subCountChanged.count
Comparison	>=
Value	10
Background	grün (Hex #22c55e)

Sobald 10 Subs erreicht sind, wird der Button grün. Reaktiv ohne extra-Polling.

Elgato Stream Deck Plugin. Variable empfangen

Das offizielle Plugin hat eine State Tile. Drag auf eine Taste, dann:

Feld	Wert
Event Name	subCountChanged
Title Template	Subs: {{count}}

Plugin abonniert das Event automatisch und ersetzt {{count}} bei jedem Push.

Beispiel-Action: [Deck] Push Mic-Mute-State

Das Deck zeigt rotes Mic-Icon wenn stumm, grünes wenn an.

Trigger: OBS Studio > Input > Mute State Changed (Filter: Input = Mic Aux).

1

Broadcast Custom WebSocket Event

Streamer.bot ›Broadcast Custom WebSocket Event

Event Name	micMuteChanged
Data (JSON)	{"muted": %muted%}

In Companion einen Button anlegen mit zwei Image-States (mic-on.png / mic-off.png), Feedback micMuteChanged.muted == true → roter Hintergrund + mic-off.png.

Verwendungsbeispiele

Deck-Taste	Live-Wert	Quelle
Subs: 12	streamSubCount	Subscription-Trigger
HR: 142	heartRate	HypeRate-Trigger
🎤 Mute	OBS-Mute-State	OBS-Mute-Trigger
LIVE	Stream-Online	Stream-Online/Offline-Trigger

Polling als Fallback

Wenn der Wert nicht eventgetrieben ist, sondern „immer aktuell“ sein soll: eine Timed Action alle 5 s, die den Wert pusht.

Action [Sys] Deck Heartbeat
  Trigger: Cron: alle 5 s
  Sub-Actions:
    1. Global Get: streamSubCount → localCount
    2. Broadcast Custom WS Event: subCountChanged { count: %localCount% }

Push-Pattern ist sparsamer, Polling ist robuster bei Connection-Drops.

Edge-Cases

• Companion-Variable nicht aktualisiert: meist falscher Event-Name oder JSON-Key-Mismatch. Im Companion-Log live nachschauen welches Event ankommt
• JSON-Escape: wenn dein Wert ein " enthält, JSON manuell escapen oder Backslash-frei umschreiben
• Plugin-Variable null: beim ersten Connect sind alle Custom-Variables null bis das erste Event reinkommt. Init-Push beim WS-Connect machen (siehe Heartbeat oben)
• Title zu lang: Stream-Deck-Tasten zeigen max ~3 Zeilen mit ~5 Zeichen. Variablen-Werte vorher kürzen ($truncate(%streamSubCount%,4)$)
• Mehrere Decks gleichzeitig: Broadcast geht an ALLE Clients gleichzeitig, also beide Decks zeigen den gleichen Wert. Zum Trennen pro Deck eigener Event-Name

Erweiterungs-Ideen

• Streamlabs-Donations anzeigen: Event Donation → Push letzten Donator-Name + Betrag aufs Deck
• Action-Activity-Indicator: eigener Event actionStarted / actionFinished, Deck-Button blinkt während laufender Action
• Heart-Rate-Zone als Hintergrundfarbe: wenn %heartRate% >= 170: Background rot; siehe HR-Zones
• Cross-Stream-Sync: zwei Streamer können sich gegenseitig Events pushen wenn beide SB-WS-Server vernetzt sind

Verwandt

• Action TriggerTaste drücken = Action auslösen.
• Heart-Rate DisplayBPM auf dem Deck anzeigen.
• Audio Mute/UnmuteMute-Status auf dem Deck.

Streamer.bot Import

Import-String folgt

Die Action ist 1:1 nach Anleitung oben nachbaubar.

Quellen

• WebSocket-Server-Guide
• Custom WebSocket Event
• Stream-Deck-Setup
• Stream-Deck Action-Trigger