# 📁 tabby-better-sidebar **Sidebar de connexions enrichie pour [Tabby](https://tabby.sh)** — favoris Ă©pinglĂ©s, statut de connexion en direct, glisser-dĂ©poser, et un explorateur SFTP contextuel qui vit *dans* la sidebar plutĂŽt que dans un panneau dockĂ© Ă  part. [English](README.md) · **Français** [![License: MIT](https://img.shields.io/github/license/TooMuhtsh/tabby-better-sidebar?color=0d9488)](LICENSE) [![Part of Better Tabby](https://img.shields.io/badge/part%20of-Better%20Tabby-0d9488)](#-better-tabby-la-famille-de-plugins)
--- Tabby possĂšde une sidebar de profils native, mais elle n'est pas exportĂ©e pour qu'un plugin tiers puisse la rĂ©utiliser. Ce plugin la reconstruit et y ajoute les favoris Ă©pinglĂ©s, le statut de connexion en direct, le glisser-dĂ©poser entre dossiers, des espaces de travail nommĂ©s, la gestion des tunnels SSH, des snippets, des notes, et un explorateur SFTP complet qui occupe l'espace de la sidebar et suit l'onglet SSH ayant le focus. **Chaque bloc est indĂ©pendant, et chacun se dĂ©sactive** depuis l'onglet de rĂ©glages du plugin — si vous n'utilisez jamais les tunnels SSH ni les espaces de travail, Ă©teignez ces deux-lĂ  et la sidebar s'allĂšge d'autant. Rien n'est supprimĂ© pour autant : vos favoris, espaces de travail et snippets restent exactement oĂč ils sont, ils cessent simplement d'ĂȘtre affichĂ©s. ## đŸ§© Better Tabby, la famille de plugins Ce plugin est l'une des deux moitiĂ©s de **Better Tabby**, une petite famille de plugins indĂ©pendants qui partagent un seul onglet de rĂ©glages au lieu d'en disperser plusieurs : | | Plugin | Apporte | |---|---|---| | 📁 | **tabby-better-sidebar** *(ce dĂ©pĂŽt)* | Favoris Ă©pinglĂ©s, statut de connexion en direct, glisser-dĂ©poser, espaces de travail, explorateur SFTP contextuel | | 🔐 | **[tabby-better-vault](https://github.com/TooMuhtsh/tabby-better-vault)** | DĂ©verrouillage automatique du coffre-fort via le trousseau du systĂšme | **Aucun des deux n'a besoin de l'autre.** N'installez que celui-ci et il se comporte exactement comme si l'autre n'existait pas — son propre onglet de rĂ©glages, rien de partagĂ©. Installez les deux, et ils Ă©lisent l'un d'entre eux pour porter un unique onglet **Better Tabby**, chacun continuant d'y rendre sa propre page. Aucune dĂ©pendance npm entre les deux dĂ©pĂŽts, aucun code commun : juste un petit contrat de chaĂźne (`BetterPanelContribution:`) que chaque plugin reconnaĂźt de son cĂŽtĂ©. ## ✹ L'arbre des profils - **Favoris Ă©pinglĂ©s**, pour les profils comme pour les dossiers - **Statut de connexion en direct** par profil, avec un indicateur de latence optionnel — un aller-retour SFTP chronomĂ©trĂ© sur le canal de la session elle-mĂȘme, et non un ping ICMP, de sorte qu'il mesure le dĂ©lai rĂ©ellement ressenti Ă  la frappe - **Section « Sessions actives »** en haut, une ligne par volet plutĂŽt que par onglet, avec le temps de connexion, un clic pour donner le focus et un raccourci vers la vue SFTP de cette session - **Profils rĂ©cents** — les cinq derniers lancĂ©s, tous types confondus (dĂ©sactivĂ© par dĂ©faut) - **Glisser-dĂ©poser** pour rĂ©organiser — profils et dossiers, y compris dĂ©placer un profil d'un dossier Ă  l'autre et changer un dossier de parent - **Espaces de travail** : masquer profils et dossiers par espace (perso / travail / projet), chacun avec ses propres favoris, son propre ordre entre frĂšres, sa propre icĂŽne et une couleur contextuelle optionnelle ; sĂ©lecteur en onglets ou en liste dĂ©roulante, et export/import JSON en un clic - **Onglet « Actifs »** : rĂ©duit la liste aux profils qui ont un onglet ouvert (dĂ©connectĂ©s compris), dans l'espace de travail sĂ©lectionnĂ© — sur « Tous » ou sans espaces de travail, toutes les sessions ouvertes - **SĂ©lection multiple**, pour agir sur plusieurs profils Ă  la fois - **Tunnels SSH** : un panneau de ce que Tabby redirige rĂ©ellement, des badges sur les profils qui dĂ©clarent des tunnels, et une modale pour en ajouter, modifier ou retirer — avec une mĂ©moire des tunnels qu'une session coupĂ©e n'a pas su remonter - **Barre de filtrage rapide**, qui cherche dans le nom, la description, l'hĂŽte et l'utilisateur — y compris dans ce que l'espace de travail masque - **Tout replier / tout dĂ©plier** en un clic, par le bouton voisin du champ de filtre ou le clic droit sur le vide de l'arbre : tous les dossiers Ă  tous les niveaux, plus les blocs Sessions actives, Profils rĂ©cents et Tunnels - **Menus contextuels**, regroupĂ©s en sous-menus `GĂ©rer` et `Plus` pour rester courts : crĂ©er et supprimer dossiers et profils, dupliquer un profil, renommer, choisir une icĂŽne, rattacher snippets et notes, partager un dossier, le masquer dans l'espace courant ## 🎹 IcĂŽnes Le sĂ©lecteur d'icĂŽnes cherche dans trois sources Ă  la fois, entiĂšrement hors ligne — aucun appel rĂ©seau n'est jamais Ă©mis : - **Font Awesome**, la collection qu'utilise Tabby lui-mĂȘme - **[Iconify](https://iconify.design)** Material Design Icons et Tabler, pour les glyphes gĂ©nĂ©riques - **[dashboard-icons](https://github.com/homarr-labs/dashboard-icons)** — environ 2 400 logos de services auto-hĂ©bergĂ©s (Proxmox, Pi-hole, Nextcloud et compagnie), bien plus parlants qu'un glyphe gĂ©nĂ©rique pour nommer un vrai parc de machines. Les icĂŽnes livrĂ©es en plusieurs palettes les proposent sous forme de pastilles sur leur tuile, ce qui permet d'Ă©changer un logo sombre contre sa variante claire sur un thĂšme sombre. Les icĂŽnes rĂ©cemment utilisĂ©es restent Ă  portĂ©e, n'importe laquelle s'Ă©pingle en favori d'un clic droit, et des SVG personnalisĂ©s peuvent ĂȘtre importĂ©s (assainis par [DOMPurify](https://github.com/cure53/DOMPurify)). Les deux grandes collections ne sont chargĂ©es qu'**Ă  la premiĂšre recherche**, dans un fichier sĂ©parĂ© : elles ne coĂ»tent rien au dĂ©marrage. ## 📂 SFTP L'explorateur remplace l'arbre des profils dans l'espace de la sidebar et suit l'onglet SSH ayant le focus — chaque onglet se souvient d'oĂč il en Ă©tait, et la vue peut ĂȘtre **figĂ©e** sur une session pour cesser de suivre le focus. - **Colonnes configurables** (taille, date, permissions en octal et en format long, type, extension), tri dossiers d'abord, affichage des fichiers cachĂ©s, lignes alternĂ©es - **Format de date au choix** : celui de la langue de Tabby, jour/mois/annĂ©e (`08/10/2026`) ou ISO 8601 (`2026-10-08`) - **Dossiers favoris, par profil** — le bouton Ă©toile les liste et ajoute ou retire le dossier courant ; un clic ramĂšne au chemin enregistrĂ© - **Tri par nom, date ou taille** — un clic sur le titre de colonne trie dessus, un second inverse le sens ; date et taille commencent par le plus rĂ©cent et le plus gros. Aussi dans le menu du clic droit sur l'en-tĂȘte, pour une colonne masquĂ©e. Le choix est mĂ©morisĂ© - **SĂ©lection multiple**, fichiers *et* dossiers, pour supprimer ou dĂ©placer par lot - **Chargement par blocs** des listings volumineux - **Le double-clic ouvre un fichier dans un Ă©diteur de code**, jamais via l'association de fichiers du systĂšme — double-cliquer un exĂ©cutable l'Ă©dite au lieu de le lancer. L'enregistrement renvoie le fichier automatiquement, aprĂšs avoir vĂ©rifiĂ© que la copie distante n'a pas changĂ© entre-temps, et restaure ses permissions. Les liens symboliques sont rĂ©solus : c'est la cible qui est Ă©ditĂ©e, pas le lien - **« Ouvrir avec
 »** reste disponible, mais seulement depuis le menu contextuel - **CrĂ©er, renommer et supprimer** des entrĂ©es — touche `Suppr` comprise, avec une confirmation HTML dont vous choisissez le bouton par dĂ©faut dans les rĂ©glages - **DĂ©placer une entrĂ©e** en la glissant sur un dossier — un `rename` cĂŽtĂ© serveur, rien ne transite - **Glisser un fichier vers le systĂšme** : le tĂ©lĂ©chargement dĂ©marre au dĂ©pĂŽt, lĂ  oĂč vous l'avez dĂ©posĂ© - **Gestionnaire de transferts** en bas de la sidebar — progression, vitesse, temps restant estimĂ© et temps Ă©coulĂ© par transfert, contrĂŽle d'arrivĂ©e qui signale une copie incomplĂšte Ă  destination, confirmation avant annulation, visible depuis les deux vues, masquĂ© quand il est vide - **RafraĂźchissement automatique** du listing, optionnel, dĂ©sactivĂ© par dĂ©faut - **Retour automatique** Ă  la vue Profils dĂšs qu'aucun onglet n'a plus de session SFTP active ## 📝 Snippets, notes et partage - **Snippets** — une commande Ă©crite une fois, rattachĂ©e Ă  un profil, Ă  un dossier ou Ă  tout, et rĂ©utilisable partout oĂč elle est rattachĂ©e. GĂšre les variables `{{nom}}` (obligatoire) et `{{nom=valeur}}` (prĂ©-remplie), hĂ©rite le long de l'arbre des dossiers, et se rĂšgle pour Ă©crire dans le terminal, Ă©crire puis valider, ou lancer la session au prĂ©alable - **Notes** — un mĂ©mo libre par profil ou par dossier, avec un badge dans l'arbre - **Partager un dossier** par le presse-papiers, en JSON, Ă  deux niveaux : *avec* les coordonnĂ©es de connexion pour vos propres machines, ou *sans identifiants* pour quelqu'un d'autre. Mots de passe, scripts de login, commandes de proxy et rĂ©fĂ©rences au coffre-fort ne voyagent jamais, Ă  aucun des deux niveaux ; ce qui a Ă©tĂ© retirĂ© est annoncĂ© dans la notice, et le JSON est revĂ©rifiĂ© champ par champ au collage ## 🌍 Langues L'interface suit la langue de Tabby — anglais, plus français, espagnol, allemand et chinois simplifiĂ©, sur l'ensemble du plugin : arbre des profils, menus contextuels, sessions actives et tunnels, explorateur SFTP, dialogues, transferts et onglet de rĂ©glages. Toute autre langue retombe sur l'anglais. ## Ailleurs - Ctrl+EntrĂ©e insĂšre un saut de ligne dans le terminal au lieu de valider - Dans le champ de recherche, les flĂšches parcourent les rĂ©sultats et EntrĂ©e ouvre celui en surbrillance dans un nouvel onglet ; Maj+EntrĂ©e l'ouvre dans un Ă©cran partagĂ© de l'onglet actif - Alt+B masque la sidebar et la fait revenir, sans rien fermer — vues SFTP ouvertes, filtre et sĂ©lection sont toujours lĂ . Le raccourci se change dans **ParamĂštres → Raccourcis** - Un onglet de rĂ©glages dĂ©diĂ© dans les paramĂštres de Tabby (partagĂ© sous **Better Tabby** quand le plugin vault est Ă©galement installĂ©) ## 📩 Installation **NĂ©cessite Tabby 1.0.231 ou plus rĂ©cent.** DĂ©veloppĂ© et testĂ© sur **Tabby 1.0.238**, la version stable actuelle. Dans Tabby, ouvrir **ParamĂštres → Plugins**, chercher `better-sidebar`, l'installer, puis relancer Tabby entiĂšrement.
Directement avec npm ```bash # Dans le dossier de plugins de Tabby : %APPDATA%\tabby\plugins sur Windows, # ~/.config/tabby/plugins sur macOS/Linux npm install tabby-better-sidebar ``` Puis relancer Tabby entiĂšrement.
## ⚙ Configuration Tout se rĂšgle dans **ParamĂštres → Better Sidebar** (ou **Better Tabby → 📁 Sidebar** si `tabby-better-vault` est Ă©galement installĂ©), rĂ©parti entre *GĂ©nĂ©ral*, *FonctionnalitĂ©s* et *Snippets*. Sur le disque, les rĂ©glages vivent sous `sidebarPlus` dans le `config.yaml` de Tabby.
Tous les rĂ©glages, avec leur valeur par dĂ©faut **Blocs** — chacun s'active indĂ©pendamment : | RĂ©glage | DĂ©faut | Effet | |---|---|---| | `enabled` | `true` | Affiche la sidebar. Éteinte, elle disparaĂźt sans rien dĂ©sinstaller ; cette page de rĂ©glages reste accessible | | `showActiveSessions` | `true` | Connexions SSH ouvertes, en haut de la sidebar | | `showRecentProfiles` | `false` | Les cinq profils lancĂ©s le plus rĂ©cemment | | `showTunnels` | `true` | Panneau de redirection de ports et badges sur les profils | | `showWorkspaces` | `true` | Barre des espaces de travail, au-dessus de la liste | | `showFilter` | `true` | Champ de recherche et son raccourci | | `searchSplitSide` | `r` | CĂŽtĂ© de l'Ă©cran partagĂ© ouvert par Maj+EntrĂ©e depuis la recherche : `r`, `b`, `l` ou `t` | | `searchClearOnLaunch` | `false` | Effacer la recherche aprĂšs l'ouverture d'un rĂ©sultat au clavier | | `showActiveToggle` | `true` | Onglet « Actifs » : seulement les profils qui ont un onglet ouvert | | `wrapNames` | `false` | Noms longs sur deux lignes au plus, au lieu d'une ligne coupĂ©e | | `showSftp` | `true` | L'onglet SFTP de la sidebar et son panneau | | `showTransfers` | `true` | Gestionnaire de transferts en bas de la sidebar | | `showSnippets` | `true` | L'entrĂ©e *Snippets* du clic droit et son onglet | | `showNotes` | `true` | L'entrĂ©e *note* du clic droit et son badge | Éteindre un bloc coupe aussi son travail de fond — plus de balayage des onglets, plus de sonde de latence, plus de suivi des transferts pour un panneau que personne ne regarde. **Comportement :** | RĂ©glage | DĂ©faut | Effet | |---|---|---| | `hideNativeTransfersMenu` | `true` | Masque le menu des transferts de Tabby, qui montre les mĂȘmes transferts | | `workspaceSelectorMode` | `tabs` | Barre des espaces de travail en onglets, ou en liste dĂ©roulante | | `pingIntervalSeconds` | `0` | Intervalle de la sonde de latence ; `0` la dĂ©sactive | | `sftpAutoRefreshSeconds` | `0` | Relit le dossier courant Ă  intervalle rĂ©gulier ; `0` dĂ©sactive | | `sftpAutoReturnToProfiles` | `true` | Revient Ă  la vue Profils quand plus aucune session SSH n'est ouverte | | `sftpEditorPath` | *(vide)* | Programme ouvert au double-clic. Vide, Windows dĂ©cide | | `sftpDeleteDefaultButton` | `cancel` | Bouton activĂ© par EntrĂ©e dans la confirmation de suppression SFTP | | `sftpDragOutFolders` | `false` | Autorise le glisser d'un *dossier* vers le systĂšme, et pas seulement d'un fichier | | `sftpColumns` | `size`, `date`, `mode` | Colonnes affichĂ©es dans le listing SFTP | | `sftpFoldersFirst` | `true` | Trie les dossiers avant les fichiers | | `sftpFavorites` | *(vide)* | Dossiers distants favoris, par identifiant de profil | | `sftpSortKey` | `name` | Colonne de tri du listing : `name`, `date` ou `size` | | `sftpSortDescending` | `false` | Sens du tri | | `sftpDateFormat` | `locale` | Écriture des dates du listing : `locale` (langue de Tabby), `dmy` (`08/10/2026`) ou `iso` (`2026-10-08`) ; l'infobulle ajoute l'heure | | `sftpShowHidden` | `true` | Affiche les fichiers commençant par un point | | `sftpColumnBorders` | `true` | SĂ©parateurs de colonnes dans le listing | | `sftpZebra` | `true` | Fond de ligne alternĂ© | Vos favoris, espaces de travail, snippets, notes, icĂŽnes personnalisĂ©es et ordres de tri sont rangĂ©s sous la mĂȘme clĂ©. Ce sont des donnĂ©es, pas des rĂ©glages : rien de ce qui prĂ©cĂšde ne les supprime.
## ⚠ Limites connues - **L'Ă©dition distante ne verrouille rien.** Le plugin vĂ©rifie que le fichier distant n'a pas changĂ© avant de renvoyer votre modification, et refuse d'Ă©craser si c'est le cas — mais deux personnes qui Ă©ditent le mĂȘme fichier en mĂȘme temps, c'est toujours le dernier qui gagne. - **Glisser vers une cible qui ne comprend pas une offre de fichier diffĂ©rĂ©e** (Terminal Windows, MobaXterm) ne produit rien du tout, en silence. La source ne peut pas le dĂ©tecter. - **Un profil partagĂ© par le presse-papiers conserve son hĂŽte et son port.** C'est dĂ©libĂ©rĂ© — c'est ce qui rend le dossier utile — mais cela signifie que le JSON dĂ©crit votre rĂ©seau. Utilisez *Copier sans les identifiants* quand cela compte. - **Les profils shell locaux ne sont jamais partagĂ©s** : leurs options sont une commande Ă  exĂ©cuter, prĂ©cisĂ©ment ce qui ne doit pas arriver par un presse-papiers. ## đŸ› ïž DĂ©veloppement ```bash git clone https://github.com/TooMuhtsh/tabby-better-sidebar cd tabby-better-sidebar npm install --ignore-scripts # Ă©vite des postinstall qui compilent du natif inutile ici npm run watch ``` Puis, Tabby fermĂ©, lier le dossier dans le rĂ©pertoire de plugins de Tabby. Ne pas utiliser la variable d'environnement `TABBY_PLUGINS` — elle est cassĂ©e sur Windows : ```powershell New-Item -ItemType Junction -Path "$env:APPDATA\tabby\plugins\node_modules\tabby-better-sidebar" -Target "" ``` Relancer Tabby entiĂšrement aprĂšs chaque reconstruction — recharger la fenĂȘtre ne suffit pas, l'Ă©tat du chargeur de plugins Ă©tant global au processus. ## Voir aussi [**tabby-better-vault**](https://github.com/TooMuhtsh/tabby-better-vault) — le plugin frĂšre, voir [Better Tabby](#-better-tabby-la-famille-de-plugins) ci-dessus. [**Documentation de gouvernance IA**](https://toomuhtsh.github.io/tabby-better-sidebar/.AIRules/README.html) — ce plugin est dĂ©veloppĂ© avec un assistant IA sous une charte de gouvernance Ă©crite, et le dossier de travail complet est public : invariants et piĂšges numĂ©rotĂ©s, journal de dĂ©veloppement, roadmap et registre de tout ce qui a Ă©tĂ© livrĂ©, consultables comme un petit site statique. ## CrĂ©dits - [Tabby](https://github.com/Eugeny/tabby) d'Eugeny — le terminal que ce plugin Ă©tend ; sa sidebar de profils native est le point de dĂ©part de celle-ci (MIT, voir [THIRD-PARTY-NOTICES.md](THIRD-PARTY-NOTICES.md)) - [dashboard-icons](https://github.com/homarr-labs/dashboard-icons) — la collection de logos de services (Apache-2.0) - [Iconify](https://iconify.design) Material Design Icons et Tabler, ainsi que [DOMPurify](https://github.com/cure53/DOMPurify) ## Licence MIT — voir [LICENSE](LICENSE).