1# Keybindings
2
3Dumber uses modal keybindings inspired by Zellij. Press a mode activation key, then use action keys within that mode.
4
5## Mode Activation
6
7| Mode | Key | Purpose |
8|------|-----|---------|
9| Pane Mode | `Ctrl+P` | Split, close, focus panes |
10| Tab Mode | `Ctrl+T` | Create, close, switch tabs |
11| Resize Mode | `Ctrl+N` | Resize pane splits |
12| Session Mode | `Ctrl+O` | Session management |
13
14Press `Escape` or `Enter` to exit any mode.
15
16## Pane Mode (`Ctrl+P`)
17
18| Action | Keys |
19|--------|------|
20| Split right | `→`, `R` |
21| Split left | `←`, `L` |
22| Split up | `↑`, `U` |
23| Split down | `↓`, `D` |
24| Stack pane | `S` |
25| Close pane | `X` |
26| Move to tab | `M` |
27| Move to next tab | `Shift+M` |
28| Focus right | `Shift+→`, `Shift+L` |
29| Focus left | `Shift+←`, `Shift+H` |
30| Focus up | `Shift+↑`, `Shift+K` |
31| Focus down | `Shift+↓`, `Shift+J` |
32| Consume/expel left | `[` |
33| Consume/expel right | `]` |
34| Consume/expel up | `{` |
35| Consume/expel down | `}` |
36| Confirm | `Enter` |
37| Cancel | `Escape` |
38
39## Tab Mode (`Ctrl+T`)
40
41| Action | Keys |
42|--------|------|
43| New tab | `N`, `C` |
44| Close tab | `X` |
45| Next tab | `L`, `Tab` |
46| Previous tab | `H`, `Shift+Tab` |
47| Rename tab | `R` |
48| Confirm | `Enter` |
49| Cancel | `Escape` |
50
51## Resize Mode (`Ctrl+N`)
52
53| Action | Keys |
54|--------|------|
55| Increase left | `H`, `←` |
56| Increase down | `J`, `↓` |
57| Increase up | `K`, `↑` |
58| Increase right | `L`, `→` |
59| Decrease left | `Shift+H` |
60| Decrease down | `Shift+J` |
61| Decrease up | `Shift+K` |
62| Decrease right | `Shift+L` |
63| Increase (smart) | `+`, `=` |
64| Decrease (smart) | `-` |
65| Confirm | `Enter` |
66| Cancel | `Escape` |
67
68## Session Mode (`Ctrl+O`)
69
70| Action | Keys |
71|--------|------|
72| Session manager | `S`, `W` |
73| Confirm | `Enter` |
74| Cancel | `Escape` |
75
76## Global Shortcuts
77
78These work outside modal modes:
79
80| Action | Keys |
81|--------|------|
82| Toggle floating pane | `Alt+F` |
83| Toggle History system view in right split (may conflict with the browser's default History shortcut; behavior can vary by browser) | `Ctrl+H` |
84| Toggle Favorites system view in right split | unbound by default |
85| Toggle Config system view in right split | unbound by default |
86| Close pane (or release floating pane) | `Ctrl+W` |
87| Next tab | `Ctrl+Tab` |
88| Previous tab | `Ctrl+Shift+Tab` |
89| Consume/expel left | `Alt+[` |
90| Consume/expel right | `Alt+]` |
91| Consume/expel up | `Alt+{` |
92| Consume/expel down | `Alt+}` |
93
94- `Alt+F` is the only floating-pane shortcut enabled by default.
95- `Alt+F` toggles floating visibility and keeps floating pane state intact.
96- `Ctrl+H` toggles `dumb://history`: it focuses an existing History pane, opens it in a right split if missing, or closes it when already active. Depending on the browser, the default History shortcut may intercept `Ctrl+H`, so behavior can vary.
97- `Ctrl+W` closes the active pane; when the floating pane is active, it fully releases that floating session.
98- Any URL shortcut (for example `Alt+G`) must be defined explicitly in `workspace.floating_pane.profiles`.
99- Floating profile shortcuts support modifier combos with `ctrl`, `shift`, and `alt` (for example `ctrl+shift+y` or `ctrl+alt+m`).
100
101Warning: some `Alt+<key>` combinations may conflict with default WebKit shortcuts, website handlers, or your desktop environment.
102If a shortcut does not trigger in Dumber, choose a different keybinding.
103
104For details, see [Floating Pane](./floating-pane.md).
105
106## Customization
107
108All keybindings can be customized in `~/.config/dumber/config.toml`:
109
110```toml
111[workspace.pane_mode.actions]
112split-right = ["arrowright", "r"]
113close-pane = ["x", "q"]
114
115[workspace.shortcuts.actions.close-pane]
116keys = ["ctrl+w"]
117
118[workspace.shortcuts.actions.toggle-floating-pane]
119keys = ["alt+f"]
120
121[workspace.shortcuts.actions.toggle-history-systemview]
122keys = ["ctrl+h"]
123
124[workspace.shortcuts.actions.toggle-favorites-systemview]
125keys = []
126
127[workspace.shortcuts.actions.toggle-config-systemview]
128keys = []
129
130[workspace.floating_pane]
131width_pct = 0.82
132height_pct = 0.72
133
134[workspace.floating_pane.profiles.google]
135keys = ["alt+g"]
136url = "https://google.com"
137
138[workspace.floating_pane.profiles.github]
139keys = ["alt+h"]
140url = "https://github.com"
141```
142
143See [Configuration](../config/index.md) for full details.