# Companion verbinden

> Das Deck in Bitfocus Companion über WLAN oder LAN nutzen, als Satellite-Surface.

Source: https://deckconnector.com/de/docs/companion/

Companion verbindet sich per Satellite oder als Network Dock. Nimm Satellite.

## Satellite

In [Bitfocus Companion](https://bitfocus.io/companion) muss **Settings › Satellite** eingeschaltet sein. Nötig ist Satellite-API 1.9 oder neuer, getestet mit Companion 5.2.

Öffne in Companion **Surfaces › Discover** und klick neben dem Connector auf **Setup**. Oder öffne in der Weboberfläche **Quellen** ([Demo](https://deckconnector.com/de/demo/#sources)) und klick auf das gefundene Companion.

Unter **Surfaces** erscheint das Deck als `streamdeck:<seriennummer>`, mit derselben ID wie über USB. Deine Seiten und Surface-Einstellungen bleiben.

Der Connector findet Companion in Docker ohne Host-Netzwerk nicht. Gib Port 16622 frei und trag seine Adresse unter **Quellen** ein.

Eine `wss://`-Adresse braucht ein Zertifikat einer öffentlichen CA. Für jedes andere Zertifikat fügst du den SHA-256 des Server-Zertifikats selbst als Pin ein. Wird dieses Zertifikat erneuert, trägst du den neuen Pin ein.

```bash
openssl x509 -noout -fingerprint -sha256 -in cert.pem
```

## Aufteilung

Companion sieht zwei Tastenreihen, die Touchleiste als vier Felder zu 200 × 100 und die vier Drehregler. Das ist wie in seinem eigenen Stream-Deck-Plugin.

- Tippen drückt das Feld. Wischen nach oben oder unten dreht das Feld wie einen Drehregler.
- Wischen zur Seite wechselt die Seite. Schalte dafür in den Surface-Einstellungen **Horizontal Swipe Changes Page** ein.
- Auf einem Stream Deck Neo bekommt Companion auch die zwei Touch-Punkte und die Infoleiste dazwischen.

## PIN-Sperre

Sperrt Companion das Deck, zeigt das Deck ein Zahlenfeld. Gib dort die PIN ein. Solange das Deck gesperrt ist, geben seine Tasten nur die PIN ein, und das Menü öffnet sich nicht. Du kannst sie auch in der Weboberfläche eingeben, unter dem Deck in der Übersicht. Ein Stream Deck Pedal hat keinen Bildschirm und braucht dafür die Weboberfläche.

## Network Dock

Companion kann den Connector unter **Surfaces › Discover** auch als Network Dock eintragen. Antwortet seine Satellite-API unter derselben Adresse, stellt der Connector es von selbst auf Satellite um. Satellite geht auch durch Docker und braucht keine Suche. Soll es ein Dock bleiben, tippst du am Deck auf **Nein** oder entfernst die Companion-Adresse unter **Quellen**.

> **Hinter einem Proxy**
>
> Der Connector sieht dann nur die Adresse des Proxys und kann die Dock-Verbindung nicht beenden. Companion zeigt das Deck doppelt, das zweite als `streamdeck:<seriennummer>-dev2`.

Über Satellite verbindet sich ein Companion gleichzeitig. Für mehr siehe [Quellen](https://deckconnector.com/de/docs/hosts/).

Next: [Quellen](https://deckconnector.com/de/docs/hosts/), [Fehlersuche](https://deckconnector.com/de/docs/troubleshooting/#companion-verbindet-sich-nicht)
