Essential reference for GNU Nano — keybindings, configuration, search/replace, and common usage for quick text editing.

Tmux Nested Scrolling Cheat Sheet

Eine praktische Anleitung zum Scrollen in tmux-Sessions — besonders beim Ausführen von tmux innerhalb von tmux. Enthält Maus-Unterstützung, Tastenkürzel, Copy-Mode und Konfiguration für nahtlose Navigation auf mehreren Ebenen.

⚠️ Das Problem mit geschachteltem tmux

Geschachteltes tmux ist eine besondere Herausforderung — wenn du tmux innerhalb von tmux ausführst, wird die Scrollback-Behandlung zu einem Kampf zwischen zwei konkurrierenden Terminal-Multiplexern. Standardmäßig:

• Prefix + Scroll → Äußeres tmux erfasst die Aktion (innere Session ignoriert)
• Mausrad → Kann äußere Session statt innerem Pane scrollen
• Copy-mode → Erfordert das Überwinden mehrerer Schichten
• Alt-Tasten → Werden oft nicht korrekt durchgereicht

Warum das wichtig ist: Geschachteltes tmux ist nicht nur eine Kuriosität — es ist ein kritischer Workflow für:

• Remote-Entwicklung: SSH auf Server → tmux → geschachteltes tmux für isolierte Projekte
• Multi-Environment-Arbeit: Verschiedene tmux-Sessions für dev, staging, production
• Team-Kollaboration: Screen-Sharing mit geschachtelten Sessions für verschiedene Kontexte
• Container-Workflows: Host-tmux → Container-tmux für Microservice-Debugging
• CI/CD-Pipelines: Build-Server mit geschachtelten Session-Hierarchien

Ohne korrekte Konfiguration verlierst du den Zugriff auf den Scrollback der inneren Session — genau das, was du beim Debugging oder zur Überprüfung von Ausgaben brauchst.

Schnelle Übersicht: Scroll-Bindungen

Konfiguration: ~/.tmux.conf

# =============================================================================
# PREFIX-TASTE (von Ctrl+B auf Ctrl+A ändern)
# =============================================================================
set -g prefix C-a
unbind C-b
bind C-a send-prefix

# =============================================================================
# MAUS-UNTERSTÜTZUNG (empfohlen)
# =============================================================================
set -g mouse on

# Direktes Mausscrollen in Panes
bind-key -n MouseWheelUpPane send-keys -X scroll-up
bind-key -n MouseWheelDownPane send-keys -X scroll-down

# =============================================================================
# ALT-TASTEN SCROLLING (ohne Prefix)
# =============================================================================
bind-key -n M-Up send-keys -X scroll-up
bind-key -n M-Down send-keys -X scroll-down
bind-key -n M-PageUp send-keys -X scroll-up
bind-key -n M-PageDown send-keys -X scroll-down

# Copy-Mode mit Alt+Space öffnen
bind-key -n M-Space copy-mode

# =============================================================================
# VI-STYLE COPY-MODE
# =============================================================================
set-window-option -g mode-keys vi

# Copy-Mode Navigation
bind-key v copy-mode
bind-key -T copy-mode-vi k send-keys -X cursor-up
bind-key -T copy-mode-vi j send-keys -X cursor-down
bind-key -T copy-mode-vi h send-keys -X cursor-left
bind-key -T copy-mode-vi l send-keys -X cursor-right
bind-key -T copy-mode-vi Space start-selection
bind-key -T copy-mode-vi Enter copy-pipe-and-cancel "xclip -selection clipboard"

# =============================================================================
# GESCHACHTTELTES TMUX HANDLING
# =============================================================================
# Doppelprefix für geschachtelte Sessions
set -g prefix2 C-a

# Erweiterte Tasten für bessere Scroll-Unterstützung
set -g extended-keys on

# =============================================================================
# PANE NAVIGATION (Bonus)
# =============================================================================
bind-key -n M-H select-pane -L
bind-key -n M-J select-pane -D
bind-key -n M-K select-pane -U
bind-key -n M-L select-pane -R

# =============================================================================
# WINDOW NAVIGATION (Bonus)
# =============================================================================
bind-key -n M-Left previous-window
bind-key -n M-Right next-window

# =============================================================================
# ALLGEMEINE EINSTELLUNGEN
# =============================================================================
set -g default-terminal "screen-256color"
set -g history-limit 10000
set -g status-interval 5

Konfiguration anwenden

# tmux-Konfiguration neu laden
tmux source-file ~/.tmux.conf

# Oder innerhalb von tmux: Prefix + :
# Dann eingeben: source-file ~/.tmux.conf

Copy-Mode Navigation (Vi-Style)

Sobald im Copy-Mode (via Alt+Space oder Prefix + [):

Geschachtelte tmux-Workflows

Szenario 1: Schnelles Scrollen (innere Session)

Inneres tmux: Mausrad oder Alt+↑/↓

Szenario 2: Äußere Session navigieren

Äußeres tmux: Prefix (C-a) dann Scroll-Tasten

Szenario 3: Von innen in die Zwischenablage kopieren

1. Alt+Space (Copy-Mode in innen öffnen)
2. Mit hjkl navigieren
3. Space zur Auswahl
4. Enter zum Kopieren

Szenario 4: Zwischen geschachtelten Sessions wechseln

Prefix + Prefix (C-a C-a) → wechselt nach außen

Häufige Probleme & Lösungen

Problem: Mausscroll funktioniert nicht

Lösung: Stelle sicher, dass set -g mouse on in der Konfiguration steht

Problem: Alt-Tasten senden Escape-Sequenzen

Lösung: set -g escape-time 0 hinzufügen und sicherstellen, dass Terminal Meta-Tasten unterstützt

Problem: Kann geschachteltes tmux nicht verlassen

Lösung: Prefix + Prefix (C-a C-a) verwenden, um äußere Session zu erreichen

Problem: Scroll-History zu kurz

Lösung: Mit set -g history-limit 10000 erhöhen (oder höher)

Deployment via Ansible

Um diese Konfiguration auf mehreren Hosts bereitzustellen:

# ansible/roles/tmux/tasks/main.yml
- name: Deploy tmux configuration
  copy:
    src: files/tmux.conf
    dest: ~/.tmux.conf
    owner: "{{ ansible_user_id }}"
    mode: '0644'
  notify: reload tmux

- name: Ensure tmux is reloaded
  command: tmux source-file ~/.tmux.conf
  ignore_errors: yes

Quick Test

Nach dem Anwenden der Konfiguration testen mit:

# 1. tmux starten
tmux

# 2. Mausscroll testen (sollte sofort funktionieren)

# 3. Alt+Up/Down testen (scrollt History)

# 4. Alt+Space testen (öffnet Copy-Mode)

# 5. Geschachtelte Session erstellen
tmux

# 6. Geschachteltes Scroll testen (Alt-Tasten funktionieren in innen, C-a C-a für außen)

Verwandte Ressourcen

• Tmux Manual
• Tmux GitHub
• Vi Mode Reference

Versionsinfo

• tmux version: 2.8+ (empfohlen für extended-keys Support)
• terminal: screen-256color oder xterm-256color
• getestet auf: Linux (Debian/Ubuntu), macOS