# 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.