Plugins

MTerm peut être étendu en installant des plugins sur tes serveurs distants. Les plugins ajoutent des fonctionnalités comme les notifications de fin de commande, la synchronisation du presse-papiers et la persistance des sessions. Deux plugins officiels sont disponibles.

mterm-tmux (plugin tmux)

Intègre tmux avec MTerm pour la synchronisation du presse-papiers, le partage de contexte, les notifications et la gestion des sessions.

Fonctionnalités

Fonctionnalité	Description
Synchronisation du presse-papiers	Synchronise les tampons de copie tmux avec l’historique du presse-papiers de MTerm
Partage de contexte	Envoie le répertoire courant, la branche Git et d’autres informations de contexte à MTerm
Notifications de commandes	Reçois des notifications push quand les commandes longues se terminent
Gestion de sessions	Liste et bascule entre les sessions et fenêtres tmux

Installation (TPM)

Si tu utilises tmux Plugin Manager (TPM), ajoute ce qui suit à ton ~/.tmux.conf :

# ~/.tmux.conf
set -g @plugin 'mtermapp/mterm-tmux'

# Press prefix + I to install

Si tu n’as pas encore TPM, configure d’abord TPM.

Configuration du hook shell

Pour activer toutes les fonctionnalités (surtout la détection de fin de commande), ajoute le hook shell à ton fichier d’initialisation shell :

# ~/.zshrc or ~/.bashrc
[ -f ~/.tmux/plugins/mterm-tmux/scripts/init.sh ] \
  && source ~/.tmux/plugins/mterm-tmux/scripts/init.sh

Cela permet à MTerm de détecter quand les commandes démarrent et se terminent, ce qui alimente le système de notifications.

Paramètres de notification

Une fois le plugin installé, configure le comportement des notifications dans les paramètres de MTerm (Paramètres → Plugins) :

Paramètre	Description
Mode de notification	ON (recevoir les notifications) / OFF (désactiver les notifications)
Seuil (secondes)	Notifier uniquement pour les commandes qui prennent plus longtemps que cette valeur (par défaut : 5 secondes, plage : 1–120)

Par exemple, un seuil de 10 secondes signifie que les commandes rapides comme ls ou cd ne déclencheront pas de notification, mais les builds, tests et scripts longs te notifieront à leur fin.

GitHub

mtermapp/mterm-tmux

mterm-shell (plugin Mac)

Un plugin shell qui s’installe directement sur ton Mac (ou serveur Linux) sans nécessiter tmux. Fournit des notifications de commandes, le partage de contexte et la persistance optionnelle des sessions.

Fonctionnalités

Fonctionnalité	Description
Persistance des sessions	Garde les sessions shell actives après les déconnexions SSH en utilisant `abduco`
Partage de contexte	Envoie le répertoire courant, la branche Git et d’autres informations de contexte à MTerm
Notifications de commandes	Reçois des notifications push quand les commandes longues se terminent

Installation

git clone https://github.com/mtermapp/mterm-shell \
  ~/.mterm/plugin

Configuration du hook shell

# ~/.zshrc or ~/.bashrc
[ -f ~/.mterm/plugin/init.sh ] \
  && source ~/.mterm/plugin/init.sh

Persistance des sessions (optionnel)

Installe abduco pour garder les sessions shell actives même quand ta connexion SSH se coupe. Quand tu te reconnectes, tu peux te rattacher à la même session et reprendre exactement là où tu t’étais arrêté.

# Install abduco (macOS)
brew install abduco

# Create a persistent session
mterm-session "my-project"

mterm-session est un wrapper autour de abduco qui crée un shell persistant nommé. Si ta connexion SSH se coupe, le shell continue de tourner. Lors de ta prochaine connexion, rattache-toi à la même session.

Paramètres de notification

Identiques à mterm-tmux — configure le mode de notification et le seuil dans Paramètres → Plugins.

GitHub

mtermapp/mterm-shell

Quel plugin utiliser ?

Situation	Recommandation
Tu utilises tmux régulièrement	mterm-tmux
Tu n’utilises pas tmux / tu te connectes directement au Mac	mterm-shell
Tu veux les deux (tmux + connexions directes)	Installe les deux — ils ne créent pas de conflit

Aucun plugin n’est requis. Toutes les fonctionnalités principales de MTerm fonctionnent sans aucune installation côté serveur. Les plugins sont des améliorations optionnelles qui ajoutent des fonctionnalités de confort.