v0.26.2 3cd9d2e

getting-started.md RawHistoryFolder

Getting Started

Launch the Browser

dumber browse

Or use the desktop entry after running dumber setup.

Basic Navigation

Dumber uses modal keybindings inspired by Zellij:

Mode Activation Purpose
Pane Mode Ctrl+P Split, close, focus panes
Tab Mode Ctrl+T Create, close, switch tabs
Resize Mode Ctrl+N Resize pane splits
Session Mode Ctrl+O Session management

Press Escape or Enter to exit any mode.

Pane Mode Quick Reference

  1. Press Ctrl+P to enter pane mode
  2. Use arrow keys or hjkl to split in that direction
  3. Shift+arrows to focus adjacent panes
  4. X to close current pane

Omnibox

Press Ctrl+L to open the omnibox for:

  • URL navigation
  • Search (uses default search engine)
  • Bang shortcuts (!g query for Google, !gh query for GitHub)

Configuration

Edit ~/.config/dumber/config.toml or use:

dumber config open

See Configuration for all options.

Launcher Integration

Use with rofi or fuzzel:

dumber dmenu | rofi -dmenu -show-icons | dumber dmenu --select

Next Steps

source
1# Getting Started
2
3## Launch the Browser
4
5```bash
6dumber browse
7```
8
9Or use the desktop entry after running `dumber setup`.
10
11## Basic Navigation
12
13Dumber uses modal keybindings inspired by Zellij:
14
15| Mode | Activation | Purpose |
16|------|------------|---------|
17| Pane Mode | `Ctrl+P` | Split, close, focus panes |
18| Tab Mode | `Ctrl+T` | Create, close, switch tabs |
19| Resize Mode | `Ctrl+N` | Resize pane splits |
20| Session Mode | `Ctrl+O` | Session management |
21
22Press `Escape` or `Enter` to exit any mode.
23
24## Pane Mode Quick Reference
25
261. Press `Ctrl+P` to enter pane mode
272. Use arrow keys or `hjkl` to split in that direction
283. `Shift+arrows` to focus adjacent panes
294. `X` to close current pane
30
31## Omnibox
32
33Press `Ctrl+L` to open the omnibox for:
34- URL navigation
35- Search (uses default search engine)
36- Bang shortcuts (`!g query` for Google, `!gh query` for GitHub)
37
38## Configuration
39
40Edit `~/.config/dumber/config.toml` or use:
41
42```bash
43dumber config open
44```
45
46See [Configuration](./config/index.md) for all options.
47
48## Launcher Integration
49
50Use with rofi or fuzzel:
51
52```bash
53dumber dmenu | rofi -dmenu -show-icons | dumber dmenu --select
54```
55
56## Next Steps
57
58- [Configuration Reference](./config/reference.md) - All settings
59- [Keybindings](./reference/keybindings.md) - Full keyboard shortcuts
60- [CLI Commands](./cli/index.md) - Command-line tools

Keyboard shortcuts

Single-key shortcuts are on. ctrl k and esc work whatever this says.

ctrl k :
go to a section, branch, tag, file or repository
?
this list
j k
move the row cursor down / up
enter
open the row under the cursor; on Files, a directory opens or closes in place
↑ ↓ ← → home end
in the file tree (focus on a row): previous / next row, close / open a directory or go to its parent / first entry, first / last row. They never open a file
l h
on Files: open a directory or a file / close a directory or go up to its parent, then to the parent page. Elsewhere: into the side panel (on a merge request, its files) / back to the content; there j k move between its controls
g g G
first / last row
/
filter the list; on Files, find a file anywhere in the repository (esc clears, enter opens the best match)
b
switch branch or tag
g s g f g c g b g m g i g r g a
tabs: summary, files, commits, branches & tags, merge requests, issues, releases, actions (when available)
g h
home
w
wide mode: use the whole width of the screen, or not (remembered)
y
copy a permalink pinned to the commit
d u x
diff: split / unified / collapse or expand all
e E
diff: the whole file in view / every file, with the lines the hunks hide
n
merge request: next note in the diff
esc
close a dialog, leave a field

Branches 8

Tags 42

↑↓ moveenter openesc close