Alle Standard-Tastenkürzel (tmux 3.x) und die zugehörigen Shell-Befehle. `C-b` bedeutet
Ctrl + b: zuerst das Präfix drücken, dann die Taste. In den Shell-Befehlen
steht -t für das Ziel (target), siehe unten.
Schnellstart!!!
Die wichtigsten Befehle für den täglichen Einstieg in tmux – kompakt an einer Stelle.
1. Neue Session erstellentmux new -s main
Startet eine neue, benannte Arbeitsumgebung.
2. Öffnen oder anhängentmux new -A -s main
Hängt an main an oder erstellt sie, falls sie noch nicht existiert.
3. Session verlassen
Ctrl + b, dann d
Trennt die Verbindung; Session und Programme laufen weiter.
4. Wieder anhängentmux a -t main
Verbindet dich wieder mit der laufenden Session main.
5. Sessions anzeigentmux ls
Zeigt alle laufenden tmux-Sessions.
Merksatz: Eine Session starten, mit Ctrl + b und d lösen und später wieder anhängen – nichts muss neu gestartet werden.
Grundlagen
Shell-Befehl
Wirkung
tmux
neue, unbenannte Session starten
tmux new -s main
neue Session mit Namen main starten
tmux new -d -s main
Session im Hintergrund starten (detached)
tmux new -A -s main
an main anhängen, sonst neu anlegen
tmux new -d -s job 'htop'
Session starten und darin einen Befehl ausführen
tmux -V
installierte tmux-Version anzeigen
man tmux
Handbuchseite
Sessions
Tastenkürzel
tmux-Befehl
Wirkung
C-bd
detach-client
Session lösen (läuft im Hintergrund weiter)
C-bs
choose-tree -s
Sessions auflisten und wechseln
C-b$
rename-session
Session umbenennen
C-b(
switch-client -p
zur vorherigen Session
C-b)
switch-client -n
zur nächsten Session
C-bL
switch-client -l
zur zuletzt verwendeten Session
C-b:kill-session
kill-session
aktuelle Session beenden (kein Standardkürzel)
Shell-Befehl
Wirkung
tmux ls / tmux list-sessions
alle Sessions anzeigen
tmux a -t main / tmux attach -t main
an Session main anhängen
tmux attach -d -t main
andere Clients trennen und anhängen
tmux kill-session -t main
Session beenden (alle Fenster darin)
tmux rename-session -t alt neu
Session umbenennen
tmux switch-client -t main
Client umschalten (aus tmux heraus)
tmux has-session -t main && echo ok
prüfen, ob Session existiert (für Skripte)
Achtung:tmux kill-server beendet alle Sessions
und den tmux-Server – nur bewusst verwenden.
Mit der Maus markieren funktioniert nicht wie gewohnt — tmux
fängt die Mausereignisse ab. Der häufigste Fehler dabei: die Auswahl landet nur
im tmux-Puffer, nicht in der Zwischenablage des Systems. Drei Wege, je nachdem
was man braucht.
Markierung starten — mode-keys vi statt Emacs (siehe
Konfiguration und Wartung):
Taste
Wirkung
Leertaste
zeichenweise markieren
Ctrl+Leertaste
wortweise markieren
v
zeilenweise markieren
Ctrl+v
blockweise markieren
Maus-Modus einschalten — in ~/.tmux.conf:
Zeile
Wirkung
set -g mouse on
Maus in tmux aktivieren (Markieren, Ziehen, Fenster)
tmux source-file ~/.tmux.conf
Konfiguration sofort neu laden
Auch mit Maus-Modus geht die Auswahl nur in den tmux-Puffer, nicht
in die Zwischenablage des Systems. Für das gewohnte Kopieren des Terminals beim
Markieren Shift gedrückt halten — dann umgeht tmux die Maus und der
Terminal-Selektor greift.
Direkt in die System-Zwischenablage kopieren — Enter im Copy-Modus
legt den Text dann dort ab:
System
Zeile in ~/.tmux.conf
Linux (X11)
set -g mode-keys viset -g set-clipboard onbind-key -T copy-mode-vi y send-keys -X copy-pipe-and-cancel "xclip -selection clipboard"
Linux (Wayland)
bind-key -T copy-mode-vi y send-keys -X copy-pipe-and-cancel "wl-copy"
macOS
bind-key -T copy-mode-vi y send-keys -X copy-pipe-and-cancel "pbcopy"
Ansicht, Clients und Sonstiges
Tastenkürzel
tmux-Befehl
Wirkung
C-b?
list-keys
alle Tastenkürzel anzeigen
C-b:
command-prompt
tmux-Befehl eingeben
C-bt
clock-mode
Uhr anzeigen
C-b~
show-messages
Meldungen anzeigen
C-br
refresh-client
Anzeige neu zeichnen
C-bD
choose-client
Client auswählen / trennen
C-bi
display-message
Informationen zum Fenster anzeigen
C-bCtrl+z
suspend-client
tmux in den Hintergrund legen
Konfiguration und Wartung
Shell-Befehl
Wirkung
tmux source-file ~/.tmux.conf
Konfiguration neu laden
tmux set-option -g mouse on
Mausunterstützung aktivieren
tmux set-option -g history-limit 20000
Scrollback vergrößern
tmux show-options -g
globale (Server-)Optionen anzeigen
tmux show-options -gw
Fenster-Optionen anzeigen
tmux list-keys
aktuelle Tastenkürzel auflisten
tmux list-commands
alle tmux-Befehle auflisten
tmux bind-key X befehl
Taste zur Laufzeit binden
tmux unbind-key X
Bindung entfernen
Zielangaben (target)
Schreibweise
Bedeutung
main
Session main
main:2
Fenster 2 in Session main
main:2.1
Pane 1 in Fenster 2
main:edit
Fenster mit dem Namen edit
:1 / :=1
Fenster 1 der aktuellen Session
Ohne Angabe gilt die aktuelle Session, das aktive Fenster beziehungsweise das aktive Pane.
Nützliche Einzeiler für Skripte
tmux new -A -s main # anhängen oder neu anlegen
tmux has-session -t main || tmux new -d -s main # idempotent starten
tmux new -d -s job 'python3 skript.py' # Hintergrundjob in eigener Session
tmux send-keys -t main:1 'ls -la' Enter # Befehl in ein Fenster senden
tmux pipe-pane -o -t main:1 'cat >> ~/main.log' # Fensterausgabe mitschreiben
tmux list-sessions -F '#{session_name}: #{session_windows} Fenster'
Formatvariablen (z. B. für -F):
#{session_name}, #{window_index}, #{window_name},
#{pane_index}, #{pane_current_command},
#{pane_current_path}.
tmux verstehen: Sessions, Windows und Panes
Die Befehle sind schnell gelernt. Wichtig ist aber auch, wie tmux seine Arbeitsumgebung aufteilt und was beim Trennen und Wiederverbinden tatsächlich passiert.
Eine neue Session erstellen oder an eine bestehende anhängen?
Eine Session ist eine eigenständige tmux-Arbeitsumgebung mit eigenen Fenstern und laufenden Prozessen. Eine neue Session beginnt von vorn. Beim Anhängen wird dagegen nur eine Verbindung zu einer bereits laufenden Session hergestellt – ihre Fenster, Shells und Programme bleiben so, wie sie waren.
Neue Session erstellen
tmux new -s meine-session
Startet eine komplett neue Session mit dem Namen meine-session. Darin werden neue Fenster und Shells angelegt.
An bestehende Session anhängen
tmux attach -t meine-sessiontmux a -t meine-session
Verbindet dich wieder mit der bereits laufenden Session. Der zweite Befehl ist nur die Kurzform.
Der typische Ablauf sieht so aus:
tmux new -s server
# etwas starten
# Ctrl+b, dann d
tmux attach -t server
Nach Ctrl + b und anschließend d bist du nur von der Session getrennt (detach). Die Session läuft im Hintergrund weiter und Programme darin bleiben aktiv. Mit tmux ls findest du später den Namen der laufenden Session wieder.
tmux new -A -s main: öffnen oder neu anlegen
Dieser Befehl ist für den Alltag besonders praktisch:
tmux new -A -s main
new bedeutet: eine Session erstellen.
-s main gibt der Session den Namen main.
-A bedeutet: Existiert main bereits, wird stattdessen an sie angehängt.
Damit lautet die praktische Bedeutung: „Öffne meine Session main; falls sie noch nicht existiert, erstelle sie.“ Du musst also nicht zuerst tmux ls ausführen und zwischen new und attach entscheiden.
Keine Sessions innerhalb von Sessions
tmux-Sessions sind grundsätzlich getrennte, eigenständige Sitzungen. Das normale Modell ist eine Hierarchie von Session → Window → Pane:
Eine Session enthält also Windows, und jedes Window kann in mehrere Panes geteilt werden. Eine Session in einer anderen Session ist nicht der normale Aufbau. Technisch lässt sich tmux zwar innerhalb einer laufenden tmux-Session erneut starten („nested tmux“), das ist aber meist unpraktisch, weil beide Instanzen standardmäßig denselben Prefix Ctrl + b verwenden können.
Mehrere Shells in einer Session sind möglich
Ja. Jedes neue Window startet normalerweise eine eigene Shell. Auch ein geteiltes Pane kann eine eigene Shell mit eigenen laufenden Programmen enthalten. So kannst du in derselben Session zum Beispiel editieren, Logs beobachten und Befehle ausführen: