#App iOS

L'app cmux pour iOS est un compagnon de votre Mac. Appairez votre iPhone ou iPad avec un Mac exécutant cmux et connectez-vous à vos terminaux depuis votre téléphone, avec transfert optionnel des notifications du terminal.

L'app iOS est en bêta. Elle est distribuée sur TestFlight sous le nom cmux BETA.

#Obtenir l'accès

L'app est distribuée via TestFlight. L'accès anticipé est inclus avec cmux Founders Edition, ainsi que d'autres fonctionnalités en avant-première.

#Prérequis

Avant de commencer, vous avez besoin de :

Un Mac exécutant cmux et connecté.
Un iPhone ou iPad avec l'app cmux BETA installée depuis TestFlight.
Un chemin réseau de votre téléphone vers votre Mac (voir Utilisez votre propre réseau ci-dessous).

#Utilisez votre propre réseau

cmux ne fournit pas de réseau par défaut. Le flux du terminal circule directement entre votre téléphone et votre Mac, donc votre téléphone doit pouvoir joindre votre Mac sur le réseau. Le plus simple est un réseau superposé privé.

#Tailscale (recommandé)

Installez Tailscale sur votre Mac et votre téléphone et connectez-vous au même tailnet. Votre téléphone peut alors joindre votre Mac par son adresse tailnet depuis n'importe où, sans redirection de ports.

#WireGuard

Si vous utilisez déjà WireGuard, placez votre Mac et votre téléphone sur le même réseau et utilisez l'adresse WireGuard du Mac.

Quel que soit votre choix, la connexion vous appartient. cmux ne fait pas office de proxy et ne relaie pas le trafic du terminal entre vos appareils.

#Appairer et connecter

Sur le Mac, ouvrez la fenêtre Mobile Connect dans cmux.
Sur votre téléphone, ouvrez l'app cmux BETA et confirmez l'appairage affiché dans Mobile Connect.
Une fois appairés, vos espaces de travail et vos terminaux apparaissent sur le téléphone via votre réseau.

L'appairage se fait par appareil. Un nouvel appareil, ou une app réinstallée, s'appaire à nouveau.

#Notifications

Vous pouvez choisir de transférer les notifications du terminal vers votre téléphone, afin qu'un panneau nécessitant votre attention envoie une notification à votre appareil. Lorsque le transfert est activé, le texte de la notification (titre et corps, tirés de la sortie du terminal) est envoyé via les serveurs de cmux au service de notifications d'Apple pour être délivré. Activez Hide content dans les réglages de notifications pour envoyer un message générique à la place et garder le texte du terminal sur vos appareils. Consultez notifications pour savoir comment cmux les déclenche.

#Quelles données sont stockées

cmux est conçu pour que votre terminal reste entre vos appareils. Sur les serveurs de cmux, nous ne stockons que ce qui est nécessaire pour vous connecter et relier vos appareils :

Votre compte issu de la connexion (e-mail), pour vous identifier sur tous vos appareils.
Un jeton de notification pour votre appareil, afin de délivrer les notifications transférées du terminal.
Les métadonnées d'appairage et d'appareil, pour relier votre téléphone à votre Mac.

Votre session de terminal interactive, son contenu et vos frappes circulent directement entre votre téléphone et votre Mac via votre propre réseau, et ne sont ni relayés ni stockés sur les serveurs de cmux. La seule exception est le texte des notifications transférées, qui transite par cmux et le service de notifications d'Apple pour atteindre votre téléphone, sauf si vous activez Hide content (voir Notifications ci-dessus).

#Entreprise et auto-hébergement

Pour un déploiement auto-hébergé ou isolé du réseau, contactez [email protected].