Manuel d'utilisation de Berth

SFTP, terminal et console série dans une seule fenêtre — de l'ajout d'un serveur aux raccourcis clavier

🚀Démarrage

Organisation de l'écran

Une seule fenêtre, quatre zones.

• Barre latérale des sites — à gauche. Serveurs, consoles série et dossiers y sont présentés en arborescence.
• Colonne des sessions — les sessions connectées. Un ruban de couleur permet d'identifier le serveur.
• Zone de travail — en haut, le panneau de fichiers (local et distant) ; en bas, le terminal. Faites glisser le séparateur pour ajuster la proportion.
• Barre d'état — tout en bas. Elle indique ce qui se passe en ce moment.

Ajouter votre premier serveur

1. Faites un clic droit sur une zone vide de la barre latérale, ou appuyez sur ⌘N.
2. Saisissez un nom et l'adresse du serveur. Si vous laissez l'utilisateur ou le port vides, les valeurs par défaut sont utilisées.
3. Un double clic dans la liste établit la connexion. Un simple clic sélectionne.

Changer de langue

Choisissez l'une des 20 langues depuis Berth › Réglages (⌘,) dans le menu. Par défaut, l'application suit la langue du système, et la langue choisie ne s'applique qu'à cette application. Redémarrez l'application après le changement pour qu'il prenne effet.

🗂Serveurs et dossiers

Regrouper en dossiers et hériter les réglages

Quand vous regroupez des serveurs dans un dossier (⌘⇧N), les réglages se propagent vers le bas. Définissez une seule fois un nom d'utilisateur ou un niveau d'attention sur le dossier, et tous les serveurs qu'il contient en héritent. C'est un dispositif pour éviter de saisir vingt fois la même valeur sur vingt serveurs.

Chaque champ de la fenêtre de réglages indique en dessous d'où vient sa valeur (définie par vous, ou héritée d'un dossier), et un bouton permet de revenir à la valeur héritée.

Niveau d'attention — Développement · Préproduction · Production

Le niveau prime sur la couleur. En Production, les actions risquées demandent une confirmation supplémentaire. Dans la liste des sessions, elle est remplie de la couleur que vous choisissez et marquée d’une bordure rouge, ainsi plusieurs serveurs de production restent distingués par la couleur. Là où un seul apparaît à la fois (boîtes de confirmation, etc.), il reste rouge comme avertissement fort.

Règles de clic

• Un clic — sélectionner (pour consulter les réglages ou déplacer l'élément)
• Deux clics — connexion pour un serveur, déplier/replier pour un dossier
• Le triangle devant un dossier se déplie d'un seul clic.

🔑Connexion et authentification

À la première connexion — autorisation de dossier

Berth respecte les règles de l'App Store (bac à sable) et ne lit donc pas librement votre dossier personnel. À la première ouverture d'un serveur, l'application vous demande de choisir une fois le dossier contenant votre configuration SSH, vos clés et known_hosts (généralement ~/.ssh). Une fois choisi, ce dossier est mémorisé et ne vous sera plus redemandé. Si vos clés se trouvent ailleurs, vous pouvez aussi choisir votre dossier personnel.

Pour la même raison, le panneau de fichiers local utilise le dossier que vous avez choisi comme racine — vous pouvez le changer via Ouvrir un dossier local dans l'en-tête du panneau, et ce choix est lui aussi mémorisé.

Lecture de ~/.ssh/config

En vous connectant par alias, Berth lit et utilise l'hôte, le port, l'utilisateur, le fichier de clé, ProxyJump et StrictHostKeyChecking de cette entrée. Même si le port enregistré est obsolète, le fichier de configuration prévaut.

Méthode d'authentification

• Automatique — laisse faire ssh. Toutes les clés par défaut sont essayées, et si aucune ne fonctionne, le mot de passe est demandé dans le terminal.
• Fichier de clé — utilise uniquement la clé indiquée.
• Mot de passe — ignore les clés.

Quand le serveur pose une question

Si vous enregistrez un mot de passe, Berth y répond une fois à votre place lors de la connexion. Pour les autres questions — code de vérification en deux étapes, nouvelle saisie après un mot de passe erroné, mot de passe d'une clé protégée — la fenêtre « Le serveur a envoyé une demande » affiche exactement la question envoyée par le serveur, à laquelle vous répondez vous-même. Pour éviter tout verrouillage de compte, le mot de passe enregistré n'est saisi automatiquement qu'une seule fois, et il n'est redemandé que trois fois au maximum.

Pour ne plus avoir à taper le mot de passe

Faites un clic droit sur le serveur et choisissez Enregistrer la clé publique sur ce serveur… pour envoyer votre clé publique de ~/.ssh sur le serveur. Les connexions suivantes se feront par clé.

Les mots de passe enregistrés ne se trouvent que dans le trousseau macOS. Le fichier de configuration ne conserve qu'une indication « enregistré », jamais la valeur elle-même.

Serveur inconnu, clé d'hôte modifiée

Pour un serveur inconnu, Berth affiche le type et l'empreinte de la clé et demande si elle doit être mémorisée. Si vous acceptez, elle est ajoutée à ~/.ssh/known_hosts dans le même format que ssh, et ne sera plus redemandée par la suite.

Cette fenêtre apparaît aussi quand l'identité du serveur est différente de la dernière fois. Cela peut être une attaque de l'homme du milieu, ou simplement un serveur réinstallé. Berth ne tranche pas à votre place et vous fournit les éléments — le type et l'empreinte des anciennes et nouvelles clés, ainsi que la commande à exécuter directement sur la console de l'appareil pour vérifier. Une fois vérifié, cliquez sur « Supprimer l'ancienne clé et mémoriser la nouvelle » pour supprimer l'ancienne entrée (sauvegardée dans known_hosts.old) et enregistrer la nouvelle clé.

Panneau de fichiers (SFTP)

Envoyer et télécharger

La gauche, c'est votre Mac ; la droite, c'est le serveur. Faites glisser-déposer, ou utilisez ⌥⌘→ (envoi) et ⌥⌘← (téléchargement) pour transférer. La progression s'accumule dans la file de transfert.

Le panneau de fichiers qui suit le terminal

Quand vous faites cd dans le terminal, le panneau distant suit dans le même dossier. Si ce suivi vous gêne, désactivez-le avec ⌘⇧L.

Emplacements fréquents · Affichage

• ⌘D — ajoute ou retire le chemin actuel des épingles. Un chemin épinglé devient une racine de l'arborescence.
• ⌘↓ — entre dans le dossier sélectionné. ⌘↑ remonte d'un niveau.
• ⌥⌘T — bascule entre vue arborescence et vue liste. Pour un dossier contenant des milliers de fichiers, la liste est préférable.
• ⌘R — Relire.
• ⌘⇧F — Rechercher sur le serveur. Ce n'est pas l'application qui parcourt la liste, mais le serveur qui exécute find.

Afficher les différences

Activez avec ⌘⇧Y pour comparer le local et le distant côte à côte et afficher ce qui diffère ou n'existe que d'un côté. Utile quand vous ne voulez envoyer que ce qui est nécessaire.

Supprimer

⌘⌫ déplace par défaut vers la corbeille côté serveur, et une confirmation est toujours demandée. Si la corbeille est désactivée sur le serveur, Berth vous prévient à l'avance que l'action sera irréversible.

⌨️Terminal

C'est un vrai shell où vim, tmux et less fonctionnent normalement. Sélectionnez avec la souris et copiez avec ⌘C : la commande se colle proprement, sans les espaces de remplissage en fin de ligne.

Confirmation du collage

Coller plusieurs lignes vous montre d'abord ce qui va être exécuté. Un collage contenant des retours à la ligne se transforme en effet immédiatement en commandes. Tout ce qui semble risqué est signalé avec la raison.

Vue élargie

⌘↩ agrandit la zone actuelle, et un nouvel appui revient à l'affichage normal. ⌥⌘↩ n'agrandit que ce panneau. La taille du texte se règle avec ⌘+ · ⌘- · ⌘0. Effacez le terminal avec ⌘L — l’écran et l’historique de défilement sont vidés, seule la ligne d’invite actuelle reste.

🔌Console série (UART)

Choisir l'appareil

Ajoutez une console série avec ⌃⌘N, puis choisissez l'appareil connecté dans les réglages. Berth ne mémorise pas le chemin, mais l'appareil lui-même — par son numéro de série s'il en a un, sinon par son type. L'appareil est retrouvé même s'il est branché sur un autre port USB.

Vitesse et réglages de la liaison

La vitesse se choisit dans la liste ou se saisit directement (des valeurs hors norme comme 1,500,000 sont acceptées — il faut simplement que l'adaptateur les prenne en charge). Par défaut, 8N1 · sans contrôle de flux, ce qui convient à la plupart des consoles.

• Contrôle de flux — n'activez que si vous utilisez un câble à 4 fils (RTS/CTS). L'activer sur un câble à 3 fils bloque au contraire la liaison.
• Avancé (parité · bits) — cliquez sur la ligne pour déplier. À utiliser uniquement dans des cas particuliers, comme le bootloader STM32 (8E1).

Carnet

Dans une session série, les commandes que vous tapez et leurs réponses s'accumulent à droite avec l'horodatage. La saisie effectuée là où un mot de passe est demandé est masquée.

⚡Raccourcis clavier

Les raccourcis de l'application comportent toujours ⌘. Les combinaisons avec ⌃ et ⌥ appartiennent au shell et aux interfaces TUI (vim, tmux) — l'application ne se les approprie pas.

❓Questions fréquentes

Où les mots de passe sont-ils enregistrés ?

Ils ne sont enregistrés que dans le trousseau macOS. Le fichier de configuration ne conserve qu'une indication « enregistré ». Le trousseau n'est ouvert qu'une seule fois, au moment de la connexion.

L'application collecte-t-elle des données d'usage ?

Non. Aucune télémétrie n'est intégrée à l'application. Elle ne compte ni ce que vous ouvrez, ni à quoi vous vous connectez.

La console série s'arrête en cours de route.

C'est une caractéristique de la liaison qui apparaît lors d'une communication volumineuse sur un UART sans contrôle de flux. Avec un câble à 4 fils, activez le contrôle de flux (RTS/CTS) dans les réglages ; avec un câble à 3 fils, réduisez la vitesse côté carte ou fractionnez la sortie avec un pager.

Dois-je ressaisir ma configuration SSH existante ?

Non. En important depuis ~/.ssh/config, la connexion se fait avec l'alias tel quel, en lisant et utilisant l'hôte, le port, l'utilisateur, la clé et ProxyJump de cette entrée.

J'ai une configuration qui utilise ProxyCommand.

ProxyCommand lance un programme externe et ne peut donc pas fonctionner dans le bac à sable de l'App Store. Si votre configuration passe par un hôte relais, remplacez-le par ProxyJump et cela fonctionnera à l'identique. ssh-agent n'est pas accessible pour la même raison : Berth lit directement le fichier de clé, et si la clé est protégée par un mot de passe, celui-ci est demandé au moment de la connexion.

Quelles versions de macOS sont prises en charge ?

macOS 14 (Sonoma) ou ultérieur, compatible avec Apple Silicon et Intel.

Si Berth vous a été utile

Berth est gratuit. Vous pouvez soutenir son développement en faisant un don.