Plugins
Das tmux-Plugin und Mac-Shell-Plugin installieren und konfigurieren
Plugins
MTerm kann durch die Installation von Plugins auf deinen Remote-Servern erweitert werden. Plugins fügen Features wie Befehlsabschluss-Benachrichtigungen, Zwischenablage-Sync und Sitzungspersistenz hinzu. Zwei offizielle Plugins sind verfügbar.
mterm-tmux (tmux-Plugin)
Integriert tmux mit MTerm für Zwischenablage-Sync, Context Sharing, Benachrichtigungen und Sitzungsverwaltung.
Features
| Feature | Beschreibung |
|---|---|
| Zwischenablage-Sync | tmux-Kopierpuffer mit MTerms Zwischenablage-Verlauf synchronisieren |
| Context Sharing | Aktuelles Verzeichnis, Git-Branch und anderen Kontext an MTerm senden |
| Befehlsbenachrichtigungen | Push-Benachrichtigungen erhalten, wenn lang laufende Befehle abgeschlossen sind |
| Sitzungsverwaltung | tmux-Sitzungen und -Windows auflisten und zwischen ihnen wechseln |
Installation (TPM)
Wenn du tmux Plugin Manager (TPM) verwendest, füge Folgendes zu deiner ~/.tmux.conf hinzu:
# ~/.tmux.conf
set -g @plugin 'mtermapp/mterm-tmux'
# Press prefix + I to install
Falls du TPM noch nicht hast, richte zuerst TPM ein.
Shell-Hook-Setup
Um die volle Funktionalität zu aktivieren (besonders die Erkennung von Befehlsabschlüssen), füge den Shell-Hook zu deiner Shell-Init-Datei hinzu:
# ~/.zshrc or ~/.bashrc
[ -f ~/.tmux/plugins/mterm-tmux/scripts/init.sh ] \
&& source ~/.tmux/plugins/mterm-tmux/scripts/init.sh
Das ermöglicht MTerm zu erkennen, wann Befehle starten und enden, was das Benachrichtigungssystem antreibt.
Benachrichtigungseinstellungen
Sobald das Plugin installiert ist, konfiguriere das Benachrichtigungsverhalten in MTerms Einstellungen (Einstellungen → Plugins):
| Einstellung | Beschreibung |
|---|---|
| Benachrichtigungsmodus | AN (Benachrichtigungen empfangen) / AUS (Benachrichtigungen deaktivieren) |
| Schwellenwert (Sekunden) | Nur bei Befehlen benachrichtigen, die länger als diesen Wert dauern (Standard: 5 Sekunden, Bereich: 1–120) |
Wenn du den Schwellenwert zum Beispiel auf 10 Sekunden setzt, lösen schnelle Befehle wie ls oder cd keine Benachrichtigungen aus, aber Builds, Tests und lang laufende Skripte benachrichtigen dich, wenn sie abgeschlossen sind.
GitHub
mterm-shell (Mac-Plugin)
Ein Shell-Plugin, das sich direkt auf deinem Mac (oder Linux-Server) installiert, ohne tmux zu benötigen. Bietet Befehlsbenachrichtigungen, Context Sharing und optionale Sitzungspersistenz.
Features
| Feature | Beschreibung |
|---|---|
| Sitzungspersistenz | Shell-Sitzungen nach SSH-Trennungen mit abduco am Leben halten |
| Context Sharing | Aktuelles Verzeichnis, Git-Branch und anderen Kontext an MTerm senden |
| Befehlsbenachrichtigungen | Push-Benachrichtigungen erhalten, wenn lang laufende Befehle abgeschlossen sind |
Installation
git clone https://github.com/mtermapp/mterm-shell \
~/.mterm/plugin
Shell-Hook-Setup
# ~/.zshrc or ~/.bashrc
[ -f ~/.mterm/plugin/init.sh ] \
&& source ~/.mterm/plugin/init.sh
Sitzungspersistenz (Optional)
Installiere abduco, um Shell-Sitzungen am Leben zu halten, auch wenn deine SSH-Verbindung abbricht. Wenn du dich wieder verbindest, kannst du zur selben Sitzung zurückkehren und genau dort weitermachen, wo du aufgehört hast.
# Install abduco (macOS)
brew install abduco
# Create a persistent session
mterm-session "my-project"
mterm-session ist ein Wrapper um abduco, der eine benannte persistente Shell erstellt. Wenn deine SSH-Verbindung abbricht, läuft die Shell weiter. Bei deiner nächsten Verbindung kehrst du zur selben Sitzung zurück.
Benachrichtigungseinstellungen
Gleich wie bei mterm-tmux — konfiguriere Benachrichtigungsmodus und Schwellenwert in Einstellungen → Plugins.
GitHub
Welches Plugin solltest du verwenden?
| Situation | Empfehlung |
|---|---|
| Du verwendest regelmäßig tmux | mterm-tmux |
| Du verwendest kein tmux / verbindest dich direkt zum Mac | mterm-shell |
| Du möchtest beides (tmux + direkte Verbindungen) | Installiere beide — sie kollidieren nicht |
Keines der Plugins ist erforderlich. Alle Kernfunktionen von MTerm funktionieren ohne serverseitige Installation. Plugins sind optionale Erweiterungen, die Komfortfunktionen hinzufügen.