Windows Setup

• System-Voraussetzungen
• Connect-Installation auf Windows
• Firewall + Antivirus

System-Voraussetzungen

System-Voraussetzungen

Bevor du Chatlix-Tools auf einem Windows-PC installierst, prüfe einmal kurz die Anforderungen. Das spart Frust mit Installations-Fehlern und SmartScreen-Warnungen.

Unterstützte Windows-Versionen

Windows	Status
Windows 11 (alle Builds)	unterstützt
Windows 10 21H2 und neuer	unterstützt
Windows 10 älter als 21H2	nicht offiziell — funktioniert in der Regel, aber Auto-Update von .NET / WebView2 kann fehlen
Windows 8.1 / 7	nicht unterstützt
Windows Server 2019 / 2022	inoffiziell, funktioniert

Nur x64 (64-Bit). ARM64-Windows (z. B. Surface Pro X) ist nicht offiziell unterstützt — die Tools laufen unter ARM64-Emulation, aber langsamer und mit gelegentlichen Glitches.

Windows-Version prüfen: Windows-Taste + R → winver → Eingabe.

Hardware

Minimal:

• 4 GB RAM (Chatlix-Tools brauchen wenig, aber Windows + Browser + OBS dazu wird sonst eng)
• 500 MB freier Speicher für die Tools
• Stabile Internetverbindung (Game-Watcher und Connect halten WebSocket-Verbindungen offen)

Empfohlen für Streamer-Setup:

• 16 GB RAM (du fährst meist OBS + Browser + Spiel parallel)
• SSD
• Ethernet (WLAN funktioniert, aber Reconnect-Stürme bei WLAN-Drops sind kein Spaß im Stream)

.NET / Runtime

• Chatlix Connect: keine .NET-Voraussetzung — Electron-basiert, bundled.
• Chatlix Game-Watcher Desktop (Electron-GUI): keine Voraussetzung — Electron-basiert, bundled.
• Chatlix Game-Watcher Standalone (Node-Exe): keine Voraussetzung — Node-Runtime bundled in der .exe.

.NET Framework wird nicht gebraucht. Wenn dir irgendwo geschrieben wird, du müsstest .NET 4.8 installieren: das ist nicht von uns.

Browser für das Dashboard

Das Web-Dashboard (https://chatlix.app/dashboard) läuft in deinem normalen Browser. Empfohlen: aktuelle Chrome, Firefox, Edge. Safari funktioniert grundsätzlich, hat aber gelegentlich Probleme mit dem WebSocket-Streaming der Live-Vorschau.

Internet Explorer ist explizit nicht unterstützt.

Hardware-Beschleunigung

Der Game-Watcher Desktop nutzt eine Browser-View (Chromium via Electron). Wenn dein PC Hardware-Acceleration deaktiviert hat oder ein extrem alter Grafiktreiber drauf ist, kann das Dashboard ruckeln. Lösung: Grafiktreiber updaten oder im Game-Watcher-Settings « Hardware-Acceleration ausschalten » toggeln.

Konflikte mit anderen Tools

• Streamlabs Desktop: koexistiert problemlos.
• OBS Studio: koexistiert problemlos — Chatlix-Overlays werden als Browserquelle eingebunden, keine OBS-Plugins nötig.
• Andere Twitch-Bots (Streamlabs Chatbot, Nightbot, Wizebot): technisch koexistierbar. Achte aber darauf, dass du Reaktionen nicht doppelt konfigurierst (z. B. „neue Follower → Sound“) — sonst spielen beide Tools den Sound ab.
• Antivirus: siehe Seite Firewall + Antivirus.

Datenschutz / lokale Daten

Die Tools speichern lokal:

• Auth-Token verschlüsselt in %APPDATA%\chatlix-connect\ bzw. %APPDATA%\chatlix-game-watcher\
• Logs in %APPDATA%\<tool>\logs\
• Konfiguration in %APPDATA%\<tool>\config.json

Wenn du das Tool deinstallierst und sauber alle Reste loswerden willst: %APPDATA% öffnen (Windows + R → %appdata%) und die jeweiligen Ordner manuell löschen.

Versions-Übersicht (Stand 2026-05)

• ChatlixConnect-Windows: 0.4.0
• chatlix-game-watcher-desktop-win: 0.2.1 beta
• chatlix-game-watcher-win (Standalone-Exe): 0.1.0 beta

Die Beta-Versionen sind grundsätzlich nutzbar, aber bekommen häufiger Updates und können gelegentlich Edge-Case-Bugs zeigen. Bug-Reports gerne über das Dashboard → Support.

Connect-Installation auf Windows

Connect-Installation auf Windows

Chatlix Connect ist die Desktop-Brücke zwischen deinem lokalen PC und Chatlix in der Cloud — sie verbindet z. B. lokale Audio-Hooks, OBS-Steuerung und Hardware-Trigger wie Stream Deck.

Diese Seite beschreibt die Installation auf Windows.

Download

https://chatlix.app/downloads/ChatlixConnect-Windows.zip

Alternativ: Dashboard → Downloads → « Connect für Windows ».

Dateigröße: ~80 MB. SHA-256 wird auf der Downloads-Seite angezeigt — bei Bedarf vergleichen mit Get-FileHash ChatlixConnect-Windows.zip in PowerShell.

Installation

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 bei Updates).
4. ChatlixConnect.exe doppelklicken.

SmartScreen-Warnung

Bei unsigniertem Beta-Build erscheint:

Der Computer wurde durch Windows geschützt.

Unten links auf « Weitere Informationen », dann « Trotzdem ausführen ».

Das ist nichts Bösartiges — Microsoft warnt bei jeder ausführbaren Datei, die keine ausreichend etablierte Code-Signatur hat. Code-Signing ist auf der Roadmap, aber für Beta-Builds noch nicht durchgängig.

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.
3. Connect-Fenster zeigt „Verbunden mit <dein-account>“.

Der Pairing-Code ist 5 Minuten gültig. Bei Timeout: in Connect « Neuen Code anfordern ».

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. Du kannst ihn manuell entfernen, falls du Connect nur ad-hoc startest.

Updates

Connect prüft beim Start auf Updates. Wenn eine neuere Version verfügbar ist:

• Notification im Fenster.
• « Update jetzt » lädt herunter und ersetzt die Exe nach Neustart.

Updates nicht während eines Live-Streams machen — Connect startet sich kurz neu, in dieser Zeit pausieren angeschlossene Features (z. B. Stream-Deck-Aktionen).

Falls Auto-Update nicht funktioniert (z. B. wegen Antivirus / Schreibrechte): die neue ZIP herunterladen, alte Exe schließen, ZIP über den Ordner entpacken, neu starten.

Game-Watcher zusätzlich

Wenn du Minecraft-Stats / Game-Detection nutzen willst, brauchst du zusätzlich den Game-Watcher. Er ist eine separate App:

• chatlix-game-watcher-desktop-win.zip (0.2.1 beta) — Electron-GUI mit Setup-Wizard, Auto-Discovery aller gängigen Minecraft-Launcher (Vanilla / Prism / MultiMC / CurseForge), Health-Cards mit Test-Buttons und Self-Healing-Hints. Empfohlen für neue User.
• chatlix-game-watcher-win.exe (0.1.0 beta) — schlanke Standalone-Variante ohne GUI, läuft im Hintergrund, lokales Web-UI auf http://localhost:9876. Empfohlen wenn du auf einem dedizierten Streaming-PC keine zusätzlichen Fenster willst.

Beide nutzen denselben Pairing-Mechanismus wie Connect.

Deinstallation

1. Connect schließen (Systemtray → Rechtsklick → Beenden).
2. Ordner C:\Tools\ChatlixConnect\ löschen.
3. Optional: %APPDATA%\chatlix-connect\ löschen (Auth-Token + Logs).
4. Optional: im Dashboard das Connect-Device entfernen.

Keine Registry-Einträge außer dem (optionalen) Autostart.

Troubleshooting

• „Connect startet nicht / Fenster blitzt nur kurz auf“: Tool aus einem Pfad ohne Sonderzeichen / Umlaute starten. Pfade wie C:\Users\Müller\Desktop\ haben in einigen Beta-Builds Probleme.
• „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 nach reconnect storm suchen. Hinweis auf instabile Internetverbindung; siehe Firewall-Seite.

Firewall + Antivirus

Firewall + Antivirus

Chatlix Connect und Game-Watcher brauchen Netzwerk-Zugriff und lokal einen offenen Port. Auf einem typischen Windows-Rechner funktioniert das ohne Konfiguration. Wenn du eine restriktive Firewall, ein Corporate-Netz oder eine besonders empfindliche Antivirus-Konfiguration hast, gibt es ein paar Stellschrauben.

Ausgehende Verbindungen

Die Tools sprechen mit:

Ziel	Port	Zweck
api.chatlix.app	443 (HTTPS)	REST-API, Auth, Config
ws.chatlix.app	443 (WSS)	Live-Events, Reward-Trigger, Status
chatlix.app (Downloads)	443	Auto-Update

Alles geht über TCP 443 (HTTPS / WSS). Wenn dein Netzwerk Port 443 ausgehend erlaubt — was Standard ist —, musst du nichts tun.

Kein Port 80 / kein TCP-irgendwas-Exotisches. Kein UDP.

Lokaler Port (Game-Watcher Standalone)

Der Standalone-Game-Watcher (chatlix-game-watcher-win.exe) hostet ein lokales Web-UI auf Port 9876. Das ist nur an localhost (127.0.0.1) gebunden, nicht am LAN — andere Geräte in deinem Netz können also nicht zugreifen.

Wenn der Port belegt ist (z. B. von einem anderen Tool):

1. In der Config (%APPDATA%\chatlix-game-watcher\config.json) einen anderen Port eintragen: "port": 9890.
2. Game-Watcher neu starten.
3. Web-UI dann auf http://localhost:9890.

Die GUI-Variante (Game-Watcher Desktop) braucht keinen lokalen Port — sie kommuniziert intern.

Windows-Firewall

Bei der allerersten Verbindung fragt Windows:

Windows-Firewall hat einige Funktionen dieser App blockiert. Zulassen?

Klick auf « Zugriff zulassen » für Privat (nicht öffentlich). Das ist alles, was du tun musst.

Falls du das versehentlich abgelehnt hast: Systemsteuerung → Windows Defender Firewall → Erweiterte Einstellungen → Ausgehende Regeln → suche nach ChatlixConnect / chatlix-game-watcher, doppelklick, Zulassen aktivieren.

Im restriktiven Netzwerk (Unternehmens-Firewall): du brauchst nur ausgehend *.chatlix.app:443 freigeschaltet. IPs nicht hardcoden — sie ändern sich.

Antivirus / SmartScreen

Weil die Beta-Builds aktuell nicht signiert sind (Code-Signing ist auf der Roadmap), kann Antivirus-Software die Tools als verdächtig markieren.

Typische False-Positives:

• Windows Defender SmartScreen: blockiert beim ersten Start. Lösung: « Weitere Informationen » → « Trotzdem ausführen ».
• Windows Defender (Echtzeitschutz): löscht oder isoliert die Exe in seltenen Fällen. Lösung:
  1. Windows-Sicherheit öffnen.
  2. Viren- und Bedrohungsschutz → Schutzverlauf.
  3. Den Chatlix-Eintrag finden, « Aktionen » → « Zulassen ».
  4. Falls die Exe schon gelöscht wurde: neu herunterladen.
• Drittanbieter (Kaspersky, Bitdefender, ESET, Avast, AVG): ähnliches Vorgehen. Im jeweiligen Quarantäne-Bereich freigeben und einen Pfad-Ausschluss für den Installations-Ordner setzen (z. B. C:\Tools\ChatlixConnect\).

Beispiel-Ausschluss für Windows Defender per PowerShell (als Admin):

Add-MpPreference -ExclusionPath "C:\Tools\ChatlixConnect"
Add-MpPreference -ExclusionPath "C:\Tools\ChatlixGameWatcher"

SSL / TLS-Inspektion in Corporate-Netzen

Wenn deine Firma einen TLS-inspizierenden Proxy einsetzt (z. B. Zscaler, Forcepoint, Palo Alto mit SSL-Decrypt), kann der WebSocket zu ws.chatlix.app scheitern, weil viele dieser Proxies WSS-Upgrades nicht sauber durchreichen. Symptome:

• Connect zeigt „Verbunden“ und kurz darauf wieder „Trennung“, in Schleife.
• Logs (%APPDATA%\chatlix-connect\logs\) zeigen WebSocket error 1006.

Lösung: IT bitten, ws.chatlix.app und api.chatlix.app von der TLS-Inspection auszunehmen.

Reconnect-Stürme

Bei flackernder Internetverbindung (z. B. instabiles WLAN) versucht Connect alle paar Sekunden, sich neu zu verbinden. Das ist Absicht — du willst keinen Live-Stream verlieren wegen eines kurzen Drops. Es kann sich aber wie hohe CPU-Last anfühlen.

Du kannst in den Connect-Einstellungen das Backoff erhöhen — « Verbindungs-Backoff » von 1s/2s/5s (default) auf 5s/15s/30s. Dafür gibt's etwas später Reconnect, dafür weniger Lärm.

Logs für den Support

Wenn du den Support kontaktierst: Logs unter %APPDATA%\chatlix-connect\logs\ zippen und anhängen. Sie enthalten keine Klartext-Token (Auth ist getrennt verschlüsselt gespeichert), aber Verbindungs-IDs und Fehler-Codes.