1# Dumber
2
3[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT) [![Go Report Card](https://goreportcard.com/badge/github.com/bnema/dumber)](https://goreportcard.com/report/github.com/bnema/dumber)
4
5A TTY-inspired web browser multiplexer for tiling window managers.
6
7- Website: [dumber.bnema.dev](https://dumber.bnema.dev)
8- Documentation: [dumber.bnema.dev/docs](https://dumber.bnema.dev/docs)
9
10---
11
12## What is Dumber?
13
14Dumber is a web browser that works like your terminal multiplexer. Tabs hold workspaces. Workspaces hold panes. Panes split and stack like Zellij.
15
16https://github.com/user-attachments/assets/232822af-08e4-4a74-9416-87f79c96b118
17
18
19
20**Features:**
21- Zellij-style panes with modal keyboard navigation
22- Floating workspace pane with profile shortcuts
23- Wayland native (Sway, Hyprland, River, Niri)
24- Session resurrection with auto-snapshots
25- Built-in ad blocking (uBlock-based)
26- GPU accelerated video (VA-API/VDPAU)
27- Launcher integration (rofi/fuzzel/dmenu)
28- Search bangs (!g, !gi, !ddg)
29- Single config.toml with hot reload
30
31## Documentation
32
33Full documentation is available at **[dumber.bnema.dev](https://dumber.bnema.dev)**
34
35- [Documentation](https://dumber.bnema.dev/docs) - Installation, configuration, CLI reference
36- [Keybindings](https://dumber.bnema.dev/docs/reference/keybindings) - Keyboard shortcuts
37
38## Quick Start
39
40```bash
41# Install
42curl -fsSL https://dumber.bnema.dev/install | sh
43
44# Launch
45dumber browse
46```
47
48### Arch Linux (AUR)
49
50```bash
51yay -S dumber-browser-bin   # Pre-built binary
52yay -S dumber-browser-git   # Build from source
53```
54
55### Flatpak
56
57```bash
58wget https://github.com/bnema/dumber/releases/latest/download/dumber.flatpak
59flatpak install --user dumber.flatpak
60flatpak run dev.bnema.Dumber browse
61```
62
63### Dependencies
64
65**Arch Linux:**
66
67```bash
68sudo pacman -S webkitgtk-6.0 gtk4 gst-plugins-base gst-plugins-good gst-plugins-bad gst-plugin-va
69```
70
71**Debian/Ubuntu:**
72
73```bash
74sudo apt install libwebkitgtk-6.0-4 libgtk-4-1 gstreamer1.0-plugins-base gstreamer1.0-plugins-good gstreamer1.0-plugins-bad
75```
76
77> ⚠️ Ubuntu 24.04 ships GLib 2.80, but Dumber requires GLib 2.84+. Use Arch, Fedora 41+, or the Flatpak.
78
79## Keyboard-Driven
80
81Four modal modes. Enter a mode, act, escape out. Vim and Zellij users already know this pattern.
82
83| Mode | Key | Actions |
84|------|-----|---------|
85| Pane | `Ctrl+P` | Split · Stack · Close · Move |
86| Tab | `Ctrl+T` | New · Close · Switch · Rename |
87| Resize | `Ctrl+N` | Grow · Shrink · hjkl/arrows |
88| Session | `Ctrl+O` | Save · Restore · Browse |
89
90## Floating Pane
91
92- `Alt+F` toggles the floating pane and preserves its state while hidden.
93- `Ctrl+W` closes the active pane; if the floating pane is active, it is fully released for a fresh next open.
94- Profile shortcuts like `Alt+G` are optional and configured under `workspace.floating_pane.profiles`.
95- Some `Alt+<key>` bindings may conflict with default WebKit shortcuts or desktop-level handlers.
96
97See [Floating Pane Reference](https://dumber.bnema.dev/docs/reference/floating-pane) for setup and behavior details.
98
99## Development
100
101Dumber uses pure-Go bindings (no CGO) but requires GTK4/WebKitGTK runtime libraries for the GUI.
102
103### Environment
104
105Set `ENV=dev` to use `.dev/dumber/` for config/data instead of XDG paths.
106
107### Build From Source
108
109**Prerequisites:**
110- Go 1.25+
111- Node.js 20+ (for frontend assets)
112- WebKitGTK 6.0 and GTK4 dev packages
113
114```bash
115git clone https://github.com/bnema/dumber
116cd dumber
117make build
118./dist/dumber browse
119```
120
121### Make Targets
122
123| Target | Description |
124|--------|-------------|
125| `make build` | Build frontend + binary |
126| `make build-quick` | Build binary only (skip frontend) |
127| `make dev` | Run with `go run` |
128| `make test` | Run tests |
129| `make lint` | Run golangci-lint |
130| `make flatpak-build` | Build Flatpak bundle |
131
132## Contributing
133
134We welcome bug fixes, performance/stability improvements, and WebUI/UX enhancements. We're not accepting new feature PRs.
135
136**All PRs must target the `next` branch.** We test there first before releasing to `main`.
137
138See [CONTRIBUTING.md](CONTRIBUTING.md) for details.
139
140## Community
141
142- [Report bugs](https://github.com/bnema/dumber/issues)
143- [Releases](https://github.com/bnema/dumber/releases)
144
145## License
146
147MIT - See `LICENSE` for details.