# Manuelle Installation

# Manuelle Installation

Fuer Linux gibt es kein Installer-Paket. Du laedst das Binary, machst es ausfuehrbar und pair-st den Client.

## Voraussetzungen

- x86_64 Linux (alle gaengigen Distros).
- `curl` oder `wget`.
- Ausgehender Zugriff auf `chatlix.app` (HTTPS 443) und `ws.chatlix.app` (WSS 443).
- Optional: OBS WebSocket auf localhost, wenn du OBS-Actions nutzen willst.

Glibc-Abhaengigkeiten gibt es keine relevanten — das Binary ist statisch gelinkt.

## Download und Installation

```bash
curl -O https://chatlix.app/downloads/chatlix-connect-linux
chmod +x chatlix-connect-linux
./chatlix-connect-linux pair
```

Der `pair`-Command zeigt einen 6-stelligen Code und eine URL. Du oeffnest die URL im Browser (im selben Account eingeloggt) und bestaetigst den Code. Sobald die Pairing-Bestaetigung durch ist, schreibt das Binary die Config nach:

```
~/.config/chatlix-connect/config.json
```

Darin steht ein Pairing-Token. **Diesen Token nicht weitergeben** — er identifiziert deinen Channel gegenueber Chatlix.

## Empfohlene Ablage

Wenn du Connect dauerhaft nutzen willst, leg das Binary nach `~/bin`:

```bash
mkdir -p ~/bin
mv chatlix-connect-linux ~/bin/
```

Danach laeuft es per `~/bin/chatlix-connect-linux` aus jedem Verzeichnis. Stell sicher, dass `~/bin` in deinem `PATH` ist (`echo $PATH`). Andernfalls passt du das in `~/.bashrc` / `~/.zshrc` an.

## Erster Start

Nach dem Pairing startest du Connect ohne weitere Argumente:

```bash
~/bin/chatlix-connect-linux
```

Du solltest in der Konsole sehen:

```
[INFO] config loaded
[INFO] ws connected to wss://ws.chatlix.app/connect
[INFO] paired as <slug>
```

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

## Update

Updates laufen ueber denselben Download. Stoppe Connect (`Ctrl+C` oder `systemctl --user stop chatlix-connect`), tausche die Datei und starte neu. Die Config bleibt erhalten, ein neues Pairing ist nicht noetig.

```bash
curl -O https://chatlix.app/downloads/chatlix-connect-linux
chmod +x chatlix-connect-linux
mv chatlix-connect-linux ~/bin/
```

## Game-Watcher auf Linux

Der Game-Watcher fuer Linux wird als Source-Tarball ausgeliefert, nicht als Binary:

```bash
curl -O https://chatlix.app/downloads/chatlix-game-watcher-source.tar.gz
tar xzf chatlix-game-watcher-source.tar.gz
cd chatlix-game-watcher
npm install
npm run start
```

Voraussetzung: Node.js >= 20. Beim ersten Start fragt der Watcher dieselben Pairing-Daten ab wie Connect; danach laeuft er parallel und meldet erkannte Game-Sessions an deinen Channel.

## Sauber deinstallieren

```bash
systemctl --user disable --now chatlix-connect 2>/dev/null
rm -f ~/bin/chatlix-connect-linux
rm -rf ~/.config/chatlix-connect ~/.local/share/chatlix-connect
```

Das Pairing kannst du zusaetzlich im Dashboard unter `/dashboard/connect` revoken — danach ist der alte Token serverseitig ungueltig.