Tmux Configuration Reference
Custom tmux setup with global keybind toggle and Wayland integration.
Prefix Keys
| Key | Type |
|---|---|
Ctrl-Space |
Primary prefix |
Ctrl-b |
Fallback prefix |
prefix + r |
Reload configuration |
Global Toggle System
| Keybind | Action |
|---|---|
Ctrl-g |
Toggle ALL custom keybinds on/off |
When OFF: All custom binds disabled, keys pass through to applications
When ON: Custom tmux binds active (default state)
Window (Tab) Management
| Keybind | Action |
|---|---|
Ctrl-t |
New window |
Ctrl-w |
Close window (with confirmation) |
Ctrl-Alt-Left |
Previous window |
Ctrl-Alt-Right |
Next window |
Pane Management
Create Panes:
| Keybind | Action |
|---|---|
Alt-\ |
Split vertically (left/right) |
| `Alt- | ` |
Close Panes:
| Keybind | Action |
|---|---|
Alt-Shift-W |
Kill pane (with confirmation) |
Ctrl-Alt-w |
Kill pane (backup binding) |
Navigate Panes:
| Keybind | Action |
|---|---|
Ctrl-Alt-Left |
Focus left pane |
Ctrl-Alt-Right |
Focus right pane |
Ctrl-Alt-Up |
Focus up pane |
Ctrl-Alt-Down |
Focus down pane |
Resize Panes:
| Keybind | Action |
|---|---|
Ctrl-Alt-Shift-Left |
Resize left (5 units) |
Ctrl-Alt-Shift-Right |
Resize right (5 units) |
Ctrl-Alt-Shift-Up |
Resize up (2 units) |
Ctrl-Alt-Shift-Down |
Resize down (2 units) |
Copy Mode (Vi-style)
Clipboard Integration (Wayland):
| Keybind | Action |
|---|---|
y |
Copy and exit copy-mode |
Y |
Copy and stay in copy-mode |
| Mouse drag | Copy without exiting copy-mode |
Plugin Keybinds
Your installed plugins and their default keybinds:
| Plugin | Keybind | Action |
|---|---|---|
| tmux-yank | prefix + y |
Copy command line to clipboard |
y (copy-mode) |
Yank selection | |
| tmux-copycat | prefix + / |
Regex search |
prefix + Ctrl-f |
Search files | |
prefix + Ctrl-g |
Search git files | |
prefix + Ctrl-u |
Search URLs | |
prefix + Ctrl-d |
Search numbers | |
prefix + Alt-h |
Search SHA hashes | |
prefix + Alt-i |
Search IP addresses | |
| tmux-open | o (copy-mode) |
Open highlighted path/URL |
Ctrl-o (copy-mode) |
Open in $EDITOR | |
| tmux-fzf | prefix + F |
FZF session/window/pane picker |
| tmux-fzf-url | prefix + u |
FZF URL picker |
| tmux-resurrect | prefix + Ctrl-s |
Save session |
prefix + Ctrl-r |
Restore session | |
| tmux-continuum | (automatic) | Auto-save every 15 min |
| TPM | prefix + I |
Install plugins |
prefix + U |
Update plugins | |
prefix + Alt-u |
Uninstall removed plugins |
Configuration Features
Options:
- Vi-mode keys enabled
- Mouse support enabled
- 100,000 line history
- Windows/panes start at index 1
- Auto-renumber windows
- Fast escape time (10ms)
- Wayland clipboard integration via wl-copy
Modular Structure:
~/.tmux.conf- Main entry point~/.tmux.d/10-options.conf- General options~/.tmux.d/20-keys.conf- Custom keybinds~/.tmux.d/30-mouse.conf- Mouse settings~/.tmux.d/40-status-theme.conf- Status bar~/.tmux.d/50-plugins.conf- Plugin configuration~/.tmux.local.conf- Local overrides
Special Features:
- All custom keybinds can be globally toggled with
Ctrl-g - When disabled, keys pass through to applications
- Wayland clipboard integration with wl-copy
- Auto-restore sessions on tmux startup
View source
| 1 | # Tmux Configuration Reference |
| 2 | |
| 3 | Custom tmux setup with global keybind toggle and Wayland integration. |
| 4 | |
| 5 | ## Prefix Keys |
| 6 | |
| 7 | | Key | Type | |
| 8 | |-----|------| |
| 9 | | `Ctrl-Space` | Primary prefix | |
| 10 | | `Ctrl-b` | Fallback prefix | |
| 11 | | `prefix + r` | Reload configuration | |
| 12 | |
| 13 | ## Global Toggle System |
| 14 | |
| 15 | | Keybind | Action | |
| 16 | |---------|--------| |
| 17 | | `Ctrl-g` | Toggle ALL custom keybinds on/off | |
| 18 | |
| 19 | **When OFF:** All custom binds disabled, keys pass through to applications |
| 20 | **When ON:** Custom tmux binds active (default state) |
| 21 | |
| 22 | ## Window (Tab) Management |
| 23 | |
| 24 | | Keybind | Action | |
| 25 | |---------|--------| |
| 26 | | `Ctrl-t` | New window | |
| 27 | | `Ctrl-w` | Close window (with confirmation) | |
| 28 | | `Ctrl-Alt-Left` | Previous window | |
| 29 | | `Ctrl-Alt-Right` | Next window | |
| 30 | |
| 31 | ## Pane Management |
| 32 | |
| 33 | **Create Panes:** |
| 34 | | Keybind | Action | |
| 35 | |---------|--------| |
| 36 | | `Alt-\` | Split vertically (left/right) | |
| 37 | | `Alt-|` | Split horizontally (top/bottom) | |
| 38 | |
| 39 | **Close Panes:** |
| 40 | | Keybind | Action | |
| 41 | |---------|--------| |
| 42 | | `Alt-Shift-W` | Kill pane (with confirmation) | |
| 43 | | `Ctrl-Alt-w` | Kill pane (backup binding) | |
| 44 | |
| 45 | **Navigate Panes:** |
| 46 | | Keybind | Action | |
| 47 | |---------|--------| |
| 48 | | `Ctrl-Alt-Left` | Focus left pane | |
| 49 | | `Ctrl-Alt-Right` | Focus right pane | |
| 50 | | `Ctrl-Alt-Up` | Focus up pane | |
| 51 | | `Ctrl-Alt-Down` | Focus down pane | |
| 52 | |
| 53 | **Resize Panes:** |
| 54 | | Keybind | Action | |
| 55 | |---------|--------| |
| 56 | | `Ctrl-Alt-Shift-Left` | Resize left (5 units) | |
| 57 | | `Ctrl-Alt-Shift-Right` | Resize right (5 units) | |
| 58 | | `Ctrl-Alt-Shift-Up` | Resize up (2 units) | |
| 59 | | `Ctrl-Alt-Shift-Down` | Resize down (2 units) | |
| 60 | |
| 61 | ## Copy Mode (Vi-style) |
| 62 | |
| 63 | **Clipboard Integration (Wayland):** |
| 64 | | Keybind | Action | |
| 65 | |---------|--------| |
| 66 | | `y` | Copy and exit copy-mode | |
| 67 | | `Y` | Copy and stay in copy-mode | |
| 68 | | Mouse drag | Copy without exiting copy-mode | |
| 69 | |
| 70 | ## Plugin Keybinds |
| 71 | |
| 72 | Your installed plugins and their default keybinds: |
| 73 | |
| 74 | | Plugin | Keybind | Action | |
| 75 | |--------|---------|--------| |
| 76 | | **tmux-yank** | `prefix + y` | Copy command line to clipboard | |
| 77 | | | `y` (copy-mode) | Yank selection | |
| 78 | | **tmux-copycat** | `prefix + /` | Regex search | |
| 79 | | | `prefix + Ctrl-f` | Search files | |
| 80 | | | `prefix + Ctrl-g` | Search git files | |
| 81 | | | `prefix + Ctrl-u` | Search URLs | |
| 82 | | | `prefix + Ctrl-d` | Search numbers | |
| 83 | | | `prefix + Alt-h` | Search SHA hashes | |
| 84 | | | `prefix + Alt-i` | Search IP addresses | |
| 85 | | **tmux-open** | `o` (copy-mode) | Open highlighted path/URL | |
| 86 | | | `Ctrl-o` (copy-mode) | Open in $EDITOR | |
| 87 | | **tmux-fzf** | `prefix + F` | FZF session/window/pane picker | |
| 88 | | **tmux-fzf-url** | `prefix + u` | FZF URL picker | |
| 89 | | **tmux-resurrect** | `prefix + Ctrl-s` | Save session | |
| 90 | | | `prefix + Ctrl-r` | Restore session | |
| 91 | | **tmux-continuum** | *(automatic)* | Auto-save every 15 min | |
| 92 | | **TPM** | `prefix + I` | Install plugins | |
| 93 | | | `prefix + U` | Update plugins | |
| 94 | | | `prefix + Alt-u` | Uninstall removed plugins | |
| 95 | |
| 96 | ## Configuration Features |
| 97 | |
| 98 | **Options:** |
| 99 | - Vi-mode keys enabled |
| 100 | - Mouse support enabled |
| 101 | - 100,000 line history |
| 102 | - Windows/panes start at index 1 |
| 103 | - Auto-renumber windows |
| 104 | - Fast escape time (10ms) |
| 105 | - Wayland clipboard integration via wl-copy |
| 106 | |
| 107 | **Modular Structure:** |
| 108 | - `~/.tmux.conf` - Main entry point |
| 109 | - `~/.tmux.d/10-options.conf` - General options |
| 110 | - `~/.tmux.d/20-keys.conf` - Custom keybinds |
| 111 | - `~/.tmux.d/30-mouse.conf` - Mouse settings |
| 112 | - `~/.tmux.d/40-status-theme.conf` - Status bar |
| 113 | - `~/.tmux.d/50-plugins.conf` - Plugin configuration |
| 114 | - `~/.tmux.local.conf` - Local overrides |
| 115 | |
| 116 | **Special Features:** |
| 117 | - All custom keybinds can be globally toggled with `Ctrl-g` |
| 118 | - When disabled, keys pass through to applications |
| 119 | - Wayland clipboard integration with wl-copy |
| 120 | - Auto-restore sessions on tmux startup |