Direkt zum Hauptinhalt

Chatlix Connect installieren

Connect gibt es für Windows (offiziell unterstützt, mit Tray-Icon) und als Linux-CLI-Binary (funktioniert, aber ohne GUI/Tray/systemd-Vorlage von Chatlix — nur für den Eigenbau). macOS wird aktuell nicht gebaut. Lade dein Paket im Dashboard unter OBS & Connect Setup (Menüpunkt /dashboard/wizard, Untertitel „Einrichtung & Download") herunter — nicht über eine generische „Downloads"-Seite.

Voraussetzungen

  • Aktiver Chatlix-Account, im Dashboard eingeloggt.
  • OBS Studio 28 oder neuer (bringt OBS-WebSocket v5 fest eingebaut mit). Mit OBS 27 + altem obs-websocket-v4-Plugin bekommst du nur eine generische Meldung „Passwort falsch / Verbindung abgelehnt" ohne automatische Diagnose — Connect erkennt den Plugin-Unterschied aktuell nicht. Wenn du auf OBS 27 hängst: zuerst auf 28+ aktualisieren, dann erst Connect einrichten.
  • Stabile Internetverbindung (Connect verbindet sich ausgehend zu wss://ws.chatlix.app/ws).
  • Auf Linux: glibc-basierte Distribution (Ubuntu 22.04+, Fedora 38+, Debian 12+ getestet).

Windows

Du hast zwei Möglichkeiten — beide führen zum selben Programm:

VarianteFür wen
ChatlixConnect-Setup-*.exe (Inno-Setup-Installer)Empfohlen: Ein-Klick-Installation, Startmenü-Eintrag, sauberes Deinstallieren über „Apps & Features".
ChatlixConnect-Desktop.zipPortable, kein Installer nötig, für Leute die lieber selbst entpacken.

Mit Setup.exe

  1. Setup-EXE aus dem Wizard-Bereich im Dashboard herunterladen.
  2. Doppelklick, Installations-Assistent durchklicken.
  3. Nach der Installation startet Connect automatisch und zeigt den Token-Assistenten (siehe Erstes Pairing).
  4. Deinstallieren später über Windows-Einstellungen → „Apps & Features" → „Chatlix Connect" oder den Startmenü-Eintrag „Chatlix Connect deinstallieren". connect.json und Logs bleiben dabei erhalten — bei einer Neuinstallation ist dein Token sofort wieder da.

Mit ZIP (portabel)

  1. ZIP herunterladen und per Rechtsklick → „Alle extrahieren…" entpacken.
  2. Wichtig: nicht in C:\Program Files\ und nicht in einen OneDrive-synchronisierten Ordner entpacken — beides verursacht bekannte Startprobleme (Schreibrechte bzw. Sync-Konflikte auf connect.json). Ein eigener Ordner wie C:\Tools\ChatlixConnect ist ideal.
  3. Nicht direkt aus dem ZIP-Fenster heraus starten. Windows öffnet ZIPs nur „zur Vorschau" — Connect kann dann nicht in seinen eigenen Ordner schreiben und das schwarze Fenster verschwindet sofort wieder. Erst vollständig entpacken, dann aus dem entpackten Ordner starten.
  4. Im entpackten Ordner liegen mehrere Helfer-Skripte:
    • ChatlixConnect starten.bat — startet Connect sichtbar in einem Konsolenfenster. Fenster minimieren ist ok, schließen nicht (das beendet Connect).
    • ChatlixConnect Hintergrund.vbs — startet Connect unsichtbar mit Tray-Icon, kein Konsolenfenster.
    • ChatlixConnect einrichten.bat — Komfort-Assistent: fragt nacheinander „Autostart einrichten?", „Desktop-Verknüpfung anlegen?", „Jetzt starten?" (alle drei standardmäßig Ja, einzeln mit n überspringbar).
    • ChatlixConnect entfernen.bat bzw. scripts\uninstall-autostart.bat — entfernt Autostart-Eintrag und Desktop-Verknüpfung wieder. connect.json, Logs und Crash-Reports bleiben unangetastet.

Linux

Nur CLI, kein Tray, keine offizielle systemd-Unit von Chatlix (unter 3 % der Twitch-Streamer nutzen Linux, deshalb ist das kein Fokus der Beta). Für den Eigenbau:

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

Optional systemd-User-Service (selbst gebaut, nicht offiziell mitgeliefert), 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

sudo mv chatlix-connect-linux /usr/local/bin/chatlix-connect
systemctl --user daemon-reload
systemctl --user enable --now chatlix-connect

OBS-WebSocket aktivieren

OBS muss seinen WebSocket-Server laufen lassen, bevor Connect etwas findet:

  1. In OBS: Werkzeuge (bzw. Extras, je nach OBS-Sprache) → WebSocket-Server-Einstellungen.
  2. Haken bei „WebSocket-Server aktivieren".
  3. Falls du Authentifizierung willst: Passwort setzen (empfohlen, aber nicht zwingend — Connect fragt nur danach, wenn OBS es verlangt).
  4. Port notieren, Standard ist 4455 (OBS 28+). Ältere Installationen mit dem separaten v4-Plugin nutzen 4444.
  5. Übernehmen. OBS muss dafür nicht neu gestartet werden.

Erster Start und Verbindung prüfen

Beim allerersten Start (egal ob über Setup.exe, ZIP-Bat oder Hintergrund-VBS) fragt Connect automatisch nach deinem Token und sucht danach selbstständig nach OBS auf 127.0.0.1, localhost und ::1 auf den Ports 4455/4444 — das ist der Kern des Assistenten aus Erstes Pairing. Es gibt keinen separaten „Verbindung testen"-Dialog vor dem Pairing; Token-Eingabe und OBS-Suche laufen in einem Rutsch.

Wenn Connect läuft, siehst du je nach Startart:

  • Über Hintergrund.vbs oder direkt per EXE/Setup: kein Fenster, ein Tray-Icon rechts unten in der Taskleiste. Rechtsklick öffnet Logs, Pause, Beenden.
  • Über die „starten.bat": ein schwarzes Konsolenfenster, das offen bleiben muss.

Im Dashboard erscheint unter Verbindungen & Webhooks (Integrationen-Seite) eine Karte „Chatlix Connect" mit grünem „Verbunden"-Status, Uptime, Anzahl ausgeführter Aktionen und einem Testbereich (Szene wechseln, Screenshot). Siehst du dort „Nicht verbunden", geh weiter zu Connect Troubleshooting.

Update-Hinweise

Connect prüft beim Start gegen manifest.json (Stable) oder manifest-beta.json (Beta) — welcher Kanal das ist, hängt vom heruntergeladenen Build ab, nicht von einer Einstellung in Connect. Details in Connect aktualisieren.