Documentation de Wardterm

Les bases du terminal

Travailler dans le terminal Wardterm : onglets et sessions, menu de session, panneaux et groupes de travail, panneau latéral, thèmes et raccourcis.

Sessions et onglets

  • Sur Mac et iPad, chaque session est un onglet. Cmd+T ouvre un nouvel onglet, où vous trouvez un serveur ou tapez user@host puis Retour. Cmd+1 à Cmd+9 passent d'un onglet à l'autre.
  • Faites glisser un onglet le long de la barre pour changer l'ordre. Sur Mac, faites-le glisser vers le bas hors de la barre et il s'ouvre dans sa propre fenêtre (Pro), sa session toujours active ; faites-le glisser dans la barre de la fenêtre principale et il revient là où vous le lâchez.
  • Clic droit sur un onglet, ou appui prolongé, pour le menu de session, qui se termine par Déplacer dans une nouvelle fenêtre (Mac), Fermer les autres sessions et Fermer les sessions à droite. Dans une fenêtre à part, le clic droit sur un onglet propose Revenir à la fenêtre principale.
  • Clic droit sur la partie vide de la barre pour Nouvel onglet et Rouvrir la session fermée (Maj+Cmd+T), qui se reconnecte aux serveurs de la dernière session fermée.
  • Sur iPhone, l'onglet Connexions liste les sessions actives. Balayez une session vers la gauche pour la fermer.

La rangée des sessions sur iPhone

En bas d'un terminal sur iPhone, une rangée contient, de gauche à droite :

  • la flèche de retour, vers la liste
  • la session de devant, avec le logo du système, le nom et l'adresse, dans la couleur de son état. Touchez-la pour la liste des sessions ouvertes. Son x ferme cette session.
  • +, une nouvelle session sur un serveur choisi dans la liste
  • le carré, avec le nombre de sessions ouvertes. Le nombre prend la couleur d'accent quand une session derrière a une nouvelle sortie. Touchez le carré pour voir toutes les sessions ouvertes côte à côte.

Pour passer à la session suivante ou précédente, faites glisser deux doigts vers la gauche ou la droite sur le terminal. Touchez le terminal pour ouvrir le clavier.

Touchez deux fois le carré pour revenir à la session précédente.

Toutes les sessions d'un coup d'œil sur iPhone

Le carré montre jusqu'à quatre terminaux en direct à la fois ; balayez sur le côté pour les autres. Chacun montre ce qui s'est passé pendant votre absence : un point pour une nouvelle sortie, une coche quand une commande est terminée, une note quand la connexion est tombée, un bord rouge pour un serveur de production.

  • Touchez un terminal pour le mettre au premier plan.
  • Maintenez-en un, puis faites-le glisser pour changer l'ordre des sessions.
  • Maintenez-le sans bouger pour son menu : Dupliquer, Reconnecter, Placer en premier, Partager la session et Fermer la session.
  • Balayez-en un vers le haut pour le fermer.
  • Touchez la dernière case, +, pour une nouvelle session.
  • Touchez Sélectionner, choisissez les sessions, puis Saisir vers tous. Un panneau s'ouvre au-dessus du clavier avec le nombre de sessions qui la reçoivent et un champ : écrivez une commande et touchez Envoyer, ou Retour sur le clavier, et elle s'exécute dans toutes. Le champ se vide pour la suivante, et les cases au-dessus montrent les résultats. Touchez une case pour l'exclure ou la réintégrer. OK arrête et revient au terminal.

Clavier ouvert, la rangée se place juste au-dessus de la barre de touches. Fermer la dernière session ramène à la liste.

Le menu de session

Sur Mac et iPad, le menu ... de l'onglet d'une session propose :

  • Reconnecter et Nouvelle session sur ce serveur
  • Garder cette session : la session continue sur le serveur si la connexion tombe. Voir Garder les sessions actives.
  • Diviser côte à côte (Cmd+D) et Diviser en haut et en bas (Maj+Cmd+D)
  • Rechercher (Cmd+F) dans le texte du terminal
  • Fichiers de ce serveur, Historique des commandes et Apparence, qui ouvrent le panneau latéral
  • Partager la session : voir Partager une session de terminal
  • Plus, en quatre groupes : Session (renommer, suggestions, enregistrer comme groupe de travail), Plusieurs sessions (envoyer à plusieurs sessions, saisir vers tous, ajouter un serveur, disposition), Enregistrer et partager (enregistrement), Shell (commande précédente et suivante, intégration du shell, import de l'historique du shell, Détails de la connexion)
  • Fermer la session (Cmd+W).

Sur iPhone, le menu ... en haut à droite du terminal propose Reconnecter, Garder cette session, Rechercher, Suggestions, Partager la session et Plus. Fichiers, Historique et Apparence sont dans le panneau latéral. + et x dans la rangée des sessions ouvrent et ferment les sessions.

Panneaux et groupes de travail

Sur Mac et iPad, un onglet peut contenir plusieurs panneaux. Sous Plus, Disposition les organise : deux côte à côte, deux superposés, quatre en grille, ou un grand et deux, avec Option+Cmd+1 à Option+Cmd+4. Tailles égales leur redonne la même taille. Maj+Cmd+Entrée met un panneau en avant, et Afficher tous les panneaux fait revenir les autres.

  • Enregistrer comme groupe de travail garde les serveurs et la disposition, pour les rouvrir ensemble depuis Groupes de travail (Pro). Le menu d'un groupe de travail propose Ouvrir, Renommer et Supprimer.
  • Saisir vers tous envoie ce que vous tapez à tous les panneaux. Une barre indique combien de panneaux le reçoivent. S'il y a des serveurs de production parmi eux, l'app demande d'abord.
  • Envoyer à plusieurs sessions envoie une ligne aux sessions que vous choisissez.

Toutes les sessions côte à côte

Sur Mac et iPad, le bouton en grille à droite de la barre des onglets affiche toutes les sessions ouvertes côte à côte, dans une grille qui suit leur nombre : deux côte à côte, trois ou quatre sur deux rangées, et ainsi de suite. Il se trouve aussi dans le menu Présentation sous Afficher toutes les sessions côte à côte (Maj+Cmd+\). Appuyez à nouveau, ou choisissez Revenir aux onglets, et vos onglets sont comme avant. Double-cliquez sur le nom d'une session pour revenir aux onglets sur celle-ci.

  • Cliquez sur une session pour saisir uniquement dans celle-ci.
  • Saisir vers tous (Maj+Cmd+I) ouvre sous les sessions un panneau qui indique combien la reçoivent, avec un champ : écrivez une commande et cliquez sur Envoyer, ou appuyez sur Entrée, et elle s'exécute dans toutes. Le champ se vide pour la suivante, et les sessions au-dessus montrent les résultats.
  • Panneau ouvert, cliquez sur une session pour l'exclure ou la réintégrer. Avec des serveurs de production parmi elles, une commande risquée demande d'abord.
  • OK, ou Échap, ferme le panneau.

Le panneau latéral

Le panneau latéral réunit Serveur, Commandes enregistrées, Historique, Fichiers, Conteneurs et Apparence à côté du terminal. Ouvrez-le avec le bouton du panneau latéral, ou avec Cmd+. sur Mac et iPad.

Sur iPhone, touchez le bouton du panneau latéral en haut à droite, à côté de .... Sur iPhone et iPad, quand il n'y a pas de place à côté du terminal, le panneau arrive par la droite et couvre l'écran, avec une icône pour chaque onglet. Fermez-le avec OK ou en le faisant glisser vers la droite. Il se rouvre sur le dernier onglet utilisé.

  • Serveur : le CPU, la mémoire, les disques et le réseau du serveur. Voir Statistiques du serveur.
  • Commandes enregistrées : un toucher écrit la commande sur la ligne sans l'exécuter, le bouton lecture l'exécute. Voir Commandes enregistrées.
  • Historique : les commandes exécutées sur ce serveur, à relancer, copier ou enregistrer comme commande.
  • Fichiers : les fichiers de ce serveur, dans le dossier du shell. Voir Fichiers en SFTP.
  • Conteneurs : les conteneurs Docker ou Podman du serveur. Voir Conteneurs.
  • Apparence : police, taille du texte et thème.

Mots de passe et collage

  • Quand une commande comme sudo ou su demande un mot de passe, l'app propose Saisir le mot de passe enregistré si le serveur en a un : un toucher le tape dans cette question seulement. Sinon Saisir le mot de passe ouvre un champ, avec S'en souvenir pour la prochaine fois pour l'enregistrer dans le serveur. Si le mot de passe enregistré est refusé, l'app propose Mettre à jour.
  • Avant de coller des caractères cachés ou une commande risquée, l'app affiche Coller ce texte ? avec le texte, et supprime les caractères cachés.

Thèmes et texte

  • Réglages, Terminal définit la taille du texte, le thème et la police de tous les terminaux. Voir Réglages.
  • Un serveur ou un groupe peut avoir son propre thème : Afficher plus, Terminal, Thème.
  • Cmd+Plus et Cmd+Moins changent la taille du texte. Sur iPhone et iPad, pincez l'écran.

Suggestions pendant la saisie

Pendant que vous tapez, des suggestions apparaissent depuis votre historique, vos commandes enregistrées et les dossiers, commandes et options du serveur : au-dessus des touches sur iPhone et iPad, sous le curseur sur Mac. Les plus probables viennent d'abord, selon ce que vous lancez sur ce serveur, dans ce dossier et récemment. Un toucher, ou la flèche droite, ajoute la suggestion à la ligne. Vous appuyez vous-même sur Entrée.

Avec Prédire la commande suivante, l'invite vide propose ce que vous lancez d'habitude ensuite. Par exemple, après

cd /var/www/app

elle propose git pull, et après git pull elle propose npm run build. Elle apprend des commandes que vous lancez sur cet appareil, et ce qu'elle apprend y reste.

  • Sur iPhone et iPad, les suggestions gardent leur place au-dessus des touches : le terminal ne bouge pas.
  • Pour les désactiver dans une seule session, choisissez Suggestions dans le menu de la session, ou touchez longuement les suggestions et choisissez Masquer dans cette session. Sur Mac, clic droit sur la liste.
  • Réglages, Terminal : Suggestions pendant la saisie les désactive partout, Prédire la commande suivante désactive les suggestions à l'invite vide et l'apprentissage. Dans Afficher plus, Oublier les habitudes apprises repart de zéro et garde l'historique des commandes.

Intégration du shell

Avec l'intégration du shell, l'app sait où chaque commande commence et finit. Une marque à côté de chaque invite indique si la commande a réussi, avec son code de sortie et sa durée, et vous pouvez sauter de commande en commande (Cmd+Haut et Cmd+Bas) ou copier la sortie d'une commande.

  1. Dans le menu de session, choisissez Plus, puis Intégration du shell.
  2. L'app affiche les lignes qu'elle ajouterait pour bash, zsh ou fish, et le fichier où elles iraient.
  3. Choisissez Ajouter. L'app garde d'abord une copie du fichier. Retirer enlève les lignes.
  4. Ouvrez une nouvelle session pour l'utiliser.

Raccourcis sur Mac

  • Cmd+K : Rechercher, serveurs, commandes et emplacements
  • Cmd+J : demander une commande, voir Demander
  • Cmd+N : nouveau serveur ; Cmd+L : nouveau terminal local
  • Cmd+Y : historique des commandes, dans le menu Session ; Cmd+. : panneau latéral
  • Option+Cmd+1 à Option+Cmd+4 : dispositions des panneaux
  • Maj+Cmd+\ : toutes les sessions côte à côte ; Maj+Cmd+I : Saisir vers tous
  • Maj+Cmd+] et Maj+Cmd+[ : session suivante et précédente
  • Maj+Cmd+T : rouvrir la session fermée
  • Maj+Cmd+L : verrouiller l'app.