Guide

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

FeatureBeschreibung
Zwischenablage-Synctmux-Kopierpuffer mit MTerms Zwischenablage-Verlauf synchronisieren
Context SharingAktuelles Verzeichnis, Git-Branch und anderen Kontext an MTerm senden
BefehlsbenachrichtigungenPush-Benachrichtigungen erhalten, wenn lang laufende Befehle abgeschlossen sind
Sitzungsverwaltungtmux-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):

EinstellungBeschreibung
BenachrichtigungsmodusAN (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

mtermapp/mterm-tmux


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

FeatureBeschreibung
SitzungspersistenzShell-Sitzungen nach SSH-Trennungen mit abduco am Leben halten
Context SharingAktuelles Verzeichnis, Git-Branch und anderen Kontext an MTerm senden
BefehlsbenachrichtigungenPush-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

mtermapp/mterm-shell


Welches Plugin solltest du verwenden?

SituationEmpfehlung
Du verwendest regelmäßig tmuxmterm-tmux
Du verwendest kein tmux / verbindest dich direkt zum Macmterm-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.