CONFIG.md Raw History Folder

Configuration Reference

Primary format: TOML (recommended) Location: ~/.config/dumber/config.toml Also supports: JSON (.json) and YAML (.yaml) JSON Schema: ~/.config/dumber/config.schema.json (auto-generated for JSON format)

Why TOML?

TOML is the recommended format for dumber configuration because:

Clear structure: Explicit sections make complex configs easy to read and modify
No ambiguity: No whitespace sensitivity or type coercion issues
Comments supported: Add documentation directly in your config
Industry standard: Used by Cargo, Hugo, and many modern tools

You can still use JSON or YAML if you prefer - dumber automatically detects the format.

Database

Key	Type	Default	Description
`database.path`	string	`~/.local/share/dumber/dumber.db`	Database file path

History

Key	Type	Default	Valid Values	Description
`history.max_entries`	int	`10000`	> 0	Maximum number of history entries
`history.retention_period_days`	int	`365`	> 0	Days to keep history (1 year)
`history.cleanup_interval_days`	int	`1`	> 0	How often to run cleanup

Search Configuration

Key	Type	Default	Description
`default_search_engine`	string	`"https://duckduckgo.com/?q=%s"`	Default search engine URL template (must contain `%s` placeholder)
`search_shortcuts`	map	See defaults	Map of shortcut aliases to URLs

Example:

# Default search engine - used when no shortcut is specified
default_search_engine = "https://duckduckgo.com/?q=%s"

# Alternative search engines:
# default_search_engine = "https://www.google.com/search?q=%s"
# default_search_engine = "https://www.startpage.com/search?q=%s"
# default_search_engine = "https://search.brave.com/search?q=%s"

Default shortcuts (usage: !shortcut query):

# Examples:
#   !ddg golang      → DuckDuckGo search for "golang"
#   !g rust tutorial → Google search for "rust tutorial"
#   !gi cats         → Google Images search for "cats"
#   !gh opencode     → GitHub search for "opencode"
#   !yt music video  → YouTube search for "music video"

[search_shortcuts.ddg]
url = "https://duckduckgo.com/?q=%s"
description = "DuckDuckGo search"

[search_shortcuts.g]
url = "https://google.com/search?q=%s"
description = "Google Search"

[search_shortcuts.gi]
url = "https://google.com/search?tbm=isch&q=%s"
description = "Google Images"

[search_shortcuts.gh]
url = "https://github.com/search?q=%s"
description = "GitHub"

[search_shortcuts.yt]
url = "https://youtube.com/results?search_query=%s"
description = "YouTube"

Dmenu / Launcher

These settings control the dumber dmenu CLI command for rofi/fuzzel integration.

Key	Type	Default	Description
`dmenu.max_history_days`	int	`30`	Number of days of history to show (0 = all)
`dmenu.show_visit_count`	bool	`true`	Show visit counts in output
`dmenu.show_last_visited`	bool	`true`	Show last visited dates in output
`dmenu.history_prefix`	string	`"🕒"`	Prefix for history items
`dmenu.shortcut_prefix`	string	`"🔍"`	Prefix for shortcuts
`dmenu.url_prefix`	string	`"🌐"`	Prefix for URLs
`dmenu.date_format`	string	`"2006-01-02 15:04"`	Go time format string
`dmenu.sort_by_visit_count`	bool	`true`	Sort by visit count instead of recency

CLI Usage:

# Pipe mode (default) - outputs history for rofi/fuzzel with favicons
dumber dmenu | rofi -dmenu -show-icons -p "Browse: " | dumber dmenu --select
dumber dmenu | fuzzel --dmenu -p "Browse: " | dumber dmenu --select

# Interactive TUI mode
dumber dmenu --interactive

# Override history days via CLI flag (show last 7 days)
dumber dmenu --days 7

# Sort by most visited instead of recency
dumber dmenu --most-visited

# Combined: most visited from last 14 days
dumber dmenu --days 14 --most-visited

Omnibox

Key	Type	Default	Valid Values	Description
`omnibox.initial_behavior`	string	`"recent"`	`recent`, `most_visited`, `none`	Initial history display behavior
`omnibox.auto_open_on_new_pane`	bool	`false`	-	Automatically open the omnibox after creating a new pane

Example:

[omnibox]
initial_behavior = "recent"  # Show recent history when omnibox opens
auto_open_on_new_pane = false

# Alternative options:
# initial_behavior = "most_visited"  # Show most visited sites
# initial_behavior = "none"          # Show no initial suggestions

Logging

Key	Type	Default	Valid Values	Description
`logging.level`	string	`"info"`	`debug`, `info`, `warn`, `error`	Log level
`logging.format`	string	`"text"`	`text`, `json`	Log format
`logging.max_age`	int	`7`	>= 0	Days to keep logs
`logging.log_dir`	string	`~/.local/state/dumber/logs/`	any	Log directory
`logging.enable_file_log`	bool	`true`	-	Enable file logging
`logging.capture_console`	bool	`false`	-	Capture browser console to logs
`logging.capture_gtk_webkit_logs`	bool	`false`	-	Capture GTK and WebKit logs for debugging

Appearance

Key	Type	Default	Description
`appearance.sans_font`	string	`"Fira Sans"`	Sans-serif font
`appearance.serif_font`	string	`"Fira Sans"`	Serif font
`appearance.monospace_font`	string	`"Fira Code"`	Monospace font
`appearance.default_font_size`	int	`16`	Font size in points
`appearance.color_scheme`	string	`"default"`	`prefer-dark`, `prefer-light`, `default`

Color Palettes

Light palette:

[appearance.light_palette]
background = "#f8f8f8"
surface = "#f2f2f2"
surface_variant = "#ececec"
text = "#1a1a1a"
muted = "#6e6e6e"
accent = "#404040"
border = "#d2d2d2"

Dark palette:

[appearance.dark_palette]
background = "#0e0e0e"
surface = "#1a1a1a"
surface_variant = "#141414"
text = "#e4e4e4"
muted = "#848484"
accent = "#a8a8a8"
border = "#363636"

Debug Options

Key	Type	Default	Description
`debug.enable_devtools`	bool	`true`	Enable browser developer tools (F12, Inspect Element)

Rendering, UI Scale & Zoom

Key	Type	Default	Valid Values	Description
`rendering.mode`	string	`"gpu"`	`auto`, `gpu`, `cpu`	WebKit hardware acceleration policy
`rendering.disable_dmabuf_renderer`	bool	`false`	-	Disable WebKit DMA-BUF renderer (may fix flicker on Wayland; slower)
`rendering.force_compositing_mode`	bool	`false`	-	Force WebKit compositing mode (`WEBKIT_FORCE_COMPOSITING_MODE`)
`rendering.disable_compositing_mode`	bool	`false`	-	Disable WebKit compositing mode (`WEBKIT_DISABLE_COMPOSITING_MODE`)
`rendering.gsk_renderer`	string	`"auto"`	`auto`, `opengl`, `vulkan`, `cairo`	GTK renderer selection (`GSK_RENDERER`)
`rendering.disable_mipmaps`	bool	`false`	-	Disable GTK mipmaps (`GSK_GPU_DISABLE=mipmap`)
`rendering.prefer_gl`	bool	`false`	-	Prefer OpenGL over GLES (`GDK_DEBUG=gl-prefer-gl`)
`rendering.draw_compositing_indicators`	bool	`false`	-	Draw WebKit compositing indicators (debug)
`rendering.show_fps`	bool	`false`	-	Show WebKit FPS counter (`WEBKIT_SHOW_FPS`)
`rendering.sample_memory`	bool	`false`	-	Enable WebKit memory sampling (`WEBKIT_SAMPLE_MEMORY`)
`rendering.debug_frames`	bool	`false`	-	Enable GTK frame timing debug (`GDK_DEBUG=frames`)
`default_ui_scale`	float	`1.0`	> 0	GTK widget UI scale (1.0=100%, 2.0=200%)
`default_webpage_zoom`	float	`1.2`	> 0	Default page zoom (1.0=100%, 1.2=120%)

Workspace Configuration

General

Key	Type	Default	Description
`workspace.new_pane_url`	string	`"about:blank"`	URL loaded for new panes/tabs (supports `http(s)://`, `dumb://`, `file://`, `about:`)
`workspace.switch_to_tab_on_move`	bool	`true`	When moving a pane to another tab, automatically switch to the destination tab

Example:

[workspace]
new_pane_url = "dumb://home"

Pane Mode

Key	Type	Default	Description
`workspace.pane_mode.activation_shortcut`	string	`"ctrl+p"`	Pane mode activation key
`workspace.pane_mode.timeout_ms`	int	`3000`	Pane mode timeout (ms)
`workspace.pane_mode.actions`	map	See below	Action→keys mappings

Default pane mode actions:

[workspace.pane_mode.actions]
split-right = ["arrowright", "r"]
split-left = ["arrowleft", "l"]
split-up = ["arrowup", "u"]
split-down = ["arrowdown", "d"]
stack-pane = ["s"]
close-pane = ["x"]
move-pane-to-tab = ["m"]
move-pane-to-next-tab = ["M", "shift+m"]

# Consume-or-expel (niri-style) - very alpha
consume-or-expel-left = ["["]
consume-or-expel-right = ["]"]
consume-or-expel-up = ["{"]
consume-or-expel-down = ["}"]

focus-right = ["shift+arrowright", "shift+l"]
focus-left = ["shift+arrowleft", "shift+h"]
focus-up = ["shift+arrowup", "shift+k"]
focus-down = ["shift+arrowdown", "shift+j"]
confirm = ["enter"]
cancel = ["escape"]

Note: Actions are inverted to key→action map in memory for O(1) lookup performance during navigation.

Tab Mode

Key	Type	Default	Description
`workspace.tab_mode.activation_shortcut`	string	`"ctrl+t"`	Tab mode activation key
`workspace.tab_mode.timeout_ms`	int	`3000`	Tab mode timeout (ms)
`workspace.tab_mode.actions`	map	See below	Action→keys mappings

Default tab mode actions:

[workspace.tab_mode.actions]
new-tab = ["n", "c"]
close-tab = ["x"]
next-tab = ["l", "tab"]
previous-tab = ["h", "shift+tab"]
rename-tab = ["r"]
confirm = ["enter"]
cancel = ["escape"]

Note: Actions are inverted to key→action map in memory for O(1) lookup performance during navigation.

Resize Mode

Key	Type	Default	Description
`workspace.resize_mode.activation_shortcut`	string	`"ctrl+n"`	Resize mode activation key
`workspace.resize_mode.timeout_ms`	int	`3000`	Resize mode timeout (ms)
`workspace.resize_mode.step_percent`	float	`5.0`	Split ratio step per keystroke (percent)
`workspace.resize_mode.min_pane_percent`	float	`10.0`	Minimum pane size (percent)
`workspace.resize_mode.actions`	map	See below	Action→keys mappings

Default resize mode actions:

[workspace.resize_mode.actions]
resize-increase-left = ["h", "arrowleft"]
resize-increase-down = ["j", "arrowdown"]
resize-increase-up = ["k", "arrowup"]
resize-increase-right = ["l", "arrowright"]
resize-decrease-left = ["H"]
resize-decrease-down = ["J"]
resize-decrease-up = ["K"]
resize-decrease-right = ["L"]
resize-increase = ["+", "="]
resize-decrease = ["-"]
confirm = ["enter"]
cancel = ["escape"]

Notes:

Directional actions (resize-increase-*/resize-decrease-*) move the split divider.
Smart actions (resize-increase / resize-decrease) grow/shrink the active pane (best-effort) by picking a direction automatically.
Timeout is refreshed on each resize keypress so you can keep adjusting without re-entering the mode.

Global Shortcuts

Global shortcuts are configured under workspace.shortcuts.actions using the same ActionBinding structure as modal keybindings:

Action	Default Keys	Description
`close_pane`	`ctrl+w`	Close active pane (closes tab if last pane)
`next_tab`	`ctrl+tab`	Switch to next tab
`previous_tab`	`ctrl+shift+tab`	Switch to previous tab
`consume_or_expel_left`	`alt+[`	Consume into left sibling stack, or expel left if stacked
`consume_or_expel_right`	`alt+]`	Consume into right sibling stack, or expel right if stacked
`consume_or_expel_up`	`alt+{`	Consume into upper sibling stack, or expel up if stacked
`consume_or_expel_down`	`alt+}`	Consume into lower sibling stack, or expel down if stacked

Example:

[workspace.shortcuts.actions.close_pane]
  keys = ["ctrl+w"]
  desc = "Close active pane"

[workspace.shortcuts.actions.next_tab]
  keys = ["ctrl+tab", "alt+l"]
  desc = "Switch to next tab"

Tip: Use dumb://config → Keybindings tab to edit shortcuts visually.

Note: New tab creation uses modal tab mode (Ctrl+T then n/c). This follows the Zellij-style modal keyboard interface.

Note: Consume-or-expel is experimental and may change behavior between releases.

Key	Type	Default	Valid Values	Description
`workspace.popups.behavior`	string	`"split"`	`split`, `stacked`, `tabbed`, `windowed`	Popup opening mode
`workspace.popups.placement`	string	`"right"`	`right`, `left`, `top`, `bottom`	Split direction
`workspace.popups.open_in_new_pane`	bool	`true`	-	Open popups in workspace
`workspace.popups.follow_pane_context`	bool	`true`	-	Follow parent pane context
`workspace.popups.blank_target_behavior`	string	`"pane"`	`pane`, `tab`	`_blank` target handling
`workspace.popups.enable_smart_detection`	bool	`true`	-	Use WindowProperties for detection
`workspace.popups.oauth_auto_close`	bool	`true`	-	Auto-close OAuth popups

Workspace Styling

Key	Type	Default	Description
`workspace.styling.border_width`	int	`1`	Active pane border width (px) - overlay
`workspace.styling.border_color`	string	`"@theme_selected_bg_color"`	Active pane border color
`workspace.styling.mode_border_width`	int	`4`	Modal mode border width (px) - applies to all modes
`workspace.styling.pane_mode_color`	string	`"#4A90E2"`	Pane mode color (blue) - used for border and toaster
`workspace.styling.tab_mode_color`	string	`"#FFA500"`	Tab mode color (orange) - used for border and toaster
`workspace.styling.session_mode_color`	string	`"#9B59B6"`	Session mode color (purple) - used for border and toaster
`workspace.styling.resize_mode_color`	string	`"#00D4AA"`	Resize mode color (teal) - used for border and toaster
`workspace.styling.mode_indicator_toaster_enabled`	bool	`true`	Show toaster notification when modal modes are active
`workspace.styling.transition_duration`	int	`120`	Border transition duration (ms)

Example:

[workspace.styling]
border_width = 1
border_color = "@theme_selected_bg_color"
mode_border_width = 4
pane_mode_color = "#4A90E2"      # Blue for pane mode
tab_mode_color = "#FFA500"       # Orange for tab mode
session_mode_color = "#9B59B6"   # Purple for session mode
resize_mode_color = "#00D4AA"    # Teal for resize mode
mode_indicator_toaster_enabled = true
transition_duration = 120

Session

Key	Type	Default	Description
`session.auto_restore`	bool	`false`	Automatically restore the last session on startup
`session.snapshot_interval_ms`	int	`5000`	Minimum interval between snapshots in milliseconds
`session.max_exited_sessions`	int	`50`	Maximum number of exited sessions to keep
`session.max_exited_session_age_days`	int	`7`	Maximum age in days for exited sessions (auto-deleted on startup)

Session Mode

Key	Type	Default	Description
`session.session_mode.activation_shortcut`	string	`"ctrl+o"`	Session mode activation key
`session.session_mode.timeout_ms`	int	`3000`	Session mode timeout (ms)
`session.session_mode.actions`	map	See below	Action to keys mappings

Default session mode actions:

[session.session_mode.actions]
session-manager = ["s", "w"]
confirm = ["enter"]
cancel = ["escape"]

Example:

[session]
auto_restore = false              # Don't auto-restore on startup
snapshot_interval_ms = 5000       # Save state every 5 seconds (debounced)
max_exited_sessions = 50          # Keep last 50 exited sessions
max_exited_session_age_days = 7   # Delete sessions older than 7 days on startup

Media

Key	Type	Default	Valid Values	Description
`media.hardware_decoding`	string	`"auto"`	`auto`, `force`, `disable`	Hardware video decoding mode
`media.prefer_av1`	bool	`false`	-	Prefer AV1 codec when available
`media.show_diagnostics`	bool	`false`	-	Show media diagnostics warnings at startup
`media.force_vsync`	bool	`false`	-	Force VSync for video playback (may help with tearing)
`media.gl_rendering_mode`	string	`"auto"`	`auto`, `gles2`, `gl3`, `none`	OpenGL API selection for video rendering
`media.gstreamer_debug_level`	int	`0`	`0-5`	GStreamer debug verbosity (0=off)

Hardware decoding modes:

auto (recommended): Hardware preferred with software fallback - fixes Twitch Error #4000
force: Hardware only - fails if unavailable
disable: Software only - higher CPU usage

GL rendering modes:

auto (default): Let GStreamer choose the best OpenGL API
gles2: Force GLES2 (better for some mobile/embedded GPUs)
gl3: Force OpenGL 3.x desktop
none: Disable GL-based rendering

GPU auto-detection: Dumber automatically detects your GPU vendor (AMD/Intel/NVIDIA) and sets optimal VA-API driver settings:

AMD: Uses radeonsi driver
Intel: Uses iHD driver (modern, for Broadwell+)
NVIDIA: Uses nvidia driver with EGL platform

Example:

[media]
hardware_decoding = "auto"    # HW preferred, SW fallback
prefer_av1 = false            # Let site choose codec
show_diagnostics = false      # Enable for debugging
force_vsync = false           # Let compositor handle VSync
gl_rendering_mode = "auto"    # GStreamer picks best GL API
gstreamer_debug_level = 0     # Increase to 3-5 for debugging

Diagnostics CLI:

# Check GStreamer plugins and VA-API status
dumber doctor --media

Runtime

Key	Type	Default	Description
`runtime.prefix`	string	`""`	Optional runtime prefix (e.g., `/opt/webkitgtk`) used to locate newer GTK/WebKitGTK installs

If set, dumber prepends prefix-derived paths to:

PKG_CONFIG_PATH (for version checks)
LD_LIBRARY_PATH (for runtime library loading)
GI_TYPELIB_PATH (GObject introspection)
XDG_DATA_DIRS (schemas/resources)

Example:

[runtime]
prefix = "/opt/webkitgtk"

Clipboard

Key	Type	Default	Description
`clipboard.auto_copy_on_selection`	bool	`true`	Automatically copy selected text to clipboard (zellij/tmux-style)

When enabled, selecting text in a web page immediately copies it to the clipboard with a brief toast notification. Does not apply to text selection in input fields or textareas.

Example:

[clipboard]
auto_copy_on_selection = true  # Enabled by default

Content Filtering

Key	Type	Default	Description
`content_filtering.enabled`	bool	`true`	Enable ad blocking
`content_filtering.auto_update`	bool	`true`	Automatically update filters

Notes:

Filter data is downloaded from bnema/ublock-webkit-filters GitHub releases.
Domain whitelist is managed via the database (content_whitelist table), not the config file.

Update

Key	Type	Default	Description
`update.enable_on_startup`	bool	`true`	Check for updates when browser starts
`update.auto_download`	bool	`false`	Automatically download updates in background
`update.notify_on_new_settings`	bool	`true`	Show toast notification when new config settings are available

Example:

[update]
enable_on_startup = true       # Check for updates on startup
auto_download = false          # Don't auto-download (prompt instead)
notify_on_new_settings = true  # Show toast when config migration available

CLI Commands:

# Check config status and available migrations
dumber config status

# Add missing settings with default values
dumber config migrate

# Skip confirmation prompt
dumber config migrate --yes

Performance Profiles

Performance profiles provide preset configurations for WebKitGTK tuning. These settings affect Skia rendering threads, memory pressure handling, and WebView pool behavior.

Note: Performance settings are applied at browser startup. Changes require a restart to take effect.

Key	Type	Default	Valid Values	Description
`performance.profile`	string	`"default"`	`default`, `lite`, `max`, `custom`	Performance profile selection

Profiles

Profile	Description	Use Case
`default`	No tuning, uses WebKit defaults	Normal browsing, most users
`lite`	Reduced resource usage	Low-RAM systems (< 4GB), battery saving
`max`	Maximum responsiveness	Heavy pages (GitHub PRs, complex SPAs), high-end systems
`custom`	Manual control over all settings	Advanced users who want fine-grained control

Profile Settings Matrix

Setting	default	lite	max
Skia CPU threads	unset	2	`NumCPU()/2` (min 4)
Skia GPU threads	unset	unset	scales with VRAM
Web process memory (MB)	unset	768	unset
Network process memory (MB)	unset	384	unset
Conservative threshold	unset	0.25	unset
Strict threshold	unset	0.4	unset
WebView pool prewarm	4	2	scales with RAM

Example:

[performance]
profile = "default"  # Most users - no tuning needed

# For low-RAM systems:
# profile = "lite"

# For heavy pages (GitHub PRs, complex web apps):
# profile = "max"

# For manual control:
# profile = "custom"

Custom Profile Settings

When profile = "custom", you can configure individual tuning options:

Key	Type	Default	Description
`performance.skia_cpu_painting_threads`	int	`0`	Skia CPU rendering threads (0=unset)
`performance.skia_gpu_painting_threads`	int	`-1`	Skia GPU rendering threads (-1=unset, 0=disable)
`performance.skia_enable_cpu_rendering`	bool	`false`	Force CPU rendering
`performance.web_process_memory_limit_mb`	int	`0`	Web process memory limit in MB (0=unset)
`performance.web_process_memory_poll_interval_sec`	float	`0`	Memory check interval (0=WebKit default: 30s)
`performance.web_process_memory_conservative_threshold`	float	`0`	Conservative cleanup threshold (0=unset)
`performance.web_process_memory_strict_threshold`	float	`0`	Strict cleanup threshold (0=unset)
`performance.network_process_memory_limit_mb`	int	`0`	Network process memory limit in MB
`performance.network_process_memory_poll_interval_sec`	float	`0`	Network memory check interval
`performance.network_process_memory_conservative_threshold`	float	`0`	Network conservative threshold
`performance.network_process_memory_strict_threshold`	float	`0`	Network strict threshold
`performance.webview_pool_prewarm_count`	int	`4`	WebViews to pre-create at startup
`performance.zoom_cache_size`	int	`256`	Domain zoom levels to cache

Custom profile example:

[performance]
profile = "custom"

# Skia threading - tune for your CPU
skia_cpu_painting_threads = 4
skia_gpu_painting_threads = 2

# Web process memory pressure
web_process_memory_limit_mb = 1024
web_process_memory_conservative_threshold = 0.4
web_process_memory_strict_threshold = 0.6

# WebView pool
webview_pool_prewarm_count = 6

Important: Individual tuning fields are ignored unless profile = "custom". Setting individual fields with any other profile will produce a validation warning.

Downloads

Key	Type	Default	Description
`downloads.path`	string	`""`	Download directory path (empty = `$XDG_DOWNLOAD_DIR` or `~/Downloads`)

Downloads are saved to the configured directory with toast notifications for download started, completed, and failed events.

Example:

[downloads]
path = ""  # Use system default ($XDG_DOWNLOAD_DIR or ~/Downloads)

# Or specify a custom directory:
# path = "/home/user/my-downloads"

Environment Variables

All config values can be overridden via environment variables with the prefix DUMBER_:

# Database
DUMBER_DATABASE_PATH=/custom/path/db.sqlite

# Rendering (examples)
# Defaults: rendering.disable_dmabuf_renderer=false, rendering.gsk_renderer="auto"
DUMBER_RENDERING_MODE=cpu
# DUMBER_RENDERING_DISABLE_DMABUF_RENDERER=true
# DUMBER_RENDERING_GSK_RENDERER=opengl
DUMBER_DEFAULT_WEBPAGE_ZOOM=1.5

# Logging
DUMBER_LOG_LEVEL=debug
DUMBER_LOG_FORMAT=json

source

1# Configuration Reference
2
3**Primary format**: TOML (recommended)
4**Location**: `~/.config/dumber/config.toml`
5**Also supports**: JSON (`.json`) and YAML (`.yaml`)
6**JSON Schema**: `~/.config/dumber/config.schema.json` (auto-generated for JSON format)
7
8## Why TOML?
9
10TOML is the recommended format for dumber configuration because:
11- **Clear structure**: Explicit sections make complex configs easy to read and modify
12- **No ambiguity**: No whitespace sensitivity or type coercion issues
13- **Comments supported**: Add documentation directly in your config
14- **Industry standard**: Used by Cargo, Hugo, and many modern tools
15
16You can still use JSON or YAML if you prefer - dumber automatically detects the format.
17
18## Database
19
20| Key | Type | Default | Description |
21|-----|------|---------|-------------|
22| `database.path` | string | `~/.local/share/dumber/dumber.db` | Database file path |
23
24## History
25
26| Key | Type | Default | Valid Values | Description |
27|-----|------|---------|--------------|-------------|
28| `history.max_entries` | int | `10000` | > 0 | Maximum number of history entries |
29| `history.retention_period_days` | int | `365` | > 0 | Days to keep history (1 year) |
30| `history.cleanup_interval_days` | int | `1` | > 0 | How often to run cleanup |
31
32## Search Configuration
33
34| Key | Type | Default | Description |
35|-----|------|---------|-------------|
36| `default_search_engine` | string | `"https://duckduckgo.com/?q=%s"` | Default search engine URL template (must contain `%s` placeholder) |
37| `search_shortcuts` | map | See defaults | Map of shortcut aliases to URLs |
38
39**Example:**
40```toml
41# Default search engine - used when no shortcut is specified
42default_search_engine = "https://duckduckgo.com/?q=%s"
43
44# Alternative search engines:
45# default_search_engine = "https://www.google.com/search?q=%s"
46# default_search_engine = "https://www.startpage.com/search?q=%s"
47# default_search_engine = "https://search.brave.com/search?q=%s"
48```
49
50**Default shortcuts (usage: `!shortcut query`):**
51```toml
52# Examples:
53#   !ddg golang      → DuckDuckGo search for "golang"
54#   !g rust tutorial → Google search for "rust tutorial"
55#   !gi cats         → Google Images search for "cats"
56#   !gh opencode     → GitHub search for "opencode"
57#   !yt music video  → YouTube search for "music video"
58
59[search_shortcuts.ddg]
60url = "https://duckduckgo.com/?q=%s"
61description = "DuckDuckGo search"
62
63[search_shortcuts.g]
64url = "https://google.com/search?q=%s"
65description = "Google Search"
66
67[search_shortcuts.gi]
68url = "https://google.com/search?tbm=isch&q=%s"
69description = "Google Images"
70
71[search_shortcuts.gh]
72url = "https://github.com/search?q=%s"
73description = "GitHub"
74
75[search_shortcuts.yt]
76url = "https://youtube.com/results?search_query=%s"
77description = "YouTube"
78```
79
80## Dmenu / Launcher
81
82These settings control the `dumber dmenu` CLI command for rofi/fuzzel integration.
83
84| Key | Type | Default | Description |
85|-----|------|---------|-------------|
86| `dmenu.max_history_days` | int | `30` | Number of days of history to show (0 = all) |
87| `dmenu.show_visit_count` | bool | `true` | Show visit counts in output |
88| `dmenu.show_last_visited` | bool | `true` | Show last visited dates in output |
89| `dmenu.history_prefix` | string | `"🕒"` | Prefix for history items |
90| `dmenu.shortcut_prefix` | string | `"🔍"` | Prefix for shortcuts |
91| `dmenu.url_prefix` | string | `"🌐"` | Prefix for URLs |
92| `dmenu.date_format` | string | `"2006-01-02 15:04"` | Go time format string |
93| `dmenu.sort_by_visit_count` | bool | `true` | Sort by visit count instead of recency |
94
95**CLI Usage:**
96```bash
97# Pipe mode (default) - outputs history for rofi/fuzzel with favicons
98dumber dmenu | rofi -dmenu -show-icons -p "Browse: " | dumber dmenu --select
99dumber dmenu | fuzzel --dmenu -p "Browse: " | dumber dmenu --select
100
101# Interactive TUI mode
102dumber dmenu --interactive
103
104# Override history days via CLI flag (show last 7 days)
105dumber dmenu --days 7
106
107# Sort by most visited instead of recency
108dumber dmenu --most-visited
109
110# Combined: most visited from last 14 days
111dumber dmenu --days 14 --most-visited
112```
113
114## Omnibox
115
116| Key | Type | Default | Valid Values | Description |
117|-----|------|---------|--------------|-------------|
118| `omnibox.initial_behavior` | string | `"recent"` | `recent`, `most_visited`, `none` | Initial history display behavior |
119| `omnibox.auto_open_on_new_pane` | bool | `false` | - | Automatically open the omnibox after creating a new pane |
120
121**Example:**
122```toml
123[omnibox]
124initial_behavior = "recent"  # Show recent history when omnibox opens
125auto_open_on_new_pane = false
126
127# Alternative options:
128# initial_behavior = "most_visited"  # Show most visited sites
129# initial_behavior = "none"          # Show no initial suggestions
130```
131
132## Logging
133
134| Key | Type | Default | Valid Values | Description |
135|-----|------|---------|--------------|-------------|
136| `logging.level` | string | `"info"` | `debug`, `info`, `warn`, `error` | Log level |
137| `logging.format` | string | `"text"` | `text`, `json` | Log format |
138| `logging.max_age` | int | `7` | >= 0 | Days to keep logs |
139| `logging.log_dir` | string | `~/.local/state/dumber/logs/` | any | Log directory |
140| `logging.enable_file_log` | bool | `true` | - | Enable file logging |
141| `logging.capture_console` | bool | `false` | - | Capture browser console to logs |
142| `logging.capture_gtk_webkit_logs` | bool | `false` | - | Capture GTK and WebKit logs for debugging |
143
144## Appearance
145
146| Key | Type | Default | Description |
147|-----|------|---------|-------------|
148| `appearance.sans_font` | string | `"Fira Sans"` | Sans-serif font |
149| `appearance.serif_font` | string | `"Fira Sans"` | Serif font |
150| `appearance.monospace_font` | string | `"Fira Code"` | Monospace font |
151| `appearance.default_font_size` | int | `16` | Font size in points |
152| `appearance.color_scheme` | string | `"default"` | `prefer-dark`, `prefer-light`, `default` |
153
154### Color Palettes
155
156**Light palette:**
157```toml
158[appearance.light_palette]
159background = "#f8f8f8"
160surface = "#f2f2f2"
161surface_variant = "#ececec"
162text = "#1a1a1a"
163muted = "#6e6e6e"
164accent = "#404040"
165border = "#d2d2d2"
166```
167
168**Dark palette:**
169```toml
170[appearance.dark_palette]
171background = "#0e0e0e"
172surface = "#1a1a1a"
173surface_variant = "#141414"
174text = "#e4e4e4"
175muted = "#848484"
176accent = "#a8a8a8"
177border = "#363636"
178```
179
180## Debug Options
181
182| Key | Type | Default | Description |
183|-----|------|---------|-------------|
184| `debug.enable_devtools` | bool | `true` | Enable browser developer tools (F12, Inspect Element) |
185
186## Rendering, UI Scale & Zoom
187
188| Key | Type | Default | Valid Values | Description |
189|-----|------|---------|--------------|-------------|
190| `rendering.mode` | string | `"gpu"` | `auto`, `gpu`, `cpu` | WebKit hardware acceleration policy |
191| `rendering.disable_dmabuf_renderer` | bool | `false` | - | Disable WebKit DMA-BUF renderer (may fix flicker on Wayland; slower) |
192| `rendering.force_compositing_mode` | bool | `false` | - | Force WebKit compositing mode (`WEBKIT_FORCE_COMPOSITING_MODE`) |
193| `rendering.disable_compositing_mode` | bool | `false` | - | Disable WebKit compositing mode (`WEBKIT_DISABLE_COMPOSITING_MODE`) |
194| `rendering.gsk_renderer` | string | `"auto"` | `auto`, `opengl`, `vulkan`, `cairo` | GTK renderer selection (`GSK_RENDERER`) |
195| `rendering.disable_mipmaps` | bool | `false` | - | Disable GTK mipmaps (`GSK_GPU_DISABLE=mipmap`) |
196| `rendering.prefer_gl` | bool | `false` | - | Prefer OpenGL over GLES (`GDK_DEBUG=gl-prefer-gl`) |
197| `rendering.draw_compositing_indicators` | bool | `false` | - | Draw WebKit compositing indicators (debug) |
198| `rendering.show_fps` | bool | `false` | - | Show WebKit FPS counter (`WEBKIT_SHOW_FPS`) |
199| `rendering.sample_memory` | bool | `false` | - | Enable WebKit memory sampling (`WEBKIT_SAMPLE_MEMORY`) |
200| `rendering.debug_frames` | bool | `false` | - | Enable GTK frame timing debug (`GDK_DEBUG=frames`) |
201| `default_ui_scale` | float | `1.0` | > 0 | GTK widget UI scale (1.0=100%, 2.0=200%) |
202| `default_webpage_zoom` | float | `1.2` | > 0 | Default page zoom (1.0=100%, 1.2=120%) |
203
204## Workspace Configuration
205
206### General
207
208| Key | Type | Default | Description |
209|-----|------|---------|-------------|
210| `workspace.new_pane_url` | string | `"about:blank"` | URL loaded for new panes/tabs (supports `http(s)://`, `dumb://`, `file://`, `about:`) |
211| `workspace.switch_to_tab_on_move` | bool | `true` | When moving a pane to another tab, automatically switch to the destination tab |
212
213**Example:**
214```toml
215[workspace]
216new_pane_url = "dumb://home"
217```
218
219### Pane Mode
220
221| Key | Type | Default | Description |
222|-----|------|---------|-------------|
223| `workspace.pane_mode.activation_shortcut` | string | `"ctrl+p"` | Pane mode activation key |
224| `workspace.pane_mode.timeout_ms` | int | `3000` | Pane mode timeout (ms) |
225| `workspace.pane_mode.actions` | map | See below | Action→keys mappings |
226
227**Default pane mode actions:**
228```toml
229[workspace.pane_mode.actions]
230split-right = ["arrowright", "r"]
231split-left = ["arrowleft", "l"]
232split-up = ["arrowup", "u"]
233split-down = ["arrowdown", "d"]
234stack-pane = ["s"]
235close-pane = ["x"]
236move-pane-to-tab = ["m"]
237move-pane-to-next-tab = ["M", "shift+m"]
238
239# Consume-or-expel (niri-style) - very alpha
240consume-or-expel-left = ["["]
241consume-or-expel-right = ["]"]
242consume-or-expel-up = ["{"]
243consume-or-expel-down = ["}"]
244
245focus-right = ["shift+arrowright", "shift+l"]
246focus-left = ["shift+arrowleft", "shift+h"]
247focus-up = ["shift+arrowup", "shift+k"]
248focus-down = ["shift+arrowdown", "shift+j"]
249confirm = ["enter"]
250cancel = ["escape"]
251```
252
253> **Note:** Actions are inverted to key→action map in memory for O(1) lookup performance during navigation.
254
255### Tab Mode
256
257| Key | Type | Default | Description |
258|-----|------|---------|-------------|
259| `workspace.tab_mode.activation_shortcut` | string | `"ctrl+t"` | Tab mode activation key |
260| `workspace.tab_mode.timeout_ms` | int | `3000` | Tab mode timeout (ms) |
261| `workspace.tab_mode.actions` | map | See below | Action→keys mappings |
262
263**Default tab mode actions:**
264```toml
265[workspace.tab_mode.actions]
266new-tab = ["n", "c"]
267close-tab = ["x"]
268next-tab = ["l", "tab"]
269previous-tab = ["h", "shift+tab"]
270rename-tab = ["r"]
271confirm = ["enter"]
272cancel = ["escape"]
273```
274
275> **Note:** Actions are inverted to key→action map in memory for O(1) lookup performance during navigation.
276
277### Resize Mode
278
279| Key | Type | Default | Description |
280|-----|------|---------|-------------|
281| `workspace.resize_mode.activation_shortcut` | string | `"ctrl+n"` | Resize mode activation key |
282| `workspace.resize_mode.timeout_ms` | int | `3000` | Resize mode timeout (ms) |
283| `workspace.resize_mode.step_percent` | float | `5.0` | Split ratio step per keystroke (percent) |
284| `workspace.resize_mode.min_pane_percent` | float | `10.0` | Minimum pane size (percent) |
285| `workspace.resize_mode.actions` | map | See below | Action→keys mappings |
286
287**Default resize mode actions:**
288```toml
289[workspace.resize_mode.actions]
290resize-increase-left = ["h", "arrowleft"]
291resize-increase-down = ["j", "arrowdown"]
292resize-increase-up = ["k", "arrowup"]
293resize-increase-right = ["l", "arrowright"]
294resize-decrease-left = ["H"]
295resize-decrease-down = ["J"]
296resize-decrease-up = ["K"]
297resize-decrease-right = ["L"]
298resize-increase = ["+", "="]
299resize-decrease = ["-"]
300confirm = ["enter"]
301cancel = ["escape"]
302```
303
304Notes:
305- Directional actions (`resize-increase-*/resize-decrease-*`) move the split divider.
306- Smart actions (`resize-increase` / `resize-decrease`) grow/shrink the active pane (best-effort) by picking a direction automatically.
307- Timeout is refreshed on each resize keypress so you can keep adjusting without re-entering the mode.
308
309### Global Shortcuts
310
311Global shortcuts are configured under `workspace.shortcuts.actions` using the same `ActionBinding` structure as modal keybindings:
312
313| Action | Default Keys | Description |
314|--------|--------------|-------------|
315| `close_pane` | `ctrl+w` | Close active pane (closes tab if last pane) |
316| `next_tab` | `ctrl+tab` | Switch to next tab |
317| `previous_tab` | `ctrl+shift+tab` | Switch to previous tab |
318| `consume_or_expel_left` | `alt+[` | Consume into left sibling stack, or expel left if stacked |
319| `consume_or_expel_right` | `alt+]` | Consume into right sibling stack, or expel right if stacked |
320| `consume_or_expel_up` | `alt+{` | Consume into upper sibling stack, or expel up if stacked |
321| `consume_or_expel_down` | `alt+}` | Consume into lower sibling stack, or expel down if stacked |
322
323**Example:**
324```toml
325[workspace.shortcuts.actions.close_pane]
326  keys = ["ctrl+w"]
327  desc = "Close active pane"
328
329[workspace.shortcuts.actions.next_tab]
330  keys = ["ctrl+tab", "alt+l"]
331  desc = "Switch to next tab"
332```
333
334> **Tip:** Use `dumb://config` → Keybindings tab to edit shortcuts visually.
335>
336> **Note:** New tab creation uses modal tab mode (Ctrl+T then n/c). This follows the Zellij-style modal keyboard interface.
337>
338> **Note:** Consume-or-expel is experimental and may change behavior between releases.
339
340### Popup Behavior
341
342| Key | Type | Default | Valid Values | Description |
343|-----|------|---------|--------------|-------------|
344| `workspace.popups.behavior` | string | `"split"` | `split`, `stacked`, `tabbed`, `windowed` | Popup opening mode |
345| `workspace.popups.placement` | string | `"right"` | `right`, `left`, `top`, `bottom` | Split direction |
346| `workspace.popups.open_in_new_pane` | bool | `true` | - | Open popups in workspace |
347| `workspace.popups.follow_pane_context` | bool | `true` | - | Follow parent pane context |
348| `workspace.popups.blank_target_behavior` | string | `"pane"` | `pane`, `tab` | `_blank` target handling |
349| `workspace.popups.enable_smart_detection` | bool | `true` | - | Use WindowProperties for detection |
350| `workspace.popups.oauth_auto_close` | bool | `true` | - | Auto-close OAuth popups |
351
352### Workspace Styling
353
354| Key | Type | Default | Description |
355|-----|------|---------|-------------|
356| `workspace.styling.border_width` | int | `1` | Active pane border width (px) - overlay |
357| `workspace.styling.border_color` | string | `"@theme_selected_bg_color"` | Active pane border color |
358| `workspace.styling.mode_border_width` | int | `4` | Modal mode border width (px) - applies to all modes |
359| `workspace.styling.pane_mode_color` | string | `"#4A90E2"` | Pane mode color (blue) - used for border and toaster |
360| `workspace.styling.tab_mode_color` | string | `"#FFA500"` | Tab mode color (orange) - used for border and toaster |
361| `workspace.styling.session_mode_color` | string | `"#9B59B6"` | Session mode color (purple) - used for border and toaster |
362| `workspace.styling.resize_mode_color` | string | `"#00D4AA"` | Resize mode color (teal) - used for border and toaster |
363| `workspace.styling.mode_indicator_toaster_enabled` | bool | `true` | Show toaster notification when modal modes are active |
364| `workspace.styling.transition_duration` | int | `120` | Border transition duration (ms) |
365
366**Example:**
367```toml
368[workspace.styling]
369border_width = 1
370border_color = "@theme_selected_bg_color"
371mode_border_width = 4
372pane_mode_color = "#4A90E2"      # Blue for pane mode
373tab_mode_color = "#FFA500"       # Orange for tab mode
374session_mode_color = "#9B59B6"   # Purple for session mode
375resize_mode_color = "#00D4AA"    # Teal for resize mode
376mode_indicator_toaster_enabled = true
377transition_duration = 120
378```
379
380## Session
381
382| Key | Type | Default | Description |
383|-----|------|---------|-------------|
384| `session.auto_restore` | bool | `false` | Automatically restore the last session on startup |
385| `session.snapshot_interval_ms` | int | `5000` | Minimum interval between snapshots in milliseconds |
386| `session.max_exited_sessions` | int | `50` | Maximum number of exited sessions to keep |
387| `session.max_exited_session_age_days` | int | `7` | Maximum age in days for exited sessions (auto-deleted on startup) |
388
389### Session Mode
390
391| Key | Type | Default | Description |
392|-----|------|---------|-------------|
393| `session.session_mode.activation_shortcut` | string | `"ctrl+o"` | Session mode activation key |
394| `session.session_mode.timeout_ms` | int | `3000` | Session mode timeout (ms) |
395| `session.session_mode.actions` | map | See below | Action to keys mappings |
396
397**Default session mode actions:**
398```toml
399[session.session_mode.actions]
400session-manager = ["s", "w"]
401confirm = ["enter"]
402cancel = ["escape"]
403```
404
405**Example:**
406```toml
407[session]
408auto_restore = false              # Don't auto-restore on startup
409snapshot_interval_ms = 5000       # Save state every 5 seconds (debounced)
410max_exited_sessions = 50          # Keep last 50 exited sessions
411max_exited_session_age_days = 7   # Delete sessions older than 7 days on startup
412```
413
414## Media
415
416| Key | Type | Default | Valid Values | Description |
417|-----|------|---------|--------------|-------------|
418| `media.hardware_decoding` | string | `"auto"` | `auto`, `force`, `disable` | Hardware video decoding mode |
419| `media.prefer_av1` | bool | `false` | - | Prefer AV1 codec when available |
420| `media.show_diagnostics` | bool | `false` | - | Show media diagnostics warnings at startup |
421| `media.force_vsync` | bool | `false` | - | Force VSync for video playback (may help with tearing) |
422| `media.gl_rendering_mode` | string | `"auto"` | `auto`, `gles2`, `gl3`, `none` | OpenGL API selection for video rendering |
423| `media.gstreamer_debug_level` | int | `0` | `0-5` | GStreamer debug verbosity (0=off) |
424
425**Hardware decoding modes:**
426- `auto` (recommended): Hardware preferred with software fallback - fixes Twitch Error #4000
427- `force`: Hardware only - fails if unavailable
428- `disable`: Software only - higher CPU usage
429
430**GL rendering modes:**
431- `auto` (default): Let GStreamer choose the best OpenGL API
432- `gles2`: Force GLES2 (better for some mobile/embedded GPUs)
433- `gl3`: Force OpenGL 3.x desktop
434- `none`: Disable GL-based rendering
435
436**GPU auto-detection:**
437Dumber automatically detects your GPU vendor (AMD/Intel/NVIDIA) and sets optimal VA-API driver settings:
438- **AMD**: Uses `radeonsi` driver
439- **Intel**: Uses `iHD` driver (modern, for Broadwell+)
440- **NVIDIA**: Uses `nvidia` driver with EGL platform
441
442**Example:**
443```toml
444[media]
445hardware_decoding = "auto"    # HW preferred, SW fallback
446prefer_av1 = false            # Let site choose codec
447show_diagnostics = false      # Enable for debugging
448force_vsync = false           # Let compositor handle VSync
449gl_rendering_mode = "auto"    # GStreamer picks best GL API
450gstreamer_debug_level = 0     # Increase to 3-5 for debugging
451```
452
453**Diagnostics CLI:**
454```bash
455# Check GStreamer plugins and VA-API status
456dumber doctor --media
457```
458
459## Runtime
460
461| Key | Type | Default | Description |
462|-----|------|---------|-------------|
463| `runtime.prefix` | string | `""` | Optional runtime prefix (e.g., `/opt/webkitgtk`) used to locate newer GTK/WebKitGTK installs |
464
465If set, dumber prepends prefix-derived paths to:
466- `PKG_CONFIG_PATH` (for version checks)
467- `LD_LIBRARY_PATH` (for runtime library loading)
468- `GI_TYPELIB_PATH` (GObject introspection)
469- `XDG_DATA_DIRS` (schemas/resources)
470
471**Example:**
472```toml
473[runtime]
474prefix = "/opt/webkitgtk"
475```
476
477## Clipboard
478
479| Key | Type | Default | Description |
480|-----|------|---------|-------------|
481| `clipboard.auto_copy_on_selection` | bool | `true` | Automatically copy selected text to clipboard (zellij/tmux-style) |
482
483When enabled, selecting text in a web page immediately copies it to the clipboard with a brief toast notification. Does not apply to text selection in input fields or textareas.
484
485**Example:**
486```toml
487[clipboard]
488auto_copy_on_selection = true  # Enabled by default
489```
490
491## Content Filtering
492
493| Key | Type | Default | Description |
494|-----|------|---------|-------------|
495| `content_filtering.enabled` | bool | `true` | Enable ad blocking |
496| `content_filtering.auto_update` | bool | `true` | Automatically update filters |
497
498Notes:
499- Filter data is downloaded from `bnema/ublock-webkit-filters` GitHub releases.
500- Domain whitelist is managed via the database (`content_whitelist` table), not the config file.
501
502## Update
503
504| Key | Type | Default | Description |
505|-----|------|---------|-------------|
506| `update.enable_on_startup` | bool | `true` | Check for updates when browser starts |
507| `update.auto_download` | bool | `false` | Automatically download updates in background |
508| `update.notify_on_new_settings` | bool | `true` | Show toast notification when new config settings are available |
509
510**Example:**
511```toml
512[update]
513enable_on_startup = true       # Check for updates on startup
514auto_download = false          # Don't auto-download (prompt instead)
515notify_on_new_settings = true  # Show toast when config migration available
516```
517
518**CLI Commands:**
519```bash
520# Check config status and available migrations
521dumber config status
522
523# Add missing settings with default values
524dumber config migrate
525
526# Skip confirmation prompt
527dumber config migrate --yes
528```
529
530## Performance Profiles
531
532Performance profiles provide preset configurations for WebKitGTK tuning. These settings affect Skia rendering threads, memory pressure handling, and WebView pool behavior.
533
534> **Note:** Performance settings are applied at browser startup. Changes require a restart to take effect.
535
536| Key | Type | Default | Valid Values | Description |
537|-----|------|---------|--------------|-------------|
538| `performance.profile` | string | `"default"` | `default`, `lite`, `max`, `custom` | Performance profile selection |
539
540### Profiles
541
542| Profile | Description | Use Case |
543|---------|-------------|----------|
544| `default` | No tuning, uses WebKit defaults | Normal browsing, most users |
545| `lite` | Reduced resource usage | Low-RAM systems (< 4GB), battery saving |
546| `max` | Maximum responsiveness | Heavy pages (GitHub PRs, complex SPAs), high-end systems |
547| `custom` | Manual control over all settings | Advanced users who want fine-grained control |
548
549### Profile Settings Matrix
550
551| Setting | default | lite | max |
552|---------|---------|------|-----|
553| Skia CPU threads | unset | 2 | `NumCPU()/2` (min 4) |
554| Skia GPU threads | unset | unset | scales with VRAM |
555| Web process memory (MB) | unset | 768 | unset |
556| Network process memory (MB) | unset | 384 | unset |
557| Conservative threshold | unset | 0.25 | unset |
558| Strict threshold | unset | 0.4 | unset |
559| WebView pool prewarm | 4 | 2 | scales with RAM |
560
561**Example:**
562```toml
563[performance]
564profile = "default"  # Most users - no tuning needed
565
566# For low-RAM systems:
567# profile = "lite"
568
569# For heavy pages (GitHub PRs, complex web apps):
570# profile = "max"
571
572# For manual control:
573# profile = "custom"
574```
575
576### Custom Profile Settings
577
578When `profile = "custom"`, you can configure individual tuning options:
579
580| Key | Type | Default | Description |
581|-----|------|---------|-------------|
582| `performance.skia_cpu_painting_threads` | int | `0` | Skia CPU rendering threads (0=unset) |
583| `performance.skia_gpu_painting_threads` | int | `-1` | Skia GPU rendering threads (-1=unset, 0=disable) |
584| `performance.skia_enable_cpu_rendering` | bool | `false` | Force CPU rendering |
585| `performance.web_process_memory_limit_mb` | int | `0` | Web process memory limit in MB (0=unset) |
586| `performance.web_process_memory_poll_interval_sec` | float | `0` | Memory check interval (0=WebKit default: 30s) |
587| `performance.web_process_memory_conservative_threshold` | float | `0` | Conservative cleanup threshold (0=unset) |
588| `performance.web_process_memory_strict_threshold` | float | `0` | Strict cleanup threshold (0=unset) |
589| `performance.network_process_memory_limit_mb` | int | `0` | Network process memory limit in MB |
590| `performance.network_process_memory_poll_interval_sec` | float | `0` | Network memory check interval |
591| `performance.network_process_memory_conservative_threshold` | float | `0` | Network conservative threshold |
592| `performance.network_process_memory_strict_threshold` | float | `0` | Network strict threshold |
593| `performance.webview_pool_prewarm_count` | int | `4` | WebViews to pre-create at startup |
594| `performance.zoom_cache_size` | int | `256` | Domain zoom levels to cache |
595
596**Custom profile example:**
597```toml
598[performance]
599profile = "custom"
600
601# Skia threading - tune for your CPU
602skia_cpu_painting_threads = 4
603skia_gpu_painting_threads = 2
604
605# Web process memory pressure
606web_process_memory_limit_mb = 1024
607web_process_memory_conservative_threshold = 0.4
608web_process_memory_strict_threshold = 0.6
609
610# WebView pool
611webview_pool_prewarm_count = 6
612```
613
614> **Important:** Individual tuning fields are ignored unless `profile = "custom"`. Setting individual fields with any other profile will produce a validation warning.
615
616## Downloads
617
618| Key | Type | Default | Description |
619|-----|------|---------|-------------|
620| `downloads.path` | string | `""` | Download directory path (empty = `$XDG_DOWNLOAD_DIR` or `~/Downloads`) |
621
622Downloads are saved to the configured directory with toast notifications for download started, completed, and failed events.
623
624**Example:**
625```toml
626[downloads]
627path = ""  # Use system default ($XDG_DOWNLOAD_DIR or ~/Downloads)
628
629# Or specify a custom directory:
630# path = "/home/user/my-downloads"
631```
632
633## Environment Variables
634
635All config values can be overridden via environment variables with the prefix `DUMBER_`:
636
637```bash
638# Database
639DUMBER_DATABASE_PATH=/custom/path/db.sqlite
640
641# Rendering (examples)
642# Defaults: rendering.disable_dmabuf_renderer=false, rendering.gsk_renderer="auto"
643DUMBER_RENDERING_MODE=cpu
644# DUMBER_RENDERING_DISABLE_DMABUF_RENDERER=true
645# DUMBER_RENDERING_GSK_RENDERER=opengl
646DUMBER_DEFAULT_WEBPAGE_ZOOM=1.5
647
648# Logging
649DUMBER_LOG_LEVEL=debug
650DUMBER_LOG_FORMAT=json
651```

CONFIG.md RawHistoryFolder

Configuration Reference

Why TOML?

Database

History

Search Configuration

Dmenu / Launcher

Omnibox

Logging

Appearance

Color Palettes

Debug Options

Rendering, UI Scale & Zoom

Workspace Configuration

General

Pane Mode

Tab Mode

Resize Mode

Global Shortcuts

Popup Behavior

Workspace Styling

Session

Session Mode

Media

Runtime

Clipboard

Content Filtering

Update

Performance Profiles

Profiles

Profile Settings Matrix

Custom Profile Settings

Downloads

Environment Variables

CONFIG.md Raw History Folder