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## Floating Pane
39
40- Press `Alt+F` to toggle the floating pane.
41- Press `Ctrl+W` to close the active pane; if the floating pane is active, this fully releases it so the next open starts fresh.
42- Some `Alt+<key>` bindings can conflict with default WebKit shortcuts or desktop-level handlers.
43
44See [Floating Pane](./reference/floating-pane.md) for profile shortcuts and configuration.
45
46## Configuration
47
48Edit `~/.config/dumber/config.toml` or use:
49
50```bash
51dumber config open
52```
53
54See [Configuration](./config/index.md) for all options.
55
56## Launcher Integration
57
58Use with rofi or fuzzel:
59
60```bash
61dumber dmenu | rofi -dmenu -show-icons | dumber dmenu --select
62```
63
64## Website Permissions
65
66Dumber includes a built-in permissions system for camera, microphone, and screen sharing:
67
68- **Custom dialog** - Clean permission prompts replace native GTK dialogs
69- **Persistent choices** - "Always Allow" and "Always Deny" are saved per-origin
70- **Privacy-focused** - All permissions stored locally
71- **Camera & Microphone** - Fully working on Wayland/PipeWire
72
73> ⚠️ **Note**: Screen sharing does not currently work on Wayland with WebKitGTK 6.0. This is a known WebKitGTK limitation.
74
75When a website requests camera or microphone access, you'll see a permission dialog with options to allow once, always allow, deny, or always deny.
76
77See [Website Permissions](./reference/permissions.md) for details.
78
79## Crash Reporting
80
81If Dumber exits unexpectedly, crash reports are automatically generated:
82
83```bash
84# List all crash reports
85dumber crashes
86
87# View the latest crash report
88dumber crashes show latest
89
90# Generate GitHub issue payload
91dumber crashes issue latest
92```
93
94See [Session Exit Classification](./reference/session-exit-classification-runbook.md) for troubleshooting.
95
96## Next Steps
97
98- [Configuration Reference](./reference/configuration.md) - All settings
99- [Keybindings](./reference/keybindings.md) - Full keyboard shortcuts
100- [CLI Commands](./cli/index.md) - Command-line tools