Erstes Pairing

Korrigiert: Chatlix Connect koppelt sich nicht über einen sechsstelligen Code, den du im Dashboard siehst und in Connect eintippst. Die OBS-Kopplung läuft über ein 64-stelliges Hex-Token, das du im Dashboard erzeugst und einmalig in Connect einfügst. (Es gibt daneben ein separates, code-basiertes Pairing für die neuere „Connect / Bridge"-Seite — siehe Hinweis am Ende dieser Seite, das ist ein anderes Feature.)

Voraussetzungen

Connect ist installiert (siehe Chatlix Connect installieren) und läuft zum ersten Mal, oder du hast ChatlixConnect reparieren.bat gestartet.
OBS läuft mit aktivem WebSocket-Server.
Du bist im Dashboard eingeloggt.

Schritt für Schritt

Im Dashboard zu OBS & Connect Setup (linke Navigation, Menüpunkt „Einrichtung & Download", URL /dashboard/wizard).
Dort einen neuen Token erzeugen. Der Token wird nur einmal im Klartext angezeigt — sofort kopieren.
Connect starten (falls noch nicht geschehen). Beim allerersten Start fragt das Programm direkt: Token:
Token einfügen, Enter drücken. Connect prüft das Format (^[a-f0-9]{64}$) und speichert es in connect.json, Dateirechte 0600 (nur dein Windows-Benutzer kann sie lesen).
Direkt im Anschluss sucht Connect selbstständig nach OBS auf deinem PC (127.0.0.1 / localhost / ::1, Port 4455 dann 4444). Findet es OBS und OBS verlangt ein Passwort, fragt Connect danach — das steht in OBS unter „WebSocket-Server-Einstellungen" → „Verbindungsinformationen anzeigen".
Wird OBS nicht sofort gefunden, wartet Connect automatisch bis zu 60 Sekunden und pollt weiter — praktisch, wenn OBS gerade erst startet. Danach kannst du Host/Port/Passwort auch manuell eintippen oder einen QR-Screenshot aus OBS als Datei-Pfad angeben.
Fertig. Es gibt keinen separaten „Koppeln"-Button und kein Pairing-Fenster im Tray — der ganze Vorgang ist der Ersteinrichtungs-Dialog direkt nach dem Programmstart.

Wie das im Dashboard aussieht

Auf der Seite Verbindungen & Webhooks (Integrationen) gibt es eine Karte „Chatlix Connect". Solange nichts gekoppelt ist, zeigt sie einen grauen „Nicht verbunden"-Punkt, eine kurze Erklärung („🔒 OBS bleibt auf deinem PC", keine öffentliche Adresse, kein Portforwarding) und einen Button „→ Connect einrichten", der dich zur Wizard-Seite schickt. Sobald Connect erfolgreich verbunden ist, wechselt die Karte auf einen grünen, pulsierenden Punkt mit „Verbunden", zeigt Uptime, Anzahl ausgeführter Aktionen, Anzahl kurzer Reconnects sowie ein Testfeld: Szenennamen eingeben und auf „🎬 Szene wechseln" oder „📸 Screenshot" klicken.

Verbindung verifizieren

Im Dashboard auf der Connect-Karte einen Szenennamen eintragen, der in OBS existiert (z. B. „Starting Soon").
Auf „🎬 Szene wechseln" klicken.
In OBS sollte die Szene sofort wechseln, im Dashboard erscheint eine grüne Bestätigung mit Klartext-Meldung.

Wenn das klappt, ist das Pairing sauber. Alternativ kannst du auch direkt in OBS gegenprüfen, dann brauchst du keinen Blick ins Dashboard.

Token widerrufen / erneuern

Wenn du Connect neu aufsetzt oder ein Token kompromittiert wurde:

Im Dashboard auf der Wizard-Seite den alten Token widerrufen.
Neuen Token erzeugen.
Auf dem PC ChatlixConnect reparieren.bat doppelklicken (ZIP-Variante) — der Assistent fragt erneut nach dem Token, ohne dass du Connect neu installieren musst. Bei der Setup.exe-Variante reicht ein Neustart von Connect, wenn der Auth-Fehler bereits aufgetreten ist (siehe unten).

Zeigt das Dashboard „Wir konnten uns nicht anmelden" mit dem Hinweis „Anmelde-Schlüssel passt nicht mehr" (interner Status auth_failed), ist der alte Token clientseitig noch gespeichert, aber serverseitig ungültig — der Fix-Link führt dich direkt zurück zur Wizard-Seite, um einen neuen zu erzeugen.

Mehrere Geräte

Du kannst Connect auf mehreren Rechnern installieren, z. B. Streaming-PC und separatem Gaming-PC. Jeder Rechner braucht dafür einen eigenen Token (im Dashboard mehrfach erzeugbar) — es gibt keine geteilte Geräteliste zum Auswählen wie früher hier beschrieben. Der zuletzt aktiv verbundene Connect-Client ist der, den das Dashboard in der Status-Karte anzeigt.

Häufige Probleme

Problem	Erste Prüfung
Token wird abgelehnt (Connect meldet „ANMELDUNG FEHLGESCHLAGEN")	Format prüfen (64 Hex-Zeichen, keine Leerzeichen), sonst im Dashboard widerrufen und neu erzeugen
Connect zeigt „TEILWEISE VERBUNDEN" / OBS antwortet nicht	OBS läuft? WebSocket-Server aktiviert? Mit `ChatlixConnect OBS testen.bat` gezielt prüfen
Schwarzes Fenster schließt sich sofort nach dem Start	Du hast vermutlich direkt aus dem ZIP-Vorschaufenster gestartet — erst vollständig entpacken
Szenen-Liste im Dashboard bleibt leer	OBS hat keine Szenen, oder OBS-WebSocket-Verbindung ist erst „Bereit", noch nicht „Verbunden"

Anderes Feature, ähnlicher Name: Unter Connect / Bridge („Lokale Tools koppeln") gibt es zusätzlich ein sechsstelliges Code-Pairing für neuere lokale Module (z. B. Local-Input/Local-Sound-Trigger). Das ist ein separater Kopplungsmechanismus mit eigenem Token-Typ und eigener Geräteliste (mehrere benannte „Bridges" pro Nutzer, mit Limit) — nicht zu verwechseln mit dem klassischen OBS-Connect-Token aus dieser Seite. Wenn du in der Dashboard-Navigation auf einen sechsstelligen Code triffst, bist du wahrscheinlich auf dieser anderen Seite gelandet.