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
16Keybinding tables use uppercase letters as visual labels for unshifted letter keys. In config, use lowercase (for example, `["w"]` for Pane Mode eject). Shifted keys are shown with an explicit `Shift+` prefix.
17
18## Pane Mode (`Ctrl+P`)
19
20| Action | Keys |
21|--------|------|
22| Split right | `→`, `R` |
23| Split left | `←`, `L` |
24| Split up | `↑`, `U` |
25| Split down | `↓`, `D` |
26| Stack pane | `S` |
27| Close pane | `X` |
28| Move to tab | `M` |
29| Move to next tab | `Shift+M` |
30| Eject to window | `W` |
31| Focus right | `Shift+→`, `Shift+L` |
32| Focus left | `Shift+←`, `Shift+H` |
33| Focus up | `Shift+↑`, `Shift+K` |
34| Focus down | `Shift+↓`, `Shift+J` |
35| Consume/expel left | `[` |
36| Consume/expel right | `]` |
37| Consume/expel up | `{` |
38| Consume/expel down | `}` |
39| Confirm | `Enter` |
40| Cancel | `Escape` |
41
42## Tab Mode (`Ctrl+T`)
43
44| Action | Keys |
45|--------|------|
46| New tab | `N`, `C` |
47| Close tab | `X` |
48| Next tab | `L`, `Tab` |
49| Previous tab | `H`, `Shift+Tab` |
50| Rename tab | `R` |
51| Confirm | `Enter` |
52| Cancel | `Escape` |
53
54## Resize Mode (`Ctrl+N`)
55
56| Action | Keys |
57|--------|------|
58| Increase left | `H`, `←` |
59| Increase down | `J`, `↓` |
60| Increase up | `K`, `↑` |
61| Increase right | `L`, `→` |
62| Decrease left | `Shift+H` |
63| Decrease down | `Shift+J` |
64| Decrease up | `Shift+K` |
65| Decrease right | `Shift+L` |
66| Increase (smart) | `+`, `=` |
67| Decrease (smart) | `-` |
68| Confirm | `Enter` |
69| Cancel | `Escape` |
70
71## Session Mode (`Ctrl+O`)
72
73| Action | Keys |
74|--------|------|
75| Session manager | `S`, `W` |
76| Confirm | `Enter` |
77| Cancel | `Escape` |
78
79## Global Shortcuts
80
81These work outside modal modes:
82
83| Action | Keys |
84|--------|------|
85| Toggle floating pane | `Alt+F` |
86| Toggle History sidebar (native GTK sidebar panel only). Ctrl+H may conflict with the browser's default History shortcut; behavior can vary by browser. | `Ctrl+H` |
87| Toggle Favorites system view in right split | unbound by default |
88| Toggle Config system view in right split | unbound by default |
89| Close pane (or release floating pane) | `Ctrl+W` |
90| Next tab | `Ctrl+Tab` |
91| Previous tab | `Ctrl+Shift+Tab` |
92| Consume/expel left | `Alt+[` |
93| Consume/expel right | `Alt+]` |
94| Consume/expel up | `Alt+{` |
95| Consume/expel down | `Alt+}` |
96
97- `Alt+F` is the only floating-pane shortcut enabled by default.
98- `Alt+F` toggles floating visibility and keeps floating pane state intact.
99- `Ctrl+H` toggles the native GTK history sidebar. The sidebar shows browsing history grouped by day with search/filter, keyboard navigation (arrows, Home/End, Ctrl+arrows for day jumps), and activation modes (Enter to navigate while keeping the sidebar open, Ctrl+Enter to navigate while keeping the sidebar open, Shift+Enter to open in a new split). If the native sidebar is unavailable, the shortcut returns an error instead of falling back to `dumb://history`.
100- `Ctrl+W` closes the active pane; when the floating pane is active, it fully releases that floating session.
101- Any URL shortcut (for example `Alt+G`) must be defined explicitly in `workspace.floating_pane.profiles`.
102- Floating profile shortcuts support modifier combos with `ctrl`, `shift`, and `alt` (for example `ctrl+shift+y` or `ctrl+alt+m`).
103
104Warning: some `Alt+<key>` combinations may conflict with browser-engine shortcuts, website handlers, or your desktop environment.
105If a shortcut does not trigger in Dumber, choose a different keybinding.
106
107For details, see [Floating Pane](./floating-pane.md).
108
109## Customization
110
111All keybindings can be customized in `~/.config/dumber/config.toml`:
112
113```toml
114[workspace.pane_mode.actions]
115split-right = ["arrowright", "r"]
116close-pane = ["x", "q"]
117
118[workspace.shortcuts.actions.close-pane]
119keys = ["ctrl+w"]
120
121[workspace.shortcuts.actions.toggle-floating-pane]
122keys = ["alt+f"]
123
124[workspace.shortcuts.actions.toggle-history-systemview]
125keys = ["ctrl+h"]
126
127[workspace.shortcuts.actions.toggle-favorites-systemview]
128keys = []
129
130[workspace.shortcuts.actions.toggle-config-systemview]
131keys = []
132
133[workspace.floating_pane]
134width_pct = 0.82
135height_pct = 0.72
136
137[workspace.floating_pane.profiles.google]
138keys = ["alt+g"]
139url = "https://google.com"
140
141[workspace.floating_pane.profiles.github]
142keys = ["alt+h"]
143url = "https://github.com"
144```
145
146See [Configuration](../config/index.md) for full details.