Direkt zum Hauptinhalt

Connect-Installation auf Windows

Chatlix Connect ist die Desktop-Brücke zwischen deinem lokalen PC und Chatlix in der Cloud — sie verbindet z. B. OBS-Steuerung (über den OBS-WebSocket-Server, Port 4455), lokale Hardware-Trigger wie Stream Deck / HID-Geräte und USB-Warnleuchten (Rundleuchte-Tab).

Diese Seite beschreibt die Installation auf Windows. Sie wurde korrigiert — der bisherige Text kannte nur die manuelle ZIP-Installation, obwohl es inzwischen einen echten Installer gibt.

Download

Zwei Varianten stehen zur Verfügung, beide im Dashboard unter Downloads → « Connect für Windows »:

  • Setup.exe (empfohlen) — ChatlixConnect-Setup-<version>-beta.exe, gebaut mit Inno Setup 6. Installiert pro-Benutzer nach %LOCALAPPDATA%\Programs\Chatlix Connect, kein UAC-Prompt / keine Admin-Rechte nötig, legt einen Uninstaller unter „Apps & Features" an und kann bestehende Installationen sauber upgraden (Konfiguration und Token bleiben beim Update erhalten).
  • ZIP — ChatlixConnect-Windows.zip. Für Firmen-PCs mit Softwareinstallations-Sperre oder wenn du Connect portabel von einem USB-Stick / Netzlaufwerk betreiben willst. Keine Registrierung im System außer optionalem Autostart-Eintrag.

Beide Varianten kommen mit einer SHA256SUMS.txt bzw. einem angezeigten SHA-256-Hash auf der Downloads-Seite. Prüfen in PowerShell:

Get-FileHash .\ChatlixConnect-Setup-0.8.1-beta.exe -Algorithm SHA256
certutil -hashfile .\ChatlixConnect-Setup-0.8.1-beta.exe SHA256

Beide Befehle tun dasselbe — certutil ist bordeigen und funktioniert auch ohne aktuelles PowerShell.

Installation über Setup.exe (empfohlen)

  1. Setup.exe herunterladen und ausführen.
  2. Bei SmartScreen-Warnung: siehe Abschnitt unten.
  3. Installationsordner bestätigen (Standard: %LOCALAPPDATA%\Programs\Chatlix Connect) und weiterklicken.
  4. Nach Abschluss startet Connect automatisch und zeigt das Pairing-Fenster.

Wenn Connect zum Installationszeitpunkt bereits läuft (z. B. Reinstall/Upgrade), fragt das Setup per Dialog nach, ob es die laufende Instanz beenden darf — deine connect.json (Token, OBS-Konfiguration) bleibt dabei erhalten.

Installation über ZIP (portabel)

  1. ZIP herunterladen.
  2. Wichtig: Rechtsklick → Eigenschaften → unten ggf. « Zulassen » ankreuzen, dann OK. Damit erspart sich Windows das pauschale Sperren der entpackten Dateien.
  3. ZIP entpacken — z. B. nach C:\Tools\ChatlixConnect\. Nicht in C:\Program Files\ entpacken (Schreibrechte-Probleme) und nicht in einen OneDrive-Ordner mit „Dateien bei Bedarf" — Connect prüft das beim Start (Preflight-Warnung, intern PREFLIGHT_ONEDRIVE) und startet im Zweifel gar nicht sauber durch.
  4. ChatlixConnect-win.exe doppelklicken, oder ChatlixConnect Hintergrund.vbs für lautlosen Tray-Start ohne kurz aufblitzendes Konsolenfenster.

SmartScreen-Warnung

Der bisherige Text sagte pauschal „unsigniert, Code-Signing ist auf der Roadmap". Das ist nicht mehr ganz aktuell und war teilweise ungenau — der Stand ist differenzierter:

  • Im Connect-Repo ist Code-Signing als optionales, aktivierbares Feature in der Installer-Konfiguration angelegt (signtool-Hook, EV-/OV-Zertifikat aus dem Windows-Zertifikatsspeicher). Es ist kein Umbau nötig, um es einzuschalten, sobald ein Zertifikat vorliegt.
  • Für aktuelle Beta-Builds kann der Signing-Status je nach Release-Cut variieren. Ob dein heruntergeladener Build signiert ist, siehst du direkt: Rechtsklick auf die Exe/Setup.exe → Eigenschaften → Reiter „Digitale Signaturen". Ist der Reiter da und zeigt einen gültigen Herausgeber, ist der Build signiert und SmartScreen sollte ohne Warnung durchlaufen (bei EV sofort, bei OV ggf. mit kurzer Reputationsphase).
  • Ist kein Signatur-Reiter vorhanden, siehst du beim ersten Start:

Der Computer wurde durch Windows geschützt.

Fehlt der „Trotzdem ausführen"-Button komplett: Das ist meist eine Gruppenrichtlinie eines Firmen-Admins, die SmartScreen-Overrides sperrt. In dem Fall bleibt nur die ZIP-Variante oder Rücksprache mit der IT.

Erster Start: Pairing

Beim ersten Start zeigt Connect ein Fenster mit einem Pairing-Code (6 Zeichen).

  1. Dashboard öffnen → Integrations → Connect → « Gerät hinzufügen ».
  2. Pairing-Code eingeben (Groß-/Kleinschreibung beachten, case-sensitive).
  3. Connect-Fenster zeigt „Verbunden mit <dein-account>".

Der Pairing-Code ist 5 Minuten gültig. Bei Timeout: in Connect « Neuen Code anfordern ». Alternativ unterstützt Connect QR-Import für die OBS-WebSocket-Zugangsdaten (Screenshot des OBS-QR-Codes einlesen) — spart das manuelle Eintippen von Host/Port/Passwort.

Oberfläche: Tray statt nur Konsole

Seit v0.5.0 läuft Connect standardmäßig im System-Tray (unten rechts in der Taskleiste), nicht mehr als dauerhaft sichtbares Konsolenfenster. Rechtsklick auf das Tray-Icon:

  • « Logs öffnen » — öffnet den Log-Ordner im Explorer.
  • « Pause » — trennt temporär alle aktiven Verbindungen (OBS, Cloud-WebSocket), ohne Connect zu beenden.
  • « Beenden » — schließt Connect vollständig.

Wenn du das klassische Konsolenfenster für Debugging brauchst: mit Parameter --no-tray starten (bei ZIP-Installation z. B. per eigener Verknüpfung mit diesem Argument).

Autostart

Wenn Connect bei jedem Windows-Login automatisch starten soll:

  • In Connect → Einstellungen → Allgemein → « Mit Windows starten » aktivieren.

Intern legt das einen Eintrag unter HKCU\Software\Microsoft\Windows\CurrentVersion\Run an (bei ZIP-Installation über die mitgelieferten Skripte install-autostart.bat/.ps1 im Programmordner, bei Setup.exe automatisch über den Installer). Du kannst den Eintrag manuell aus der Registry entfernen oder mit dem beiliegenden uninstall-autostart.bat, falls du Connect nur ad-hoc starten willst.

Updates — korrigiert: kein Auto-Apply

Der bisherige Text hier war schlicht falsch: er beschrieb, „Update jetzt" lade herunter und ersetze die Exe automatisch. Das ist nicht das aktuelle Verhalten. Laut Connect-eigenem Release-Runbook ist das bewusst so gebaut:

  • Connect prüft beim Start gegen ein Versions-Manifest und zeigt bei neuerer Version ein passives Banner im Fenster/Tray.
  • Es gibt keinen Ein-Klick-Auto-Update-Mechanismus und keinen Self-Updater. Du musst die neue Version manuell laden: Setup.exe erneut ausführen (überschreibt sauber, Konfig bleibt) oder bei ZIP die alte Exe schließen und den neuen Ordnerinhalt über den alten kopieren.
  • Der SHA-256-Hash aus dem Update-Banner lässt sich gegen die heruntergeladene Datei verifizieren — die Prüf-Funktion dafür ist im Code fest verankert (verifyDownloadAgainstManifest).

Updates nicht während eines Live-Streams machen — Connect trennt beim Neustart kurz alle aktiven Verbindungen (OBS-Steuerung, Stream-Deck-Aktionen, HID-Geräte).

Game-Watcher zusätzlich

Wenn du Spiel-Erkennung / Stats (z. B. Minecraft, DCS World und weitere) nutzen willst, brauchst du zusätzlich den Game-Watcher — eine separate App mit eigenem Versionsstand:

  • chatlix-game-watcher-desktop-win.zip (aktuell 0.4.0) — Electron-GUI mit Setup-Wizard, Auto-Discovery gängiger Launcher, Health-Cards mit Test-Buttons. Empfohlen für neue User.
  • chatlix-game-watcher-win.exe (aktuell 0.7.5) — schlanke Standalone-Variante ohne GUI, läuft im Hintergrund, optionales lokales Web-UI per Startparameter --web --web-port=<N>. Hat außerdem eine lokale Bridge für LAN-Geräte wie WLED (Standardport 9878, nicht wie früher hier angegeben 9876) und einen separaten Mod-Bridge-Port 9877 für Spiel-Mod-Integrationen. Details und Port-Konflikt-Lösung: Seite Firewall + Antivirus.

Beide nutzen denselben Pairing-Mechanismus wie Connect.

Deinstallation

Bei Setup.exe-Installation:

  1. Connect schließen (Tray → Rechtsklick → Beenden).
  2. Windows-Einstellungen → Apps → „Chatlix Connect (beta)" → Deinstallieren. Das entfernt Programmdateien und Verknüpfungen.
  3. connect.json, logs\ und diagnostics\ bleiben absichtlich stehen (nicht-destruktiver Uninstall, falls du später neu installierst). Willst du komplett aufräumen: den verbliebenen Ordner unter %LOCALAPPDATA%\Programs\Chatlix Connect manuell löschen.
  4. Optional: im Dashboard das Connect-Device entfernen.

Bei ZIP-Installation:

  1. Connect schließen (Systemtray → Rechtsklick → Beenden).
  2. Programmordner löschen (z. B. C:\Tools\ChatlixConnect\).
  3. Falls Autostart aktiviert war: uninstall-autostart.bat vorher ausführen, sonst bleibt ein verwaister Registry-Eintrag zurück.
  4. Optional: im Dashboard das Connect-Device entfernen.

Troubleshooting

  • „Connect startet nicht / Fenster blitzt nur kurz auf": Programm aus einem Pfad ohne Sonderzeichen/Umlaute starten. Pfade wie C:\Users\Müller\Desktop\ haben in einigen Beta-Builds Probleme. Ebenfalls prüfen: crashes\-Ordner im Programmverzeichnis — liegt dort ein Crash-Report, ist das ein P0-Fall für den Support.
  • „Pairing-Code wird nicht akzeptiert": Großschreibung beachten, Code ist case-sensitive. Notfalls neuen anfordern.
  • „Verbunden, aber Dashboard zeigt offline": Browser-Tab des Dashboards neuladen — der Status wird beim Tab-Öffnen frisch gezogen.
  • „Hohe CPU-Last": in logs\connect.log nach reconnect storm oder ws:reconnect_storm suchen. Hinweis auf instabile Internetverbindung; siehe Firewall-Seite für Backoff-Einstellungen.
  • „OBS verbindet nicht, Log zeigt ECONNREFUSED": OBS läuft nicht oder der WebSocket-Server ist in OBS nicht aktiviert (Werkzeuge → WebSocket-Server-Einstellungen → „WebSocket-Server aktivieren"). Bei OBS 27.x (WebSocket-Plugin v4) funktioniert die v5-Authentifizierung von Connect nicht — auf OBS 28 oder neuer updaten.
  • Diagnose-Bundle für den Support: Doppelklick auf ChatlixConnect Diagnose exportieren.bat im Programmordner erzeugt eine TXT unter diagnostics\. Tokens, OBS-Passwörter, Cookies und volle Windows-Nutzerpfade werden automatisch maskiert. Nicht automatisch gefiltert werden gelegentlich Streamer-Klarnamen in eigenen Labels sowie Query-Token in Webhook-URLs (z. B. Discord-Webhooks) — vor dem Versenden kurz selbst drüberschauen.

Siehe auch: Seite System-Voraussetzungen (Architektur/Versionen) und Seite Firewall + Antivirus (Ports, Netzwerk, AV-Ausnahmen).