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

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 = ["bracketleft", "["]
consume-or-expel-right = ["bracketright", "]"]
consume-or-expel-up = ["shift+bracketleft", "braceleft", "{"]
consume-or-expel-down = ["shift+bracketright", "braceright", "}"]

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

Key	Type	Default	Description
`workspace.shortcuts.close_pane`	string	`"ctrl+w"`	Close active pane (closes tab if last pane)
`workspace.shortcuts.next_tab`	string	`"ctrl+tab"`	Next tab shortcut
`workspace.shortcuts.previous_tab`	string	`"ctrl+shift+tab"`	Previous tab shortcut
`workspace.shortcuts.consume_or_expel_left`	string	`"alt+bracketleft"`	Consume into left sibling stack, or expel left if stacked (very alpha)
`workspace.shortcuts.consume_or_expel_right`	string	`"alt+bracketright"`	Consume into right sibling stack, or expel right if stacked (very alpha)
`workspace.shortcuts.consume_or_expel_up`	string	`"alt+shift+bracketleft"`	Consume into upper sibling stack, or expel up if stacked (very alpha)
`workspace.shortcuts.consume_or_expel_down`	string	`"alt+shift+bracketright"`	Consume into lower sibling stack, or expel down if stacked (very alpha)

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
143## Appearance
144
145| Key | Type | Default | Description |
146|-----|------|---------|-------------|
147| `appearance.sans_font` | string | `"Fira Sans"` | Sans-serif font |
148| `appearance.serif_font` | string | `"Fira Sans"` | Serif font |
149| `appearance.monospace_font` | string | `"Fira Code"` | Monospace font |
150| `appearance.default_font_size` | int | `16` | Font size in points |
151| `appearance.color_scheme` | string | `"default"` | `prefer-dark`, `prefer-light`, `default` |
152
153### Color Palettes
154
155**Light palette:**
156```toml
157[appearance.light_palette]
158background = "#f8f8f8"
159surface = "#f2f2f2"
160surface_variant = "#ececec"
161text = "#1a1a1a"
162muted = "#6e6e6e"
163accent = "#404040"
164border = "#d2d2d2"
165```
166
167**Dark palette:**
168```toml
169[appearance.dark_palette]
170background = "#0e0e0e"
171surface = "#1a1a1a"
172surface_variant = "#141414"
173text = "#e4e4e4"
174muted = "#848484"
175accent = "#a8a8a8"
176border = "#363636"
177```
178
179## Debug Options
180
181| Key | Type | Default | Description |
182|-----|------|---------|-------------|
183| `debug.enable_devtools` | bool | `true` | Enable browser developer tools (F12, Inspect Element) |
184
185## Rendering, UI Scale & Zoom
186
187| Key | Type | Default | Valid Values | Description |
188|-----|------|---------|--------------|-------------|
189| `rendering.mode` | string | `"gpu"` | `auto`, `gpu`, `cpu` | WebKit hardware acceleration policy |
190| `rendering.disable_dmabuf_renderer` | bool | `false` | - | Disable WebKit DMA-BUF renderer (may fix flicker on Wayland; slower) |
191| `rendering.force_compositing_mode` | bool | `false` | - | Force WebKit compositing mode (`WEBKIT_FORCE_COMPOSITING_MODE`) |
192| `rendering.disable_compositing_mode` | bool | `false` | - | Disable WebKit compositing mode (`WEBKIT_DISABLE_COMPOSITING_MODE`) |
193| `rendering.gsk_renderer` | string | `"auto"` | `auto`, `opengl`, `vulkan`, `cairo` | GTK renderer selection (`GSK_RENDERER`) |
194| `rendering.disable_mipmaps` | bool | `false` | - | Disable GTK mipmaps (`GSK_GPU_DISABLE=mipmap`) |
195| `rendering.prefer_gl` | bool | `false` | - | Prefer OpenGL over GLES (`GDK_DEBUG=gl-prefer-gl`) |
196| `rendering.draw_compositing_indicators` | bool | `false` | - | Draw WebKit compositing indicators (debug) |
197| `rendering.show_fps` | bool | `false` | - | Show WebKit FPS counter (`WEBKIT_SHOW_FPS`) |
198| `rendering.sample_memory` | bool | `false` | - | Enable WebKit memory sampling (`WEBKIT_SAMPLE_MEMORY`) |
199| `rendering.debug_frames` | bool | `false` | - | Enable GTK frame timing debug (`GDK_DEBUG=frames`) |
200| `default_ui_scale` | float | `1.0` | > 0 | GTK widget UI scale (1.0=100%, 2.0=200%) |
201| `default_webpage_zoom` | float | `1.2` | > 0 | Default page zoom (1.0=100%, 1.2=120%) |
202
203## Workspace Configuration
204
205### General
206
207| Key | Type | Default | Description |
208|-----|------|---------|-------------|
209| `workspace.new_pane_url` | string | `"about:blank"` | URL loaded for new panes/tabs (supports `http(s)://`, `dumb://`, `file://`, `about:`) |
210| `workspace.switch_to_tab_on_move` | bool | `true` | When moving a pane to another tab, automatically switch to the destination tab |
211
212**Example:**
213```toml
214[workspace]
215new_pane_url = "dumb://home"
216```
217
218### Pane Mode
219
220| Key | Type | Default | Description |
221|-----|------|---------|-------------|
222| `workspace.pane_mode.activation_shortcut` | string | `"ctrl+p"` | Pane mode activation key |
223| `workspace.pane_mode.timeout_ms` | int | `3000` | Pane mode timeout (ms) |
224| `workspace.pane_mode.actions` | map | See below | Action→keys mappings |
225
226**Default pane mode actions:**
227```toml
228[workspace.pane_mode.actions]
229split-right = ["arrowright", "r"]
230split-left = ["arrowleft", "l"]
231split-up = ["arrowup", "u"]
232split-down = ["arrowdown", "d"]
233stack-pane = ["s"]
234close-pane = ["x"]
235move-pane-to-tab = ["m"]
236move-pane-to-next-tab = ["M", "shift+m"]
237
238# Consume-or-expel (niri-style) - very alpha
239consume-or-expel-left = ["bracketleft", "["]
240consume-or-expel-right = ["bracketright", "]"]
241consume-or-expel-up = ["shift+bracketleft", "braceleft", "{"]
242consume-or-expel-down = ["shift+bracketright", "braceright", "}"]
243
244focus-right = ["shift+arrowright", "shift+l"]
245focus-left = ["shift+arrowleft", "shift+h"]
246focus-up = ["shift+arrowup", "shift+k"]
247focus-down = ["shift+arrowdown", "shift+j"]
248confirm = ["enter"]
249cancel = ["escape"]
250```
251
252> **Note:** Actions are inverted to key→action map in memory for O(1) lookup performance during navigation.
253
254### Tab Mode
255
256| Key | Type | Default | Description |
257|-----|------|---------|-------------|
258| `workspace.tab_mode.activation_shortcut` | string | `"ctrl+t"` | Tab mode activation key |
259| `workspace.tab_mode.timeout_ms` | int | `3000` | Tab mode timeout (ms) |
260| `workspace.tab_mode.actions` | map | See below | Action→keys mappings |
261
262**Default tab mode actions:**
263```toml
264[workspace.tab_mode.actions]
265new-tab = ["n", "c"]
266close-tab = ["x"]
267next-tab = ["l", "tab"]
268previous-tab = ["h", "shift+tab"]
269rename-tab = ["r"]
270confirm = ["enter"]
271cancel = ["escape"]
272```
273
274> **Note:** Actions are inverted to key→action map in memory for O(1) lookup performance during navigation.
275
276### Resize Mode
277
278| Key | Type | Default | Description |
279|-----|------|---------|-------------|
280| `workspace.resize_mode.activation_shortcut` | string | `"ctrl+n"` | Resize mode activation key |
281| `workspace.resize_mode.timeout_ms` | int | `3000` | Resize mode timeout (ms) |
282| `workspace.resize_mode.step_percent` | float | `5.0` | Split ratio step per keystroke (percent) |
283| `workspace.resize_mode.min_pane_percent` | float | `10.0` | Minimum pane size (percent) |
284| `workspace.resize_mode.actions` | map | See below | Action→keys mappings |
285
286**Default resize mode actions:**
287```toml
288[workspace.resize_mode.actions]
289resize-increase-left = ["h", "arrowleft"]
290resize-increase-down = ["j", "arrowdown"]
291resize-increase-up = ["k", "arrowup"]
292resize-increase-right = ["l", "arrowright"]
293resize-decrease-left = ["H"]
294resize-decrease-down = ["J"]
295resize-decrease-up = ["K"]
296resize-decrease-right = ["L"]
297resize-increase = ["+", "="]
298resize-decrease = ["-"]
299confirm = ["enter"]
300cancel = ["escape"]
301```
302
303Notes:
304- Directional actions (`resize-increase-*/resize-decrease-*`) move the split divider.
305- Smart actions (`resize-increase` / `resize-decrease`) grow/shrink the active pane (best-effort) by picking a direction automatically.
306- Timeout is refreshed on each resize keypress so you can keep adjusting without re-entering the mode.
307
308### Global Shortcuts
309
310| Key | Type | Default | Description |
311|-----|------|---------|-------------|
312| `workspace.shortcuts.close_pane` | string | `"ctrl+w"` | Close active pane (closes tab if last pane) |
313| `workspace.shortcuts.next_tab` | string | `"ctrl+tab"` | Next tab shortcut |
314| `workspace.shortcuts.previous_tab` | string | `"ctrl+shift+tab"` | Previous tab shortcut |
315| `workspace.shortcuts.consume_or_expel_left` | string | `"alt+bracketleft"` | Consume into left sibling stack, or expel left if stacked (very alpha) |
316| `workspace.shortcuts.consume_or_expel_right` | string | `"alt+bracketright"` | Consume into right sibling stack, or expel right if stacked (very alpha) |
317| `workspace.shortcuts.consume_or_expel_up` | string | `"alt+shift+bracketleft"` | Consume into upper sibling stack, or expel up if stacked (very alpha) |
318| `workspace.shortcuts.consume_or_expel_down` | string | `"alt+shift+bracketright"` | Consume into lower sibling stack, or expel down if stacked (very alpha) |
319
320> **Note:** New tab creation uses modal tab mode (Ctrl+T then n/c). This follows the Zellij-style modal keyboard interface.
321>
322> **Note:** Consume-or-expel is experimental and may change behavior between releases.
323
324### Popup Behavior
325
326| Key | Type | Default | Valid Values | Description |
327|-----|------|---------|--------------|-------------|
328| `workspace.popups.behavior` | string | `"split"` | `split`, `stacked`, `tabbed`, `windowed` | Popup opening mode |
329| `workspace.popups.placement` | string | `"right"` | `right`, `left`, `top`, `bottom` | Split direction |
330| `workspace.popups.open_in_new_pane` | bool | `true` | - | Open popups in workspace |
331| `workspace.popups.follow_pane_context` | bool | `true` | - | Follow parent pane context |
332| `workspace.popups.blank_target_behavior` | string | `"pane"` | `pane`, `tab` | `_blank` target handling |
333| `workspace.popups.enable_smart_detection` | bool | `true` | - | Use WindowProperties for detection |
334| `workspace.popups.oauth_auto_close` | bool | `true` | - | Auto-close OAuth popups |
335
336### Workspace Styling
337
338| Key | Type | Default | Description |
339|-----|------|---------|-------------|
340| `workspace.styling.border_width` | int | `1` | Active pane border width (px) - overlay |
341| `workspace.styling.border_color` | string | `"@theme_selected_bg_color"` | Active pane border color |
342| `workspace.styling.mode_border_width` | int | `4` | Modal mode border width (px) - applies to all modes |
343| `workspace.styling.pane_mode_color` | string | `"#4A90E2"` | Pane mode color (blue) - used for border and toaster |
344| `workspace.styling.tab_mode_color` | string | `"#FFA500"` | Tab mode color (orange) - used for border and toaster |
345| `workspace.styling.session_mode_color` | string | `"#9B59B6"` | Session mode color (purple) - used for border and toaster |
346| `workspace.styling.resize_mode_color` | string | `"#00D4AA"` | Resize mode color (teal) - used for border and toaster |
347| `workspace.styling.mode_indicator_toaster_enabled` | bool | `true` | Show toaster notification when modal modes are active |
348| `workspace.styling.transition_duration` | int | `120` | Border transition duration (ms) |
349
350**Example:**
351```toml
352[workspace.styling]
353border_width = 1
354border_color = "@theme_selected_bg_color"
355mode_border_width = 4
356pane_mode_color = "#4A90E2"      # Blue for pane mode
357tab_mode_color = "#FFA500"       # Orange for tab mode
358session_mode_color = "#9B59B6"   # Purple for session mode
359resize_mode_color = "#00D4AA"    # Teal for resize mode
360mode_indicator_toaster_enabled = true
361transition_duration = 120
362```
363
364## Session
365
366| Key | Type | Default | Description |
367|-----|------|---------|-------------|
368| `session.auto_restore` | bool | `false` | Automatically restore the last session on startup |
369| `session.snapshot_interval_ms` | int | `5000` | Minimum interval between snapshots in milliseconds |
370| `session.max_exited_sessions` | int | `50` | Maximum number of exited sessions to keep |
371| `session.max_exited_session_age_days` | int | `7` | Maximum age in days for exited sessions (auto-deleted on startup) |
372
373### Session Mode
374
375| Key | Type | Default | Description |
376|-----|------|---------|-------------|
377| `session.session_mode.activation_shortcut` | string | `"ctrl+o"` | Session mode activation key |
378| `session.session_mode.timeout_ms` | int | `3000` | Session mode timeout (ms) |
379| `session.session_mode.actions` | map | See below | Action to keys mappings |
380
381**Default session mode actions:**
382```toml
383[session.session_mode.actions]
384session-manager = ["s", "w"]
385confirm = ["enter"]
386cancel = ["escape"]
387```
388
389**Example:**
390```toml
391[session]
392auto_restore = false              # Don't auto-restore on startup
393snapshot_interval_ms = 5000       # Save state every 5 seconds (debounced)
394max_exited_sessions = 50          # Keep last 50 exited sessions
395max_exited_session_age_days = 7   # Delete sessions older than 7 days on startup
396```
397
398## Media
399
400| Key | Type | Default | Valid Values | Description |
401|-----|------|---------|--------------|-------------|
402| `media.hardware_decoding` | string | `"auto"` | `auto`, `force`, `disable` | Hardware video decoding mode |
403| `media.prefer_av1` | bool | `false` | - | Prefer AV1 codec when available |
404| `media.show_diagnostics` | bool | `false` | - | Show media diagnostics warnings at startup |
405| `media.force_vsync` | bool | `false` | - | Force VSync for video playback (may help with tearing) |
406| `media.gl_rendering_mode` | string | `"auto"` | `auto`, `gles2`, `gl3`, `none` | OpenGL API selection for video rendering |
407| `media.gstreamer_debug_level` | int | `0` | `0-5` | GStreamer debug verbosity (0=off) |
408
409**Hardware decoding modes:**
410- `auto` (recommended): Hardware preferred with software fallback - fixes Twitch Error #4000
411- `force`: Hardware only - fails if unavailable
412- `disable`: Software only - higher CPU usage
413
414**GL rendering modes:**
415- `auto` (default): Let GStreamer choose the best OpenGL API
416- `gles2`: Force GLES2 (better for some mobile/embedded GPUs)
417- `gl3`: Force OpenGL 3.x desktop
418- `none`: Disable GL-based rendering
419
420**GPU auto-detection:**
421Dumber automatically detects your GPU vendor (AMD/Intel/NVIDIA) and sets optimal VA-API driver settings:
422- **AMD**: Uses `radeonsi` driver
423- **Intel**: Uses `iHD` driver (modern, for Broadwell+)
424- **NVIDIA**: Uses `nvidia` driver with EGL platform
425
426**Example:**
427```toml
428[media]
429hardware_decoding = "auto"    # HW preferred, SW fallback
430prefer_av1 = false            # Let site choose codec
431show_diagnostics = false      # Enable for debugging
432force_vsync = false           # Let compositor handle VSync
433gl_rendering_mode = "auto"    # GStreamer picks best GL API
434gstreamer_debug_level = 0     # Increase to 3-5 for debugging
435```
436
437**Diagnostics CLI:**
438```bash
439# Check GStreamer plugins and VA-API status
440dumber doctor --media
441```
442
443## Runtime
444
445| Key | Type | Default | Description |
446|-----|------|---------|-------------|
447| `runtime.prefix` | string | `""` | Optional runtime prefix (e.g., `/opt/webkitgtk`) used to locate newer GTK/WebKitGTK installs |
448
449If set, dumber prepends prefix-derived paths to:
450- `PKG_CONFIG_PATH` (for version checks)
451- `LD_LIBRARY_PATH` (for runtime library loading)
452- `GI_TYPELIB_PATH` (GObject introspection)
453- `XDG_DATA_DIRS` (schemas/resources)
454
455**Example:**
456```toml
457[runtime]
458prefix = "/opt/webkitgtk"
459```
460
461## Clipboard
462
463| Key | Type | Default | Description |
464|-----|------|---------|-------------|
465| `clipboard.auto_copy_on_selection` | bool | `true` | Automatically copy selected text to clipboard (zellij/tmux-style) |
466
467When 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.
468
469**Example:**
470```toml
471[clipboard]
472auto_copy_on_selection = true  # Enabled by default
473```
474
475## Content Filtering
476
477| Key | Type | Default | Description |
478|-----|------|---------|-------------|
479| `content_filtering.enabled` | bool | `true` | Enable ad blocking |
480| `content_filtering.auto_update` | bool | `true` | Automatically update filters |
481
482Notes:
483- Filter data is downloaded from `bnema/ublock-webkit-filters` GitHub releases.
484- Domain whitelist is managed via the database (`content_whitelist` table), not the config file.
485
486## Update
487
488| Key | Type | Default | Description |
489|-----|------|---------|-------------|
490| `update.enable_on_startup` | bool | `true` | Check for updates when browser starts |
491| `update.auto_download` | bool | `false` | Automatically download updates in background |
492| `update.notify_on_new_settings` | bool | `true` | Show toast notification when new config settings are available |
493
494**Example:**
495```toml
496[update]
497enable_on_startup = true       # Check for updates on startup
498auto_download = false          # Don't auto-download (prompt instead)
499notify_on_new_settings = true  # Show toast when config migration available
500```
501
502**CLI Commands:**
503```bash
504# Check config status and available migrations
505dumber config status
506
507# Add missing settings with default values
508dumber config migrate
509
510# Skip confirmation prompt
511dumber config migrate --yes
512```
513
514## Performance Profiles
515
516Performance profiles provide preset configurations for WebKitGTK tuning. These settings affect Skia rendering threads, memory pressure handling, and WebView pool behavior.
517
518> **Note:** Performance settings are applied at browser startup. Changes require a restart to take effect.
519
520| Key | Type | Default | Valid Values | Description |
521|-----|------|---------|--------------|-------------|
522| `performance.profile` | string | `"default"` | `default`, `lite`, `max`, `custom` | Performance profile selection |
523
524### Profiles
525
526| Profile | Description | Use Case |
527|---------|-------------|----------|
528| `default` | No tuning, uses WebKit defaults | Normal browsing, most users |
529| `lite` | Reduced resource usage | Low-RAM systems (< 4GB), battery saving |
530| `max` | Maximum responsiveness | Heavy pages (GitHub PRs, complex SPAs), high-end systems |
531| `custom` | Manual control over all settings | Advanced users who want fine-grained control |
532
533### Profile Settings Matrix
534
535| Setting | default | lite | max |
536|---------|---------|------|-----|
537| Skia CPU threads | unset | 2 | `NumCPU()/2` (min 4) |
538| Skia GPU threads | unset | unset | scales with VRAM |
539| Web process memory (MB) | unset | 768 | unset |
540| Network process memory (MB) | unset | 384 | unset |
541| Conservative threshold | unset | 0.25 | unset |
542| Strict threshold | unset | 0.4 | unset |
543| WebView pool prewarm | 4 | 2 | scales with RAM |
544
545**Example:**
546```toml
547[performance]
548profile = "default"  # Most users - no tuning needed
549
550# For low-RAM systems:
551# profile = "lite"
552
553# For heavy pages (GitHub PRs, complex web apps):
554# profile = "max"
555
556# For manual control:
557# profile = "custom"
558```
559
560### Custom Profile Settings
561
562When `profile = "custom"`, you can configure individual tuning options:
563
564| Key | Type | Default | Description |
565|-----|------|---------|-------------|
566| `performance.skia_cpu_painting_threads` | int | `0` | Skia CPU rendering threads (0=unset) |
567| `performance.skia_gpu_painting_threads` | int | `-1` | Skia GPU rendering threads (-1=unset, 0=disable) |
568| `performance.skia_enable_cpu_rendering` | bool | `false` | Force CPU rendering |
569| `performance.web_process_memory_limit_mb` | int | `0` | Web process memory limit in MB (0=unset) |
570| `performance.web_process_memory_poll_interval_sec` | float | `0` | Memory check interval (0=WebKit default: 30s) |
571| `performance.web_process_memory_conservative_threshold` | float | `0` | Conservative cleanup threshold (0=unset) |
572| `performance.web_process_memory_strict_threshold` | float | `0` | Strict cleanup threshold (0=unset) |
573| `performance.network_process_memory_limit_mb` | int | `0` | Network process memory limit in MB |
574| `performance.network_process_memory_poll_interval_sec` | float | `0` | Network memory check interval |
575| `performance.network_process_memory_conservative_threshold` | float | `0` | Network conservative threshold |
576| `performance.network_process_memory_strict_threshold` | float | `0` | Network strict threshold |
577| `performance.webview_pool_prewarm_count` | int | `4` | WebViews to pre-create at startup |
578| `performance.zoom_cache_size` | int | `256` | Domain zoom levels to cache |
579
580**Custom profile example:**
581```toml
582[performance]
583profile = "custom"
584
585# Skia threading - tune for your CPU
586skia_cpu_painting_threads = 4
587skia_gpu_painting_threads = 2
588
589# Web process memory pressure
590web_process_memory_limit_mb = 1024
591web_process_memory_conservative_threshold = 0.4
592web_process_memory_strict_threshold = 0.6
593
594# WebView pool
595webview_pool_prewarm_count = 6
596```
597
598> **Important:** Individual tuning fields are ignored unless `profile = "custom"`. Setting individual fields with any other profile will produce a validation warning.
599
600## Downloads
601
602| Key | Type | Default | Description |
603|-----|------|---------|-------------|
604| `downloads.path` | string | `""` | Download directory path (empty = `$XDG_DOWNLOAD_DIR` or `~/Downloads`) |
605
606Downloads are saved to the configured directory with toast notifications for download started, completed, and failed events.
607
608**Example:**
609```toml
610[downloads]
611path = ""  # Use system default ($XDG_DOWNLOAD_DIR or ~/Downloads)
612
613# Or specify a custom directory:
614# path = "/home/user/my-downloads"
615```
616
617## Environment Variables
618
619All config values can be overridden via environment variables with the prefix `DUMBER_`:
620
621```bash
622# Database
623DUMBER_DATABASE_PATH=/custom/path/db.sqlite
624
625# Rendering (examples)
626# Defaults: rendering.disable_dmabuf_renderer=false, rendering.gsk_renderer="auto"
627DUMBER_RENDERING_MODE=cpu
628# DUMBER_RENDERING_DISABLE_DMABUF_RENDERER=true
629# DUMBER_RENDERING_GSK_RENDERER=opengl
630DUMBER_DEFAULT_WEBPAGE_ZOOM=1.5
631
632# Logging
633DUMBER_LOG_LEVEL=debug
634DUMBER_LOG_FORMAT=json
635```

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