Settings reference

Generated from the source code of JBrowser 1.5.3.

Every key in settings.json, generated from DEFAULTS in this version's core/settings.py. The Notes column is the comment next to the key in the source; Read in lists the modules that mention the key. How the store works is explained in settings.

59 settings, from DEFAULTS in jbrowser/core/settings.py.

General#

Key	Default	Notes	Read in
`settings.version`	`SETTINGS_VERSION`

Appearance#

Key	Default	Notes	Read in
`appearance.theme`	`"system"`	system \| dark \| light	controller.py, settings.py, onboarding.py, theme.py
`appearance.material`	`"acrylic"`	acrylic \| mica \| mica_alt \| solid	chrome_window.py, controller.py, settings.py, onboarding.py …
`appearance.use_accent`	`true`		settings.py, theme.py
`appearance.animations`	`true`		app.py, context.py, actions.py, controller.py …
`appearance.sidebar_collapsed`	`false`		controller.py, settings.py, sidebar.py
`appearance.favorites_bar`	`true`		actions.py, controller.py, settings.py, favorites_bar.py
`appearance.force_dark_web`	`false`		profiles.py, actions.py, settings.py
`appearance.sounds`	`true`	welcome-screen sound effects	settings.py, onboarding.py, sounds.py
`appearance.tint`	`"none"`	a colour tint from ui/theme.py TINTS, or "none"	actions.py, settings.py, onboarding.py, theme.py
`sidebar.new_card_always`	`true`	"New card" row even when a space has no cards	actions.py, settings.py, sidebar.py
`gallery.all_spaces`	`false`	the Gallery shows every space, not just the current one	gallery.py

Ribbon#

Key	Default	Notes	Read in
`toolbar.home_button`	`false`		actions.py, controller.py, settings.py, onboarding.py …
`toolbar.home_mode`	`"lazy"`	lazy (open the Lazy Toolbar) \| url	controller.py, settings.py, onboarding.py, titlebar.py
`toolbar.home_url`	`""`		controller.py, settings.py, titlebar.py

First-run welcome and guided tour#

Key	Default	Notes	Read in
`onboarding.version`	`0`		app.py, onboarding.py

Automatic updates from GitHub Releases#

Key	Default	Notes	Read in
`updates.auto_check`	`true`		updater.py, settings.py
`updates.last_check`	`0`		updater.py
`updates.skipped`	`""`	a version the user chose to skip	updater.py

Canvas#

Key	Default	Notes	Read in
`canvas.default_width`	`0.5`		tab_controller.py, controller.py, settings.py
`canvas.show_minimap`	`true`		actions.py, canvas.py, controller.py, settings.py

Startup / window#

Key	Default	Read in
`startup.restore_session`	`true`	session.py, settings.py, onboarding.py
`window.geometry`	`null`	window.py
`window.maximized`	`false`	window.py

Search#

Key	Default	Read in
`search.engine`	`"google"`	search.py, settings.py, onboarding.py
`search.suggestions`	`true`	settings.py, lazy_toolbar.py, onboarding.py
`search.keywords`	`DEFAULT_SEARCH_KEYWORDS`	search.py, settings.py
`search.recent`	`[]`	search.py, settings.py

Privacy#

Key	Default	Notes	Read in
`privacy.block_trackers`	`true`		profiles.py, privacy.py, actions.py, controller.py …
`privacy.block_third_party_cookies`	`true`		privacy.py, actions.py, controller.py, settings.py …
`privacy.gpc`	`true`		profiles.py, privacy.py, controller.py, settings.py
`privacy.dnt`	`true`		profiles.py, privacy.py, controller.py, settings.py
`privacy.https_upgrade`	`false`		privacy.py, actions.py, settings.py, onboarding.py
`privacy.popup_blocking`	`true`		profiles.py, settings.py
`privacy.webrtc_public_only`	`true`		profiles.py, settings.py
`privacy.block_autoplay`	`false`		profiles.py, settings.py, onboarding.py
`privacy.allowlist`	`[]`		profiles.py, privacy.py, settings.py
`privacy.blocklist_updated`	`0`		privacy.py, settings.py
`privacy.blocklist_auto`	`true`	weekly background refresh of tracker lists	privacy.py
`privacy.threat_protection`	`true`		threats.py, actions.py, controller.py, settings.py …
`privacy.threatlist_updated`	`0`		threats.py
`privacy.strip_tracking`	`true`		privacy.py, actions.py, controller.py, settings.py …
`privacy.fingerprint_protection`	`true`		profiles.py, actions.py, controller.py, settings.py …
`privacy.clear_on_exit`	`[]`	any of: history, cookies, cache, downloads	context.py, profiles.py, settings.py

Performance#

Key	Default	Read in
`performance.sleep_preset`	`"moderate"`	lifecycle.py, actions.py, controller.py, settings.py
`performance.throttle`	`true`	lifecycle.py, actions.py, controller.py, settings.py
`performance.never_sleep`	`[]`	lifecycle.py, settings.py

Network#

Key	Default	Notes	Read in
`network.dns_mode`	`"quad9"`	system \| quad9 \| cloudflare	context.py, network.py, actions.py, controller.py …
`network.dns_fallback`	`false`		context.py, network.py, settings.py
`network.proxy`	{"mode": "direct", "type": "http", "host…		app.py, context.py, network.py, network.py
`network.dev_hosts`	[{"host": "app.test", "target": "127.0.0…		privacy.py, network.py

Passwords#

Key	Default	Read in
`passwords.offer_save`	`true`	tab_controller.py, settings.py
`passwords.autofill`	`true`	tab_controller.py, settings.py
`passwords.warn_insecure`	`true`	tab_controller.py, settings.py

Downloads#

Key	Default	Read in
`downloads.directory`	`""`	downloads.py, settings.py
`downloads.ask`	`false`	downloads.py, settings.py
`downloads.protect`	`true`	downloads.py, settings.py

Zoom#

Key	Default	Notes	Read in
`zoom.sites`	`{}`		context.py, tab_controller.py, settings.py

Profiles scheduled for deletion on next start#

Key	Default	Notes	Read in
`profiles.pending_wipe`	`[]`		profiles.py, settings.py