## Type: Bool
# c.content.javascript.alert = True
-## Allow JavaScript to read from or write to the clipboard. With
-## QtWebEngine, writing the clipboard as response to a user interaction
-## is always allowed.
-## Type: Bool
-# c.content.javascript.can_access_clipboard = False
-
## Allow JavaScript to close tabs.
## Type: Bool
# c.content.javascript.can_close_tabs = False
## Type: Bool
# c.content.javascript.can_open_tabs_automatically = False
+## Allow JavaScript to read from or write to the clipboard. With
+## QtWebEngine, writing the clipboard as response to a user interaction
+## is always allowed.
+## Type: String
+## Valid values:
+## - none: Disable access to clipboard.
+## - access: Allow reading from and writing to the clipboard.
+## - access-paste: Allow accessing the clipboard and pasting clipboard content.
+# c.content.javascript.clipboard = 'none'
+
## Enable JavaScript.
## Type: Bool
# c.content.javascript.enabled = True
## Type: Dict
# c.content.javascript.log = {'unknown': 'debug', 'info': 'debug', 'warning': 'debug', 'error': 'debug'}
+## Javascript messages to *not* show in the UI, despite a corresponding
+## `content.javascript.log_message.levels` setting. Both keys and values
+## are glob patterns, with the key matching the location of the error,
+## and the value matching the error message. By default, the
+## https://web.dev/csp/[Content security policy] violations triggered by
+## qutebrowser's stylesheet handling are excluded, as those errors are to
+## be expected and can't be easily handled by the underlying code.
+## Type: Dict
+# c.content.javascript.log_message.excludes = {'userscript:_qute_stylesheet': ['*Refused to apply inline style because it violates the following Content Security Policy directive: *']}
+
+## Javascript message sources/levels to show in the qutebrowser UI. When
+## a JavaScript message is logged from a location matching the glob
+## pattern given in the key, and is from one of the levels listed as
+## value, it's surfaced as a message in the qutebrowser UI. By default,
+## errors happening in qutebrowser internally are shown to the user.
+## Type: Dict
+# c.content.javascript.log_message.levels = {'qute:*': ['error'], 'userscript:GM-*': [], 'userscript:*': ['error']}
+
## Use the standard JavaScript modal dialog for `alert()` and
## `confirm()`.
## Type: Bool
## Type: Bool
# c.content.notifications.show_origin = True
-## Allow pdf.js to view PDF files in the browser. Note that the files can
-## still be downloaded by clicking the download button in the pdf.js
-## viewer.
+## Display PDF files via PDF.js in the browser without showing a download
+## prompt. Note that the files can still be downloaded by clicking the
+## download button in the pdf.js viewer. With this set to `false`, the
+## `:prompt-open-download --pdfjs` command (bound to `<Ctrl-p>` by
+## default) can be used in the download prompt.
## Type: Bool
# c.content.pdfjs = False
## Proxy to use. In addition to the listed values, you can use a
## `socks://...` or `http://...` URL. Note that with QtWebEngine, it will
## take a couple of seconds until the change is applied, if this value is
-## changed at runtime.
+## changed at runtime. Authentication for SOCKS proxies isn't supported
+## due to Chromium limitations.
## Type: Proxy
## Valid values:
## - system: Use the system wide proxy.
## - js-string-replaceall
## - js-globalthis
## - js-object-fromentries
+## - js-array-at
## - misc-krunker
## - misc-mathml-darkmode
# c.content.site_specific_quirks.skip = ['js-string-replaceall']
## Type: Encoding
# c.editor.encoding = 'utf-8'
+## Delete the temporary file upon closing the editor.
+## Type: Bool
+# c.editor.remove_file = True
+
## Command (and arguments) to use for selecting a single folder in forms.
## The command should write the selected folder path to the specified
## file or stdout. The following placeholders are defined: * `{}`:
c.fileselect.folder.command = in_terminal(['ranger', '--choosedir={}'])
## Handler for selecting file(s) in forms. If `external`, then the
-## commands specified by `fileselect.single_file.command` and
-## `fileselect.multiple_files.command` are used to select one or multiple
-## files respectively.
+## commands specified by `fileselect.single_file.command`,
+## `fileselect.multiple_files.command` and `fileselect.folder.command`
+## are used to select one file, multiple files, and folders,
+## respectively.
## Type: String
## Valid values:
## - default: Use the default file selector.
## CSS selectors used to determine which elements on a page should have
## hints.
## Type: Dict
-# c.hints.selectors = {'all': ['a', 'area', 'textarea', 'select', 'input:not([type="hidden"])', 'button', 'frame', 'iframe', 'img', 'link', 'summary', '[contenteditable]:not([contenteditable="false"])', '[onclick]', '[onmousedown]', '[role="link"]', '[role="option"]', '[role="button"]', '[ng-click]', '[ngClick]', '[data-ng-click]', '[x-ng-click]', '[tabindex]'], 'links': ['a[href]', 'area[href]', 'link[href]', '[role="link"][href]'], 'images': ['img'], 'media': ['audio', 'img', 'video'], 'url': ['[src]', '[href]'], 'inputs': ['input[type="text"]', 'input[type="date"]', 'input[type="datetime-local"]', 'input[type="email"]', 'input[type="month"]', 'input[type="number"]', 'input[type="password"]', 'input[type="search"]', 'input[type="tel"]', 'input[type="time"]', 'input[type="url"]', 'input[type="week"]', 'input:not([type])', '[contenteditable]:not([contenteditable="false"])', 'textarea']}
+c.hints.selectors = {'all': ['a', 'area', 'textarea', 'select',
+ 'input:not([type="hidden"])', 'button', 'frame',
+ 'iframe', 'img', 'link', 'summary',
+ '[contenteditable]:not([contenteditable="false"])',
+ '[onclick]', '[onmousedown]', '[role="link"]',
+ '[role="option"]', '[role="button"]',
+ '[role="tab"]', '[role="checkbox"]',
+ '[role="menuitem"]', '[role="menuitemcheckbox"]',
+ '[role="menuitemradio"]', '[role="treeitem"]',
+ '[ng-click]', '[ngClick]', '[data-ng-click]',
+ '[x-ng-click]', '[tabindex]:not([tabindex="-1"])'],
+ 'links': ['a[href]', 'area[href]', 'link[href]', '[role="link"][href]'],
+ 'images': ['img'],
+ 'media': ['audio', 'img', 'video'],
+ 'url': ['[src]', '[href]'],
+ 'inputs': ['input[type="text"]', 'input[type="date"]',
+ 'input[type="datetime-local"]',
+ 'input[type="email"]', 'input[type="month"]',
+ 'input[type="number"]', 'input[type="password"]',
+ 'input[type="search"]', 'input[type="tel"]',
+ 'input[type="time"]', 'input[type="url"]',
+ 'input[type="week"]', 'input:not([type])',
+ '[contenteditable]:not([contenteditable="false"])',
+ 'textarea']
+ }
## Make characters in hint strings uppercase.
## Type: Bool
## Type: Bool
# c.input.links_included_in_focus_chain = True
+## Interpret number prefixes as counts for bindings. This enables for vi-
+## like bindings that can be prefixed with a number to indicate a count.
+## Disabling it allows for emacs-like bindings where number keys are
+## passed through (according to `input.forward_unbound_keys`) instead.
+## Type: Bool
+# c.input.match_counts = True
+
## Whether the underlying Chromium should handle media keys. On Linux,
## disabling this also disables Chromium's MPRIS integration.
## Type: Bool
# c.input.media_keys = True
+## Mode to change to when focusing on a tab/URL changes.
+## Type: String
+## Valid values:
+## - normal
+## - insert
+## - passthrough
+# c.input.mode_override = None
+
## Enable back and forward buttons on the mouse.
## Type: Bool
# c.input.mouse.back_forward_buttons = True
# c.input.partial_timeout = 0
## Enable spatial navigation. Spatial navigation consists in the ability
-## to navigate between focusable elements in a Web page, such as
-## hyperlinks and form controls, by using Left, Right, Up and Down arrow
-## keys. For example, if the user presses the Right key, heuristics
-## determine whether there is an element he might be trying to reach
-## towards the right and which element he probably wants.
+## to navigate between focusable elements, such as hyperlinks and form
+## controls, on a web page by using the Left, Right, Up and Down arrow
+## keys. For example, if a user presses the Right key, heuristics
+## determine whether there is an element they might be trying to reach
+## towards the right and which element they probably want.
## Type: Bool
# c.input.spatial_navigation = False
## Type: List of String
c.qt.args = ['proxy-pac-url=file://' + str(config.configdir / 'proxy.pac')]
+## When to use Chromium's low-end device mode. This improves the RAM
+## usage of renderer processes, at the expense of performance.
+## Type: String
+## Valid values:
+## - always: Always use low-end device mode.
+## - auto: Decide automatically (uses low-end mode with < 1 GB available RAM).
+## - never: Never use low-end device mode.
+# c.qt.chromium.low_end_device_mode = 'auto'
+
+## Which Chromium process model to use. Alternative process models use
+## less resources, but decrease security and robustness. See the
+## following pages for more details: -
+## https://www.chromium.org/developers/design-documents/process-models
+## - https://doc.qt.io/qt-5/qtwebengine-features.html#process-models
+## Type: String
+## Valid values:
+## - process-per-site-instance: Pages from separate sites are put into separate processes and separate visits to the same site are also isolated.
+## - process-per-site: Pages from separate sites are put into separate processes. Unlike Process per Site Instance, all visits to the same site will share an OS process. The benefit of this model is reduced memory consumption, because more web pages will share processes. The drawbacks include reduced security, robustness, and responsiveness.
+## - single-process: Run all tabs in a single process. This should be used for debugging purposes only, and it disables `:open --private`.
+# c.qt.chromium.process_model = 'process-per-site-instance'
+
+## What sandboxing mechanisms in Chromium to use. Chromium has various
+## sandboxing layers, which should be enabled for normal browser usage.
+## Mainly for testing and development, it's possible to disable
+## individual sandboxing layers via this setting. Open `chrome://sandbox`
+## to see the current sandbox status. Changing this setting is only
+## recommended if you know what you're doing, as it **disables one of
+## Chromium's security layers**. To avoid sandboxing being accidentally
+## disabled persistently, this setting can only be set via `config.py`,
+## not via `:set`. See the Chromium documentation for more details: - htt
+## ps://chromium.googlesource.com/chromium/src/\+/HEAD/docs/linux/sandbox
+## ing.md[Linux] - https://chromium.googlesource.com/chromium/src/\+/HEAD
+## /docs/design/sandbox.md[Windows] - https://chromium.googlesource.com/c
+## hromium/src/\+/HEAD/docs/design/sandbox_faq.md[FAQ (Windows-centric)]
+## Type: String
+## Valid values:
+## - enable-all: Enable all available sandboxing mechanisms.
+## - disable-seccomp-bpf: Disable the Seccomp BPF filter sandbox (Linux only).
+## - disable-all: Disable all sandboxing (**not recommended!**).
+# c.qt.chromium.sandboxing = 'enable-all'
+
## Additional environment variables to set. Setting an environment
## variable to null/None will unset it.
## Type: Dict
## Type: Bool
# c.qt.highdpi = False
-## When to use Chromium's low-end device mode. This improves the RAM
-## usage of renderer processes, at the expense of performance.
-## Type: String
-## Valid values:
-## - always: Always use low-end device mode.
-## - auto: Decide automatically (uses low-end mode with < 1 GB available RAM).
-## - never: Never use low-end device mode.
-# c.qt.low_end_device_mode = 'auto'
-
-## Which Chromium process model to use. Alternative process models use
-## less resources, but decrease security and robustness. See the
-## following pages for more details: -
-## https://www.chromium.org/developers/design-documents/process-models
-## - https://doc.qt.io/qt-5/qtwebengine-features.html#process-models
-## Type: String
-## Valid values:
-## - process-per-site-instance: Pages from separate sites are put into separate processes and separate visits to the same site are also isolated.
-## - process-per-site: Pages from separate sites are put into separate processes. Unlike Process per Site Instance, all visits to the same site will share an OS process. The benefit of this model is reduced memory consumption, because more web pages will share processes. The drawbacks include reduced security, robustness, and responsiveness.
-## - single-process: Run all tabs in a single process. This should be used for debugging purposes only, and it disables `:open --private`.
-# c.qt.process_model = 'process-per-site-instance'
-
## Work around locale parsing issues in QtWebEngine 5.15.3. With some
## locales, QtWebEngine 5.15.3 is unusable without this workaround. In
## affected scenarios, QtWebEngine will log "Network service crashed,
## Type: Bool
# c.search.wrap = True
+## Display messages when advancing through text matches at the top and
+## bottom of the page, e.g. `Search hit TOP`.
+## Type: Bool
+# c.search.wrap_messages = True
+
## Name of the session to save by default. If this is set to null, the
## session which was last loaded is saved.
## Type: SessionName
## - scroll: Percentage of the current page position like `10%`.
## - scroll_raw: Raw percentage of the current page position like `10`.
## - history: Display an arrow when possible to go back/forward in history.
+## - search_match: A match count when searching, e.g. `Match [2/10]`.
## - tabs: Current active tab, e.g. `2`.
## - keypress: Display pressed keys when composing a vi command.
## - progress: Progress bar for the current page loading.
## - text:foo: Display the static text after the colon, `foo` in the example.
-# c.statusbar.widgets = ['keypress', 'url', 'scroll', 'history', 'tabs', 'progress']
+## - clock: Display current time. The format can be changed by adding a format string via `clock:...`. For supported format strings, see https://docs.python.org/3/library/datetime.html#strftime-and-strptime-format-codes[the Python datetime documentation].
+# c.statusbar.widgets = ['keypress', 'search_match', 'url', 'scroll', 'history', 'tabs', 'progress']
## Open new tabs (middleclick/ctrl+click) in the background.
## Type: Bool
## - center
# c.tabs.title.alignment = 'left'
+## Position of ellipsis in truncated title of tabs.
+## Type: ElidePosition
+## Valid values:
+## - left
+## - right
+## - middle
+## - none
+# c.tabs.title.elide = 'right'
+
## Format to use for the tab title. The following placeholders are
## defined:
## * `{perc}`: Percentage as a string like `[10%]`.
## * `{title_sep}`: The string `" - "` if a title is set, empty otherwise.
## * `{index}`: Index of this tab.
## * `{aligned_index}`: Index of this tab padded with spaces to have the same width.
+## * `{relative_index}`: Index of this tab relative to the current tab.
## * `{id}`: Internal tab ID of this tab.
## * `{scroll_pos}`: Page scroll position.
## * `{host}`: Host of the current web page.
## Page to open if :open -t/-b/-w is used without URL. Use `about:blank`
## for a blank page.
## Type: FuzzyUrl
-c.url.default_page = 'https://duckduckgo.com/?t=chakra'
+# c.url.default_page = 'https://start.duckduckgo.com/'
## URL segments where `:navigate increment/decrement` will search for a
## number.
# config.bind('<Ctrl-Return>', 'command-accept --rapid', mode='command')
# config.bind('<Ctrl-Shift-C>', 'completion-item-yank --sel', mode='command')
# config.bind('<Ctrl-Shift-Tab>', 'completion-item-focus prev-category', mode='command')
+# config.bind('<Ctrl-Shift-W>', 'rl-filename-rubout', mode='command')
# config.bind('<Ctrl-Tab>', 'completion-item-focus next-category', mode='command')
# config.bind('<Ctrl-U>', 'rl-unix-line-discard', mode='command')
-# config.bind('<Ctrl-W>', 'rl-unix-word-rubout', mode='command')
+# config.bind('<Ctrl-W>', 'rl-rubout " "', mode='command')
# config.bind('<Ctrl-Y>', 'rl-yank', mode='command')
# config.bind('<Down>', 'completion-item-focus --history next', mode='command')
# config.bind('<Escape>', 'mode-leave', mode='command')
# config.bind('<Alt-B>', 'rl-backward-word', mode='prompt')
# config.bind('<Alt-Backspace>', 'rl-backward-kill-word', mode='prompt')
# config.bind('<Alt-D>', 'rl-kill-word', mode='prompt')
+# config.bind('<Alt-E>', 'prompt-fileselect-external', mode='prompt')
# config.bind('<Alt-F>', 'rl-forward-word', mode='prompt')
# config.bind('<Alt-Shift-Y>', 'prompt-yank --sel', mode='prompt')
# config.bind('<Alt-Y>', 'prompt-yank', mode='prompt')
# config.bind('<Ctrl-H>', 'rl-backward-delete-char', mode='prompt')
# config.bind('<Ctrl-K>', 'rl-kill-line', mode='prompt')
# config.bind('<Ctrl-P>', 'prompt-open-download --pdfjs', mode='prompt')
+# config.bind('<Ctrl-Shift-W>', 'rl-filename-rubout', mode='prompt')
# config.bind('<Ctrl-U>', 'rl-unix-line-discard', mode='prompt')
-# config.bind('<Ctrl-W>', 'rl-unix-word-rubout', mode='prompt')
+# config.bind('<Ctrl-W>', 'rl-rubout " "', mode='prompt')
# config.bind('<Ctrl-X>', 'prompt-open-download', mode='prompt')
# config.bind('<Ctrl-Y>', 'rl-yank', mode='prompt')
# config.bind('<Down>', 'prompt-item-focus next', mode='prompt')