Manuelle Installation

Fuer Linux gibt es keinen Paketmanager-Weg (kein .deb, kein PPA, kein Flatpak) und keinen klassischen Installer. Du laedst ein fertiges Artefakt herunter und startest es direkt. Es gibt zwei Wege — waehle nach Anwendungsfall, nicht nach Geschmack: die Desktop-App fuer normalen Streamer-Betrieb mit grafischer Session, das CLI-Binary fuer Server/headless-Setups.

Voraussetzungen

x86_64 Linux (arm64 wird nicht gebaut — pkg-Targets und Electron-Builder sind ausschliesslich node18-linux-x64 bzw. x64).
curl oder wget.
Ausgehender Zugriff auf chatlix.app (HTTPS 443) und ws.chatlix.app (WSS 443, Endpunkt konkret wss://ws.chatlix.app/ws).
Optional: OBS mit aktiviertem WebSocket-Server (Tools → WebSocket Server Settings) auf 127.0.0.1:4455 — das ist der Default in connect.json, nicht frei erfunden.
Fuer die Desktop-App zusaetzlich: eine laufende grafische Session (X11 oder XWayland). Reines Wayland ohne X11-Kompatibilitaetsschicht funktioniert nicht zuverlaessig.
Glibc-Abhaengigkeiten fuer das CLI-Binary: keine relevanten, es ist ein pkg-Bundle mit eingebauter Node-Runtime. Die Desktop-App bringt ihre eigene Electron/Chromium-Runtime mit, braucht aber auf sehr minimalen Distros ggf. libfuse2 fuer das AppImage-Format (siehe unten).

Weg A: Desktop-App (empfohlen fuer normale Streamer-Nutzung)

Es gibt zwei Auslieferungsformen fuer dieselbe App — beide unter https://chatlix.app/downloads/chatlix-connect/:

# Variante 1: AppImage (portabel, kein Entpacken noetig)
# ACHTUNG: Es gibt keine fixe Datei "chatlix-connect-linux.AppImage" auf dem
# Server — der Dateiname ist immer versioniert (z.B. "Chatlix Connect-0.7.40.AppImage").
# Ermittle den aktuellen Namen von https://chatlix.app/downloads/chatlix-connect/
# und setze ihn hier ein, z.B.:
curl -O "https://chatlix.app/downloads/chatlix-connect/Chatlix Connect-0.7.40.AppImage"
chmod +x "Chatlix Connect-0.7.40.AppImage"
"./Chatlix Connect-0.7.40.AppImage"

Der genaue Dateiname (Versionsnummer im Namen) steht auf der Downloadseite bzw. im Link dort — die Server-Datei wird bei jedem Release ueberschrieben/versioniert, ein fixer Name ist nicht garantiert.

# Variante 2: tar.gz (falls AppImage/FUSE Probleme macht)
curl -O https://chatlix.app/downloads/chatlix-connect/chatlix-connect-desktop-linux.tar.gz
tar xzf chatlix-connect-desktop-linux.tar.gz
cd chatlix-connect-desktop-*/   # Ordnername enthaelt die Versionsnummer
./chatlix-connect-desktop

AppImage startet nicht (libfuse.so.2 fehlt): Auf Distros ohne FUSE (z.B. minimale Container-Images, manche Ubuntu-24.04-Installationen ohne fuse) hilft entweder sudo apt install libfuse2/libfuse2t64, oder du extrahierst das AppImage ohne FUSE und startest direkt (Binaryname wie im tar.gz — pruefe mit ls squashfs-root/, falls unsicher):

"./Chatlix Connect-0.7.40.AppImage" --appimage-extract
./squashfs-root/chatlix-connect-desktop

Beim ersten Start oeffnet sich der Einrichtungsassistent. Anders als in einer frueheren Version dieser Seite beschrieben gibt es keinen 6-stelligen Pairing-Code und keinen separaten pair-Befehl. Der Ablauf ist:

Im Dashboard unter /dashboard/integrations einen Connect-Token erzeugen (falls noch keiner existiert).
Token in den Assistenten einfuegen — er wird direkt in die Config geschrieben.
Optional: OBS-Auto-Discovery laufen lassen (sucht lokale OBS-Instanzen auf den ueblichen Ports) oder Host/Port/Passwort manuell eintragen.

Die Config landet danach unter ~/.config/Chatlix Connect/connect.json (Electron-userData-Pfad, siehe « Status auf Linux »). Der Platzhalter-Wert im Beispiel-Config ist DEIN_CONNECT_TOKEN_AUS_DEM_DASHBOARD — solange der drinsteht, gilt Connect intern als "nicht eingerichtet".

Weg B: Headless-CLI-Binary (Server, Streaming-Box ohne Login-Session)

curl -O https://chatlix.app/downloads/chatlix-connect/chatlix-connect-linux
chmod +x chatlix-connect-linux
mkdir -p ~/bin && mv chatlix-connect-linux ~/bin/
cd ~/bin

Das Binary ist portabel: Config, Logs und Statusdateien landen im selben Verzeichnis wie das Binary, nicht unter ~/.config oder ~/.local/share (das war in der alten Doku falsch). Kopiere dazu eine Beispiel-Config an denselben Ort:

cat > connect.json << 'EOF'
{
  "chatlix": {
    "url": "wss://ws.chatlix.app/ws",
    "api_base": "https://chatlix.app",
    "token": "DEIN_CONNECT_TOKEN_AUS_DEM_DASHBOARD",
    "client_id": "mein-server"
  },
  "modules": { "obs": { "enabled": true, "host": "127.0.0.1", "port": 4455, "password": "" } }
}
EOF

Token wie bei Weg A aus /dashboard/integrations holen und in connect.json eintragen. Alternativ fuehrt dich der interaktive Assistent durch dieselben Schritte:

node index.js   # im Quell-Checkout, oder:
./chatlix-connect-linux --debug   # zeigt den Setup-Hinweis, falls Token fehlt/Platzhalter ist

Nach erfolgreichem Setup pruefst du mit:

./chatlix-connect-linux doctor

Fuer Dauerbetrieb siehe « Systemd-Unit (optional) » — dafuer ist ausschliesslich diese CLI-Variante geeignet, nicht die Desktop-App.

Erster Start (CLI-Binary)

~/bin/chatlix-connect-linux

Erwartete Ausgabe (gekuerzt, Live-Status statt reiner Logzeilen):

══════════════════════════════════
   Chatlix Connect
══════════════════════════════════
● VERBUNDEN
 (user <id>)

Im Dashboard unter /dashboard/connect springt der Status innerhalb weniger Sekunden auf online.

Update

Es gibt fuer Linux keinen Auto-Updater (der eingebaute Update-Check/-Apply-Pfad ist laut PUBLIC_BETA_BLOCKERS.md aktuell nur fuer Windows abgesichert — Code-Signing-Verify und Rollback-Test fehlen fuer die anderen Plattformen). Updates laufen manuell ueber denselben Download:

# CLI-Binary
systemctl --user stop chatlix-connect 2>/dev/null   # falls als Service aktiv
curl -O https://chatlix.app/downloads/chatlix-connect/chatlix-connect-linux
chmod +x chatlix-connect-linux
mv chatlix-connect-linux ~/bin/
systemctl --user start chatlix-connect 2>/dev/null

# Desktop-App (Dateiname ist versioniert, siehe Downloadseite)
pkill -f "Chatlix Connect" 2>/dev/null
curl -O "https://chatlix.app/downloads/chatlix-connect/Chatlix Connect-0.7.40.AppImage"
chmod +x "Chatlix Connect-0.7.40.AppImage"

Die Config bleibt in beiden Faellen erhalten (liegt getrennt vom Binary/AppImage), ein neues Pairing/Token-Setup ist nicht noetig. Pruefe nach dem Update die Versionsnummer im Live-Status bzw. im Electron-Menü gegen https://chatlix.app/downloads/chatlix-connect/latest.json.

Game-Watcher auf Linux

Der Game-Watcher ist kein Source-Tarball mehr, der npm install braucht (das war veraltet) — er wird wie Connect selbst mit pkg als eigenstaendiges Binary gebaut und ausgeliefert:

curl -O https://chatlix.app/downloads/chatlix-connect/chatlix-game-watcher-linux
chmod +x chatlix-game-watcher-linux
./chatlix-game-watcher-linux doctor --config config.json
./chatlix-game-watcher-linux start --config config.json

Der Game-Watcher ist mehr als reine Spielerkennung: Er haelt zusaetzlich eine lokale HTTP-Bruecke auf Port 9878 offen ("Local Creator Bridge"), ueber die dein Browser mit LAN-Geraeten wie WLED-Lichtsteuerungen sprechen kann. Wenn du eine lokale Firewall (ufw/firewalld) aktiv hast, muss Port 9878 zumindest fuer localhost erreichbar sein — fuer reine Spiel-Erkennung ohne Lighting-Integration brauchst du ihn nicht nach aussen zu oeffnen. Ausgehend braucht der Game-Watcher dieselben Ziele wie Connect (chatlix.app/ws.chatlix.app).

Konfiguration erfolgt ueber eine eigene config.json (Vorlage: config.example.json aus dem Download-Paket), nicht ueber dieselbe Datei wie Connect. Pairing-Daten (Token/Channel) traegst du dort separat ein.

Sauber deinstallieren

# CLI-Binary
systemctl --user disable --now chatlix-connect 2>/dev/null
rm -f ~/bin/chatlix-connect-linux
rm -rf ~/bin/connect.json ~/bin/logs ~/bin/data ~/bin/crashes ~/bin/diagnostics

# Desktop-App (Dateiname ist versioniert)
pkill -f "Chatlix Connect" 2>/dev/null
rm -f ~/Downloads/"Chatlix Connect-"*.AppImage
rm -rf ~/.config/"Chatlix Connect"

Das Pairing kannst du zusaetzlich im Dashboard unter /dashboard/connect bzw. /dashboard/integrations revoken — danach ist der alte Token serverseitig ungueltig, unabhaengig davon ob die lokalen Dateien schon geloescht sind.