Was ist Chatlix Connect?

Chatlix Connect ist ein kleines Programm, das lokal auf deinem Streaming-PC läuft und die Brücke zwischen OBS und deinem Chatlix-Dashboard baut. Das hängt vom Kanal ab: Der Stable-Build (0.6.0) ist tatsächlich eine in eine EXE gepackte Node.js-Runtime (Build-Tool pkg, ~38 MB), reine Kommandozeile/Tray ohne eigenes Fenster. Der aktuelle Beta-Build (0.8.1-beta.4) ist dagegen eine Electron-App (gebaut mit electron-builder aus dem desktop/-Unterprojekt, portable EXE ~79 MB) mit echten Fenstern für einzelne Module (z. B. Rundleuchte-Tab, Govee-Pixel-Tab, ASCII-Stream-Fenster) zusätzlich zum Tray-Icon. Die Grund-Einrichtung (Token einfügen, OBS-Suche) läuft trotzdem größtenteils textbasiert/assistentengeführt ab — Details zur genauen Bedienoberfläche der Beta-Fenster sind in dieser Doku nicht durchgängig verifiziert.

Was Connect konkret tut

Verbindet sich lokal per OBS-WebSocket (Port 4455 bzw. 4444 bei alten Installationen) mit deinem laufenden OBS.
Hält eine ausgehende, verschlüsselte Verbindung zu wss://ws.chatlix.app/ws offen — Connect ruft Chatlix an, niemand ruft von außen deinen PC an.
Leitet Befehle aus dem Dashboard (Szene wechseln, Quelle ein-/ausblenden, Lautstärke, Aufnahme starten, …) an OBS weiter und schickt den aktuellen OBS-Zustand zurück, damit das Dashboard live Szenen, Quellen und Audio-Pegel anzeigen kann.
Optional: bridged weitere lokale Tools wie den Game Watcher, den Postkarten-Drucker (DYMO) oder — je nach Modul-Version — Govee-Lighting, Local-Input und Local-Sound-Trigger.

Wann du Connect brauchst

Du willst OBS-Szenen, Quellen-Sichtbarkeit, Position/Skalierung von Quellen oder Lautstärken aus dem Dashboard/Automation-Builder heraus steuern.
Du willst Stream/Aufnahme aus Chatlix heraus starten oder stoppen, ohne OBS-Hotkeys einzurichten.
Du nutzt den Game Watcher oder willst Screenshots/Live-Vorschauen einzelner Szenen im Producer-Pult sehen.

Wann du Connect nicht brauchst

Du nutzt nur Overlays als Browser-Source in OBS (die laufen unabhängig von Connect).
Twitch-Events kommen direkt per EventSub-Webhook am Backend an — dafür brauchst du keinen lokalen Client.
Du willst eine reine Web-Only-Konfiguration ohne OBS-Fernsteuerung.

Viele Setups laufen komplett ohne Connect. Wenn du am Anfang nur Alerts und ein paar Overlays brauchst, kannst du Connect jederzeit später nachrüsten — siehe Chatlix Connect installieren.

Was Connect nicht ist

Kein Twitch-Bot mit Chat-Commands — das läuft serverseitig bei Chatlix.
Kein Aufnahme- oder Streaming-Tool selbst; OBS bleibt dafür zuständig, Connect drückt nur die Knöpfe.
Kein Pflichtbestandteil von Chatlix — ein optionales, lokal installiertes Zusatzprogramm.
Keine Cloud-Telemetrie: Connect sendet ausschließlich Status-Pings ("OBS verbunden", "Aktion ausgeführt") und Ergebnisse deiner eigenen Befehle. Keine Screen-/Kamera-/Audioinhalte, keine Tastatur-/Mauseingaben, keine Szenen-, Quellen- oder Audiokanal-Listen ohne dass du danach fragst.

Architektur

  [ OBS Studio ]
        |
  OBS-WebSocket (lokal, i.d.R. Port 4455)
        |
  [ Chatlix Connect ]  <-- wss://ws.chatlix.app/ws -->  [ Chatlix Backend ]
        |                                                       |
  [ Tray-Icon / Logs / Diagnose ]                     [ Dashboard im Browser ]

Connect baut die Verbindung zum Backend immer selbst auf (Outbound-only). Das Dashboard schickt Befehle über das Backend, das Backend leitet sie per WebSocket an Connect weiter, Connect ruft lokal die passende OBS-WebSocket-Methode auf und meldet das Ergebnis zurück. Es gibt kein Portforwarding, kein VPN, kein DuckDNS — auch hinter NAT/CGNAT funktioniert das, weil nur Connect nach draußen verbindet.

Versionen und Kanäle

Connect hat zwei Update-Kanäle, die serverseitig über getrennte Manifeste ausgeliefert werden:

Kanal	Version (Stand dieser Doku)	Manifest
Stable	0.6.0	`manifest.json`
Beta	0.8.1-beta.4	`manifest-beta.json`

Wichtig: Welchen Kanal du bekommst, entscheidet sich beim Download (Beta-Link vs. Stable-Link im Dashboard), nicht über einen Schalter in Connect selbst — der Kanal ist fest im jeweiligen Build einkompiliert. Mehr dazu in Connect aktualisieren. Der Versionssprung zwischen den Kanälen ist aktuell groß (0.6.0 vs. 0.8.1-beta.4) — wenn dir eine Funktion aus dieser Doku in deiner Installation fehlt, prüfe zuerst, auf welchem Kanal du bist.

Datenfluss und Sicherheit

Connect authentifiziert sich beim Backend mit einem 64-stelligen Hex-Token, das du im Dashboard erzeugst (siehe Erstes Pairing).
OBS-WebSocket wird lokal angesprochen, mit Passwort falls in OBS gesetzt — das Passwort verlässt deinen Rechner nie, es liegt nur in der lokalen connect.json.
Seit Version 0.8.1-beta liegt eine gültige Code-Signatur für Setup.exe und die Runtime-EXE vor (kein "unbekannter Herausgeber" mehr im Kern), die SmartScreen-Reputation baut sich aber erst mit steigenden Installationszahlen auf — vereinzelte Warnungen sind also möglich, siehe Connect Troubleshooting.

Nächste Schritte

Chatlix Connect installieren — Download, Entpacken, OBS-WebSocket aktivieren.
Erstes Pairing — Token erzeugen und in Connect eintragen.
Connect aktualisieren — wie der Versions-Check funktioniert und wie du manuell aktualisierst.
Connect Troubleshooting — wenn OBS nicht reagiert, der Token abgelehnt wird oder SmartScreen nervt.