3 Tmux
dotfiles-sync edited this page 2026-08-07 21:19:23 +00:00
This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

Tmux

Konfiguriert in config/tmux/tmux.conf + config/tmux/theme.conf (Farben, generiert aus der Catppuccin-Palette).

Grundlagen

  • Prefix: Ctrl+A statt des Tmux-Standards Ctrl+B (GNU-Screen-Stil).
  • Maus: aktiviert (Panes anklicken, Fenster in der Statusleiste anklicken, Scrollbalken).
  • Fenster-/Pane-Nummerierung: beginnt bei 1 statt 0, rückt beim Schließen automatisch lückenlos nach (renumber-windows).
  • Nur eine Dauer-Session im typischen Workflow (nicht mehrere Sessions parallel) – deshalb zeigt die Statusleiste bewusst keinen Session-Namen, nur den Hostname (wichtig bei mehreren SSH-Verbindungen).

Keybindings

Alles mit Prefix (Ctrl+A dann die Taste) außer explizit als "ohne Prefix" markiert.

Taste Wirkung
| Horizontal splitten (neues Pane rechts), startet im aktuellen Verzeichnis
- Vertikal splitten (neues Pane darunter), startet im aktuellen Verzeichnis
Alt+←/→/↑/↓ (ohne Prefix) Zwischen Panes springen
h / j / k / l Zwischen Panes springen (Vim-Stil, zusätzlich zu den Alt-Pfeiltasten)
H / J / K / L Aktives Pane in 5er-Schritten verkleinern/vergrößern – wiederholbar, ohne den Prefix zwischen den Tastendrücken erneut zu drücken (Fenster bleibt ca. 500ms "aktiv" dafür)
r tmux.conf neu laden, ohne die Session neu zu starten
I Plugins installieren (TPM)
U Plugins aktualisieren (TPM)

Hinweis: L ist damit bewusst umbelegt – Tmux' Standard-Binding dafür (switch-client -l, zur zuletzt genutzten Session wechseln) ist ohne Multi-Session-Workflow ungenutzt.

Copy-Mode

  • setw -g mode-keys vi: Copy-Mode (Scrollback durchsuchen/kopieren, mit Prefix + [ betreten) nutzt Vim- statt Emacs-Bindings (h/j/k/l, v zum Markieren, y zum Kopieren, / zum Suchen, q zum Verlassen).
  • tmux-yank-Plugin: Copy-Mode-Auswahl (und Maus-Drag-Selektion) landet automatisch in der System-Zwischenablage statt nur im Tmux-internen Buffer – besonders über SSH sonst umständlich. Kein zusätzliches Binding nötig, y funktioniert automatisch systemweit.
  • Maus-Markierung bleibt sichtbar: tmux-yanks Default (@yank_action copy-pipe-and-cancel) würde die Markierung im selben Moment wieder verschwinden lassen, in dem man die Maustaste loslässt (kopiert zwar trotzdem korrekt, wirkt aber wie ein Bug). Hier auf @yank_action 'copy-pipe' umgestellt – Text bleibt nach dem Loslassen markiert stehen, bis man z.B. Escape drückt.

Plugins (via TPM)

Installiert/aktualisiert über scripts/ensure-plugins-unix.sh, läuft bei jedem dotfiles update.

Plugin Macht
tpm Tmux Plugin Manager selbst
tmux-resurrect Speichert/stellt Fenster-Layout und laufende Programme wieder her
tmux-continuum Automatisches Speichern (alle 1 Minute) + automatisches Wiederherstellen bei Server-Start (@continuum-restore on) – übersteht so Absturz/Reboot/SSH-Verbindungsabbruch
tmux-yank Copy-Mode → System-Zwischenablage (siehe oben)
tmux-prefix-highlight Zeigt in der Statusleiste sichtbar an, wenn der Prefix (Ctrl+A) gerade aktiv ist bzw. Copy-Mode läuft

Verschachteltes Tmux (lokal → SSH → Tmux auf dem Server)

Zwei Ebenen, um mit einer verschachtelten Session zu arbeiten:

  • Ctrl+A Ctrl+A (Prefix zweimal): schickt ein einzelnes, literales Ctrl+A an die innere Session durch, statt es selbst als Prefix abzufangen (bind C-a send-prefix). Reicht für einzelne Befehle in der inneren Session.
  • F12: schaltet den äußeren Prefix für die gesamte Session komplett aus (Key-Table off) und färbt die Statusleiste rot mit der Aufschrift "VERSCHACHTELT" – ab jetzt landet jede Taste (inkl. Ctrl+A) unverändert in der inneren Session, ohne dass man ständig doppelt drücken muss. Praktisch für einen längeren Aufenthalt in der verschachtelten Session. F12 nochmal drücken schaltet zurück zur normalen äußeren Bedienung (Statusleiste wird wieder normal).

Statusleiste

  • Links: Hostname (eigener Farbblock) – wichtig, um auf einen Blick zu sehen, auf welchem Server man gerade ist.
  • Rechts: Prefix-Highlight-Indikator (tmux-prefix-highlight) + Datum/Uhrzeit.
  • Fenster-Liste (Mitte): Index:Name je offenem Fenster, aktives Fenster farblich hervorgehoben.

Sonstiges

  • escape-time 0: kein spürbares Delay mehr nach Esc in (Neo)vim (Tmux wartet sonst standardmäßig 500ms auf eine evtl. folgende Escape-Sequenz).
  • history-limit 50000: deutlich mehr Scrollback als der Tmux-Default (2000 Zeilen).
  • Echtes 24-bit-Farbschema erzwungen (default-terminal tmux-256color + terminal-overrides), damit die Catppuccin-Farben korrekt aussehen.
  • allow-passthrough on + update-environment TERM/TERM_PROGRAM: nötig, damit Bild-Escape-Sequenzen (Kitty-Grafikprotokoll, iTerm2, Sixel) durch Tmux zum eigentlichen Terminal durchgereicht werden – betrifft z.B. Yazis Bildvorschau (siehe Eza-and-Yazi), die sonst innerhalb von Tmux gar nichts anzeigt. Setzt zusätzlich voraus, dass das Terminal selbst (außerhalb von Tmux) eines der Protokolle unterstützt – ohne das bleibt nur Yazis chafa-Fallback (reine ANSI-Farben statt echtem Bild).