v0.30.0 eb3068f

index.md RawHistoryFolder

Dumber Documentation

Dumber is a keyboard-driven browser for tiling window managers, built with GTK4. It uses CEF by default, with WebKitGTK available as a fallback backend.

What is Dumber?

A browser designed for Wayland compositors that works like your favorite terminal multiplexer:

  • Tiling Panes - Split, stack, and organize pages like Zellij/tmux
  • Modal Keybindings - Keyboard-driven workflow with mode indicators
  • Session Management - Auto-save and restore workspaces
  • Built-in Ad Blocking - UBlock-based network + cosmetic filtering
  • Launcher Integration - Rofi/fuzzel with favicons and history
  • GPU Rendering - Automatic VA-API detection for video playback

Quick Navigation

Getting Started

Configuration

CLI Reference

Reference

Requirements

  • Linux with Wayland (Sway, Hyprland, River, Niri, etc.)
  • GTK4, CEF for the default backend, and WebKitGTK for the fallback backend
  • GStreamer (for WebKit media playback and diagnostics)
source
1# Dumber Documentation
2
3Dumber is a keyboard-driven browser for tiling window managers, built with GTK4. It uses CEF by default, with WebKitGTK available as a fallback backend.
4
5## What is Dumber?
6
7A browser designed for Wayland compositors that works like your favorite terminal multiplexer:
8
9- **Tiling Panes** - Split, stack, and organize pages like Zellij/tmux
10- **Modal Keybindings** - Keyboard-driven workflow with mode indicators
11- **Session Management** - Auto-save and restore workspaces
12- **Built-in Ad Blocking** - UBlock-based network + cosmetic filtering
13- **Launcher Integration** - Rofi/fuzzel with favicons and history
14- **GPU Rendering** - Automatic VA-API detection for video playback
15
16## Quick Navigation
17
18### Getting Started
19
20- [Installation](./installation.md) - Install via script, Flatpak, or from source
21- [Getting Started](./getting-started.md) - First steps after installation
22
23### Configuration
24
25- [Configuration Overview](./config/index.md) - All configuration options
26- [Configuration Reference](./reference/configuration.md) - Quick reference table
27
28### CLI Reference
29
30- [CLI Commands](./cli/index.md) - All available commands
31
32### Reference
33
34- [Dependencies](./reference/dependencies.md) - System dependencies for Arch and Debian/Ubuntu
35- [Keybindings](./reference/keybindings.md) - Keyboard shortcuts reference
36- [Floating Pane](./reference/floating-pane.md) - Floating pane behavior, shortcuts, and profiles
37- [Website Permissions](./reference/permissions.md) - Camera, microphone, and screen sharing permissions
38- [Session Exit Classification](./reference/session-exit-classification-runbook.md) - Understanding crash reports
39- [Troubleshooting](./reference/troubleshooting.md) - Common issues and solutions
40
41## Requirements
42
43- Linux with Wayland (Sway, Hyprland, River, Niri, etc.)
44- GTK4, CEF for the default backend, and WebKitGTK for the fallback backend
45- GStreamer (for WebKit media playback and diagnostics)

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