Setup

Setup

Dieser Leitfaden bringt dich vom „Stream Deck eingesteckt“ zu „erste Chatlix-Aktion läuft per Tastendruck“.

1. Stream Deck Software installieren

Falls noch nicht: Lad die Stream Deck Software von Elgato (https://www.elgato.com/) und installier sie. Verbinde das Gerät, prüf dass die Tasten reagieren.

Die Software erkennt Stream Deck (Original, Mini, XL, Plus, Mobile) automatisch.

2. Chatlix-Plugin installieren

Im Chatlix-Dashboard auf /dashboard/streamdeck klick « Plugin herunterladen ». Du bekommst eine .streamDeckPlugin-Datei. Doppelklick installiert sie in der Elgato-Software.

Nach erfolgreicher Installation siehst du in der Stream Deck Software unter der Aktions-Liste rechts den Bereich „Chatlix“ mit den verfügbaren Chatlix-Aktionen.

Alternativ: Über /v1/streamdeck/plugin kannst du die aktuellste Plugin-Datei direkt via API ziehen, falls du das automatisiert deployen willst.

3. API-Token anlegen

Im Chatlix-Dashboard /dashboard/tokens:

• « Neues Token ».
• Name: z.B. „Stream Deck Hauptrechner“.
• Scope: streamdeck.
• Anlegen, Token einmal kopieren (wird danach nur als Suffix angezeigt).

API-Pendant: POST /v1/tokens/ mit {"name":"Stream Deck Hauptrechner","scope":"streamdeck"}.

4. Plugin authentifizieren

In der Stream Deck Software klick auf eine beliebige Chatlix-Aktion und zieh sie auf einen freien Button. Beim ersten Mal öffnet sich ein Konfig-Panel mit „Token einfügen“:

• Token einsetzen.
• « Verbinden ».
• Es prüft die Verbindung gegen POST /v1/streamdeck/auth. Bei Erfolg siehst du rechts grün den verbundenen Account-Namen.

Das Token wird einmal hinterlegt und gilt dann für alle Chatlix-Aktionen auf dem Gerät; du musst es nicht pro Button neu eingeben.

5. Erste Aktion anlegen

Wähl als Test die Aktion « Sound abspielen ». Im Konfig-Panel:

• Asset: Klick « Asset wählen » und such ein Sound-Asset aus deiner Media Library (z.B. Test-Beep).
• Lautstärke: 60%.
• Cooldown: 1 Sekunde.

Speichern. Drück die Taste auf dem Stream Deck. Wenn dein OBS mit Chatlix-Overlay läuft, hörst du den Sound.

Im Chatlix-Dashboard kannst du parallel auf /dashboard/streamdeck sehen, dass die Aktion ausgeführt wurde (Last-Action-Log mit Zeitstempel).

6. Buttons strukturieren

Stream Deck hat „Folder“-Buttons (Unterordner). Empfehlung:

• Erste Seite mit den häufigsten Aktionen (5–10 Buttons).
• Folder „Sounds“ mit allen Soundboard-Tasten.
• Folder „Overlays“ mit Szenen-Wechseln.
• Folder „Quest“ für StoryQuest-Choices, falls du oft im Multi-Mode bist.
• Folder „Test“ für gefährliche Aktionen (Hype-Train-Test, Counter-Reset) — eine Stufe weg vom Haupt-Layout, damit du nicht versehentlich drückst.

7. Pro Profil eigene Layouts

Stream Deck Software unterstützt Profile pro Anwendung. Du kannst z.B. ein Profil „Just Chatting“ mit anderen Chatlix-Aktionen anlegen als „Gameplay“. Profil-Wechsel sind Stream-Deck-nativ, das Plugin macht da nichts Eigenes.

8. Mehrere Geräte

Wenn du z.B. einen Hauptrechner und einen Mobile-Stream-Deck nutzt: Pro Gerät ein eigenes API-Token anlegen. So kannst du einzelne Geräte revoken, ohne die anderen zu verlieren.

Troubleshooting

• Plugin nicht in der Liste: Stream Deck Software neu starten. Falls weiterhin fehlend, Plugin-Datei erneut doppelklicken.
• „Token ungültig“: Token im Dashboard prüfen (existiert noch? Scope streamdeck?). Neu anlegen, im Plugin austauschen.
• Aktion zeigt im Log „PLAN_REQUIRED“: Einige Aktionen sind plan-gated. Plan-Hinweis im Dashboard prüfen.
• Sound spielt nicht: Overlay aktiv? Browser-Source in OBS gerade aktualisiert? Im Chatlix-Dashboard /dashboard/overlays siehst du den Verbindungs-Status pro Overlay.
• Tasten reagieren verzögert: Internet-Latenz zwischen Stream-Deck-Rechner und Chatlix prüfen. Normalerweise <200ms; bei 1s+ stimmt etwas auf Netzwerk-Ebene nicht.