docs: document cef_dir as optional, add CEF engine setup in README

commit: 06300740261532093928b8da238dfc985c3211b6
author: brice · 5mo ago · 2026-04-28 04:17 UTC
parent: e6b7103
signature: GPG VerifiedCD88F9E564E0102646FB6077A1A07C7C7C3E349D · arch-gpg Verified for the committer email

2 files · +25 -1

M README.md +24 -0


@@ -76,6 +76,30 @@ sudo apt install libwebkitgtk-6.0-4 libgtk-4-1 gstreamer1.0-plugins-base gstream
76	76
77	77		> ⚠️ Ubuntu 24.04 ships GLib 2.80, but Dumber requires GLib 2.84+. Use Arch, Fedora 41+, or the Flatpak.
78	78
	79	+	### CEF engine (optional)
	80	+
	81	+	Dumber supports a Chromium Embedded Framework engine as an alternative to WebKit.
	82	+	To use it on Arch:
	83	+
	84	+	```bash
	85	+	sudo pacman -S cef
	86	+	```
	87	+
	88	+	Dumber uses `/usr/lib/cef` by default when available. Override via:
	89	+
	90	+	```toml
	91	+	[engine.cef]
	92	+	cef_dir = "/custom/path"
	93	+	```
	94	+
	95	+	Or set the `CEF_DIR` environment variable:
	96	+
	97	+	```bash
	98	+	CEF_DIR=/custom/path dumber browse
	99	+	```
	100	+
	101	+	Then set `engine.type = "cef"` in your config.
	102	+
79	103		## Keyboard-Driven
80	104
81	105		Four modal modes. Enter a mode, act, escape out. Vim and Zellij users already know this pattern.


@@ -76,6 +76,30 @@ sudo apt install libwebkitgtk-6.0-4 libgtk-4-1 gstreamer1.0-plugins-base gstream
76		76
77	> ⚠️ Ubuntu 24.04 ships GLib 2.80, but Dumber requires GLib 2.84+. Use Arch, Fedora 41+, or the Flatpak.	77		> ⚠️ Ubuntu 24.04 ships GLib 2.80, but Dumber requires GLib 2.84+. Use Arch, Fedora 41+, or the Flatpak.
78		78
		79	+	### CEF engine (optional)
		80	+
		81	+	Dumber supports a Chromium Embedded Framework engine as an alternative to WebKit.
		82	+	To use it on Arch:
		83	+
		84	+	```bash
		85	+	sudo pacman -S cef
		86	+	```
		87	+
		88	+	Dumber uses `/usr/lib/cef` by default when available. Override via:
		89	+
		90	+	```toml
		91	+	[engine.cef]
		92	+	cef_dir = "/custom/path"
		93	+	```
		94	+
		95	+	Or set the `CEF_DIR` environment variable:
		96	+
		97	+	```bash
		98	+	CEF_DIR=/custom/path dumber browse
		99	+	```
		100	+
		101	+	Then set `engine.type = "cef"` in your config.
		102	+
79	## Keyboard-Driven	103		## Keyboard-Driven
80		104
81	Four modal modes. Enter a mode, act, escape out. Vim and Zellij users already know this pattern.	105		Four modal modes. Enter a mode, act, escape out. Vim and Zellij users already know this pattern.

M internal/infrastructure/config/schema_provider.go +1 -1


@@ -1028,7 +1028,7 @@ func (SchemaProvider) getRuntimeKeys(defaults Config) []entity.ConfigKeyInfo {
1028	1028		Key: "engine.cef.cef_dir",
1029	1029		Type: "string",
1030	1030		Default: defaults.Engine.CEF.CEFDir,
1031		-	Description: "Custom CEF runtime directory containing libcef and Resources",
	1031	+	Description: "Optional CEF runtime directory containing libcef.so and Resources; overrides the default runtime discovery order (CEF_DIR env, /usr/lib/cef, ~/.local/share/cef)",
1032	1032		Section: SectionRuntime,
1033	1033		},
1034	1034		{


@@ -1028,7 +1028,7 @@ func (SchemaProvider) getRuntimeKeys(defaults Config) []entity.ConfigKeyInfo {
1028		Key: "engine.cef.cef_dir",	1028		Key: "engine.cef.cef_dir",
1029		Type: "string",	1029		Type: "string",
1030		Default: defaults.Engine.CEF.CEFDir,	1030		Default: defaults.Engine.CEF.CEFDir,
1031	-	Description: "Custom CEF runtime directory containing libcef and Resources",	1031	+	Description: "Optional CEF runtime directory containing libcef.so and Resources; overrides the default runtime discovery order (CEF_DIR env, /usr/lib/cef, ~/.local/share/cef)",
1032		Section: SectionRuntime,	1032		Section: SectionRuntime,
1033		},	1033		},
1034		{	1034		{