Chatlix Connect

Connect ist die Desktop-Bruecke zwischen Chatlix und OBS. Installation, Konfiguration, Updates, Troubleshooting.

Was ist Chatlix Connect?
Chatlix Connect installieren
Erstes Pairing
Connect aktualisieren
Connect Troubleshooting

Was ist Chatlix Connect?

Chatlix Connect ist ein optionaler Desktop-Client fuer Windows und Linux. Er sitzt zwischen deinem lokalen OBS und dem Chatlix-Backend und macht zwei Dinge:

OBS-WebSocket lokal anbinden, sodass das Dashboard Szenen, Quellen und Audio steuern kann.
Tools wie den Game Watcher bridgen, sodass deren Daten an Chatlix gelangen.

Wann du Connect brauchst

Du willst OBS-Szenen aus dem Browser umschalten
Du willst Audio-Quellen aus Reaktionen heraus stumm schalten oder einblenden
Du nutzt den Game Watcher und willst dessen Stats live nutzen
Du willst Aktionen ausloesen, ohne OBS-Hotkeys zu konfigurieren

Wann du Connect nicht brauchst

Du nutzt nur Overlays als Browser-Source in OBS
Twitch-Events kommen direkt per EventSub-Webhook am Backend an
Du arbeitest mit einer reinen Web-Only-Konfiguration

Viele Setups laufen komplett ohne Connect. Wenn du am Anfang nur Alerts und ein paar Overlays brauchst, kannst du Connect spaeter nachruesten.

Was Connect nicht ist

Kein Twitch-Bot mit Chat-Commands
Kein Aufnahme- oder Streaming-Tool, OBS bleibt dafuer zustaendig
Kein Pflichtbestandteil von Chatlix

Architektur

  [ OBS Studio ]
        |
  OBS-WebSocket (lokal, Port 4455)
        |
  [ Chatlix Connect ]  <--->  [ Chatlix Backend ]
        |                              |
  [ Game Watcher ]              [ Dashboard im Browser ]

Connect haelt eine Verbindung zum Backend offen. Das Dashboard schickt Befehle an das Backend, das Backend leitet sie an Connect weiter, Connect spricht mit OBS.

Versionen

Aktuell stehen unter /opt/chatlix/app/public/downloads/ bereit:

Datei	Version
`ChatlixConnect-Windows.zip`	0.4.0
`chatlix-connect-linux`	0.4.0

Die Versions-Metadaten liegen in manifest.json und manifest-beta.json.

Datenfluss und Sicherheit

Connect verbindet sich nach Pairing per gesichertem Token zum Backend.
OBS-WebSocket spricht Connect lokal an, idealerweise mit Passwort.
Keine Stream-Inhalte werden uebertragen, nur Steuerbefehle und Metadaten.

Naechste Schritte

„Chatlix Connect installieren" fuer den Download und die Erstkonfiguration.
„Erstes Pairing" fuer die Kopplung mit deinem Account.
„Connect Troubleshooting" wenn etwas hakt.

Chatlix Connect installieren

Connect gibt es als Windows-Build und als Linux-Binary. Such dir die Variante fuer dein System.

Voraussetzungen

Aktiver Chatlix-Account
OBS Studio 28+ mit aktiviertem OBS-WebSocket
Stabile Internet-Verbindung
Auf Linux: glibc-basierte Distribution (Ubuntu 22.04+, Fedora 38+, Debian 12+ getestet)

Windows

Im Dashboard zu Downloads, Datei ChatlixConnect-Windows.zip (0.4.0) herunterladen.
ZIP nach C:\Program Files\Chatlix Connect\ entpacken. Du brauchst Schreibrechte.
Per Doppelklick auf ChatlixConnect.exe starten.
Beim ersten Start kann der SmartScreen-Warner anschlagen. Mehr Infos, dann Trotzdem ausfuehren.
Tray-Icon erscheint unten rechts.

Autostart einrichten:

Rechtsklick auf das Tray-Icon, « Einstellungen ».
Haken bei „Beim Anmelden starten".

Linux

Binary herunterladen:

curl -L -o chatlix-connect-linux \
  https://chatlix.app/downloads/chatlix-connect-linux
chmod +x chatlix-connect-linux

Optional nach /usr/local/bin/ verschieben:

sudo mv chatlix-connect-linux /usr/local/bin/chatlix-connect

Manuell starten:

chatlix-connect

Fuer Autostart als systemd-User-Service unter ~/.config/systemd/user/chatlix-connect.service:

[Unit]
Description=Chatlix Connect
After=network-online.target

[Service]
ExecStart=/usr/local/bin/chatlix-connect
Restart=on-failure

[Install]
WantedBy=default.target

Aktivieren:

systemctl --user daemon-reload
systemctl --user enable --now chatlix-connect

OBS-WebSocket aktivieren

OBS muss seinen WebSocket-Server laufen lassen, damit Connect ihn ansprechen kann.

In OBS auf Werkzeuge, dann „WebSocket-Server-Einstellungen".
Haken bei „WebSocket-Server aktivieren".
Authentifizierung aktivieren und ein Passwort setzen.
Port notieren (Standard 4455).
Uebernehmen.

Verbindung pruefen

Nach dem Start zeigt Connect im Tray oder im Terminal den Status. Drei Zustaende sind moeglich:

Zustand	Bedeutung
Bereit	OBS erreichbar, aber noch nicht gepaart
Verbunden	Mit Backend gepaart und OBS erreichbar
Getrennt	OBS oder Backend nicht erreichbar

Wenn du „Bereit" siehst, geh weiter zu „Erstes Pairing". Wenn „Getrennt": pruefe OBS-WebSocket-Einstellungen und Internet-Verbindung.

Update-Hinweise

Connect prueft beim Start auf neue Versionen via manifest.json. Updates werden in „Connect aktualisieren" beschrieben.

Erstes Pairing

Nach der Installation muss Connect einmalig mit deinem Chatlix-Account gekoppelt werden. Das funktioniert ueber einen kurzlebigen Pairing-Code.

Voraussetzungen

Connect laeuft und Status ist „Bereit"
OBS laeuft mit aktivem WebSocket-Server
Du bist im Dashboard eingeloggt

Schritt fuer Schritt

Im Dashboard zu Integrationen, dann zu Connect (Komponente ConnectPanel).
« Neues Geraet koppeln » klicken.
Im Dashboard wird ein sechsstelliger Code angezeigt.
In Connect das Pairing-Fenster oeffnen (Tray-Icon, dann « Koppeln »).
Code eingeben und bestaetigen.
Connect zeigt jetzt deinen Account und das Geraet an.
Dashboard aktualisiert die Liste der Geraete.

Fertig. Der Status in Connect sollte auf „Verbunden" wechseln.

OBS-WebSocket-Zugang in Connect hinterlegen

Damit Connect mit OBS sprechen kann, muss es Host, Port und Passwort kennen.

In Connect auf Einstellungen, dann OBS.
Host: in der Regel localhost.
Port: meist 4455.
Passwort: das, das du in OBS-WebSocket-Einstellungen vergeben hast.
« Testen » klicken. Bei Erfolg zeigt Connect die aktuelle OBS-Version.
Speichern.

Im Dashboard sollte nun unter OBS-Steuerung deine Szenen-Liste erscheinen.

Verbindung verifizieren

Kleiner End-to-End-Test:

Im Dashboard auf OBS-Steuerung (Komponente ObsScenesPanel).
Eine andere Szene auswaehlen.
« Wechseln » klicken.
In OBS sollte die Szene sofort wechseln.

Wenn das funktioniert, ist das Pairing sauber.

Mehrere Geraete

Du kannst Connect auf mehreren Rechnern installieren, z. B. Streaming-PC und Gaming-PC. Jedes Geraet bekommt ein eigenes Pairing und taucht im Dashboard als separater Eintrag auf. Im Dashboard waehlst du, an welches Geraet ein Befehl gehen soll.

Pairing widerrufen

Wenn du ein Geraet verlierst oder neu aufsetzt:

Dashboard, Connect-Panel.
Bei dem betreffenden Geraet auf « Entfernen » klicken.
Connect auf dem Geraet zeigt danach „Getrennt". Du kannst es neu paaren oder deinstallieren.

Probleme

Problem	Erste Pruefung
Code wird nicht akzeptiert	Code ist abgelaufen, neuen anfordern
Connect bleibt auf „Bereit"	Account-Login im Dashboard pruefen
OBS-Test schlaegt fehl	Port, Passwort, OBS-Version
Szenen-Liste leer	OBS hat keine Szenen oder WebSocket-Scope eingeschraenkt

Connect aktualisieren

Connect aktualisiert sich nicht voll automatisch. Du bekommst eine Benachrichtigung, wenn eine neue Version vorliegt, und ziehst das Update an.

Wie der Update-Check funktioniert

Connect liest beim Start manifest.json (stable) oder manifest-beta.json (beta) vom Server. Darin steht die aktuelle Versionsnummer. Liegt sie ueber deiner installierten Version, zeigt Connect einen Hinweis im Tray.

Aktuelle Version pruefen

Im Tray oder Hauptfenster steht die Versionsnummer. Aktuell stabil:

Plattform	Version
Windows	0.4.0
Linux	0.4.0

Windows aktualisieren

Connect beenden (Tray, « Beenden »).
Neue ChatlixConnect-Windows.zip aus dem Dashboard-Downloads-Bereich laden.
Inhalt des bisherigen Verzeichnisses sichern (C:\Program Files\Chatlix Connect\).
ZIP entpacken und ueberschreiben.
Connect starten. Pairing bleibt erhalten.

Wenn das Update fehlschlaegt: das gesicherte Verzeichnis zurueckspielen.

Linux aktualisieren

Mit systemd-User-Service:

systemctl --user stop chatlix-connect
curl -L -o /tmp/chatlix-connect-linux \
  https://chatlix.app/downloads/chatlix-connect-linux
chmod +x /tmp/chatlix-connect-linux
sudo mv /tmp/chatlix-connect-linux /usr/local/bin/chatlix-connect
systemctl --user start chatlix-connect
systemctl --user status chatlix-connect

Ohne systemd: laufenden Prozess beenden, Binary austauschen, neu starten.

Beta-Track

Wenn du Beta-Builds testen willst:

Connect-Einstellungen, dann Update-Kanal.
„Beta" auswaehlen.

Connect liest dann manifest-beta.json statt manifest.json. Du kannst jederzeit zurueck zu Stable wechseln, aber gehe nicht davon aus, dass eine aeltere Stable-Version sich nahtlos installieren laesst, wenn die Beta neue Felder eingefuehrt hat. Im Zweifel die Konfiguration kurz sichern.

Pairing nach dem Update

In der Regel bleibt das Pairing nach dem Update bestehen. Falls Connect nach dem Update wieder „Bereit" statt „Verbunden" zeigt:

Pruefen, ob OBS laeuft und WebSocket aktiv ist.
Pruefen, ob der Account im Dashboard noch aktiv ist.
Notfalls neu paaren (siehe „Erstes Pairing").

Versions-Konflikte

Wenn das Dashboard meldet, dass deine Connect-Version zu alt ist, kommt das meist daher, dass das Backend neue Felder erwartet. Loesung ist dann immer das Update auf die aktuelle Version. Es lohnt nicht, dagegen zu pruefen.

Sicherheits-Updates

Sicherheitsrelevante Updates bekommen einen entsprechenden Hinweis im Dashboard. Wenn du das siehst: zeitnah aktualisieren, idealerweise vor dem naechsten Stream.

Connect Troubleshooting

Wenn Connect nicht das tut, was du erwartest, gehe die folgenden Schritte der Reihe nach durch. Spring nicht zu schnell zu „neu installieren", die meisten Probleme liegen bei OBS-WebSocket oder Firewall.

Status verstehen

Status	Bedeutung	Erste Aktion
Bereit	OBS ok, Backend noch nicht erreicht	Account einloggen, paaren
Verbunden	Alles ok	Nichts noetig
Getrennt	Backend nicht erreichbar	Netzwerk, DNS
OBS offline	OBS laeuft nicht oder WS aus	OBS und WS pruefen

Connect startet nicht

Windows:

Pruefen, ob ein anderer Prozess ChatlixConnect.exe bereits laeuft (Task-Manager).
Ausfuehren als Administrator testen.
Antivirus-Quarantaene pruefen.

Linux:

chatlix-connect --version

Wenn das schon scheitert, ist die Binary nicht ausfuehrbar oder inkompatibel.

file $(which chatlix-connect)
ldd $(which chatlix-connect)

Fehlende glibc-Symbole bedeuten meistens, dass die Distribution zu alt ist.

OBS-WebSocket nicht erreichbar

In OBS auf Werkzeuge, „WebSocket-Server-Einstellungen". Aktiv?
Port stimmt mit Connect-Konfiguration ueberein?
Lokale Firewall blockiert nicht localhost?
OBS Studio Version 28+?
Wenn OBS auf anderem Rechner laeuft: dort die Bind-Adresse pruefen.

Kurzer Test mit curl:

curl -v http://localhost:4455

Du solltest entweder einen HTTP-Upgrade-Versuch oder ein 400 sehen. Connection refused bedeutet: WS laeuft nicht.

Backend nicht erreichbar

Im Browser https://api.chatlix.app/ aufrufen, eine Antwort sollte kommen.
DNS-Aufloesung pruefen:

getent hosts api.chatlix.app

Pruefen, ob ein Unternehmens-Proxy oder VPN HTTPS unterbricht.

Pairing klappt nicht

Code abgelaufen: neuen anfordern, sie sind absichtlich kurzlebig.
Falscher Account im Dashboard: oben rechts auf Profil pruefen.
Connect zeigt „Verbunden" obwohl du nichts erwartest: vermutlich altes Pairing, im Dashboard pruefen und ggf. entfernen.

Szenen werden nicht uebernommen

Im Dashboard pruefen, ob Connect-Status auf „Verbunden" steht.
In Connect den OBS-Test laufen lassen.
In OBS pruefen, ob die Szenen existieren.
Falls Studio-Mode aktiv: das veraendert die Bedeutung von „Szene wechseln" (Vorschau vs. Programm).

Hohe CPU oder RAM

Connect ist normalerweise unauffaellig. Wenn doch hoch:

Connect beenden und neu starten.
OBS-Version aktualisieren, alte WS-Versionen koennen Loops ausloesen.
Logs in Connect-Einstellungen oeffnen, nach wiederholten Fehler-Eintraegen suchen.

Logs

Logs liegen unter:

Windows: %APPDATA%\ChatlixConnect\logs\
Linux: ~/.local/share/chatlix-connect/logs/

Fuer Support-Anfragen: die letzten 200 Zeilen reichen meistens.

Wenn nichts hilft

Connect deinstallieren.
Konfigurationsordner sichern und loeschen.
Aktuelle Version frisch installieren.
Neu paaren.

Groessere Datenverluste sind dabei nicht zu erwarten, weil alles Wesentliche serverseitig liegt.