garandos/cheatsheets/tmux/tmux.cheatsheet.md

Tmux on ddubsOS — Summary & Cheatsheet

🚀 Summary of modules/home/terminals/tmux.nix

⌨️ What is the Tmux Prefix?

• The prefix is a special key you press before most tmux commands, so tmux can tell them apart from regular typing.
• Notation guide used below:
  • C-x = hold Control and press x (e.g., C-a means Control+a)
  • M-x = hold Alt/Meta and press x (sometimes shown as Alt+x)
  • S-x = hold Shift and press x (often implicit for uppercase letters)
• Tmux default prefix is C-b (Control+b). In this config it’s changed to C-a (Control+a), which mirrors the historical GNU Screen workflow many users prefer.

Quick examples (with prefix = C-a):

• New window: press C-a then c

• Next window: press C-a then n

• Split horizontally: press C-a then |

• Split vertically: press C-a then -

• Resize left: press C-a then C-h (hold Control and press h)

• Program

  • tmux enabled; prefix: C-a; key mode: vi; baseIndex: 1; pane-base-index: 1
    • baseIndex: window numbering starts at 1 instead of 0
    • pane-base-index: pane numbering inside a window starts at 1 instead of 0
  • Terminal overrides RGB; terminal set to "kitty"; shell: zsh
  • Mouse: enabled; 12-hour clock; history-limit: 5000; renumber-windows: on

• Status/UX

  • Status bar at top; passthrough: on; confirmations reduced (kill-pane without prompt)

• Plugins

  • vim-tmux-navigator, sensible, catppuccin

---

🗝️ Keybindings Cheatsheet

Navigation

• Prefix h/j/k/l — select-pane Left/Down/Up/Right
• Prefix o — select next pane
• C-Tab — next-window
• C-S-Tab — previous-window
• M-Tab — new-window

Splits

• Prefix | — split-window -h (cwd)
• Prefix \ — split-window -fh (cwd)
• Prefix - — split-window -v (cwd)
• Prefix _ — split-window -fv (cwd)

Resize

• Prefix C-h/C-j/C-k/C-l — resize-pane 15 cols/rows in direction
• Prefix m — toggle zoom (resize-pane -Z)

Windows

• Prefix c — new-window
• Prefix n — next-window
• Prefix p — previous-window (note: config binds 'n' twice; intended p for previous)
• Prefix t — clock-mode
• Prefix q — display-panes
• Prefix u — refresh-client

Session/Reload

• Prefix r — source-file ~/.config/tmux/tmux.conf
• Prefix x — kill-pane (no prompt)

Popups (display-popup)

• Prefix C-y — lazygit (80%x80% at cwd)
• Prefix C-n — prompt for session name; create and switch
• Prefix C-j — switch session via fzf
• Prefix C-r — yazi (90%x90% at cwd)
• Prefix C-z — nvim ~/ddubsos/flake.nix (90%x90%)
• Prefix C-t — zsh (75%x75% at cwd)

Menu (display-menu)

• Prefix d — Dotfiles menu with quick-open entries:
  • f: flake.nix (ddubsOS)
  • c: core packages (ddubsOS)
  • g: global packages (ddubsOS)
  • k: keybinds (Hyprland)
  • w: window rules (Hyprland)
  • z: ZaneyOS flake.nix
  • p: ZaneyOS packages
  • q: Exit

Notes

• Pane/Window indices start at 1.
• Terminal passthrough and RGB enabled for truecolor.