Direkt zum Hauptinhalt

Connect aktualisieren

Connect aktualisiert sich nicht automatisch. Beim Start prüft es gegen ein Versions-Manifest auf dem Server und zeigt dir einen Hinweis, wenn eine neuere Version verfügbar ist. Das Herunterladen und Austauschen der Dateien machst du selbst.

Wie der Update-Check funktioniert

Connect liest beim Start eine JSON-Datei vom Server:

  • https://chatlix.app/downloads/chatlix-connect/manifest.json — Stable-Kanal
  • https://chatlix.app/downloads/chatlix-connect/manifest-beta.json — Beta-Kanal

Wichtig, weil das oft missverstanden wird: Welchen Kanal deine Installation abfragt, steht fest in deinem Build (Feld chatlix_connect.channel in der mitgelieferten package.json, gesetzt beim Bauen der jeweiligen Version) — es gibt keine Einstellung „Update-Kanal" in Connect, die du zur Laufzeit umschalten kannst. Ob du Stable oder Beta bekommst, entscheidest du beim Herunterladen: Stable- und Beta-Build sind zwei unterschiedliche Dateien im Dashboard. Willst du wechseln, musst du das jeweils andere Paket herunterladen und Connect damit ersetzen.

Liegt die Server-Version über deiner installierten Version, zeigt Connect beim nächsten Start einen Update-Hinweis mit Direktlink. Der Vergleich läuft nach Semver (Major.Minor.Patch, Vorabversionen wie -beta.4 werden für den reinen Zahlenvergleich ignoriert).

Aktuelle Version prüfen

Die installierte Version steht im Tray-Menü (Rechtsklick auf das Icon) bzw. im Konsolenfenster beim Start. Aktueller Stand pro Kanal:

KanalVersion
Stable0.6.0
Beta0.8.1-beta.4

Der Abstand zwischen den Kanälen ist ungewöhnlich groß — neue OBS-Aktionen wie das Setzen von Position/Skalierung einer Quelle oder die Szenen-Vorschau im Producer-Pult stecken aktuell nur im Beta-Kanal. Wenn dir in der Doku beschriebene Funktionen fehlen, prüfe zuerst deinen Kanal.

Windows aktualisieren

Setup.exe-Installation

  1. Neues Setup aus dem Dashboard (Wizard-Seite) herunterladen.
  2. Connect vorher beenden (Tray-Icon → Beenden, oder Task-Manager).
  3. Setup erneut ausführen — es installiert über die bestehende Version, connect.json und Logs bleiben erhalten.

ZIP-Installation (portabel)

  1. Connect beenden (Tray-Icon → Beenden, oder das Konsolenfenster mit Strg+C bzw. schließen).
  2. Neue ChatlixConnect-Desktop.zip aus dem Dashboard laden.
  3. Deinen bisherigen Ordner sichern (Kopie), dann die neuen Dateien darüber entpacken. connect.json, logs\ und diagnostics\ bleiben bei einem sauberen Überschreiben erhalten.
  4. Connect wie gewohnt starten (Bat-Datei oder Hintergrund-VBS). Dein Token bleibt gespeichert, ein erneutes Pairing ist normalerweise nicht nötig.

Schlägt das Update fehl: gesichertes Verzeichnis zurückspielen und ChatlixConnect diagnose.bat laufen lassen, um zu sehen, was genau bricht.

Linux aktualisieren

Reines Binary-Ersetzen, es gibt kein Setup-Programm:

systemctl --user stop chatlix-connect   # falls als systemd-Service eingerichtet
curl -L -o /tmp/chatlix-connect-linux \
  https://chatlix.app/downloads/chatlix-connect/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 (pkill chatlix-connect oder Terminal schließen), Binary austauschen, neu starten.

Wie du an den Beta-Kanal kommst

Es gibt keinen Umschalter — du lädst im Dashboard explizit das Beta-Paket herunter (bzw. bekommst den Link über eine Beta-Einladung). Danach zeigt dir Connect Updates ausschließlich gegen manifest-beta.json an. Zurück zu Stable geht nur, indem du den Stable-Build erneut installierst; erwarte dabei keine nahtlose Migration, wenn die Beta zwischenzeitlich neue Config-Felder eingeführt hat — connect.json vorher sichern.

Bekannte Einschränkung: Auto-Update erkennt Beta nicht immer zuverlässig

Der Update-Banner im aktuellen Beta-Build (0.8.1-beta.4) zeigt Versionswechsel innerhalb des Beta-Kanals nicht in jedem Fall zuverlässig an — insbesondere bei Pre-Release-Suffixen (-beta.2 → -beta.4) kann der Hinweis ausbleiben, obwohl eine neuere Datei auf dem Server liegt. Verlass dich bei Beta-Teilnahme nicht allein auf den Banner: die aktuelle Beta-Version steht zusätzlich in den Release-Notes im Discord (#beta) bzw. in der Beta-Mail. Im Zweifel Version im Tray-Menü mit der zuletzt angekündigten Version vergleichen.

Pairing nach dem Update

In der Regel bleibt dein Token nach dem Update gültig. Zeigt Connect danach „Nicht verbunden" oder das Dashboard „auth_failed":

  1. Prüfen, ob OBS läuft und der WebSocket-Server aktiv ist.
  2. Prüfen, ob der Token im Dashboard noch aktiv (nicht widerrufen) ist.
  3. Notfalls neuen Token erzeugen und mit ChatlixConnect reparieren.bat neu eintragen — siehe Erstes Pairing.

Versions-Konflikte

Wenn das Dashboard meldet, dass deine Connect-Version zu alt ist (z. B. weil ein neues Snapshot-Feld erwartet wird), hilft nur das Update auf die aktuelle Version deines Kanals — dagegen anzukämpfen lohnt sich nicht, das Backend ist bewusst additiv gebaut, aber strukturelle Änderungen erzwingen irgendwann ein Mindest-Client-Alter.

Sicherheits-Updates

Weil es kein Auto-Apply gibt, muss ein sicherheitsrelevanter Fix aktiv über eine Mail- oder Discord-Welle beworben werden — ein still im Hintergrund liegender Update-Banner reicht dafür nicht. Siehst du im Dashboard einen als sicherheitsrelevant markierten Hinweis: zeitnah aktualisieren, idealerweise vor dem nächsten Stream.