Stream Deck Integration Setup

~5 Min

Was du lernst

• Stream Deck via Companion oder Plugin mit Streamer.bot verbinden
• WebSocket-Server in Streamer.bot konfigurieren

Stream Deck (Elgato) ist die mit Abstand häufigste Hardware um SB-Actions auf physische Tasten zu legen. Es gibt zwei verbreitete Wege, jeder hat eigene Stärken. Beide nutzen am Ende den WebSocket-Server von Streamer.bot um Actions auszulösen.

Doku: docs.streamer.bot/guide/servers-clients/websocket-server

Welcher Weg ist der richtige?

	Bitfocus Companion	Elgato + SB-Plugin
Hardware	Stream Deck, Loupedeck, X-Touch, MIDI, Web	nur Elgato Stream Deck (Mini/MK.2/XL/+/Mobile)
Kosten	Free (Open Source)	Free, Stream-Deck-Hardware ist Pflicht
Setup-Aufwand	Mittel: eigene App, Web-UI auf :8000	Niedrig. Plugin in Elgato-Software per Marketplace
Feedback (LED-Texte/Icons)	sehr stark, mit Variablen aus SB	gut, mit Variablen aus SB
Cross-PC	super (läuft im Netzwerk)	nur lokal oder über Stream Deck Mobile
Community	dominant in der Reddit-/Discord-Praxis	offizieller, simpler

Empfehlung: Wenn du nur das Elgato-Deck hast und schlanken Workflow willst → Plugin. Wenn du Loupedeck/X-Touch/MIDI nutzt oder mehrere Decks vernetzt orchestrierst → Companion.

Beide Wege schließen sich nicht aus: manche Streamer fahren Companion am Stream-PC und das offizielle Plugin am Gaming-PC parallel.

Voraussetzungen für beide Wege

In Streamer.bot muss der WebSocket-Server laufen:

1. Links Servers/Clients → WebSocket Server
2. Enabled Toggle aktiv
3. Port: 8080 (Default): merken
4. Endpoint: / (Default)
5. Authentication: Optional. Für reines LAN-Setup meist aus. Für Cross-PC oder VPN: Username + Password setzen
6. Save + ggf. Restart Server

Status muss Running sein.

Weg 1. Bitfocus Companion

Bitfocus Companion ist eine eigene App die auf deinem PC läuft und das Stream-Deck (oder Loupedeck / etc.) als „Programmable Surface“ verfügbar macht. Companion bietet ein Streamer.bot Modul an.

Companion installieren

1. Download von bitfocus.io/companion: gewähl die stabile Version (kein Beta) für dein OS
2. Installer durchklicken: Companion startet automatisch als Service
3. Tray-Icon → Launch GUI öffnet die Web-UI im Browser auf http://localhost:8000
4. Beim ersten Start wählst du das Network-Interface (Localhost reicht für lokales Deck)

Stream Deck mit Companion verbinden

1. Elgato Stream Deck Software schließen (Companion und Elgato-Software dürfen sich nicht gleichzeitig das Deck schnappen)
2. Stream Deck per USB anstecken
3. In der Companion-Web-UI: Surfaces Tab → Deck wird automatisch erkannt
4. Falls nicht: Rescan USB klicken

Streamer.bot Modul aktivieren

1. Connections Tab → Add Connection
2. Im Filter streamer.bot eingeben → Modul Streamer.bot satellite wählen
3. Felder:

Feld	Wert
Label	Streamer.bot
Host	127.0.0.1 (oder LAN-IP wenn anderer PC)
Port	8080
Endpoint	/
Password	leer oder das was du im SB-WS-Server gesetzt hast

4. Save → Status muss OK (grün) werden

Bei rotem Status: Port-Tippfehler, Firewall blockt, oder SB-WS-Server nicht Enabled.

Weg 2. Offizielles Elgato-Plugin

Es gibt ein Stream-Deck-Plugin von Streamer.bot, das direkt in der Elgato-Software läuft. Ohne Companion.

Plugin installieren

1. Elgato Stream Deck Software öffnen
2. Rechts oben Marketplace öffnen
3. Suche nach Streamer.bot
4. Plugin installieren
5. Stream-Deck-Software lädt Plugin sofort, neuer Eintrag in der Actions-Liste rechts

Plugin mit SB verbinden

1. In der Elgato-Software: Plugin-Settings öffnen (Plugin-Icon rechts oben über der Actions-Liste)
2. Felder:

Feld	Wert
Host	127.0.0.1
Port	8080
Endpoint	/
Username	leer oder dein SB-Username
Password	leer oder dein SB-Password

3. Connect klicken: Status muss Connected werden

Verbindung testen

Beide Wege haben in der Action-Liste eine Trigger Action Tile. Drag-n-Drop auf eine freie Taste, dann:

1. Aus dem Dropdown Action eine bestehende SB-Action wählen (sie wird automatisch von SB gefetched)
2. Taste am Deck drücken
3. Die SB-Action muss laufen: z. B. [Test] Hello Chat schreibt was im Twitch-Chat

Wenn keine Actions im Dropdown sind → SB-WS-Server hat noch keine Verbindung aufgebaut, neu starten.

Cross-PC Setup

Beide Wege erlauben Stream-Deck auf Gaming-PC während SB auf dem Stream-PC läuft:

1. Stream-PC: SB-WS-Server auf 0.0.0.0 (alle Interfaces), Port 8080 in der Firewall freigeben
2. Stream-PC: LAN-IP rausfinden (ipconfig → IPv4-Adresse)
3. Gaming-PC: Im Companion-Modul oder Elgato-Plugin diese IP statt 127.0.0.1 eintragen
4. Authentication aktivieren: Username + Password setzen, im Client gleich eintragen

Use-Cases in dieser Sektion

Use-Case	MD
Key am Deck löst eine SB-Action aus	Action-Trigger
LED/Icon-Feedback von SB → Deck	LED-Feedback

Häufige Fallen

• Beide Welten gleichzeitig: Elgato-Software und Companion können sich nicht das gleiche Deck teilen. Eine schließen
• Firewall blockt 8080: bei Cross-PC muss der Port auf dem SB-PC freigegeben sein
• WS-Server nicht enabled: der Toggle in den SB-Settings ist nach Install aus. Ohne aktiven Server keine Verbindung
• Plugin lädt keine Actions: meist Auth-Mismatch. Username/Password in Plugin und WS-Server müssen byte-exakt übereinstimmen
• Update-Reihenfolge: wenn SB-Update den WS-Server-Endpoint wechselt, beide Clients neu konfigurieren
• Companion startet nicht als Service: Tray-Icon prüfen, sonst Run as Administrator versuchen (Windows)

Verwandt

• Action TriggerTaste drücken = Action auslösen.
• LED-/Icon-FeedbackLive-Werte auf dem Deck anzeigen.
• InstallationStreamer.bot installieren.

Quellen

• WebSocket-Server-Guide
• Bitfocus Companion: bitfocus.io/companion
• Companion SB-Modul: github.com/bitfocus/companion-module-streamerbot-satellite
• Elgato Stream Deck Plugin (Marketplace): marketplace.elgato.com: Suche Streamer.bot