Paramètres

Ce que fait chaque champ, interrupteur et paramètre : 140 éléments sur cette page. C’est le texte derrière le ⓘ à côté de chaque libellé dans les applications : sur ordinateur, survolez-le ou cliquez dessus (ou appuyez sur F1 dans le champ) ; sur le téléphone, touchez-le.

La ligne sous chaque nom donne l’identifiant que le code utilise et indique quand une seule des applications a l’élément.

Paramètres : Apparence

Où: Paramètres › Apparence.

Thème de l’application

settings.appTheme

Couleurs claires ou sombres pour l’application elle-même. « Système » suit le réglage clair ou sombre de votre ordinateur ou téléphone.

• Par défaut: Système.

Thème de couleurs

settings.appThemeName

Les couleurs de l’application elle-même : Sternway (bleu profond), Arctic (gris-bleu froid), Solar (crème chaud et bleu canard), Graphite (gris neutre), Forest (vert) ou Contraste élevé (noir et blanc avec des couleurs franches). Chacun existe en clair et en sombre, et « Thème de l’application » choisit lequel. Chaque thème garde le texte lisible sur ses fonds. Le terminal a son propre thème.

• Par défaut: Sternway.

Couleur d’accentuation

settings.appAccent

La couleur des boutons, des liens, de la ligne sélectionnée et du contour de ce qui a le clavier. « Couleur du thème » reprend celle du thème de couleurs ; une pastille ou « Couleur personnalisée » en met une autre à sa place. Une couleur difficile à lire sur les fonds du thème est éclaircie ou foncée juste assez pour être lisible.

• Par défaut: Couleur du thème.

Langue

settings.language

La langue des menus, boutons et messages : anglais, espagnol, allemand, français, portugais du Brésil ou japonais, chacune indiquée dans sa propre langue. « Langue du système » suit la langue de votre ordinateur ou téléphone, et l’anglais est utilisé quand Sternway ne la parle pas. Les dates, heures, nombres et tailles de fichiers suivent aussi la langue. Réglage propre à chaque appareil.

• Par défaut: Langue du système.
• Attention: Les longs documents générés, comme les mentions de tiers, restent en anglais.

Taille de l’interface

settings.interfaceSize · Ordinateur uniquement

La taille du texte, des boutons et des espacements dans toute l’application : Compacte, Par défaut ou Grande. La taille de police du terminal est distincte (Paramètres › Terminal). Réglage propre à chaque ordinateur, car les écrans diffèrent.

• Par défaut: Par défaut.

Utiliser la barre de titre du système

settings.systemTitleBar · Ordinateur uniquement

Sternway dessine sa propre barre en haut de la fenêtre, avec le menu, les onglets et les boutons de fenêtre. Activez cette option pour retrouver la barre de titre et la barre de menus de votre système d’exploitation, par exemple quand la fenêtre ne se déplace, ne se redimensionne ou ne s’aimante pas comme vos autres fenêtres. Réglage propre à chaque ordinateur. Prend effet au prochain démarrage de Sternway.

• Par défaut: Désactivé.

Les formulaires s’ouvrent en

settings.forms.defaultMode

Comment s’ouvrent « Nouvel hôte » et les autres éditeurs. Un assistant demande une chose à la fois ; le formulaire complet affiche tous les champs d’un coup. On peut passer de l’un à l’autre une fois ouvert.

• Par défaut: Formulaire complet sur ordinateur, assistant sur mobile.

Thème du terminal

settings.terminalThemeId

Les couleurs des terminaux qui n’ont pas leur propre thème. « Suivre le thème de l’application » suit l’apparence claire ou sombre de l’application. Un hôte ou un groupe peut définir son propre thème, et un thème choisi dans une session l’emporte pour cette session.

• Par défaut: Suivre le thème de l’application.

Garder le texte lisible

settings.keepTextReadable

Éclaircit le texte dont la couleur est trop proche de celle du fond jusqu’à ce qu’il soit lisible (un contraste de 3:1). Certains thèmes ont volontairement de telles couleurs : le noir et le noir vif de Solarized sont des tons de son fond, et un programme qui écrit dans ces couleurs serait invisible. Les couleurs déjà lisibles ne sont pas modifiées, ni le thème lui-même. Désactivez cette option pour voir chaque couleur exactement telle que le thème la définit.

• Par défaut: Activé.

Nom

theme.name

Le nom du thème personnalisé dans les listes de thèmes. Obligatoire, 64 caractères maximum.

• Exemple: Solarized, à ma façon

Couleur

theme.color

Une couleur du thème, en valeur hexadécimale. Le fond et le premier plan sont obligatoires ; une couleur laissée sur « Par défaut » est déduite de ces deux-là (le curseur prend le premier plan) ou de la palette standard de 16 couleurs.

• Exemple: #1a2b3c

Coller du JSON

theme.paste · Téléphone uniquement

Collez un thème pour l’importer : un thème exporté de Sternway en JSON, ou le texte XML d’un fichier .itermcolors d’iTerm2 (ouvrez le fichier dans un éditeur de texte et copiez-le en entier). Les couleurs sont d’abord vérifiées, et le thème est ajouté à vos thèmes personnalisés sans en remplacer un du même nom.

Paramètres : Terminal

Où: Paramètres › Terminal.

Police

settings.fontFamily

La police du terminal. Fournies : JetBrains Mono, Fira Code, Cascadia Code, Source Code Pro et Hack. Sur ordinateur, vous pouvez aussi saisir le nom de n’importe quelle police installée.

• Par défaut: JetBrains Mono.

Taille de police

settings.fontSize

La taille du texte du terminal en pixels entiers, de 6 à 72. Un hôte ou une session peut utiliser la sienne. Tant que vous n’avez pas défini de taille, chaque appareil utilise sa propre valeur par défaut ; une taille définie ici s’applique à tous vos appareils.

• Par défaut: 10 sur un téléphone, 12 sur une tablette, 14 sur un ordinateur.

Hauteur de ligne

settings.lineHeight

L’espace occupé par chaque ligne du terminal, en multiple de la taille de police, de 0,8 à 2. Augmentez-le si les lignes semblent serrées.

• Par défaut: 1,2.

Texte en gras

settings.boldText

Indique si le texte marqué en gras par les programmes est affiché en gras. Désactivez cette option si le gras paraît flou avec votre police.

• Par défaut: Activé.

Le texte en gras utilise les couleurs vives

settings.boldIsBright

Affiche le texte en gras dans la variante vive de sa couleur, comme les anciens terminaux. Désactivé, le texte en gras garde sa couleur et est seulement plus épais, ce que font la plupart des terminaux actuels et ce pour quoi les thèmes sont conçus : dans Solarized, par exemple, les couleurs vives sont des gris, si bien qu’un nom de dossier bleu en gras deviendrait gris. Activez cette option si un programme que vous utilisez se sert du gras pour dire « plus vif ».

• Par défaut: Désactivé.

Curseur

settings.cursorStyle

La forme du curseur de texte : un bloc plein, un soulignement ou une barre fine.

• Par défaut: Bloc.

Curseur clignotant

settings.cursorBlink

Indique si le curseur clignote. Désactivez cette option si le mouvement vous distrait.

• Par défaut: Activé.

Saisie semi-automatique

settings.autocomplete

Affiche des suggestions pendant la saisie à une invite : les commandes installées sur l’hôte, leurs sous-commandes et options, les valeurs adaptées à l’argument (branches après « git checkout », services après « systemctl restart », fichiers et dossiers), vos extraits d’une ligne enregistrés et les commandes déjà exécutées sur cet hôte. La commande complète la plus probable de votre historique s’affiche en grisé après le curseur ; la liste sous le curseur contient les alternatives. En choisir une la saisit sans appuyer sur Enter. Rien n’est suggéré dans un programme plein écran comme vim ni à une demande de mot de passe. Les sessions Telnet, série et Mosh n’ont que l’historique, les extraits et les descriptions de commandes intégrées, de même qu’un terminal local sous Windows exécutant Git Bash ou une distribution WSL (l’application n’y a pas de shell propre à interroger) ; dans PowerShell et l’invite de commandes, rien n’est suggéré. Sur ordinateur, elle propose aussi le mot de passe enregistré de l’hôte à une demande de mot de passe. Un hôte peut désactiver les suggestions pour lui-même.

• Par défaut: Activé.
• Attention: Un serveur qui n’autorise qu’un canal par connexion ne peut pas être interrogé : les suggestions sont donc désactivées pour cet hôte sur cet appareil, avec un avis.

Rechercher les commandes et options sur l’hôte

settings.autocompleteHostLookup

Permet à la saisie semi-automatique d’interroger l’hôte sur ce qu’il contient : les commandes installées, les options de la page de manuel d’une commande, et des valeurs comme les branches git, services, conteneurs, utilisateurs et noms de fichiers. Les requêtes sont des commandes fixes en lecture seule (par exemple « ls », « man », « git for-each-ref », « systemctl list-units ») exécutées en arrière-plan via la connexion existante de la session, jamais saisies dans votre terminal. Ce que vous tapez ne leur est transmis que sous forme de nom ou de chemin entre guillemets, et aucun programme n’est lancé juste pour lire son aide. La liste des commandes installées est conservée une journée sur cet appareil pour que la session suivante l’ait immédiatement. Désactivé, les suggestions proviennent uniquement de votre historique, de vos extraits et des descriptions de commandes intégrées.

• Par défaut: Activé.
• Attention: Les requêtes s’exécutent sous l’utilisateur avec lequel vous avez ouvert la session et sont visibles par l’hôte comme toute autre commande (une liste de processus ou un journal d’audit les montre). Désactivez cette option pour un hôte où même des commandes en lecture seule ne doivent pas s’exécuter sans demande.

Touche Tab

settings.autocompleteTab · Ordinateur uniquement

Ce que fait Tab quand la liste de suggestions est affichée. « Suggestions Sternway d’abord » insère la suggestion en surbrillance, ou la première. « Complétion du shell d’abord » envoie Tab au shell comme d’habitude, et n’insère une suggestion qu’après être entré dans la liste avec la flèche bas. Sans liste affichée, Tab va toujours au shell.

• Par défaut: Suggestions Sternway d’abord.

Copier à la sélection

settings.copyOnSelect

Copie le texte dans le presse-papiers dès que vous le sélectionnez dans le terminal, comme les terminaux Linux.

• Par défaut: Désactivé.
• Attention: Chaque sélection remplace silencieusement le contenu du presse-papiers.

Avertir avant de coller

settings.pasteWarning

Demande avant de coller un texte de plusieurs lignes ou volumineux (5 Ko ou plus), car chaque ligne collée peut s’exécuter comme une commande dès son arrivée.

• Par défaut: Collages multilignes.
• Attention: Avec « Jamais », un bloc de commandes collé s’exécute immédiatement. Les commandes écrites par l’assistant IA font toujours l’objet d’une demande quand elles ont plusieurs lignes.

Clic droit

settings.rightClick · Ordinateur uniquement

L’action du bouton droit de la souris dans un terminal : ouvrir le menu, ou coller directement le presse-papiers comme PuTTY.

• Par défaut: Afficher le menu.

Cloche

settings.bell

Ce qui se passe quand un programme fait sonner le terminal (un échec de complétion par Tab, par exemple) : un bref clignotement, un son sur ordinateur ou une vibration sur mobile, ou rien.

• Par défaut: Clignotement.

Historique de défilement

settings.scrollback

Le nombre de lignes de sortie passée que chaque terminal conserve pour le défilement arrière, de 1 000 à 100 000. Plus de lignes consomme plus de mémoire par terminal ouvert.

• Par défaut: 10 000 lignes.

TERM par défaut

settings.defaultTermType

Ce que l’application déclare être aux serveurs (la variable TERM), ce qui détermine les couleurs et les touches qu’utilisent les programmes. Un hôte ou un groupe peut la remplacer. Ne la modifiez que si les programmes plein écran se comportent mal partout. Les choix sont xterm-256color, xterm, vt100 et linux (la console Linux).

• Par défaut: xterm-256color.

Séparateurs de mots

settings.wordSeparators

Les caractères qui terminent un mot quand vous double-cliquez (double-touchez sur mobile) pour en sélectionner un. Retirez un caractère pour qu’il soit sélectionné comme partie du mot.

• Par défaut: Une espace et ( ) [ ] { } ’ “ , ; :

Ligatures de police

settings.ligatures · Ordinateur uniquement

Affiche des paires comme -> et != sous forme d’un seul symbole lié, dans les polices qui en disposent. Cela ne change que leur apparence, pas ce qui est envoyé.

• Par défaut: Désactivé.

Surlignage intelligent

settings.smartHighlight

Sternway colore ce qu’il reconnaît dans la sortie brute : adresses, chemins, tailles, dates, niveaux de journal, colonnes d’une liste de fichiers, etc., chacun dans une couleur du thème du terminal, si bien qu’un autre thème les recolore. Les couleurs propres aux programmes ne sont jamais modifiées : seul le texte affiché par un programme dans la couleur par défaut est coloré. C’est purement visuel : la copie, la recherche, les journaux et ce qui est envoyé ne sont pas affectés. Les programmes plein écran comme vim et less, ainsi que la ligne en cours de saisie, ne sont pas touchés. Chaque type peut être désactivé ci-dessous ; un hôte peut définir son propre réglage, et une session peut être basculée depuis son menu.

• Par défaut: Activé.

Listes de fichiers (ls -l)

settings.smartSet.listing

Dans une liste de fichiers détaillée : les lettres de permissions, le propriétaire et le groupe, la taille et la date, et le nom selon sa nature (dossier, lien, programme), quand ls n’a pas coloré le nom lui-même.

• Par défaut: Activé.
• Exemple: ls -l | head

Diffs

settings.smartSet.diff

Les lignes ajoutées et supprimées et les en-têtes @@ d’un diff unifié affiché sans couleur. Une ligne commençant par + ou - n’est colorée qu’à l’intérieur d’un diff.

• Par défaut: Activé.
• Exemple: git diff –no-color

Journaux de serveur web

settings.smartSet.http

Dans les lignes de journal d’accès : la méthode de la requête, et le code d’état selon sa classe (2xx, 3xx, 4xx, 5xx).

• Par défaut: Activé.
• Exemple: “GET /health HTTP/1.1” 200

Liens et adresses e-mail

settings.smartSet.links

Les adresses web et autres commençant par un schéma (https://, ssh://, …) et les adresses e-mail, soulignées. Les liens restent cliquables comme avant.

• Par défaut: Activé.
• Exemple: https://example.com

Adresses IP et MAC

settings.smartSet.addresses

Les adresses IPv4, IPv6 et matérielles (MAC). Quatre nombres faisant partie d’une version (version 1.2.3.4, curl-8.5.0.1) ne sont pas pris pour une adresse.

• Par défaut: Activé.
• Exemple: 10.0.0.5, fe80::1, 00:15:5d:0a:1b:2c

Identifiants et hachages

settings.smartSet.ids

Les UUID, hachages de commit et de condensat et les nombres 0x, atténués pour que le texte autour se lise plus facilement.

• Par défaut: Activé.
• Exemple: 9fceb02d, 0x7ffe

Dates et heures

settings.smartSet.dates

Les dates et horodatages (ISO, syslog, listes de fichiers, journaux web), atténués. Une heure ne compte qu’avec ses secondes : 19:36:01, pas 19:36.

• Par défaut: Activé.
• Exemple: 2026-10-07 19:36:01, Apr 15 19:36

Niveaux de journal et résultats

settings.smartSet.levels

ERROR, WARN, INFO, OK, DEBUG et similaires, et les mots qui indiquent comment quelque chose s’est terminé : failed, denied, refused, deprecated, passed, active (running). Un mot de niveau en minuscules ne compte que là où il est marqué comme tel (error:, [warn], level=info), pas dans une phrase.

• Par défaut: Activé.
• Exemple: ERROR, [warn], Permission denied

Clés JSON et YAML

settings.smartSet.data

La clé au début d’une ligne « clé: valeur », les clés entre guillemets du JSON, et true, false et null sur une telle ligne.

• Par défaut: Activé.
• Exemple: “name”: “web-01”

Chemins de fichiers

settings.smartSet.paths

Les chemins absolus et les chemins sous ~/. Un chemin se terminant par / est coloré comme un dossier. Un seul composant ne compte que pour un dossier système (/etc, /var), si bien que « and/or » et « n/a » ne sont pas touchés.

• Par défaut: Activé.
• Exemple: /var/log/nginx/, ~/src/app.conf

Tailles et nombres

settings.smartSet.numbers

Les nombres avec une unité (12K, 3.4G, 85%, 340ms) et les nombres alignés en colonne. Un nombre dans une phrase, une version ou un nom n’est pas touché.

• Par défaut: Activé.
• Exemple: 3.4G, 85%

Texte entre guillemets

settings.smartSet.strings

Le texte entre guillemets doubles, apostrophes simples ou accents graves. Une apostrophe à l’intérieur d’un mot n’ouvre pas de citation.

• Par défaut: Activé.
• Exemple: echo “hello world”

Options de commande

settings.smartSet.options

Les options longues (–verbose), une option courte au début d’une ligne d’aide indentée, et le nom dans nom=valeur.

• Par défaut: Activé.
• Exemple: –verbose, TERM=xterm

Surligner les mots-clés

settings.keywordHighlight

Colore dans la sortie du terminal les correspondances de vos propres règles ci-dessous, chacune dans la couleur que vous lui avez donnée. Vos règles l’emportent sur la coloration intelligente et colorent aussi le texte qu’un programme a coloré lui-même. Comme la coloration intelligente, c’est purement visuel et cela ne s’applique qu’à l’écran normal, pas aux programmes plein écran comme vim. Les règles se synchronisent avec vos autres appareils ; elles se modifient sur ordinateur.

• Par défaut: Désactivé.

Expression régulière

settings.keywordPattern · Ordinateur uniquement

Le texte à colorer, sous forme d’expression régulière, sans tenir compte de la casse. Quand deux règles correspondent au même texte, celle placée plus haut dans la liste l’emporte. L’éditeur accepte jusqu’à 64 règles ; une règle dont le motif n’est pas une expression valide est ignorée.

• Exemple: error|failed, ou \bWARN(ING)?\b

Shell local

settings.localShellPath · Ordinateur uniquement

Le programme qu’exécute un terminal local (sur cet ordinateur, pas sur un serveur). Laissez vide pour la valeur par défaut du système : votre shell de connexion sous Linux et macOS, PowerShell sous Windows (PowerShell 7 s’il est installé, sinon Windows PowerShell). La liste contient les shells trouvés sur cet ordinateur (sous Windows : PowerShell, invite de commandes, Git Bash et chaque distribution WSL) ; « Personnalisé… » accepte tout autre programme par son chemin complet. « Nouveau terminal local dans », dans le menu + de la barre d’onglets, lance n’importe quel shell listé pour un onglet sans modifier ce paramètre. La saisie semi-automatique n’est pas proposée dans PowerShell ni l’invite de commandes, et un espace de travail restauré ne change pas de dossier dans un terminal local sous Windows.

• Par défaut: Langue du système.
• Exemple: /bin/zsh, ou C:\Program Files\PowerShell\7\pwsh.exe

Programme shell

settings.localShellCustom · Ordinateur uniquement

Le chemin complet du programme qu’exécutent les terminaux locaux, pour un shell que la liste ci-dessus n’affiche pas. « Parcourir… » choisit le fichier. Videz-le pour revenir à la valeur par défaut du système.

• Exemple: /usr/bin/fish, ou D:\tools\nu.exe

Option comme Meta

settings.optionAsMeta

Fait fonctionner la touche Option (Alt) comme la touche Meta qu’attendent les shells et éditeurs, pour qu’Option+B recule d’un mot au lieu de taper un caractère spécial. Sur mobile, cela s’applique à un clavier physique.

• Par défaut: Désactivé.

Image de fond

settings.terminalBackground · Ordinateur uniquement

Une image derrière le texte de chaque terminal. « Choisir une image… » accepte un fichier PNG, JPEG ou WebP de 8 Mo, 8 192 pixels par côté et 24 millions de pixels en tout au plus ; un PNG ou WebP animé bouge comme ailleurs. Sternway en garde une copie dans le profil de cet ordinateur, donc déplacer ou supprimer l’original ne change rien. Là où l’image rendrait le texte difficile à lire, la couleur de fond du terminal est posée dessus juste assez pour que chaque couleur lisible du thème reste à 4,5:1. Sur cet ordinateur seulement : elle n’est pas synchronisée, et une sauvegarde ne la contient que si « Inclure dans les sauvegardes » est activé.

• Par défaut: Aucune image.
• Attention: Un fichier est vérifié d’après son contenu, pas son nom : un SVG, un GIF ou tout ce qui n’est pas l’un des trois formats est refusé, de même qu’une image trop grande pour être dessinée.

Opacité de l’image

settings.terminal.backgroundOpacity · Ordinateur uniquement

À quel point l’image de fond se voit, de 5 à 100 pour cent par pas de 5. Là où cela rendrait le texte difficile à lire, l’image est encore assombrie, si bien que le texte reste toujours lisible. Conservé sur cet ordinateur.

• Par défaut: 30 %.

Flou de l’image

settings.terminal.backgroundBlur · Ordinateur uniquement

Rend l’image de fond floue, de 0 à 20 pixels, pour que ses détails ne concurrencent pas le texte. Conservé sur cet ordinateur.

• Par défaut: Pas de flou (0).

Inclure dans les sauvegardes

settings.terminal.backgroundInBackups · Ordinateur uniquement

Met l’image de fond, son opacité et son flou dans les sauvegardes chiffrées que vous exportez (Paramètres › Sauvegardes), si bien que restaurer l’une d’elles sur un autre ordinateur ramène l’image. Une sauvegarde de quelques coffres seulement, comme ceux d’une équipe, ne la contient jamais.

• Par défaut: Désactivé : l’image reste sur cet ordinateur.

Paramètres : Connexions et SSH

Où: Paramètres › Connexions et SSH ; Paramètres › Arrière-plan et keep-alive.

Délai de connexion

settings.ssh.connectTimeoutSec

Le délai d’attente de la réponse d’un serveur, puis de la négociation d’authentification, avant d’abandonner. Augmentez-le pour des liaisons lentes ou lointaines. De 1 à 300 secondes ; un hôte ou un groupe peut définir le sien.

• Par défaut: 15 secondes.

Reconnexion automatique

settings.ssh.autoReconnect

Quand une session tombe de façon inattendue, se reconnecter sans demander : 5 tentatives rapides, en attendant 1, 2, 4, 8 et 16 secondes, puis une tentative par minute tant que son onglet est ouvert, et aussitôt que le réseau change ou que l’appareil se réveille. Sur le téléphone, cela attend tant que l’app est en arrière-plan, sauf si Maintenir les sessions en arrière-plan est activé. Une redirection de ports en cours dont la connexion tombe réessaie aussi : jusqu’à 10 tentatives en 5 minutes environ, et aussitôt que le réseau de cet ordinateur ou de ce téléphone change. Un hôte ou un groupe peut définir son propre réglage.

• Par défaut: Activé.

Clés d’hôte inconnues

settings.ssh.hostKeyPolicy

Chaque serveur prouve son identité avec une clé d’hôte, que l’application mémorise (Hôtes connus). Ce réglage décide de ce qui se passe la première fois qu’un serveur est rencontré : « Demander » affiche son empreinte et vous laisse l’accepter ; « Strict » refuse tout serveur non encore connu. Un serveur dont la clé a changé est toujours bloqué avec un avertissement, quel que soit votre choix. Vous ne pouvez continuer qu’en choisissant Remplacer la clé.

• Par défaut: Demander.
• Attention: Avec « Demander », accepter une empreinte sans la vérifier est précisément ce qui permet d’intercepter une connexion. Comparez-la avec celle que vous fournit l’administrateur du serveur.

Transfert d’agent

settings.ssh.agentForwarding

Permet au serveur sur lequel vous êtes d’utiliser vos clés pour ouvrir une session sur un autre serveur, sans que les clés privées quittent cet appareil. C’est la valeur par défaut des hôtes qui ne définissent pas la leur. « Clé d’authentification » ne propose que la clé qui vous a authentifié ; « Toutes les clés » propose les clés de l’hôte et de ses hôtes de rebond. Ce transfert n’est demandé que dans les sessions de terminal, pas pour SFTP ni les redirections de port. « Clé d’authentification » ne propose rien si vous avez ouvert la session avec un mot de passe ou une clé de l’agent SSH de cet ordinateur. « Toutes les clés » exclut les clés de sécurité (matérielles) et les clés chiffrées dont la phrase secrète n’est ni enregistrée ni mémorisée ; il ne la demande pas.

• Par défaut: Désactivé.
• Attention: Tant que vous êtes connecté, toute personne ayant des droits d’administrateur sur le serveur peut ouvrir une session ailleurs en votre nom. Laissez cette option désactivée ici et activez-la par hôte pour les serveurs de confiance.

Utiliser l’agent SSH de cet ordinateur

settings.ssh.systemAgent · Ordinateur uniquement

Ouvre aussi la session avec les clés d’un agent SSH de cet ordinateur, pour chaque hôte, en plus de la clé ou du mot de passe que l’hôte a dans Sternway. Les clés restent dans l’agent : Sternway lui demande seulement de signer. L’agent se choisit sous « Agent SSH » : celui du système, 1Password, Bitwarden ou un socket que vous indiquez. Rien ne se passe si cet agent ne tourne pas. Ce réglage est propre à cet ordinateur et n’est pas synchronisé.

• Par défaut: Désactivé.
• Attention: Un serveur qui n’autorise que quelques tentatives d’authentification peut refuser la connexion quand l’agent détient beaucoup de clés : chaque clé proposée compte comme une tentative.
• En savoir plus: Lire la suite (en anglais)

Agent SSH

settings.ssh.agentSource · Ordinateur uniquement

L’agent avec lequel « Utiliser l’agent SSH de cet ordinateur » ouvre la session. « Agent du système (SSH_AUTH_SOCK) » est celui de votre terminal : sous Linux et macOS, l’agent désigné par SSH_AUTH_SOCK ; sous Windows, le service OpenSSH Authentication Agent, ou Pageant quand SSH_AUTH_SOCK désigne son canal nommé. « 1Password » et « Bitwarden » sont les agents de ces gestionnaires de mots de passe une fois activés dans leurs réglages : Sternway trouve leur socket tout seul. Sous Windows, les deux utilisent le canal nommé de l’agent OpenSSH, le même que l’agent du système. « Socket ou canal nommé personnalisé » utilise le chemin indiqué sous « Socket ou canal nommé de l’agent ». Chaque choix indique si son agent tourne ; « Tester » liste les clés qu’il détient.

• Par défaut: Agent du système (SSH_AUTH_SOCK).
• Attention: Un gestionnaire de mots de passe vous demande, dans sa propre fenêtre, d’approuver chaque connexion avec l’une de ses clés. La connexion attend votre réponse.
• En savoir plus: Lire la suite (en anglais)

Socket ou canal nommé de l’agent

settings.ssh.agentPath · Ordinateur uniquement

Le socket d’un autre agent SSH, pour « Socket ou canal nommé personnalisé » : un chemin complet comme /run/user/1000/gnupg/S.gpg-agent.ssh ou, sous Windows, un canal nommé comme \\.\pipe\openssh-ssh-agent. Seul un socket ou un canal nommé de cet ordinateur est utilisé, jamais une adresse réseau. Saisir un chemin ici choisit « Socket ou canal nommé personnalisé ». Laissé vide, ce choix utilise l’agent du système.

• Par défaut: Vide.
• En savoir plus: Lire la suite (en anglais)

Rester aligné sur ~/.ssh/config

settings.ssh.configLink · Ordinateur uniquement

Affiche tous les hôtes de votre fichier de configuration OpenSSH (et des fichiers qu’il inclut) dans un dossier « Config SSH », et le tient à jour : une modification du fichier apparaît en quelques secondes. Modifier l’un de ces hôtes dans Sternway réécrit la modification dans le fichier, ligne par ligne, en laissant intacts vos commentaires, l’ordre et les paramètres que Sternway n’utilise pas. ProxyCommand, ProxyJump, IdentityFile, IdentitiesOnly, User, Port, ForwardAgent, les redirections et ServerAliveInterval sont utilisés à la connexion ; les détails d’un hôte listent ce que le fichier indique d’autre et que Sternway n’utilise pas. Les hôtes des fichiers inclus sont affichés mais jamais modifiés. Le dossier reste sur cet ordinateur : il n’est pas synchronisé.

• Par défaut: Désactivé.
• Attention: Un ProxyCommand exécute un programme sur cet ordinateur à chaque connexion à cet hôte, exactement comme ssh. Les modifications sont écrites dans votre vrai ~/.ssh/config.

Afficher les hôtes qui répondent

settings.hosts.reachability

Un point à côté de chaque hôte de la liste indique si son port SSH accepte des connexions en ce moment : vert avec le temps mis, rouge s’il ne répond pas. L’app ne vérifie que les hôtes à l’écran, chacun environ une fois par minute, en ouvrant une connexion TCP vers le port SSH et en la fermant aussitôt : pas d’échange SSH, pas d’ouverture de session, ni mot de passe ni clé, elle ne déclenche donc jamais de demande à deux facteurs et ne compte jamais comme un échec d’ouverture de session. Un hôte derrière un hôte de rebond ou un proxy, ou qui demande du port knocking, apparaît comme inconnu : le vérifier voudrait dire ouvrir une session sur les rebonds ou frapper aux ports.

• Par défaut: Désactivé.
• Attention: Chaque vérification est une connexion que le serveur voit et peut journaliser. Beaucoup d’hôtes à l’écran, ou une liste ouverte pendant des heures, finissent par compter : une règle Fail2Ban ou de pare-feu stricte qui compte les connexions (et non les échecs d’ouverture de session) pourrait bloquer cet appareil.

Autoriser les anciens algorithmes

settings.ssh.legacyAlgorithms

Proposer aussi d’anciennes méthodes de chiffrement (échange de clés et signatures SHA-1, chiffrements CBC, clés d’hôte ssh-rsa) à tous les serveurs. Préférez l’activer pour le seul ancien hôte qui en a besoin, dans les paramètres avancés de cet hôte sur ordinateur.

• Par défaut: Désactivé.
• Attention: Ces méthodes sont faibles.

Échange de clés post-quantique

settings.ssh.pqc

Privilégier une méthode plus récente d’accord sur les clés de chiffrement de la session (la méthode appelée mlkem768x25519), qui résiste aussi à un futur ordinateur quantique, lorsque le serveur la prend en charge. Les méthodes habituelles restent proposées. Ne la désactivez que si des serveurs se comportent mal avec elle.

• Par défaut: Activé.

Intervalle keepalive

settings.ssh.keepaliveIntervalSec

Un keep-alive est un minuscule message « tu es là ? » envoyé quand une connexion est silencieuse, pour que les routeurs ne la coupent pas et qu’une liaison morte soit détectée. Ceci est l’intervalle entre deux messages, de 0 à 3600 secondes. S’applique à partir de la connexion suivante ; un hôte ou un groupe peut définir le sien.

• Par défaut: 30 secondes.
• Attention: Désactivé, une connexion morte silencieusement n’est remarquée que lorsque vous tapez.

Keepalives manqués autorisés

settings.ssh.keepaliveCountMax

Nombre de keep-alives consécutifs pouvant rester sans réponse avant que la connexion soit déclarée perdue et fermée (la reconnexion automatique prend alors le relais, si elle est activée). Avec les valeurs par défaut, cela fait environ une minute et demie. De 1 à 100.

• Par défaut: 3.

Maintenir les sessions en arrière-plan

settings.background.keepAlive · Téléphone uniquement

Maintient vos connexions actives après avoir quitté l’application, en exécutant un service Android avec une notification qui comporte aussi des boutons de déconnexion. Sur iOS, le système n’accorde qu’un court délai de grâce.

• Par défaut: Activé.
• Attention: Désactivé, le système peut fermer vos connexions peu après que vous avez changé d’application.

Afficher l’écran de connexion

settings.terminal.connectScreen

Pendant la connexion d’une session, un écran à sa place montre le chemin de cet appareil jusqu’à l’hôte (à travers chaque hôte de rebond ou proxy), l’étape en cours, et tout ce qu’elle doit demander : une clé d’hôte inconnue, un mot de passe, une phrase secrète, un code. « Toujours » l’affiche pour chaque connexion, et sa durée pour une connexion rapide dépend du réglage « Animation de connexion » ci-dessous. « Seulement si cela prend plus d’un instant » ne l’affiche pas pour une connexion rapide, mais l’affiche aussitôt en cas de question ou d’échec. « Jamais » revient au petit texte d’état dans l’en-tête de la session, et les questions sont posées dans des boîtes de dialogue.

• Par défaut: Toujours.

Animation de connexion

settings.terminal.connectPace

Comment l’écran de connexion montre le chemin vers un hôte. Une connexion sur un réseau local s’établit en une fraction de seconde, trop vite pour être vue : l’écran parcourt donc le chemin à son propre rythme, de cet appareil à l’hôte en passant par chaque hôte de rebond, chaque vérification à son tour, en marquant une courte pause quand chacune est cochée dans la liste, et environ une seconde à chaque hôte de rebond, où la liste montre cette machine terminée et la suivante qui démarre avant de continuer ; il affiche ensuite l’état final et passe la main au terminal. « Complète » dure environ 5 secondes pour une connexion directe, environ 8 secondes via un hôte de rebond et environ 11 via deux, assez pour lire à la fois l’image et la liste ; une longue chaîne d’hôtes de rebond ne dépasse jamais 12 secondes. « Rapide » dure environ 3 secondes pour une connexion directe et environ 4,5 secondes via un hôte de rebond, avec une demi-seconde à chaque hôte de rebond, jamais plus de 8. « Désactivée » n’affiche l’écran que pendant l’établissement réel de la connexion. La connexion elle-même n’est jamais ralentie : la session est prête en dessous aussi tôt qu’elle le serait de toute façon, ce que vous tapez entre-temps lui parvient, et une touche, un clic ou un toucher met fin à l’animation dès que la session est prête. Une reconnexion n’est jamais plus lente que Rapide, un terminal local saute l’écran, et si la réduction des animations est activée dans le système, rien ne bouge : chaque étape est simplement affichée un instant.

• Par défaut: Complète.

Écho local sur les liaisons lentes

settings.terminal.localEcho

Affiche aussitôt ce que vous tapez, souligné, au lieu d’attendre que l’hôte le renvoie, comme le fait Mosh ; l’écho de l’hôte prend ensuite sa place. « Quand la liaison est lente » commence dès que la frappe met plus de 100 ms à revenir de cet hôte, mesuré pendant que vous tapez ; « Toujours » dès la première touche. Seule la frappe simple en fin de ligne est affichée d’avance, touche par touche et seulement une fois que l’hôte a renvoyé une touche tapée sur cette ligne : une touche de contrôle, une flèche, Retour arrière ou un collage attendent l’hôte, tout comme tout ce qui se passe dans un programme plein écran tel qu’un éditeur.

• Par défaut: Désactivé.
• Attention: Jamais à une demande de mot de passe ou de phrase secrète, et jamais pour ce qui est tapé avant que l’hôte ne renvoie quoi que ce soit sur la ligne : la frappe anticipée devant une demande sans écho n’est pas affichée. Une supposition que l’hôte n’a pas renvoyée en une seconde environ (ou trois temps d’écho sur une liaison lente) est retirée et plus rien n’est supposé avant que le programme écrive une nouvelle ligne. Quand l’hôte affiche autre chose (un shell qui complète ou colore la ligne), les suppositions sont retirées aussitôt.

Texte prédictif et saisie gestuelle

settings.terminal.predictiveText · Téléphone uniquement

Permet au clavier virtuel de traiter le terminal comme un champ de texte ordinaire : il suggère des mots, les corrige et accepte la saisie gestuelle. Chaque lettre est toujours envoyée dès qu’elle apparaît, et une correction arrive sous forme d’effacements suivis du mot corrigé. Désactivé, « Mode clavier » décide de ce qui est demandé au clavier, et dans son mode « Texte brut », une correction faite d’office par le clavier n’est pas appliquée. Une demande de mot de passe sur l’hôte transforme le champ en champ de type mot de passe, que cette option soit activée ou non.

• Par défaut: Désactivé.
• Attention: Activé, une correction automatique réécrit ce que vous avez tapé à l’invite, et un clavier peut retarder une lettre le temps de choisir un mot.

Mode clavier

settings.terminal.keyboardMode · Téléphone uniquement

Le type de champ que le terminal déclare au clavier virtuel, quand « Texte prédictif et saisie gestuelle » est désactivé. Les claviers en déduisent ce qu’ils proposent. « Texte brut (recommandé) » déclare du texte ordinaire avec les suggestions désactivées : le clavier garde ses emoji, son presse-papiers, sa barre de suggestions s’il en a une, et la saisie gestuelle. Le terminal se prémunit contre ce que cela pourrait coûter. Quand l’hôte demande un mot de passe ou une phrase secrète, le champ passe de lui-même en mode Strict, et une ligne au-dessus des touches indique « Saisie de mot de passe : suggestions désactivées » ; il revient quand la demande est satisfaite, annulée ou disparue. Il est demandé au clavier de ne pas mettre de majuscules et de ne pas ouvrir d’éditeur plein écran ; pendant une demande de mot de passe, il lui est aussi demandé de ne pas apprendre ce qui est tapé. Et une commande arrive telle qu’elle a été tapée : un mot que le clavier corrige de lui-même quand vous tapez une espace ou une ponctuation n’est pas modifié sur la ligne de commande, deux espaces restent deux espaces, et seule une suggestion que vous touchez remplace le mot avant le curseur. « Terminal (comme Termux) » ne déclare aucun type de champ, comme Termux par défaut : frappes de touches uniquement, rien n’est suggéré ni corrigé. « Strict » déclare un champ de type mot de passe : le clavier envoie chaque touche immédiatement, y masque ses emoji et suggestions et n’apprend pas ce qui est tapé. Dans tous les modes, la rangée de touches, Ctrl et Alt, Retour arrière, Enter et la touche emoji fonctionnent de la même façon, et la saisie est envoyée en UTF-8. Le changement s’applique immédiatement, y compris aux sessions ouvertes ; « Clavier » dans les Outils du terminal d’une session modifie ce même réglage sans quitter la session. Android uniquement.

• Par défaut: Texte brut (recommandé). Une installation qui n’avait jamais modifié ce réglage passe de Strict à Texte brut avec la mise à jour ; un mode choisi est conservé.
• Attention: Une demande de mot de passe est reconnue à ses mots (« password », « passphrase », « PIN », « passcode » devant un deux-points en fin de ligne). Un programme qui demande un secret avec d’autres mots n’est pas reconnu : passez d’abord en Strict, ou utilisez Rédiger avec « Masquer ma saisie ». Les claviers diffèrent ; si la saisie se passe mal dans un mode, essayez-en un autre.

Secouer

settings.terminal.shakeAction · Téléphone uniquement

Ce qu’une secousse franche du téléphone envoie au terminal affiché, comme les boutons de volume qui envoient Haut et Bas. « Flèche haut » rappelle la commande précédente, « Tab » complète, « Esc » et « Ctrl+C » sont les touches de ce nom. Le capteur de mouvement n’est lu que lorsqu’un terminal est ouvert et que ce réglage n’est pas sur Désactivé, et une seule secousse par seconde au plus est prise en compte. Android uniquement.

• Par défaut: Désactivé.
• Attention: Une secousse peut aussi être accidentelle (en marchant, sur une route cahoteuse). « Ctrl+C » arrête ce qui est en cours.

Déconnecter après avoir quitté l’application

settings.background.disconnectAfterMin · Téléphone uniquement

Ferme toutes les sessions, explorateurs de fichiers et redirections de port une fois l’application restée en arrière-plan pendant cette durée. Utile pour qu’une session oubliée ne reste pas ouverte toute la journée. De 0 à 1440 minutes ; 0 ne déconnecte jamais.

• Par défaut: Jamais.
• Attention: Tout ce qui tourne encore dans ces sessions, ainsi que le travail non enregistré, est interrompu.

Garder un verrou de veille pendant les sessions

settings.background.wakeLock · Téléphone uniquement

Empêche le processeur du téléphone de se mettre en veille tant que des connexions sont ouvertes, pour qu’elles ne soient pas figées écran éteint. Cela consomme de la batterie.

• Par défaut: Activé.

Garder un verrou Wi-Fi pendant les sessions

settings.background.wifiLock · Téléphone uniquement

Empêche le téléphone de mettre le Wi-Fi en veille tant que des connexions sont ouvertes. Cela consomme de la batterie.

• Par défaut: Activé.

Paramètres : liens

Où: Paramètres › Connexions et SSH.

Ouvrir les liens ssh:// avec Sternway

settings.links.handleSsh

Fait de cette application celle que votre système ouvre quand vous cliquez sur un lien ssh:// dans un navigateur, un wiki ou une messagerie. Un lien ne se connecte jamais de lui-même : l’application affiche l’hôte, l’utilisateur et le port qu’il indique et attend que vous choisissiez Connecter. Un mot de passe dans un lien n’est jamais utilisé, et rien dans un lien n’est exécuté. Tant que cette option est désactivée, l’application n’est pas enregistrée et ignore tout lien avec lequel elle est lancée.

• Par défaut: Désactivé.
• Attention: N’importe qui peut placer un lien ssh:// sur une page. Lisez l’hôte dans la confirmation avant de vous connecter : un lien peut désigner un serveur qui ressemble seulement au vôtre.

Paramètres : SFTP

Où: Paramètres › SFTP.

Afficher les fichiers cachés

settings.sftp.showHidden

Affiche les fichiers dont le nom commence par un point (.bashrc, .ssh) dans un nouveau volet de fichiers. Le menu de chaque volet permet de basculer ce réglage pour ce volet.

• Par défaut: Désactivé.

Si un fichier existe déjà

settings.sftp.conflictDefault

Ce que fait un transfert quand la destination contient déjà un fichier de ce nom : demander à chaque fois, le remplacer, l’ignorer, ou conserver les deux (le nouveau reçoit un numéro).

• Par défaut: Demander.
• Attention: « Remplacer » écrase les fichiers existants sans demander.

Vérifier les transferts repris

settings.sftp.verifyResumed

Quand un transfert reprend après une pause, une nouvelle tentative ou une perte de connexion, le fichier terminé est comparé à l’original avant de recevoir son nom : un SHA-256 des deux copies. Cet appareil calcule le sien ; il est demandé à l’hôte d’exécuter « sha256sum » sur sa copie, et rien d’autre. Si l’hôte n’a pas cette commande ou n’autorise pas de second canal, et quand cette option est désactivée, seule la taille est comparée ; le transfert indique alors « vérifié par la taille ».

• Par défaut: Activé.
• Attention: Une somme de contrôle relit tout le fichier des deux côtés : un très gros fichier met donc plus de temps à se terminer. Un transfert jamais interrompu n’est pas vérifié ainsi, sauf une copie directe d’un hôte à un autre (deux volets sur deux hôtes), dont chaque fichier est vérifié par SHA-256 si les deux hôtes ont « sha256sum », sinon par la taille, quel que soit ce réglage.

Abandonner les transferts inachevés après

settings.sftp.unfinishedDays

Un transfert qui échoue, ou qui est en pause ou encore en cours de copie à la fermeture de l’application, laisse le fichier qu’il écrivait à côté de sa destination sous le nom « nom.sternwaypart », et apparaît sous Inachevés dans Transferts avec Reprendre et Abandonner. Après ce nombre de jours, le fichier partiel est supprimé et l’entrée disparaît. Un fichier partiel sur un hôte est supprimé la prochaine fois que les fichiers de cet hôte sont ouverts ; celui d’un hôte utilisé seulement en connexion rapide n’est pas suivi et doit être supprimé manuellement.

• Par défaut: 7 jours. De 0 à 365.
• Exemple: 0 (affiché « Jamais ») conserve les transferts inachevés jusqu’à ce que vous les abandonniez.
• Attention: Abandonner supprime ce qui a déjà été copié ; le transfert repart alors du début.

Placer les fichiers supprimés dans la corbeille

settings.sftp.trash · Ordinateur uniquement

Supprimer des fichiers ou dossiers sur un hôte les déplace dans un dossier nommé .sternway-trash de votre dossier personnel sur cet hôte, où la Corbeille (dans le menu du volet) les liste avec Restaurer et Supprimer définitivement. Le déplacement est un renommage sur l’hôte : rien n’est copié, un gros dossier part donc instantanément. Les fichiers de cet ordinateur ne sont pas concernés.

• Par défaut: Activé.
• Attention: Les éléments de la corbeille occupent toujours de l’espace sur l’hôte jusqu’à ce que vous la vidiez. Un élément situé sur un autre disque que votre dossier personnel ne peut pas y être déplacé ; il vous est alors demandé s’il faut le supprimer définitivement. Désactivé : la suppression est définitive, sans retour possible.

Dossier de téléchargement

settings.sftp.downloadDir · Ordinateur uniquement

L’emplacement où Télécharger place les fichiers sur cet ordinateur, et où s’ouvre le volet local. Réglage propre à chaque ordinateur. Sans dossier défini, Télécharger en demande un à chaque fois, en partant de votre dossier Téléchargements, et le volet local s’ouvre dans votre dossier personnel.

• Par défaut: Aucun : demander à chaque fois.

Ouvrir avec

settings.sftp.openWith · Ordinateur uniquement

Le programme que lance « Ouvrir avec » pour une extension de fichier. Saisissez l’extension (avec ou sans le point ; la casse n’a pas d’importance) et le programme : son chemin complet ou une commande de votre PATH. Le programme reçoit le fichier téléchargé comme seul argument. Sous Windows, ce doit être un programme (.exe), pas un lanceur .cmd ou .bat.

• Par défaut: Aucun programme défini.
• Exemple: .log → /usr/bin/code, ou .log → C:\Windows\System32\notepad.exe

Paramètres : Sécurité

Où: Paramètres › Sécurité.

Verrouillage automatique

settings.security.autoLockMinutes

Verrouille l’application après cette durée d’inactivité, si un verrouillage est défini. Les sessions continuent de tourner derrière le verrouillage. De 0 à 1440 minutes ; 0 désactive le verrouillage automatique.

• Par défaut: 5 minutes.

Verrouiller à la mise en veille du système

settings.security.lockOnSleep

Sur ordinateur : verrouiller l’application quand l’ordinateur se met en veille ou que son écran est verrouillé. Sur mobile : verrouiller dès que vous quittez l’application. N’a d’effet que si un verrouillage de l’application est défini.

• Par défaut: Activé.

Vider le presse-papiers après la copie d’un secret

settings.security.clipboardClearSec

Quand vous copiez un mot de passe ou un autre secret depuis l’application, le presse-papiers est vidé après cette durée, s’il contient encore ce secret. De 0 à 3600 secondes ; 0 ne le vide jamais.

• Par défaut: 60 secondes.
• Attention: « Jamais » laisse les secrets copiés dans le presse-papiers, où d’autres applications et gestionnaires de presse-papiers peuvent les lire. Une clé privée copiée est de toute façon effacée sous 60 secondes sur ordinateur.

Synchroniser les clés et identités

settings.sync.syncCredentials

Indique si les clés privées, identités, certificats et mots de passe enregistrés de votre coffre personnel sont transmis chiffrés à vos autres appareils via votre serveur. Les coffres d’équipe se synchronisent toujours. Ce réglage est propre à chaque appareil.

• Par défaut: Activé.
• Attention: Désactivé, ces clés et mots de passe n’existent que sur cet appareil : perdez l’appareil et ils disparaissent.

Vérifier les fuites pour les nouveaux mots de passe

settings.security.leakedPasswordCheck

Quand vous définissez le mot de passe d’un compte, vérifie s’il figure dans des fuites de données connues. Seuls les 5 premiers caractères d’une forme brouillée du mot de passe (son hachage) sont envoyés à api.pwnedpasswords.com, qui répond avec tous les hachages divulgués commençant ainsi ; la comparaison se fait ici, et le mot de passe lui-même ne quitte jamais l’appareil. Une correspondance donne seulement un avertissement.

• Par défaut: Désactivé.

Bloquer les captures d’écran

settings.security.blockScreenshots · Téléphone uniquement

Sur Android, bloque les captures et enregistrements d’écran dans toute l’application et masque son aperçu dans le sélecteur d’applications. Une clé privée en cours d’importation, le kit de récupération et l’écran de verrouillage sont protégés même si cette option est désactivée.

• Par défaut: Désactivé.

Paramètres : IA

Où: Paramètres › IA.

Assistant IA

settings.aiEnabled

Affiche les commandes d’IA : « Écrire une commande » et « Expliquer ou demander » dans le terminal, et « Générer » dans l’éditeur d’extraits. Rien n’est envoyé tant que vous n’en utilisez pas une, et un fournisseur doit être configuré ci-dessous.

• Par défaut: Désactivé.

Toujours afficher un aperçu avant l’envoi

settings.ai.previewBeforeSend

Avant chaque requête d’IA, montre exactement ce qui sera envoyé : votre demande et le texte du terminal sélectionné, s’il y en a, avec les secrets déjà remplacés par [REDACTED]. Avec eux partent les instructions fixes de Sternway pour la requête et, si la requête les porte, le système et le shell de l’hôte. Rien ne part avant que vous appuyiez sur Envoyer. Les secrets sont masqués sur cet appareil que ce réglage soit activé ou non : mots de passe, clés et jetons d’après leur forme, et les mots de passe, clés privées, phrases secrètes et clés API enregistrés dans vos coffres d’après leur valeur exacte.

• Par défaut: Activé.
• Attention: Désactivé, une requête part dès que vous demandez. Le masquage ne peut pas connaître un secret qu’il n’a jamais vu : un secret qui n’est enregistré dans aucun coffre et n’en a pas l’air est envoyé tel qu’il a été saisi.

Utiliser un fournisseur d’IA

settings.ai.enable

Connecte l’assistant à un modèle de votre choix, avec votre propre clé d’API ou votre propre serveur. Réglage propre à chaque appareil.

• Par défaut: Désactivé.
• Attention: Le désactiver oublie l’adresse, le modèle et la clé d’API enregistrée.

Fournisseur

settings.ai.kind

Le service qui répond. « Anthropic » et « OpenAI » utilisent les API de ces entreprises ; « OpenAI » convient aussi à la plupart des serveurs locaux et auto-hébergés (Ollama, LM Studio, OpenRouter). « Sternway » utilise l’IA du serveur auquel vous êtes connecté et ne nécessite aucune clé.

• Par défaut: Anthropic.

URL de base

settings.ai.baseUrl

L’adresse de l’API du fournisseur. L’application cherche sous /v1, sauf si l’adresse contient déjà une version dans son chemin, comme /v1 ou /v1beta. Un point de terminaison complet collé (se terminant par /chat/completions, /messages ou /models) est ramené à sa base. 0.0.0.0 est contacté en tant que 127.0.0.1.

• Par défaut: https://api.anthropic.com ou https://api.openai.com, selon le fournisseur.
• Exemple: https://api.openai.com, ou http://localhost:1234 pour un modèle sur cet ordinateur
• Attention: Le simple http:// n’est accepté que pour cet appareil et les réseaux privés ; votre clé et vos requêtes y circulent sans chiffrement.

Modèle

settings.ai.model

Le nom exact du modèle à interroger, tel que le fournisseur le liste. « Tester la connexion » affiche les noms proposés par le fournisseur.

• Exemple: claude-sonnet-5-5, ou le nom listé par votre serveur local

Clé API

settings.ai.apiKey

Le secret que votre fournisseur vous a donné pour facturer et autoriser les requêtes. Un serveur local n’en demande généralement pas.

• Attention: Stockée sur cet appareil uniquement, non synchronisée. Sur ordinateur, elle n’est plus jamais affichée une fois enregistrée ; saisissez une nouvelle clé pour la remplacer.

Paramètres : Mises à jour, Journaux, Profils

Où: Paramètres › Mises à jour, Journaux, Profils (ordinateur).

Autoriser la recherche de mises à jour

settings.updater.enabled · Ordinateur uniquement

Permet au bouton « Rechercher des mises à jour » ci-dessous d’interroger votre flux de mises à jour sur l’existence d’une version plus récente. L’application ne vérifie jamais d’elle-même, ni au démarrage ni ensuite : une vérification n’a lieu que lorsque vous appuyez sur le bouton. Rien n’est jamais téléchargé ni installé ; une version plus récente est affichée avec un lien vers sa page de téléchargement.

• Par défaut: Désactivé.

URL du flux de mises à jour

settings.updater.feedUrl · Ordinateur uniquement

L’adresse https du flux de mises à jour signé publié par la personne qui compile votre copie de Sternway. La signature du flux est vérifiée avec une clé intégrée à l’application.

• Par défaut: Aucune.
• Exemple: https://updates.example.com/sternway.json

Journaliser les sessions dans …

settings.logging.vault · Ordinateur uniquement

Enregistre ce qu’affichent les sessions des hôtes de ce coffre, pour le lire plus tard dans Journaux. Un hôte peut s’en exclure, et les sessions Mosh ne sont jamais enregistrées. Pour un coffre partagé, le réglage s’applique à tous ceux qui l’utilisent. Les journaux restent sur l’appareil qui les a enregistrés, sauf si « Synchroniser les journaux de session » est activé.

• Attention: Le désactiver supprime tous les journaux déjà stockés pour le coffre, sur cet appareil et sur le serveur. Un journal contient tout ce qui s’est affiché à l’écran, y compris les secrets affichés par une commande.

Synchroniser les journaux de session

settings.sync.syncLogs

Indique si les journaux de session enregistrés par cet appareil le quittent. Désactivé, un journal et son contenu restent uniquement sur cet appareil. Activé, tant que vous êtes connecté, les journaux de vos coffres synchronisés sont envoyés à votre serveur chiffrés avec la clé du coffre, et peuvent être lus sur vos autres appareils et, pour un coffre d’équipe, par ses membres. Ce réglage est propre à chaque appareil. Les journaux qu’un autre appareil a choisi de synchroniser sont reçus ici dans tous les cas.

• Par défaut: Désactivé.
• Attention: Un journal contient tout ce qui s’est affiché à l’écran, y compris les secrets affichés par une commande. Désactiver cette option plus tard arrête l’envoi des nouveaux journaux ; ceux déjà sur le serveur y restent jusqu’à ce que vous les supprimiez.

Montrer mon activité à mon équipe

settings.team.sharePresence

Tant que cette option est activée et que vous êtes connecté à un hôte d’un coffre d’équipe, les autres membres de ce coffre voient que vous y êtes (vos initiales sur l’hôte). Seuls l’identifiant de l’hôte et celui du coffre sont envoyés, via votre serveur de synchronisation, et uniquement aux membres qui peuvent ouvrir ce coffre ; rien sur ce que vous tapez ou voyez. L’information est oubliée moins d’une minute après votre déconnexion. Les hôtes de votre coffre personnel ne sont jamais signalés. Vous voyez toujours l’activité de vos coéquipiers quand cette option est désactivée.

• Par défaut: Activé.
• Attention: Désactivé : rien sur votre activité n’est envoyé. Ce qui était déjà affiché est retiré immédiatement.

Nom du nouveau profil

settings.profileName · Ordinateur uniquement

Un profil est une copie entièrement séparée des données de l’application : ses propres hôtes, clés, compte et paramètres. Utilisez-en un pour le travail et un pour la maison. Jusqu’à 64 caractères, 32 profils au maximum.

• Exemple: Travail

Paramètres : Notifications

Où: Paramètres › Notifications.

Notifications

settings.notifications.enabled

L’interrupteur général. Activé, Sternway liste ce qui s’est passé sous la cloche et transmet à votre système, sous forme de notifications, les types activés ci-dessous. Désactivé, rien n’est listé ni affiché, à une exception près : une clé d’hôte modifiée ou une connexion refusée pour des raisons de sécurité est toujours listée sous la cloche.

• Par défaut: Activé.

Aussi quand Sternway est au premier plan

settings.notifications.whenInFront

Normalement, une notification système ne s’affiche que lorsque vous ne regardez pas : l’application est derrière une autre fenêtre (sur un téléphone : pas à l’écran), ou la session concernée est dans un autre onglet. Activez cette option pour recevoir la notification système à chaque fois.

• Par défaut: Désactivé.

Émettre un son

settings.notifications.sound · Ordinateur uniquement

Indique si une notification système joue le son de notification de votre système. Votre système peut tout de même le couper (Ne pas déranger, Assistant de concentration).

• Par défaut: Activé.

Masquer les détails dans les notifications système

settings.notifications.hideDetails

Une notification système indique alors seulement le type d’événement (« Activité du terminal », « Une session demande votre attention ») : pas de nom d’hôte, pas de nom de fichier et pas de texte d’un terminal. La liste sous la cloche conserve les détails. Sur l’écran de verrouillage Android, le texte d’une notification est masqué dans tous les cas ; avec cette option activée, le nom d’hôte y est aussi masqué.

• Par défaut: Désactivé : le nom d’hôte s’affiche, y compris sur l’écran de verrouillage.
• Attention: Une ligne correspondante ou un message d’un programme distant peut afficher tout ce que contient cette ligne. Les mots de passe, clés et jetons que Sternway reconnaît sont remplacés, mais il ne peut pas connaître tous les secrets.

Heures calmes

settings.notifications.quietHours

Une plage horaire pendant laquelle aucune notification système n’est affichée ni sonore. Ce qui se passe entre-temps est toujours listé sous la cloche.

• Par défaut: Désactivé.
• Exemple: De 22:00 à 07:00.

Calme à partir de

settings.notifications.quietFrom

Le début des heures silencieuses, dans votre heure locale. Un début plus tardif que la fin signifie que la plage passe minuit.

• Par défaut: 22:00.

Calme jusqu’à

settings.notifications.quietUntil

La fin des heures silencieuses, dans votre heure locale. La même heure que le début signifie aucune heure silencieuse.

• Par défaut: 07:00.

Commande longue

settings.notifications.longCommandSec

« M’avertir quand cette commande se termine » ne se déclenche que pour une commande qui a duré au moins ce temps, pour que chaque ls ne notifie pas. De 1 à 3600 secondes.

• Par défaut: 10 secondes.

Silencieuse depuis

settings.notifications.quietMin

« M’avertir quand elle devient silencieuse » se déclenche quand une session n’a rien affiché pendant cette durée : une compilation terminée sans invite, un téléchargement bloqué, un programme en attente. Une notification par période de silence ; une nouvelle sortie relance le décompte. De 1 à 240 minutes.

• Par défaut: 5 minutes.

Une session a été déconnectée

settings.notifications.sessionDisconnected

Une session connectée a perdu sa connexion sans que vous la fermiez. Signalé une fois, y compris pendant que Sternway tente de se reconnecter ; la notification propose Reconnecter.

• Par défaut: Activé.

Une session s’est reconnectée

settings.notifications.sessionReconnected

La reconnexion automatique a rétabli une session tombée. Désactivé par défaut, car la session refonctionne simplement.

• Par défaut: Désactivé.

Échec de la reconnexion

settings.notifications.sessionReconnectFailed

Sternway a cessé de tenter de reconnecter une session tombée, car une tentative a besoin de vous : la clé d’hôte a été refusée, ou l’ouverture de session a été annulée ou attend une réponse. La notification propose Reconnecter.

• Par défaut: Activé.

Un transfert est terminé

settings.notifications.transferFinished

Un transfert de fichiers s’est terminé pendant que vous ne regardiez pas (Sternway n’était pas au premier plan) ou après avoir duré plus de 10 secondes. Plusieurs transferts terminés ensemble donnent une seule notification.

• Par défaut: Activé.

Un transfert a échoué

settings.notifications.transferFailed

Un transfert de fichiers s’est arrêté sur une erreur. La notification en indique la raison et propose Réessayer.

• Par défaut: Activé.

Un transfert attend une réponse

settings.notifications.transferNeedsAnswer

Un transfert attend que vous indiquiez quoi faire d’un fichier qui existe déjà. Elle reste jusqu’à votre réponse.

• Par défaut: Activé.

Une règle de redirection de port s’est arrêtée

settings.notifications.forwardStopped

Une règle en cours d’exécution s’est arrêtée d’elle-même (sa connexion a été perdue), ou une règle n’a pas pu démarrer. Une règle que vous arrêtez vous-même ne signale rien.

• Par défaut: Activé.

Une règle de redirection de port a démarré d’elle-même

settings.notifications.forwardAutoStarted

Une règle configurée pour démarrer avec l’application, ou avec la connexion de son hôte, a été démarrée.

• Par défaut: Désactivé.

La synchronisation requiert votre attention

settings.notifications.syncFailed

La synchronisation s’est arrêtée d’une manière qui ne se résout pas d’elle-même : le mot de passe a été modifié ailleurs, cet appareil a été retiré du compte, ou le serveur refuse. Être hors ligne n’en fait pas partie ; cela s’affiche dans la barre latérale.

• Par défaut: Activé, une fois connecté.

Un nouvel appareil s’est connecté

settings.notifications.newDevice

Un appareil qui n’était pas sur votre compte y figure désormais. Sternway le découvre lorsque cet appareil vérifie le compte (après une synchronisation, et toutes les 15 minutes pendant son exécution), pas au moment où cela se produit.

• Par défaut: Activé, une fois connecté.
• Attention: Si ce n’était pas vous, révoquez l’appareil dans Compte › Appareils et changez votre mot de passe.

Ajouté à une équipe

settings.notifications.teamJoined

Votre compte fait partie d’une équipe dont il n’était pas membre avant. Une invitation arrive elle-même par e-mail et ne peut pas être affichée ici : l’application n’apprend l’existence d’une équipe qu’une fois que vous en êtes membre.

• Par défaut: Activé, une fois connecté.

Accès à l’équipe modifié

settings.notifications.teamAccessChanged

Votre rôle dans une équipe a changé, on vous en a proposé la propriété, ou votre accès à l’un de ses coffres a été accordé, modifié ou retiré.

• Par défaut: Activé, une fois connecté.

Retiré d’une équipe

settings.notifications.teamRemoved

Votre compte ne fait plus partie d’une équipe ; ses coffres ont disparu de cet appareil.

• Par défaut: Activé, une fois connecté.

Une session partagée attend une réponse

settings.notifications.shareRequest

Quelqu’un attend d’être admis dans une session que vous partagez, ou demande à y saisir du texte.

• Par défaut: Activé.

Une mise à jour est disponible

settings.notifications.appUpdate · Ordinateur uniquement

Une version plus récente de Sternway a été trouvée. Uniquement si la recherche de mises à jour est activée dans Paramètres › Mises à jour ; Sternway vérifie alors une fois par jour.

• Par défaut: Activé.

Transferts inachevés au démarrage

settings.notifications.unfinishedTransfers

Quand l’application s’ouvre et trouve des transferts laissés inachevés lors d’une exécution précédente, elle le signale une fois, pour qu’ils puissent être repris ou abandonnés.

• Par défaut: Activé.

Verrouillé pendant des transferts

settings.notifications.lockedWithTransfers

L’application s’est verrouillée alors que des transferts de fichiers sont encore en cours. Ils continuent derrière le verrouillage.

• Par défaut: Désactivé.

Nom de la règle

settings.notifications.ruleName

Le titre de la notification quand la règle correspond (« Erreurs détectées sur web-01 »). Jusqu’à 60 caractères.

• Exemple: Erreurs

La ligne correspond à

settings.notifications.rulePattern

Une expression régulière. Une session pour laquelle « quand une ligne correspond » est activé notifie quand une ligne de sa sortie y correspond. La notification n’affiche que la ligne correspondante, tronquée, avec les mots de passe, clés et jetons que Sternway reconnaît remplacés. Un motif qui pourrait durer indéfiniment sur certaines lignes (une répétition dans une répétition, comme (a+)+) est refusé, seuls les 1 000 premiers caractères d’une ligne sont examinés, et une règle qui s’avère lente est désactivée jusqu’à ce que vous la modifiiez.

• Exemple: error|failed (l’un ou l’autre mot), ou ^Deploy finished (une ligne qui commence ainsi).
• Attention: Les lignes à l’intérieur d’un programme plein écran (un éditeur, un pager) ne sont pas examinées.

Respecter la casse

settings.notifications.ruleCase

Activé, le motif ne correspond qu’au texte ayant les mêmes majuscules et minuscules. Désactivé, ERROR, Error et error sont équivalents.

• Par défaut: Désactivé.

Paramètres : Jetons CLI

Où: Paramètres › Jetons CLI (ordinateur).

Nom du jeton

settings.cli.tokenName · Ordinateur uniquement

À quoi sert le jeton, pour savoir lequel révoquer plus tard : le script, la machine ou la tâche qui l’utilise. Jusqu’à 64 caractères. Le nom ne fait jamais partie du jeton lui-même.

• Exemple: Script de sauvegarde sur build-01

Lister les hôtes

settings.cli.scope.hosts · Ordinateur uniquement

Permet à sternway-cli hosts de lister vos hôtes enregistrés : le nom, l’adresse et l’identifiant de chacun. Rien d’autre sur un hôte n’est donné : ni nom d’utilisateur, ni mot de passe, ni clé, ni note.

Ouvrir des terminaux

settings.cli.scope.connect · Ordinateur uniquement

Permet à sternway-cli connect <host> d’ouvrir dans cette app un terminal vers un hôte enregistré, comme si vous aviez double-cliqué dessus. Le terminal s’ouvre dans l’app, devant vous : la commande ne peut ni y taper ni le lire.

Exécuter des snippets

settings.cli.scope.run · Ordinateur uniquement

Permet à sternway-cli run <snippet> --hosts … d’exécuter un de vos snippets enregistrés sur les hôtes nommés et d’afficher ce que chaque hôte a affiché, comme Snippets › Exécuter sur des hôtes (l’exécution apparaît aussi dans l’app). Seuls les snippets enregistrés sont exécutés, jamais une commande inventée par le script ; une note n’est jamais exécutée.

• Attention: Qui a le jeton peut exécuter n’importe lequel de vos snippets enregistrés sur n’importe lequel de vos hôtes. Ne le donnez qu’à un script de confiance, et seulement le temps nécessaire.

Copier des fichiers (SFTP)

settings.cli.scope.sftp · Ordinateur uniquement

Permet à sternway-cli cp de copier un fichier d’un hôte vers un dossier de cet ordinateur ou (si le jeton n’est pas en lecture seule) de cet ordinateur vers un dossier d’un hôte, par le SFTP de l’hôte. Un fichier déjà présent est laissé tel quel, sauf si la commande indique –overwrite.

• Attention: Une copie vers un hôte peut y remplacer des fichiers avec –overwrite. Cochez aussi Lecture seule si le script doit seulement récupérer des fichiers.

Lecture seule

settings.cli.scope.readOnly · Ordinateur uniquement

Limite les autres choix à ce qui ne modifie rien : lister les hôtes et copier des fichiers depuis un hôte. Avec elle, le jeton ne peut jamais ouvrir de terminal, exécuter de snippet ni copier de fichier vers un hôte ni remplacer un fichier de cet ordinateur (–overwrite), même si ces choix sont cochés. Ce n’est pas une autorisation en soi : seule, elle ne permet rien.

Dossier des fichiers

settings.cli.folder · Ordinateur uniquement

Le seul dossier de cet ordinateur où vont les téléchargements du jeton et d’où partent ses envois ; choisi à sa création. Tout reste dedans : pas de chemin avec .., pas de lien symbolique, pas de fichier ni de dossier caché (nom commençant par un point). Ainsi un jeton ne peut jamais créer ~/.ssh/authorized_keys, /.bashrc ou une entrée de démarrage automatique, ni envoyer une clé privée. Le dossier est créé en 0700. Ce doit être un dossier nouveau ou vide (ou celui d’un autre jeton) : jamais le dossier personnel, un dossier au-dessus, ni un dossier que lisent les programmes (/.config, ~/Library, %APPDATA%).

• Par défaut: Sternway dans votre dossier Téléchargements.

Expire après

settings.cli.expiry · Ordinateur uniquement

Quand le jeton cesse de fonctionner tout seul. Tout jeton expire ; un an au plus. Ensuite, la commande est refusée et vous créez un nouveau jeton. Vous pouvez révoquer un jeton à tout moment avant.

• Par défaut: 30 jours.