# Chatlix Connect installieren

# Chatlix Connect installieren

Connect gibt es als Windows-Build und als Linux-Binary. Such dir die Variante fuer dein System.

## Voraussetzungen

- Aktiver Chatlix-Account
- OBS Studio 28+ mit aktiviertem OBS-WebSocket
- Stabile Internet-Verbindung
- Auf Linux: glibc-basierte Distribution (Ubuntu 22.04+, Fedora 38+, Debian 12+ getestet)

## Windows

1. Im Dashboard zu Downloads, Datei `ChatlixConnect-Windows.zip` (0.4.0) herunterladen.
2. ZIP nach `C:\Program Files\Chatlix Connect\` entpacken. Du brauchst Schreibrechte.
3. Per Doppelklick auf `ChatlixConnect.exe` starten.
4. Beim ersten Start kann der SmartScreen-Warner anschlagen. Mehr Infos, dann Trotzdem ausfuehren.
5. Tray-Icon erscheint unten rechts.

Autostart einrichten:

1. Rechtsklick auf das Tray-Icon, `« Einstellungen »`.
2. Haken bei „Beim Anmelden starten".

## Linux

1. Binary herunterladen:

```bash
curl -L -o chatlix-connect-linux \
  https://chatlix.app/downloads/chatlix-connect-linux
chmod +x chatlix-connect-linux
```

2. Optional nach `/usr/local/bin/` verschieben:

```bash
sudo mv chatlix-connect-linux /usr/local/bin/chatlix-connect
```

3. Manuell starten:

```bash
chatlix-connect
```

4. Fuer Autostart als systemd-User-Service unter `~/.config/systemd/user/chatlix-connect.service`:

```ini
[Unit]
Description=Chatlix Connect
After=network-online.target

[Service]
ExecStart=/usr/local/bin/chatlix-connect
Restart=on-failure

[Install]
WantedBy=default.target
```

Aktivieren:

```bash
systemctl --user daemon-reload
systemctl --user enable --now chatlix-connect
```

## OBS-WebSocket aktivieren

OBS muss seinen WebSocket-Server laufen lassen, damit Connect ihn ansprechen kann.

1. In OBS auf Werkzeuge, dann „WebSocket-Server-Einstellungen".
2. Haken bei „WebSocket-Server aktivieren".
3. Authentifizierung aktivieren und ein Passwort setzen.
4. Port notieren (Standard 4455).
5. Uebernehmen.

## Verbindung pruefen

Nach dem Start zeigt Connect im Tray oder im Terminal den Status. Drei Zustaende sind moeglich:

| Zustand | Bedeutung |
|---------|-----------|
| Bereit | OBS erreichbar, aber noch nicht gepaart |
| Verbunden | Mit Backend gepaart und OBS erreichbar |
| Getrennt | OBS oder Backend nicht erreichbar |

Wenn du „Bereit" siehst, geh weiter zu „Erstes Pairing". Wenn „Getrennt": pruefe OBS-WebSocket-Einstellungen und Internet-Verbindung.

## Update-Hinweise

Connect prueft beim Start auf neue Versionen via `manifest.json`. Updates werden in „Connect aktualisieren" beschrieben.