3 from qutebrowser
.config
.configfiles
import ConfigAPI
4 from qutebrowser
.config
.config
import ConfigContainer
6 c
: ConfigContainer
= c
# noqa: F821 pylint: disable=E0602,C0103
7 config
: ConfigAPI
= config
# noqa: F821 pylint: disable=E0602,C0103
10 def in_terminal(cmd
: list):
11 """Wraps cmd to be run in the default TERMINAL, as set by environment.
13 :cmd: cmd to execute in TERMINAL
14 :returns: A shell command as a list
17 t
= getenv('TERMINAL', 'xterm')
18 return [t
, '-e'] + cmd
21 ## Change the argument to True to still load settings configured via autoconfig.yml
22 config
.load_autoconfig(True)
24 ## Aliases for commands. The keys of the given dictionary are the
25 ## aliases, while the values are the commands they map to.
27 c
.aliases
= {'w': 'session-save',
33 'mpv': 'spawn --userscript ~/src/qutebrowser/misc/userscripts/view_in_mpv'
36 ## Time interval (in milliseconds) between auto-saves of
37 ## config/cookies/etc.
39 # c.auto_save.interval = 15000
41 ## Always restore open sites when qutebrowser is reopened. Without this
42 ## option set, `:wq` (`:quit --save`) needs to be used to save open tabs
43 ## (and restore them), while quitting qutebrowser in any other way will
44 ## not save/restore the session. By default, this will save to the
45 ## session which was last loaded. This behavior can be customized via the
46 ## `session.default_name` setting.
48 c
.auto_save
.session
= True
50 ## Backend to use to display websites. qutebrowser supports two different
51 ## web rendering engines / backends, QtWebEngine and QtWebKit (not
52 ## recommended). QtWebEngine is Qt's official successor to QtWebKit, and
53 ## both the default/recommended backend. It's based on a stripped-down
54 ## Chromium and regularly updated with security fixes and new features by
55 ## the Qt project: https://wiki.qt.io/QtWebEngine QtWebKit was
56 ## qutebrowser's original backend when the project was started. However,
57 ## support for QtWebKit was discontinued by the Qt project with Qt 5.6 in
58 ## 2016. The development of QtWebKit was picked up in an official fork:
59 ## https://github.com/qtwebkit/qtwebkit - however, the project seems to
60 ## have stalled again. The latest release (5.212.0 Alpha 4) from March
61 ## 2020 is based on a WebKit version from 2016, with many known security
62 ## vulnerabilities. Additionally, there is no process isolation and
63 ## sandboxing. Due to all those issues, while support for QtWebKit is
64 ## still available in qutebrowser for now, using it is strongly
68 ## - webengine: Use QtWebEngine (based on Chromium - recommended).
69 ## - webkit: Use QtWebKit (based on WebKit, similar to Safari - many known security issues!).
70 # c.backend = 'webengine'
72 ## Map keys to other keys, so that they are equivalent in all modes. When
73 ## the key used as dictionary-key is pressed, the binding for the key
74 ## used as dictionary-value is invoked instead. This is useful for global
75 ## remappings of keys, for example to map <Ctrl-[> to <Escape>. NOTE:
76 ## This should only be used if two keys should always be equivalent, i.e.
77 ## for things like <Enter> (keypad) and <Return> (non-keypad). For normal
78 ## command bindings, qutebrowser works differently to vim: You always
79 ## bind keys to commands, usually via `:bind` or `config.bind()`. Instead
80 ## of using this setting, consider finding the command a key is bound to
81 ## (e.g. via `:bind gg`) and then binding the same command to the desired
82 ## key. Note that when a key is bound (via `bindings.default` or
83 ## `bindings.commands`), the mapping is ignored.
85 c
.bindings
.key_mappings
= {
86 '<Ctrl-6>': '<Ctrl-^>',
87 '<Ctrl-M>': '<Return>',
88 '<Ctrl-J>': '<Return>',
90 '<Shift-Return>': '<Return>',
91 '<Enter>': '<Return>',
92 '<Shift-Enter>': '<Return>',
93 '<Ctrl-Enter>': '<Ctrl-Return>'
96 ## When to show a changelog after qutebrowser was upgraded.
99 ## - major: Show changelog for major upgrades (e.g. v2.0.0 -> v3.0.0).
100 ## - minor: Show changelog for major and minor upgrades (e.g. v2.0.0 -> v2.1.0).
101 ## - patch: Show changelog for major, minor and patch upgrades (e.g. v2.0.0 -> v2.0.1).
102 ## - never: Never show changelog after upgrades.
103 c
.changelog_after_upgrade
= 'patch'
105 ## Which algorithm to use for modifying how colors are rendered with
106 ## darkmode. The `lightness-cielab` value was added with QtWebEngine 5.14
107 ## and is treated like `lightness-hsl` with older QtWebEngine versions.
110 ## - lightness-cielab: Modify colors by converting them to CIELAB color space and inverting the L value. Not available with Qt < 5.14.
111 ## - lightness-hsl: Modify colors by converting them to the HSL color space and inverting the lightness (i.e. the "L" in HSL).
112 ## - brightness-rgb: Modify colors by subtracting each of r, g, and b from their maximum value.
113 # c.colors.webpage.darkmode.algorithm = 'lightness-cielab'
115 ## Contrast for dark mode. This only has an effect when
116 ## `colors.webpage.darkmode.algorithm` is set to `lightness-hsl` or
119 # c.colors.webpage.darkmode.contrast = 0.0
121 ## Render all web contents using a dark theme. Example configurations
122 ## from Chromium's `chrome://flags`: - "With simple HSL/CIELAB/RGB-based
123 ## inversion": Set `colors.webpage.darkmode.algorithm` accordingly. -
124 ## "With selective image inversion": Set
125 ## `colors.webpage.darkmode.policy.images` to `smart`. - "With selective
126 ## inversion of non-image elements": Set
127 ## `colors.webpage.darkmode.threshold.text` to 150 and
128 ## `colors.webpage.darkmode.threshold.background` to 205. - "With
129 ## selective inversion of everything": Combines the two variants above.
130 ## - "With increased text contrast": Set
131 ## `colors.webpage.darkmode.increase_text_contrast` (QtWebEngine 6.3+)
133 # c.colors.webpage.darkmode.enabled = False
135 ## Render all colors as grayscale. This only has an effect when
136 ## `colors.webpage.darkmode.algorithm` is set to `lightness-hsl` or
139 # c.colors.webpage.darkmode.grayscale.all = False
141 ## Desaturation factor for images in dark mode. If set to 0, images are
142 ## left as-is. If set to 1, images are completely grayscale. Values
143 ## between 0 and 1 desaturate the colors accordingly.
145 # c.colors.webpage.darkmode.grayscale.images = 0.0
147 ## Increase text contrast by drawing an outline of the uninverted color.
149 # c.colors.webpage.darkmode.increase_text_contrast = False
151 ## Which images to apply dark mode to. With QtWebEngine 5.15.0, this
152 ## setting can cause frequent renderer process crashes due to a
153 ## https://codereview.qt-project.org/c/qt/qtwebengine-
154 ## chromium/+/304211[bug in Qt].
157 ## - always: Apply dark mode filter to all images.
158 ## - never: Never apply dark mode filter to any images.
159 ## - smart: Apply dark mode based on image content. Not available with Qt 5.15.0.
160 # c.colors.webpage.darkmode.policy.images = 'smart'
162 ## Which pages to apply dark mode to. The underlying Chromium setting has
163 ## been removed in QtWebEngine 5.15.3, thus this setting is ignored
164 ## there. Instead, every element is now classified individually.
167 ## - always: Apply dark mode filter to all frames, regardless of content.
168 ## - smart: Apply dark mode filter to frames based on background color.
169 # c.colors.webpage.darkmode.policy.page = 'smart'
171 ## Threshold for inverting background elements with dark mode. Background
172 ## elements with brightness above this threshold will be inverted, and
173 ## below it will be left as in the original, non-dark-mode page. Set to
174 ## 256 to never invert the color or to 0 to always invert it. Note: This
175 ## behavior is the opposite of `colors.webpage.darkmode.threshold.text`!
177 # c.colors.webpage.darkmode.threshold.background = 0
179 ## Threshold for inverting text with dark mode. Text colors with
180 ## brightness below this threshold will be inverted, and above it will be
181 ## left as in the original, non-dark-mode page. Set to 256 to always
182 ## invert text color or to 0 to never invert text color.
184 # c.colors.webpage.darkmode.threshold.text = 256
186 ## Value to use for `prefers-color-scheme:` for websites. The "light"
187 ## value is only available with QtWebEngine 5.15.2+. On older versions,
188 ## it is the same as "auto". The "auto" value is broken on QtWebEngine
189 ## 5.15.2 due to a Qt bug. There, it will fall back to "light"
193 ## - auto: Use the system-wide color scheme setting.
194 ## - light: Force a light theme.
195 ## - dark: Force a dark theme.
196 # c.colors.webpage.preferred_color_scheme = 'auto'
198 ## Number of commands to save in the command history. 0: no history / -1:
201 # c.completion.cmd_history_max_items = 100
203 ## Delay (in milliseconds) before updating completions after typing a
206 # c.completion.delay = 0
208 ## Default filesystem autocomplete suggestions for :open. The elements of
209 ## this list show up in the completion window under the Filesystem
210 ## category when the command line contains `:open` but no argument.
211 ## Type: List of String
213 # c.completion.favorite_paths = []
215 ## Height (in pixels or as percentage of the window) of the completion.
217 c
.completion
.height
= 150
219 ## Minimum amount of characters needed to update completions.
221 # c.completion.min_chars = 1
223 ## Which categories to show (in which order) in the :open completion.
231 # c.completion.open_categories = ['searchengines', 'quickmarks', 'bookmarks', 'history', 'filesystem']
233 ## Move on to the next part when there's only one possible completion
236 c
.completion
.quick
= False
238 ## Padding (in pixels) of the scrollbar handle in the completion window.
240 # c.completion.scrollbar.padding = 2
242 ## Width (in pixels) of the scrollbar in the completion window.
244 # c.completion.scrollbar.width = 12
246 ## When to show the autocompletion window.
249 ## - always: Whenever a completion is available.
250 ## - auto: Whenever a completion is requested.
252 # c.completion.show = 'always'
254 ## Shrink the completion to be smaller than the configured size if there
255 ## are no scrollbars.
257 c
.completion
.shrink
= True
259 ## Format of timestamps (e.g. for the history completion). See
260 ## https://sqlite.org/lang_datefunc.html and
261 ## https://docs.python.org/3/library/datetime.html#strftime-strptime-
262 ## behavior for allowed substitutions, qutebrowser uses both sqlite and
263 ## Python to format its timestamps.
265 # c.completion.timestamp_format = '%Y-%m-%d %H:%M'
267 ## Execute the best-matching command on a partial match.
269 # c.completion.use_best_match = False
271 ## A list of patterns which should not be shown in the history. This only
272 ## affects the completion. Matching URLs are still saved in the history
273 ## (and visible on the `:history` page), but hidden in the completion.
274 ## Changing this setting will cause the completion history to be
275 ## regenerated on the next start, which will take a short while.
276 ## Type: List of UrlPattern
277 # c.completion.web_history.exclude = []
279 ## Number of URLs to show in the web history. 0: no history / -1:
282 # c.completion.web_history.max_items = -1
284 ## Require a confirmation before quitting the application.
287 ## - always: Always show a confirmation.
288 ## - multiple-tabs: Show a confirmation if multiple tabs are opened.
289 ## - downloads: Show a confirmation if downloads are running
290 ## - never: Never show a confirmation.
291 c
.confirm_quit
= ['downloads']
293 ## Automatically start playing `<video>` elements.
295 # c.content.autoplay = True
297 ## List of URLs to ABP-style adblocking rulesets. Only used when Brave's
298 ## ABP-style adblocker is used (see `content.blocking.method`). You can
299 ## find an overview of available lists here:
300 ## https://adblockplus.org/en/subscriptions - note that the special
301 ## `subscribe.adblockplus.org` links aren't handled by qutebrowser, you
302 ## will instead need to find the link to the raw `.txt` file (e.g. by
303 ## extracting it from the `location` parameter of the subscribe URL and
306 # c.content.blocking.adblock.lists = ['https://easylist.to/easylist/easylist.txt', 'https://easylist.to/easylist/easyprivacy.txt']
308 ## Enable the ad/host blocker
310 # c.content.blocking.enabled = True
312 ## Block subdomains of blocked hosts. Note: If only a single subdomain is
313 ## blocked but should be allowed, consider using
314 ## `content.blocking.whitelist` instead.
316 # c.content.blocking.hosts.block_subdomains = True
318 ## List of URLs to host blocklists for the host blocker. Only used when
319 ## the simple host-blocker is used (see `content.blocking.method`). The
320 ## file can be in one of the following formats: - An `/etc/hosts`-like
321 ## file - One host per line - A zip-file of any of the above, with either
322 ## only one file, or a file named `hosts` (with any extension). It's
323 ## also possible to add a local file or directory via a `file://` URL. In
324 ## case of a directory, all files in the directory are read as adblock
325 ## lists. The file `~/.config/qutebrowser/blocked-hosts` is always read
328 # c.content.blocking.hosts.lists = ['https://raw.githubusercontent.com/StevenBlack/hosts/master/hosts']
330 ## Which method of blocking ads should be used. Support for Adblock Plus
331 ## (ABP) syntax blocklists using Brave's Rust library requires the
332 ## `adblock` Python package to be installed, which is an optional
333 ## dependency of qutebrowser. It is required when either `adblock` or
334 ## `both` are selected.
337 ## - auto: Use Brave's ABP-style adblocker if available, host blocking otherwise
338 ## - adblock: Use Brave's ABP-style adblocker
339 ## - hosts: Use hosts blocking
340 ## - both: Use both hosts blocking and Brave's ABP-style adblocker
341 # c.content.blocking.method = 'auto'
343 ## A list of patterns that should always be loaded, despite being blocked
344 ## by the ad-/host-blocker. Local domains are always exempt from
345 ## adblocking. Note this whitelists otherwise blocked requests, not
346 ## first-party URLs. As an example, if `example.org` loads an ad from
347 ## `ads.example.org`, the whitelist entry could be
348 ## `https://ads.example.org/*`. If you want to disable the adblocker on a
349 ## given page, use the `content.blocking.enabled` setting with a URL
351 ## Type: List of UrlPattern
352 # c.content.blocking.whitelist = []
354 ## Enable support for the HTML 5 web application cache feature. An
355 ## application cache acts like an HTTP cache in some sense. For documents
356 ## that use the application cache via JavaScript, the loader engine will
357 ## first ask the application cache for the contents, before hitting the
360 # c.content.cache.appcache = True
362 ## Maximum number of pages to hold in the global memory page cache. The
363 ## page cache allows for a nicer user experience when navigating forth or
364 ## back to pages in the forward/back history, by pausing and resuming up
365 ## to _n_ pages. For more information about the feature, please refer to:
366 ## https://webkit.org/blog/427/webkit-page-cache-i-the-basics/
368 # c.content.cache.maximum_pages = 0
370 ## Size (in bytes) of the HTTP network cache. Null to use the default
371 ## value. With QtWebEngine, the maximum supported value is 2147483647 (~2
374 # c.content.cache.size = None
376 ## Allow websites to read canvas elements. Note this is needed for some
377 ## websites to work properly.
379 # c.content.canvas_reading = True
381 ## Which cookies to accept. With QtWebEngine, this setting also controls
382 ## other features with tracking capabilities similar to those of cookies;
383 ## including IndexedDB, DOM storage, filesystem API, service workers, and
384 ## AppCache. Note that with QtWebKit, only `all` and `never` are
385 ## supported as per-domain values. Setting `no-3rdparty` or `no-
386 ## unknown-3rdparty` per-domain on QtWebKit will have the same effect as
387 ## `all`. If this setting is used with URL patterns, the pattern gets
388 ## applied to the origin/first party URL of the page making the request,
389 ## not the request URL. With QtWebEngine 5.15.0+, paths will be stripped
390 ## from URLs, so URL patterns using paths will not match. With
391 ## QtWebEngine 5.15.2+, subdomains are additionally stripped as well, so
392 ## you will typically need to set this setting for `example.com` when the
393 ## cookie is set on `somesubdomain.example.com` for it to work properly.
394 ## To debug issues with this setting, start qutebrowser with `--debug
395 ## --logfilter network --debug-flag log-cookies` which will show all
396 ## cookies being set.
399 ## - all: Accept all cookies.
400 ## - no-3rdparty: Accept cookies from the same origin only. This is known to break some sites, such as GMail.
401 ## - no-unknown-3rdparty: Accept cookies from the same origin only, unless a cookie is already set for the domain. On QtWebEngine, this is the same as no-3rdparty.
402 ## - never: Don't accept cookies at all.
403 c
.content
.cookies
.accept
= 'no-3rdparty'
407 # c.content.cookies.store = True
409 ## Default encoding to use for websites. The encoding must be a string
410 ## describing an encoding such as _utf-8_, _iso-8859-1_, etc.
412 # c.content.default_encoding = 'iso-8859-1'
414 ## Allow websites to share screen content.
420 # c.content.desktop_capture = 'ask'
422 ## Try to pre-fetch DNS entries to speed up browsing.
424 # c.content.dns_prefetch = True
426 ## Expand each subframe to its contents. This will flatten all the frames
427 ## to become one scrollable page.
429 # c.content.frame_flattening = False
431 ## Set fullscreen notification overlay timeout in milliseconds. If set to
432 ## 0, no overlay will be displayed.
434 # c.content.fullscreen.overlay_timeout = 3000
436 ## Limit fullscreen to the browser window (does not expand to fill the
439 # c.content.fullscreen.window = False
441 ## Allow websites to request geolocations.
447 c
.content
.geolocation
= False
449 ## Value to send in the `Accept-Language` header. Note that the value
450 ## read from JavaScript is always the global value.
452 c
.content
.headers
.accept_language
= 'en-UK;q=1.0, en;q=0.9, de;q=0.7, fr;q=0.7, *;q=0.5'
454 ## Custom headers for qutebrowser HTTP requests.
456 # c.content.headers.custom = {}
458 ## Value to send in the `DNT` header. When this is set to true,
459 ## qutebrowser asks websites to not track your identity. If set to null,
460 ## the DNT header is not sent at all.
462 # c.content.headers.do_not_track = True
464 ## When to send the Referer header. The Referer header tells websites
465 ## from which website you were coming from when visiting them. Note that
466 ## with QtWebEngine, websites can override this preference by setting the
467 ## `Referrer-Policy:` header, so that any websites visited from them get
468 ## the full referer. No restart is needed with QtWebKit.
471 ## - always: Always send the Referer. With QtWebEngine 6.2+, this value is unavailable and will act like `same-domain`.
472 ## - never: Never send the Referer. This is not recommended, as some sites may break.
473 ## - same-domain: Only send the Referer for the same domain. This will still protect your privacy, but shouldn't break any sites. With QtWebEngine, the referer will still be sent for other domains, but with stripped path information.
474 # c.content.headers.referer = 'same-domain'
476 ## User agent to send. The following placeholders are defined: *
477 ## `{os_info}`: Something like "X11; Linux x86_64". * `{webkit_version}`:
478 ## The underlying WebKit version (set to a fixed value with
479 ## QtWebEngine). * `{qt_key}`: "Qt" for QtWebKit, "QtWebEngine" for
480 ## QtWebEngine. * `{qt_version}`: The underlying Qt version. *
481 ## `{upstream_browser_key}`: "Version" for QtWebKit, "Chrome" for
482 ## QtWebEngine. * `{upstream_browser_version}`: The corresponding
483 ## Safari/Chrome version. * `{qutebrowser_version}`: The currently
484 ## running qutebrowser version. The default value is equal to the
485 ## unchanged user agent of QtWebKit/QtWebEngine. Note that the value
486 ## read from JavaScript is always the global value. With QtWebEngine
487 ## between 5.12 and 5.14 (inclusive), changing the value exposed to
488 ## JavaScript requires a restart.
489 ## Type: FormatString
490 # c.content.headers.user_agent = 'Mozilla/5.0 ({os_info}) AppleWebKit/{webkit_version} (KHTML, like Gecko) {qt_key}/{qt_version} {upstream_browser_key}/{upstream_browser_version} Safari/{webkit_version}'
492 ## Enable hyperlink auditing (`<a ping>`).
494 # c.content.hyperlink_auditing = False
496 ## Load images automatically in web pages.
498 # c.content.images = True
500 ## Show javascript alerts.
502 # c.content.javascript.alert = True
504 ## Allow JavaScript to close tabs.
506 # c.content.javascript.can_close_tabs = False
508 ## Allow JavaScript to open new tabs without user interaction.
510 # c.content.javascript.can_open_tabs_automatically = False
512 ## Allow JavaScript to read from or write to the clipboard. With
513 ## QtWebEngine, writing the clipboard as response to a user interaction
514 ## is always allowed.
517 ## - none: Disable access to clipboard.
518 ## - access: Allow reading from and writing to the clipboard.
519 ## - access-paste: Allow accessing the clipboard and pasting clipboard content.
520 c
.content
.javascript
.clipboard
= 'none'
521 config
.set('content.javascript.clipboard', 'access', '*://*.gitlab.com/*')
522 config
.set('content.javascript.clipboard', 'access', '*://*.github.com/*')
524 ## Enable JavaScript.
526 # c.content.javascript.enabled = True
528 ## Log levels to use for JavaScript console logging messages. When a
529 ## JavaScript message with the level given in the dictionary key is
530 ## logged, the corresponding dictionary value selects the qutebrowser
531 ## logger to use. On QtWebKit, the "unknown" setting is always used. The
532 ## following levels are valid: `none`, `debug`, `info`, `warning`,
535 # c.content.javascript.log = {'unknown': 'debug', 'info': 'debug', 'warning': 'debug', 'error': 'debug'}
537 ## Javascript messages to *not* show in the UI, despite a corresponding
538 ## `content.javascript.log_message.levels` setting. Both keys and values
539 ## are glob patterns, with the key matching the location of the error,
540 ## and the value matching the error message. By default, the
541 ## https://web.dev/csp/[Content security policy] violations triggered by
542 ## qutebrowser's stylesheet handling are excluded, as those errors are to
543 ## be expected and can't be easily handled by the underlying code.
545 # c.content.javascript.log_message.excludes = {'userscript:_qute_stylesheet': ['*Refused to apply inline style because it violates the following Content Security Policy directive: *']}
547 ## Javascript message sources/levels to show in the qutebrowser UI. When
548 ## a JavaScript message is logged from a location matching the glob
549 ## pattern given in the key, and is from one of the levels listed as
550 ## value, it's surfaced as a message in the qutebrowser UI. By default,
551 ## errors happening in qutebrowser internally are shown to the user.
553 # c.content.javascript.log_message.levels = {'qute:*': ['error'], 'userscript:GM-*': [], 'userscript:*': ['error']}
555 ## Use the standard JavaScript modal dialog for `alert()` and
558 # c.content.javascript.modal_dialog = False
560 ## Show javascript prompts.
562 # c.content.javascript.prompt = True
564 ## Allow locally loaded documents to access other local URLs.
566 # c.content.local_content_can_access_file_urls = True
568 ## Allow locally loaded documents to access remote URLs.
570 # c.content.local_content_can_access_remote_urls = False
572 ## Enable support for HTML 5 local storage and Web SQL.
574 # c.content.local_storage = True
576 ## Allow websites to record audio.
582 # c.content.media.audio_capture = 'ask'
584 ## Allow websites to record audio and video.
590 # c.content.media.audio_video_capture = 'ask'
592 ## Allow websites to record video.
598 # c.content.media.video_capture = 'ask'
600 ## Allow websites to lock your mouse pointer.
606 # c.content.mouse_lock = 'ask'
608 ## Automatically mute tabs. Note that if the `:tab-mute` command is used,
609 ## the mute status for the affected tab is now controlled manually, and
610 ## this setting doesn't have any effect.
612 # c.content.mute = False
614 ## Netrc-file for HTTP authentication. If unset, `~/.netrc` is used.
616 # c.content.netrc_file = None
618 ## Allow websites to show notifications.
624 c
.content
.notifications
.enabled
= 'ask'
625 config
.set('content.notifications.enabled', True, '*://*.gitlab.com/*')
626 config
.set('content.notifications.enabled', True, '*://*.google.com/*')
628 ## What notification presenter to use for web notifications. Note that
629 ## not all implementations support all features of notifications: - The
630 ## `qt` and `systray` options only support showing one notification at
631 ## the time and ignore the `tag` option to replace existing
632 ## notifications. - The `herbe` option only supports showing one
633 ## notification at the time and doesn't show icons. - The `messages`
634 ## option doesn't show icons and doesn't support the `click` and
638 ## - auto: Tries `libnotify`, `systray` and `messages`, uses the first one available without showing error messages.
639 ## - qt: Use Qt's native notification presenter, based on a system tray icon. Switching from or to this value requires a restart of qutebrowser.
640 ## - libnotify: Shows messages via DBus in a libnotify-compatible way. If DBus isn't available, falls back to `systray` or `messages`, but shows an error message.
641 ## - systray: Use a notification presenter based on a systray icon. Falls back to `libnotify` or `messages` if not systray is available. This is a reimplementation of the `qt` setting value, but with the possibility to switch to it at runtime.
642 ## - messages: Show notifications as qutebrowser messages. Most notification features aren't available.
643 ## - herbe: (experimental!) Show notifications using herbe (github.com/dudik/herbe). Most notification features aren't available.
644 # c.content.notifications.presenter = 'auto'
646 ## Whether to show the origin URL for notifications. Note that URL
647 ## patterns with this setting only get matched against the origin part of
648 ## the URL, so e.g. paths in patterns will never match. Note that with
649 ## the `qt` presenter, origins are never shown.
651 # c.content.notifications.show_origin = True
653 ## Display PDF files via PDF.js in the browser without showing a download
654 ## prompt. Note that the files can still be downloaded by clicking the
655 ## download button in the pdf.js viewer. With this set to `false`, the
656 ## `:prompt-open-download --pdfjs` command (bound to `<Ctrl-p>` by
657 ## default) can be used in the download prompt.
659 c
.content
.pdfjs
= True
661 ## Allow websites to request persistent storage quota via
662 ## `navigator.webkitPersistentStorage.requestQuota`.
668 # c.content.persistent_storage = 'ask'
670 ## Enable plugins in Web pages.
672 # c.content.plugins = False
674 ## Request websites to minimize non-essentials animations and motion.
675 ## This results in the `prefers-reduced-motion` CSS media query to
676 ## evaluate to `reduce` (rather than `no-preference`). On Windows, if
677 ## this setting is set to False, the system-wide animation setting is
680 c
.content
.prefers_reduced_motion
= True
682 ## Draw the background color and images also when the page is printed.
684 # c.content.print_element_backgrounds = True
686 ## Open new windows in private browsing mode which does not record
689 # c.content.private_browsing = False
691 ## Proxy to use. In addition to the listed values, you can use a
692 ## `socks://...` or `http://...` URL. Note that with QtWebEngine, it will
693 ## take a couple of seconds until the change is applied, if this value is
694 ## changed at runtime. Authentication for SOCKS proxies isn't supported
695 ## due to Chromium limitations.
698 ## - system: Use the system wide proxy.
699 ## - none: Don't use any proxy
700 # c.content.proxy = 'system'
702 ## Send DNS requests over the configured proxy.
704 # c.content.proxy_dns_requests = True
706 ## Allow websites to register protocol handlers via
707 ## `navigator.registerProtocolHandler`.
713 # c.content.register_protocol_handler = 'ask'
714 with config
.pattern('*://mail.google.com/*') as p
:
715 p
.content
.register_protocol_handler
= False
716 with config
.pattern('*://calendar.google.com/*') as p
:
717 p
.content
.register_protocol_handler
= False
719 ## Enable quirks (such as faked user agent headers) needed to get
720 ## specific sites to work properly.
722 # c.content.site_specific_quirks.enabled = True
724 ## Disable a list of named quirks.
733 ## - js-string-replaceall
736 ## - misc-mathml-darkmode
737 # c.content.site_specific_quirks.skip = []
739 ## How to proceed on TLS certificate errors.
742 ## - ask: Ask how to proceed for every certificate error (unless non-overridable due to HSTS).
743 ## - ask-block-thirdparty: Ask how to proceed for normal page loads, but silently block resource loads.
744 ## - block: Automatically block loading on certificate errors.
745 ## - load-insecurely: Force loading pages despite certificate errors. This is *insecure* and should be avoided. Instead of using this, consider fixing the underlying issue or importing a self-signed certificate via `certutil` (or Chromium) instead.
746 # c.content.tls.certificate_errors = 'ask'
748 ## How navigation requests to URLs with unknown schemes are handled.
751 ## - disallow: Disallows all navigation requests to URLs with unknown schemes.
752 ## - allow-from-user-interaction: Allows navigation requests to URLs with unknown schemes that are issued from user-interaction (like a mouse-click), whereas other navigation requests (for example from JavaScript) are suppressed.
753 ## - allow-all: Allows all navigation requests to URLs with unknown schemes.
754 # c.content.unknown_url_scheme_policy = 'allow-from-user-interaction'
756 ## List of user stylesheet filenames to use.
757 ## Type: List of File, or File
758 # c.content.user_stylesheets = []
762 c
.content
.webgl
= False
763 config
.set('content.webgl', True, '*://meet.google.com/*')
765 ## Which interfaces to expose via WebRTC.
768 ## - all-interfaces: WebRTC has the right to enumerate all interfaces and bind them to discover public interfaces.
769 ## - default-public-and-private-interfaces: WebRTC should only use the default route used by http. This also exposes the associated default private address. Default route is the route chosen by the OS on a multi-homed endpoint.
770 ## - default-public-interface-only: WebRTC should only use the default route used by http. This doesn't expose any local addresses.
771 ## - disable-non-proxied-udp: WebRTC should only use TCP to contact peers or servers unless the proxy server supports UDP. This doesn't expose any local addresses either.
772 # c.content.webrtc_ip_handling_policy = 'all-interfaces'
774 ## Monitor load requests for cross-site scripting attempts. Suspicious
775 ## scripts will be blocked and reported in the devtools JavaScript
776 ## console. Note that bypasses for the XSS auditor are widely known and
777 ## it can be abused for cross-site info leaks in some scenarios, see:
778 ## https://www.chromium.org/developers/design-documents/xss-auditor
780 # c.content.xss_auditing = False
782 ## Directory to save downloads to. If unset, a sensible OS-specific
785 c
.downloads
.location
.directory
= "~/downloads"
787 ## Prompt the user for the download location. If set to false,
788 ## `downloads.location.directory` will be used.
790 # c.downloads.location.prompt = True
792 ## Remember the last used download directory.
794 # c.downloads.location.remember = True
796 ## What to display in the download filename input.
799 ## - path: Show only the download path.
800 ## - filename: Show only download filename.
801 ## - both: Show download path and filename.
802 # c.downloads.location.suggestion = 'path'
804 ## Default program used to open downloads. If null, the default internal
805 ## handler is used. Any `{}` in the string will be expanded to the
806 ## filename, else the filename will be appended.
808 c
.downloads
.open_dispatcher
= "rifle"
810 ## Where to show the downloaded files.
811 ## Type: VerticalPosition
815 # c.downloads.position = 'top'
817 ## Automatically abort insecure (HTTP) downloads originating from secure
818 ## (HTTPS) pages. For per-domain settings, the relevant URL is the URL
819 ## initiating the download, not the URL the download itself is coming
820 ## from. It's not recommended to set this setting to false globally.
822 # c.downloads.prevent_mixed_content = True
824 ## Duration (in milliseconds) to wait before removing finished downloads.
825 ## If set to -1, downloads are never removed.
827 # c.downloads.remove_finished = -1
829 ## Editor (and arguments) to use for the `edit-*` commands. The following
830 ## placeholders are defined: * `{file}`: Filename of the file to be
831 ## edited. * `{line}`: Line in which the caret is found in the text. *
832 ## `{column}`: Column in which the caret is found in the text. *
833 ## `{line0}`: Same as `{line}`, but starting from index 0. * `{column0}`:
834 ## Same as `{column}`, but starting from index 0.
835 ## Type: ShellCommand
836 c
.editor
.command
= in_terminal(['vim', '{file}', '-c', 'normal {line}G{column0}l'])
838 ## Encoding to use for the editor.
840 # c.editor.encoding = 'utf-8'
842 ## Delete the temporary file upon closing the editor.
844 # c.editor.remove_file = True
846 ## Command (and arguments) to use for selecting a single folder in forms.
847 ## The command should write the selected folder path to the specified
848 ## file or stdout. The following placeholders are defined: * `{}`:
849 ## Filename of the file to be written to. If not contained in any
850 ## argument, the standard output of the command is read instead.
851 ## Type: ShellCommand
852 c
.fileselect
.folder
.command
= in_terminal(['ranger', '--choosedir={}'])
854 ## Handler for selecting file(s) in forms. If `external`, then the
855 ## commands specified by `fileselect.single_file.command`,
856 ## `fileselect.multiple_files.command` and `fileselect.folder.command`
857 ## are used to select one file, multiple files, and folders,
861 ## - default: Use the default file selector.
862 ## - external: Use an external command.
863 c
.fileselect
.handler
= 'external'
865 ## Command (and arguments) to use for selecting multiple files in forms.
866 ## The command should write the selected file paths to the specified file
867 ## or to stdout, separated by newlines. The following placeholders are
868 ## defined: * `{}`: Filename of the file to be written to. If not
869 ## contained in any argument, the standard output of the command is
871 ## Type: ShellCommand
872 c
.fileselect
.multiple_files
.command
= in_terminal(['ranger', '--choosefiles={}'])
874 ## Command (and arguments) to use for selecting a single file in forms.
875 ## The command should write the selected file path to the specified file
876 ## or stdout. The following placeholders are defined: * `{}`: Filename of
877 ## the file to be written to. If not contained in any argument, the
878 ## standard output of the command is read instead.
879 ## Type: ShellCommand
880 c
.fileselect
.single_file
.command
= in_terminal(['ranger', '--choosefile={}'])
882 ## Font used in the completion categories.
884 # c.fonts.completion.category = 'bold default_size default_family'
886 ## Font used in the completion widget.
888 # c.fonts.completion.entry = 'default_size default_family'
890 ## Font used for the context menu. If set to null, the Qt default is
893 # c.fonts.contextmenu = None
895 ## Font used for the debugging console.
897 # c.fonts.debug_console = 'default_size default_family'
899 ## Default font families to use. Whenever "default_family" is used in a
900 ## font setting, it's replaced with the fonts listed here. If set to an
901 ## empty value, a system-specific monospace default is used.
902 ## Type: List of Font, or Font
903 c
.fonts
.default_family
= ["Fira Code"]
905 ## Default font size to use. Whenever "default_size" is used in a font
906 ## setting, it's replaced with the size listed here. Valid values are
907 ## either a float value with a "pt" suffix, or an integer value with a
910 # c.fonts.default_size = '10pt'
912 ## Font used for the downloadbar.
914 # c.fonts.downloads = 'default_size default_family'
916 ## Font used for the hints.
918 # c.fonts.hints = 'bold default_size default_family'
920 ## Font used in the keyhint widget.
922 # c.fonts.keyhint = 'default_size default_family'
924 ## Font used for error messages.
926 # c.fonts.messages.error = 'default_size default_family'
928 ## Font used for info messages.
930 # c.fonts.messages.info = 'default_size default_family'
932 ## Font used for warning messages.
934 # c.fonts.messages.warning = 'default_size default_family'
936 ## Font used for prompts.
938 # c.fonts.prompts = 'default_size sans-serif'
940 ## Font used in the statusbar.
942 # c.fonts.statusbar = 'default_size default_family'
944 ## Font used for selected tabs.
946 # c.fonts.tabs.selected = 'default_size default_family'
948 ## Font used for unselected tabs.
950 # c.fonts.tabs.unselected = 'default_size default_family'
952 ## Font used for tooltips. If set to null, the Qt default is used.
954 # c.fonts.tooltip = None
956 ## Font family for cursive fonts.
958 # c.fonts.web.family.cursive = ''
960 ## Font family for fantasy fonts.
962 # c.fonts.web.family.fantasy = ''
964 ## Font family for fixed fonts.
966 # c.fonts.web.family.fixed = ''
968 ## Font family for sans-serif fonts.
970 # c.fonts.web.family.sans_serif = ''
972 ## Font family for serif fonts.
974 # c.fonts.web.family.serif = ''
976 ## Font family for standard fonts.
978 # c.fonts.web.family.standard = ''
980 ## Default font size (in pixels) for regular text.
982 # c.fonts.web.size.default = 16
984 ## Default font size (in pixels) for fixed-pitch text.
986 # c.fonts.web.size.default_fixed = 13
988 ## Hard minimum font size (in pixels).
990 # c.fonts.web.size.minimum = 0
992 ## Minimum logical font size (in pixels) that is applied when zooming
995 # c.fonts.web.size.minimum_logical = 6
997 ## When a hint can be automatically followed without pressing Enter.
1000 ## - always: Auto-follow whenever there is only a single hint on a page.
1001 ## - unique-match: Auto-follow whenever there is a unique non-empty match in either the hint string (word mode) or filter (number mode).
1002 ## - full-match: Follow the hint when the user typed the whole hint (letter, word or number mode) or the element's text (only in number mode).
1003 ## - never: The user will always need to press Enter to follow a hint.
1004 # c.hints.auto_follow = 'unique-match'
1006 ## Duration (in milliseconds) to ignore normal-mode key bindings after a
1007 ## successful auto-follow.
1009 # c.hints.auto_follow_timeout = 0
1011 ## CSS border value for hints.
1013 # c.hints.border = '1px solid #E3BE23'
1015 ## Characters used for hint strings.
1016 ## Type: UniqueCharString
1017 c
.hints
.chars
= 'aoeuidhtns'
1019 ## Dictionary file to be used by the word hints.
1021 # c.hints.dictionary = '/usr/share/dict/words'
1023 ## Which implementation to use to find elements to hint.
1026 ## - javascript: Better but slower
1027 ## - python: Slightly worse but faster
1028 # c.hints.find_implementation = 'python'
1030 ## Hide unmatched hints in rapid mode.
1032 # c.hints.hide_unmatched_rapid_hints = True
1034 ## Leave hint mode when starting a new page load.
1036 # c.hints.leave_on_load = False
1038 ## Minimum number of characters used for hint strings.
1040 c
.hints
.min_chars
= 2
1042 ## Mode to use for hints.
1045 ## - number: Use numeric hints. (In this mode you can also type letters from the hinted element to filter and reduce the number of elements that are hinted.)
1046 ## - letter: Use the characters in the `hints.chars` setting.
1047 ## - word: Use hints words based on the html elements and the extra words.
1048 # c.hints.mode = 'letter'
1050 ## Comma-separated list of regular expressions to use for 'next' links.
1051 ## Type: List of Regex
1052 # c.hints.next_regexes = ['\\bnext\\b', '\\bmore\\b', '\\bnewer\\b', '\\b[>→≫]\\b', '\\b(>>|»)\\b', '\\bcontinue\\b']
1054 ## Padding (in pixels) for hints.
1056 # c.hints.padding = {'top': 0, 'bottom': 0, 'left': 3, 'right': 3}
1058 ## Comma-separated list of regular expressions to use for 'prev' links.
1059 ## Type: List of Regex
1060 # c.hints.prev_regexes = ['\\bprev(ious)?\\b', '\\bback\\b', '\\bolder\\b', '\\b[<←≪]\\b', '\\b(<<|«)\\b']
1062 ## Rounding radius (in pixels) for the edges of hints.
1064 # c.hints.radius = 3
1066 ## Scatter hint key chains (like Vimium) or not (like dwb). Ignored for
1069 c
.hints
.scatter
= False
1071 ## CSS selectors used to determine which elements on a page should have
1074 # TODO: reduce hints on some websites like reddit
1075 c
.hints
.selectors
= {
1077 'a', 'area', 'textarea', 'select', 'input:not([type="hidden"])',
1078 'button', 'frame', 'iframe', 'img', 'link', 'summary',
1079 '[contenteditable]:not([contenteditable="false"])', '[onclick]',
1080 '[onmousedown]', '[role="link"]', '[role="option"]', '[role="button"]',
1081 '[role="tab"]', '[role="checkbox"]', '[role="menuitem"]',
1082 '[role="menuitemcheckbox"]', '[role="menuitemradio"]',
1083 '[role="treeitem"]', '[aria-haspopup]', '[ng-click]', '[ngClick]',
1084 '[data-ng-click]', '[x-ng-click]', '[tabindex]:not([tabindex="-1"])'
1086 'links': ['a[href]', 'area[href]', 'link[href]', '[role="link"][href]'],
1088 'media': ['audio', 'img', 'video'],
1089 'url': ['[src]', '[href]'],
1091 'input[type="text"]', 'input[type="date"]',
1092 'input[type="datetime-local"]', 'input[type="email"]',
1093 'input[type="month"]', 'input[type="number"]',
1094 'input[type="password"]', 'input[type="search"]', 'input[type="tel"]',
1095 'input[type="time"]', 'input[type="url"]', 'input[type="week"]',
1096 'input:not([type])',
1097 '[contenteditable]:not([contenteditable="false"])', 'textarea'
1101 ## Make characters in hint strings uppercase.
1103 # c.hints.uppercase = False
1105 ## Maximum time (in minutes) between two history items for them to be
1106 ## considered being from the same browsing session. Items with less time
1107 ## between them are grouped when being displayed in `:history`. Use -1 to
1108 ## disable separation.
1110 # c.history_gap_interval = 30
1112 ## Allow Escape to quit the crash reporter.
1114 # c.input.escape_quits_reporter = True
1116 ## Which unbound keys to forward to the webview in normal mode.
1119 ## - all: Forward all unbound keys.
1120 ## - auto: Forward unbound non-alphanumeric keys.
1121 ## - none: Don't forward any keys.
1122 # c.input.forward_unbound_keys = 'auto'
1124 ## Enter insert mode if an editable element is clicked.
1126 # c.input.insert_mode.auto_enter = True
1128 ## Leave insert mode if a non-editable element is clicked.
1130 # c.input.insert_mode.auto_leave = True
1132 ## Automatically enter insert mode if an editable element is focused
1133 ## after loading the page.
1135 # c.input.insert_mode.auto_load = False
1137 ## Leave insert mode when starting a new page load. Patterns may be
1138 ## unreliable on this setting, and they may match the url you are
1139 ## navigating to, or the URL you are navigating from.
1141 c
.input.insert_mode
.leave_on_load
= True
1143 ## Switch to insert mode when clicking flash and other plugins.
1145 # c.input.insert_mode.plugins = False
1147 ## Include hyperlinks in the keyboard focus chain when tabbing.
1149 # c.input.links_included_in_focus_chain = True
1151 ## Interpret number prefixes as counts for bindings. This enables for vi-
1152 ## like bindings that can be prefixed with a number to indicate a count.
1153 ## Disabling it allows for emacs-like bindings where number keys are
1154 ## passed through (according to `input.forward_unbound_keys`) instead.
1156 # c.input.match_counts = True
1158 ## Whether the underlying Chromium should handle media keys. On Linux,
1159 ## disabling this also disables Chromium's MPRIS integration.
1161 # c.input.media_keys = True
1163 ## Mode to change to when focusing on a tab/URL changes.
1169 # c.input.mode_override = None
1171 ## Enable back and forward buttons on the mouse.
1173 # c.input.mouse.back_forward_buttons = True
1175 ## Enable Opera-like mouse rocker gestures. This disables the context
1178 # c.input.mouse.rocker_gestures = False
1180 ## Timeout (in milliseconds) for partially typed key bindings. If the
1181 ## current input forms only partial matches, the keystring will be
1182 ## cleared after this time. If set to 0, partially typed bindings are
1185 # c.input.partial_timeout = 0
1187 ## Enable spatial navigation. Spatial navigation consists in the ability
1188 ## to navigate between focusable elements, such as hyperlinks and form
1189 ## controls, on a web page by using the Left, Right, Up and Down arrow
1190 ## keys. For example, if a user presses the Right key, heuristics
1191 ## determine whether there is an element they might be trying to reach
1192 ## towards the right and which element they probably want.
1194 # c.input.spatial_navigation = False
1196 ## Keychains that shouldn't be shown in the keyhint dialog. Globs are
1197 ## supported, so `;*` will blacklist all keychains starting with `;`. Use
1198 ## `*` to disable keyhints.
1199 ## Type: List of String
1200 # c.keyhint.blacklist = []
1202 ## Time (in milliseconds) from pressing a key to seeing the keyhint
1205 # c.keyhint.delay = 500
1207 ## Rounding radius (in pixels) for the edges of the keyhint dialog.
1209 # c.keyhint.radius = 6
1211 ## Level for console (stdout/stderr) logs. Ignored if the `--loglevel` or
1212 ## `--debug` CLI flags are used.
1221 # c.logging.level.console = 'info'
1223 ## Level for in-memory logs.
1232 # c.logging.level.ram = 'debug'
1234 ## Duration (in milliseconds) to show messages in the statusbar for. Set
1235 ## to 0 to never clear messages.
1237 # c.messages.timeout = 3000
1239 ## How to open links in an existing instance if a new one is launched.
1240 ## This happens when e.g. opening a link from a terminal. See
1241 ## `new_instance_open_target_window` to customize in which window the
1242 ## link is opened in.
1245 ## - tab: Open a new tab in the existing window and activate the window.
1246 ## - tab-bg: Open a new background tab in the existing window and activate the window.
1247 ## - tab-silent: Open a new tab in the existing window without activating the window.
1248 ## - tab-bg-silent: Open a new background tab in the existing window without activating the window.
1249 ## - window: Open in a new window.
1250 ## - private-window: Open in a new private window.
1251 # c.new_instance_open_target = 'tab'
1253 ## Which window to choose when opening links as new tabs. When
1254 ## `new_instance_open_target` is set to `window`, this is ignored.
1257 ## - first-opened: Open new tabs in the first (oldest) opened window.
1258 ## - last-opened: Open new tabs in the last (newest) opened window.
1259 ## - last-focused: Open new tabs in the most recently focused window.
1260 ## - last-visible: Open new tabs in the most recently visible window.
1261 c
.new_instance_open_target_window
= 'last-visible'
1263 ## Show a filebrowser in download prompts.
1265 # c.prompt.filebrowser = True
1267 ## Rounding radius (in pixels) for the edges of prompts.
1269 # c.prompt.radius = 8
1271 ## Additional arguments to pass to Qt, without leading `--`. With
1272 ## QtWebEngine, some Chromium arguments (see
1273 ## https://peter.sh/experiments/chromium-command-line-switches/ for a
1275 ## Type: List of String
1276 c
.qt
.args
= ['proxy-pac-url=file://' + str(config
.configdir
/ 'proxy.pac')]
1278 ## Enables Web Platform features that are in development. This passes the
1279 ## `--enable-experimental-web-platform-features` flag to Chromium. By
1280 ## default, this is enabled with Qt 5 to maximize compatibility despite
1281 ## an aging Chromium base.
1284 ## - always: Enable experimental web platform features.
1285 ## - auto: Enable experimental web platform features when using Qt 5.
1286 ## - never: Disable experimental web platform features.
1287 # c.qt.chromium.experimental_web_platform_features = 'auto'
1289 ## When to use Chromium's low-end device mode. This improves the RAM
1290 ## usage of renderer processes, at the expense of performance.
1293 ## - always: Always use low-end device mode.
1294 ## - auto: Decide automatically (uses low-end mode with < 1 GB available RAM).
1295 ## - never: Never use low-end device mode.
1296 # TODO: maybe never?
1297 # c.qt.chromium.low_end_device_mode = 'auto'
1299 ## Which Chromium process model to use. Alternative process models use
1300 ## less resources, but decrease security and robustness. See the
1301 ## following pages for more details: -
1302 ## https://www.chromium.org/developers/design-documents/process-models
1303 ## - https://doc.qt.io/qt-6/qtwebengine-features.html#process-models
1306 ## - process-per-site-instance: Pages from separate sites are put into separate processes and separate visits to the same site are also isolated.
1307 ## - 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.
1308 ## - single-process: Run all tabs in a single process. This should be used for debugging purposes only, and it disables `:open --private`.
1309 # c.qt.chromium.process_model = 'process-per-site-instance'
1311 ## What sandboxing mechanisms in Chromium to use. Chromium has various
1312 ## sandboxing layers, which should be enabled for normal browser usage.
1313 ## Mainly for testing and development, it's possible to disable
1314 ## individual sandboxing layers via this setting. Open `chrome://sandbox`
1315 ## to see the current sandbox status. Changing this setting is only
1316 ## recommended if you know what you're doing, as it **disables one of
1317 ## Chromium's security layers**. To avoid sandboxing being accidentally
1318 ## disabled persistently, this setting can only be set via `config.py`,
1319 ## not via `:set`. See the Chromium documentation for more details: - htt
1320 ## ps://chromium.googlesource.com/chromium/src/\+/HEAD/docs/linux/sandbox
1321 ## ing.md[Linux] - https://chromium.googlesource.com/chromium/src/\+/HEAD
1322 ## /docs/design/sandbox.md[Windows] - https://chromium.googlesource.com/c
1323 ## hromium/src/\+/HEAD/docs/design/sandbox_faq.md[FAQ (Windows-centric)]
1326 ## - enable-all: Enable all available sandboxing mechanisms.
1327 ## - disable-seccomp-bpf: Disable the Seccomp BPF filter sandbox (Linux only).
1328 ## - disable-all: Disable all sandboxing (**not recommended!**).
1329 # c.qt.chromium.sandboxing = 'enable-all'
1331 ## Additional environment variables to set. Setting an environment
1332 ## variable to null/None will unset it.
1336 ## Force a Qt platform to use. This sets the `QT_QPA_PLATFORM`
1337 ## environment variable and is useful to force using the XCB plugin when
1338 ## running QtWebEngine on Wayland.
1340 # c.qt.force_platform = None
1342 ## Force a Qt platformtheme to use. This sets the `QT_QPA_PLATFORMTHEME`
1343 ## environment variable which controls dialogs like the filepicker. By
1344 ## default, Qt determines the platform theme based on the desktop
1347 # c.qt.force_platformtheme = None
1349 ## Force software rendering for QtWebEngine. This is needed for
1350 ## QtWebEngine to work with Nouveau drivers and can be useful in other
1351 ## scenarios related to graphic issues.
1354 ## - software-opengl: Tell LibGL to use a software implementation of GL (`LIBGL_ALWAYS_SOFTWARE` / `QT_XCB_FORCE_SOFTWARE_OPENGL`)
1355 ## - qt-quick: Tell Qt Quick to use a software renderer instead of OpenGL. (`QT_QUICK_BACKEND=software`)
1356 ## - chromium: Tell Chromium to disable GPU support and use Skia software rendering instead. (`--disable-gpu`)
1357 ## - none: Don't force software rendering.
1358 # c.qt.force_software_rendering = 'none'
1360 ## Turn on Qt HighDPI scaling. This is equivalent to setting
1361 ## QT_ENABLE_HIGHDPI_SCALING=1 (Qt >= 5.14) in the environment. It's off
1362 ## by default as it can cause issues with some bitmap fonts. As an
1363 ## alternative to this, it's possible to set font sizes and the
1364 ## `zoom.default` setting.
1366 # c.qt.highdpi = False
1368 ## Disable accelerated 2d canvas to avoid graphical glitches. On some
1369 ## setups graphical issues can occur on sites like Google sheets and
1370 ## PDF.js. These don't occur when accelerated 2d canvas is turned off, so
1371 ## we do that by default. So far these glitches only occur on some Intel
1372 ## graphics devices.
1375 ## - always: Disable accelerated 2d canvas
1376 ## - auto: Disable on Qt6 < 6.6.0, enable otherwise
1377 ## - never: Enable accelerated 2d canvas
1378 # c.qt.workarounds.disable_accelerated_2d_canvas = 'auto'
1380 ## Work around locale parsing issues in QtWebEngine 5.15.3. With some
1381 ## locales, QtWebEngine 5.15.3 is unusable without this workaround. In
1382 ## affected scenarios, QtWebEngine will log "Network service crashed,
1383 ## restarting service." and only display a blank page. However, It is
1384 ## expected that distributions shipping QtWebEngine 5.15.3 follow up with
1385 ## a proper fix soon, so it is disabled by default.
1387 # c.qt.workarounds.locale = False
1389 ## Delete the QtWebEngine Service Worker directory on every start. This
1390 ## workaround can help with certain crashes caused by an unknown
1391 ## QtWebEngine bug related to Service Workers. Those crashes happen
1392 ## seemingly immediately on Windows; after one hour of operation on other
1393 ## systems. Note however that enabling this option *can lead to data
1394 ## loss* on some pages (as Service Worker data isn't persisted) and will
1395 ## negatively impact start-up time.
1397 # c.qt.workarounds.remove_service_workers = False
1399 ## When/how to show the scrollbar.
1402 ## - always: Always show the scrollbar.
1403 ## - never: Never show the scrollbar.
1404 ## - when-searching: Show the scrollbar when searching for text in the webpage. With the QtWebKit backend, this is equal to `never`.
1405 ## - overlay: Show an overlay scrollbar. On macOS, this is unavailable and equal to `when-searching`; with the QtWebKit backend, this is equal to `never`. Enabling/disabling overlay scrollbars requires a restart.
1406 # c.scrolling.bar = 'overlay'
1408 ## Enable smooth scrolling for web pages. Note smooth scrolling does not
1409 ## work with the `:scroll-px` command.
1411 # c.scrolling.smooth = False
1413 ## When to find text on a page case-insensitively.
1416 ## - always: Search case-insensitively.
1417 ## - never: Search case-sensitively.
1418 ## - smart: Search case-sensitively if there are capital characters.
1419 # c.search.ignore_case = 'smart'
1421 ## Find text on a page incrementally, renewing the search for each typed
1424 # c.search.incremental = True
1426 ## Wrap around at the top and bottom of the page when advancing through
1427 ## text matches using `:search-next` and `:search-prev`.
1429 # c.search.wrap = True
1431 ## Display messages when advancing through text matches at the top and
1432 ## bottom of the page, e.g. `Search hit TOP`.
1434 # c.search.wrap_messages = True
1436 ## Name of the session to save by default. If this is set to null, the
1437 ## session which was last loaded is saved.
1438 ## Type: SessionName
1439 # c.session.default_name = None
1441 ## Load a restored tab as soon as it takes focus.
1443 # c.session.lazy_restore = False
1445 ## Whether to automatically save a session when it is closed.
1447 # c.session.save_when_close = True
1449 ## Which sessions to load on startup. None will load the last saved
1450 ## sessions from the sate file, if you want to not load any sessions,
1451 ## pass an empty list.
1452 ## Type: List of String
1453 # c.session.startup_sessions = None
1455 ## Languages to use for spell checking. You can check for available
1456 ## languages and install dictionaries using scripts/dictcli.py. Run the
1457 ## script with -h/--help for instructions.
1458 ## Type: List of String
1460 ## - af-ZA: Afrikaans (South Africa)
1461 ## - bg-BG: Bulgarian (Bulgaria)
1462 ## - ca-ES: Catalan (Spain)
1463 ## - cs-CZ: Czech (Czech Republic)
1464 ## - da-DK: Danish (Denmark)
1465 ## - de-DE: German (Germany)
1466 ## - el-GR: Greek (Greece)
1467 ## - en-AU: English (Australia)
1468 ## - en-CA: English (Canada)
1469 ## - en-GB: English (United Kingdom)
1470 ## - en-US: English (United States)
1471 ## - es-ES: Spanish (Spain)
1472 ## - et-EE: Estonian (Estonia)
1473 ## - fa-IR: Farsi (Iran)
1474 ## - fo-FO: Faroese (Faroe Islands)
1475 ## - fr-FR: French (France)
1476 ## - he-IL: Hebrew (Israel)
1477 ## - hi-IN: Hindi (India)
1478 ## - hr-HR: Croatian (Croatia)
1479 ## - hu-HU: Hungarian (Hungary)
1480 ## - id-ID: Indonesian (Indonesia)
1481 ## - it-IT: Italian (Italy)
1483 ## - lt-LT: Lithuanian (Lithuania)
1484 ## - lv-LV: Latvian (Latvia)
1485 ## - nb-NO: Norwegian (Norway)
1486 ## - nl-NL: Dutch (Netherlands)
1487 ## - pl-PL: Polish (Poland)
1488 ## - pt-BR: Portuguese (Brazil)
1489 ## - pt-PT: Portuguese (Portugal)
1490 ## - ro-RO: Romanian (Romania)
1491 ## - ru-RU: Russian (Russia)
1492 ## - sh: Serbo-Croatian
1493 ## - sk-SK: Slovak (Slovakia)
1494 ## - sl-SI: Slovenian (Slovenia)
1497 ## - sv-SE: Swedish (Sweden)
1498 ## - ta-IN: Tamil (India)
1499 ## - tg-TG: Tajik (Tajikistan)
1500 ## - tr-TR: Turkish (Turkey)
1501 ## - uk-UA: Ukrainian (Ukraine)
1502 ## - vi-VN: Vietnamese (Viet Nam)
1503 c
.spellcheck
.languages
= ['en-GB']
1505 ## Padding (in pixels) for the statusbar.
1507 # c.statusbar.padding = {'top': 1, 'bottom': 1, 'left': 0, 'right': 0}
1509 ## Position of the status bar.
1510 ## Type: VerticalPosition
1514 # c.statusbar.position = 'bottom'
1516 ## When to show the statusbar.
1519 ## - always: Always show the statusbar.
1520 ## - never: Always hide the statusbar.
1521 ## - in-mode: Show the statusbar when in modes other than normal mode.
1522 # c.statusbar.show = 'always'
1524 ## List of widgets displayed in the statusbar.
1525 ## Type: List of StatusbarWidget
1527 ## - url: Current page URL.
1528 ## - scroll: Percentage of the current page position like `10%`.
1529 ## - scroll_raw: Raw percentage of the current page position like `10`.
1530 ## - history: Display an arrow when possible to go back/forward in history.
1531 ## - search_match: A match count when searching, e.g. `Match [2/10]`.
1532 ## - tabs: Current active tab, e.g. `2`.
1533 ## - keypress: Display pressed keys when composing a vi command.
1534 ## - progress: Progress bar for the current page loading.
1535 ## - text:foo: Display the static text after the colon, `foo` in the example.
1536 ## - 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].
1537 # c.statusbar.widgets = ['keypress', 'search_match', 'url', 'scroll', 'history', 'tabs', 'progress']
1539 ## Open new tabs (middleclick/ctrl+click) in the background.
1541 # c.tabs.background = True
1543 ## Mouse button with which to close tabs.
1546 ## - right: Close tabs on right-click.
1547 ## - middle: Close tabs on middle-click.
1548 ## - none: Don't close tabs using the mouse.
1549 # c.tabs.close_mouse_button = 'middle'
1551 ## How to behave when the close mouse button is pressed on the tab bar.
1554 ## - new-tab: Open a new tab.
1555 ## - close-current: Close the current tab.
1556 ## - close-last: Close the last tab.
1557 ## - ignore: Don't do anything.
1558 # c.tabs.close_mouse_button_on_bar = 'new-tab'
1560 ## Scaling factor for favicons in the tab bar. The tab size is unchanged,
1561 ## so big favicons also require extra `tabs.padding`.
1563 # c.tabs.favicons.scale = 1.0
1565 ## When to show favicons in the tab bar. When switching this from never
1566 ## to always/pinned, note that favicons might not be loaded yet, thus
1567 ## tabs might require a reload to display them.
1570 ## - always: Always show favicons.
1571 ## - never: Always hide favicons.
1572 ## - pinned: Show favicons only on pinned tabs.
1573 # c.tabs.favicons.show = 'always'
1575 ## Maximum stack size to remember for tab switches (-1 for no maximum).
1577 # c.tabs.focus_stack_size = 10
1579 ## Padding (in pixels) for tab indicators.
1581 # c.tabs.indicator.padding = {'top': 2, 'bottom': 2, 'left': 0, 'right': 4}
1583 ## Width (in pixels) of the progress indicator (0 to disable).
1585 # c.tabs.indicator.width = 3
1587 ## How to behave when the last tab is closed. If the
1588 ## `tabs.tabs_are_windows` setting is set, this is ignored and the
1589 ## behavior is always identical to the `close` value.
1592 ## - ignore: Don't do anything.
1593 ## - blank: Load a blank page.
1594 ## - startpage: Load the start page.
1595 ## - default-page: Load the default page.
1596 ## - close: Close the window.
1597 # c.tabs.last_close = 'ignore'
1599 ## Maximum width (in pixels) of tabs (-1 for no maximum). This setting
1600 ## only applies when tabs are horizontal. This setting does not apply to
1601 ## pinned tabs, unless `tabs.pinned.shrink` is False. This setting may
1602 ## not apply properly if max_width is smaller than the minimum size of
1603 ## tab contents, or smaller than tabs.min_width.
1605 # c.tabs.max_width = -1
1607 ## Minimum width (in pixels) of tabs (-1 for the default minimum size
1608 ## behavior). This setting only applies when tabs are horizontal. This
1609 ## setting does not apply to pinned tabs, unless `tabs.pinned.shrink` is
1612 # c.tabs.min_width = -1
1614 ## When switching tabs, what input mode is applied.
1617 ## - persist: Retain the current mode.
1618 ## - restore: Restore previously saved mode.
1619 ## - normal: Always revert to normal mode.
1620 # c.tabs.mode_on_change = 'normal'
1622 ## Switch between tabs using the mouse wheel.
1624 # c.tabs.mousewheel_switching = True
1626 ## Position of new tabs opened from another tab. See
1627 ## `tabs.new_position.stacking` for controlling stacking behavior.
1628 ## Type: NewTabPosition
1630 ## - prev: Before the current tab.
1631 ## - next: After the current tab.
1632 ## - first: At the beginning.
1633 ## - last: At the end.
1634 # c.tabs.new_position.related = 'next'
1636 ## Stack related tabs on top of each other when opened consecutively.
1637 ## Only applies for `next` and `prev` values of
1638 ## `tabs.new_position.related` and `tabs.new_position.unrelated`.
1640 # c.tabs.new_position.stacking = True
1642 ## Position of new tabs which are not opened from another tab. See
1643 ## `tabs.new_position.stacking` for controlling stacking behavior.
1644 ## Type: NewTabPosition
1646 ## - prev: Before the current tab.
1647 ## - next: After the current tab.
1648 ## - first: At the beginning.
1649 ## - last: At the end.
1650 c
.tabs
.new_position
.unrelated
= 'next'
1652 ## Padding (in pixels) around text for tabs.
1654 # c.tabs.padding = {'top': 0, 'bottom': 0, 'left': 5, 'right': 5}
1656 ## Force pinned tabs to stay at fixed URL.
1658 # c.tabs.pinned.frozen = True
1660 ## Shrink pinned tabs down to their contents.
1662 # c.tabs.pinned.shrink = True
1664 ## Position of the tab bar.
1671 # c.tabs.position = 'top'
1673 ## Which tab to select when the focused tab is removed.
1674 ## Type: SelectOnRemove
1676 ## - prev: Select the tab which came before the closed one (left in horizontal, above in vertical).
1677 ## - next: Select the tab which came after the closed one (right in horizontal, below in vertical).
1678 ## - last-used: Select the previously selected tab.
1679 c
.tabs
.select_on_remove
= 'prev'
1681 ## When to show the tab bar.
1684 ## - always: Always show the tab bar.
1685 ## - never: Always hide the tab bar.
1686 ## - multiple: Hide the tab bar if only one tab is open.
1687 ## - switching: Show the tab bar when switching tabs.
1688 # c.tabs.show = 'always'
1690 ## Duration (in milliseconds) to show the tab bar before hiding it when
1691 ## tabs.show is set to 'switching'.
1693 # c.tabs.show_switching_delay = 800
1695 ## Open a new window for every tab.
1697 # c.tabs.tabs_are_windows = False
1699 ## Alignment of the text inside of tabs.
1700 ## Type: TextAlignment
1705 # c.tabs.title.alignment = 'left'
1707 ## Position of ellipsis in truncated title of tabs.
1708 ## Type: ElidePosition
1714 # c.tabs.title.elide = 'right'
1716 ## Format to use for the tab title. The following placeholders are
1718 ## * `{perc}`: Percentage as a string like `[10%]`.
1719 ## * `{perc_raw}`: Raw percentage, e.g. `10`.
1720 ## * `{current_title}`: Title of the current web page.
1721 ## * `{title_sep}`: The string `" - "` if a title is set, empty otherwise.
1722 ## * `{index}`: Index of this tab.
1723 ## * `{aligned_index}`: Index of this tab padded with spaces to have the same width.
1724 ## * `{relative_index}`: Index of this tab relative to the current tab.
1725 ## * `{id}`: Internal tab ID of this tab.
1726 ## * `{scroll_pos}`: Page scroll position.
1727 ## * `{host}`: Host of the current web page.
1728 ## * `{backend}`: Either `webkit` or `webengine`
1729 ## * `{private}`: Indicates when private mode is enabled.
1730 ## * `{current_url}`: URL of the current web page.
1731 ## * `{protocol}`: Protocol (http/https/...) of the current web page.
1732 ## * `{audio}`: Indicator for audio/mute status.
1733 ## Type: FormatString
1734 # c.tabs.title.format = '{audio}{index}: {current_title}'
1736 ## Format to use for the tab title for pinned tabs. The same placeholders
1737 ## like for `tabs.title.format` are defined.
1738 ## Type: FormatString
1739 # c.tabs.title.format_pinned = '{index}'
1741 ## Show tooltips on tabs. Note this setting only affects windows opened
1742 ## after it has been set.
1744 # c.tabs.tooltips = True
1746 ## Number of closed tabs (per window) and closed windows to remember for
1747 ## :undo (-1 for no maximum).
1749 # c.tabs.undo_stack_size = 100
1751 ## Width (in pixels or as percentage of the window) of the tab bar if
1754 # c.tabs.width = '15%'
1756 ## Wrap when changing tabs.
1758 # c.tabs.wrap = True
1760 ## What search to start when something else than a URL is entered.
1763 ## - naive: Use simple/naive check.
1764 ## - dns: Use DNS requests (might be slow!).
1765 ## - never: Never search automatically.
1766 ## - schemeless: Always search automatically unless URL explicitly contains a scheme.
1767 # c.url.auto_search = 'naive'
1769 ## Page to open if :open -t/-b/-w is used without URL. Use `about:blank`
1770 ## for a blank page.
1772 # c.url.default_page = 'https://start.duckduckgo.com/'
1774 ## URL segments where `:navigate increment/decrement` will search for a
1783 # c.url.incdec_segments = ['path', 'query']
1785 ## Open base URL of the searchengine if a searchengine shortcut is
1786 ## invoked without parameters.
1788 # c.url.open_base_url = False
1790 ## Search engines which can be used via the address bar. Maps a search
1791 ## engine name (such as `DEFAULT`, or `ddg`) to a URL with a `{}`
1792 ## placeholder. The placeholder will be replaced by the search term, use
1793 ## `{{` and `}}` for literal `{`/`}` braces. The following further
1794 ## placeholds are defined to configure how special characters in the
1795 ## search terms are replaced by safe characters (called 'quoting'):
1796 ## * `{}` and `{semiquoted}` quote everything except slashes; this is the
1797 ## most sensible choice for almost all search engines (for the search
1798 ## term `slash/and&` this placeholder expands to `slash/and%26amp`).
1799 ## * `{quoted}` quotes all characters (for `slash/and&` this
1800 ## placeholder expands to `slash%2Fand%26amp`).
1801 ## * `{unquoted}` quotes nothing (for `slash/and&` this placeholder
1802 ## expands to `slash/and&`).
1803 ## * `{0}` means the same as `{}`, but can be used multiple times. The search
1804 ## engine named `DEFAULT` is used when
1805 ## `url.auto_search` is turned on and something else than a URL was
1806 ## entered to be opened. Other search engines can be used by prepending
1807 ## the search engine name to the search term, e.g. `:open google
1810 c
.url
.searchengines
= {'DEFAULT': 'https://duckduckgo.com/?t=chakra&q={}
',
1811 'ddg
': 'https
://duckduckgo
.com
/?t
=chakra
&q
={}',
1812 'cdda
': 'https
://nornagon
.github
.io
/cdda
-guide
/?v
=0.F
-2#/search/{}',
1813 'std': 'http://en.cppreference.com/mwiki/index.php?title=Special%3ASearch&search={}',
1814 'hoogle': 'https://hoogle.haskell.org/?hoogle={}',
1815 'h': 'https://hoogle.haskell.org/?hoogle={}',
1816 'fpp/slack': 'https://focalpointpositioning.slack.com/messages/{}',
1817 'fpp/confluence': 'https://fppnt.atlassian.net/wiki/search?text={}',
1818 'evk': 'https://gitlab.com/search?&scope=issues&group_id=13301433&search={}',
1819 'dev': 'https://devdocs.io/#q={}',
1820 'phind': 'https://www.phind.com/search?q={}',
1823 ## Page(s) to open at the start.
1824 ## Type: List of FuzzyUrl, or FuzzyUrl
1825 # c.url.start_pages = ['https://start.duckduckgo.com']
1827 ## URL parameters to strip with `:yank url`.
1828 ## Type: List of String
1829 # c.url.yank_ignored_parameters = ['ref', 'utm_source', 'utm_medium', 'utm_campaign', 'utm_term', 'utm_content']
1831 ## Hide the window decoration. This setting requires a restart on
1834 # c.window.hide_decoration = False
1836 ## Format to use for the window title. The same placeholders like for
1837 ## `tabs.title.format` are defined.
1838 ## Type: FormatString
1839 # c.window.title_format = '{perc}{current_title}{title_sep}qutebrowser'
1841 ## Set the main window background to transparent. This allows having a
1842 ## transparent tab- or statusbar (might require a compositor such as
1843 ## picom). However, it breaks some functionality such as dmenu embedding
1844 ## via its `-w` option. On some systems, it was additionally reported
1845 ## that main window transparency negatively affects performance. Note
1846 ## this setting only affects windows opened after setting it.
1848 # c.window.transparent = False
1850 ## Default zoom level.
1852 # c.zoom.default = '100%'
1854 ## Available zoom levels.
1855 ## Type: List of Perc
1856 # c.zoom.levels = ['25%', '33%', '50%', '67%', '75%', '90%', '100%', '110%', '125%', '150%', '175%', '200%', '250%', '300%', '400%', '500%']
1858 ## Number of zoom increments to divide the mouse wheel movements to.
1860 # c.zoom.mouse_divider = 512
1862 ## Apply the zoom factor on a frame only to the text or to all content.
1864 # c.zoom.text_only = False
1866 ## Bindings for normal mode
1867 # config.bind("'", 'mode-enter jump_mark')
1868 # config.bind('+', 'zoom-in')
1869 # config.bind('-', 'zoom-out')
1870 # config.bind('.', 'cmd-repeat-last')
1871 # config.bind('/', 'cmd-set-text /')
1872 # config.bind(':', 'cmd-set-text :')
1873 # config.bind(';I', 'hint images tab')
1874 # config.bind(';O', 'hint links fill :open -t -r {hint-url}')
1875 # config.bind(';R', 'hint --rapid links window')
1876 # config.bind(';Y', 'hint links yank-primary')
1877 # config.bind(';b', 'hint all tab-bg')
1878 # config.bind(';d', 'hint links download')
1879 # config.bind(';f', 'hint all tab-fg')
1880 # config.bind(';h', 'hint all hover')
1881 # config.bind(';i', 'hint images')
1882 # config.bind(';o', 'hint links fill :open {hint-url}')
1883 # config.bind(';r', 'hint --rapid links tab-bg')
1884 # config.bind(';t', 'hint inputs')
1885 # config.bind(';y', 'hint links yank')
1886 # config.bind('<Alt-1>', 'tab-focus 1')
1887 # config.bind('<Alt-2>', 'tab-focus 2')
1888 # config.bind('<Alt-3>', 'tab-focus 3')
1889 # config.bind('<Alt-4>', 'tab-focus 4')
1890 # config.bind('<Alt-5>', 'tab-focus 5')
1891 # config.bind('<Alt-6>', 'tab-focus 6')
1892 # config.bind('<Alt-7>', 'tab-focus 7')
1893 # config.bind('<Alt-8>', 'tab-focus 8')
1894 # config.bind('<Alt-9>', 'tab-focus -1')
1895 # config.bind('<Alt-m>', 'tab-mute')
1896 # config.bind('<Ctrl-A>', 'navigate increment')
1897 # config.bind('<Ctrl-Alt-p>', 'print')
1898 # config.bind('<Ctrl-B>', 'scroll-page 0 -1')
1899 # config.bind('<Ctrl-D>', 'scroll-page 0 0.5')
1900 # config.bind('<Ctrl-F5>', 'reload -f')
1901 # config.bind('<Ctrl-F>', 'scroll-page 0 1')
1902 # config.bind('<Ctrl-N>', 'open -w')
1903 # config.bind('<Ctrl-PgDown>', 'tab-next')
1904 # config.bind('<Ctrl-PgUp>', 'tab-prev')
1905 # config.bind('<Ctrl-Q>', 'quit')
1906 # config.bind('<Ctrl-Return>', 'selection-follow -t')
1907 # config.bind('<Ctrl-Shift-N>', 'open -p')
1908 # config.bind('<Ctrl-Shift-T>', 'undo')
1909 # config.bind('<Ctrl-Shift-Tab>', 'nop')
1910 # config.bind('<Ctrl-Shift-W>', 'close')
1911 # config.bind('<Ctrl-T>', 'open -t')
1912 # config.bind('<Ctrl-Tab>', 'tab-focus last')
1913 # config.bind('<Ctrl-U>', 'scroll-page 0 -0.5')
1914 # config.bind('<Ctrl-V>', 'mode-enter passthrough')
1915 # config.bind('<Ctrl-W>', 'tab-close')
1916 # config.bind('<Ctrl-X>', 'navigate decrement')
1917 # config.bind('<Ctrl-^>', 'tab-focus last')
1918 # config.bind('<Ctrl-h>', 'home')
1919 # config.bind('<Ctrl-p>', 'tab-pin')
1920 # config.bind('<Ctrl-s>', 'stop')
1921 config
.bind('<Escape>', 'clear-keychain ;; search ;; fullscreen --leave ;; fake-key <Escape>')
1922 # config.bind('<F11>', 'fullscreen')
1923 # config.bind('<F5>', 'reload')
1924 # config.bind('<Return>', 'selection-follow')
1925 # config.bind('<back>', 'back')
1926 # config.bind('<forward>', 'forward')
1927 # config.bind('=', 'zoom')
1928 # config.bind('?', 'cmd-set-text ?')
1929 # config.bind('@', 'macro-run')
1930 # config.bind('B', 'cmd-set-text -s :quickmark-load -t')
1931 # config.bind('D', 'tab-close -o')
1932 # config.bind('F', 'hint all tab')
1933 # config.bind('G', 'scroll-to-perc')
1934 # config.bind('H', 'back')
1935 config
.bind('K', 'tab-next')
1936 config
.bind('J', 'tab-prev')
1937 # config.bind('L', 'forward')
1938 # config.bind('M', 'bookmark-add')
1939 # config.bind('N', 'search-prev')
1940 # config.bind('O', 'cmd-set-text -s :open -t')
1941 # config.bind('PP', 'open -t -- {primary}')
1942 # config.bind('Pp', 'open -t -- {clipboard}')
1943 # config.bind('R', 'reload -f')
1944 # config.bind('Sb', 'bookmark-list --jump')
1945 # config.bind('Sh', 'history')
1946 # config.bind('Sq', 'bookmark-list')
1947 # config.bind('Ss', 'set')
1948 # config.bind('T', 'cmd-set-text -sr :tab-focus')
1949 # config.bind('U', 'undo -w')
1950 # config.bind('V', 'mode-enter caret ;; selection-toggle --line')
1951 # config.bind('ZQ', 'quit')
1952 # config.bind('ZZ', 'quit --save')
1953 # config.bind('[[', 'navigate prev')
1954 # config.bind(']]', 'navigate next')
1955 # config.bind('`', 'mode-enter set_mark')
1956 # config.bind('ad', 'download-cancel')
1957 # config.bind('b', 'cmd-set-text -s :quickmark-load')
1958 # config.bind('cd', 'download-clear')
1960 config
.bind('co', 'download-open')
1961 # config.bind('d', 'tab-close')
1962 # config.bind('f', 'hint')
1963 # config.bind('g$', 'tab-focus -1')
1964 # config.bind('g0', 'tab-focus 1')
1965 # config.bind('gB', 'cmd-set-text -s :bookmark-load -t')
1966 # config.bind('gC', 'tab-clone')
1967 # config.bind('gD', 'tab-give')
1968 # config.bind('gJ', 'tab-move +')
1969 # config.bind('gK', 'tab-move -')
1970 # config.bind('gO', 'cmd-set-text :open -t -r {url:pretty}')
1971 # config.bind('gU', 'navigate up -t')
1972 # config.bind('g^', 'tab-focus 1')
1973 # config.bind('ga', 'open -t')
1974 # config.bind('gb', 'cmd-set-text -s :bookmark-load')
1975 # config.bind('gd', 'download')
1976 # config.bind('gf', 'view-source')
1977 # config.bind('gg', 'scroll-to-perc 0')
1978 # config.bind('gi', 'hint inputs --first')
1979 config
.bind('gl', 'tab-move -')
1980 # config.bind('gm', 'tab-move')
1981 # config.bind('go', 'cmd-set-text :open {url:pretty}')
1982 config
.bind('gr', 'tab-move +')
1983 # config.bind('gt', 'cmd-set-text -s :tab-select')
1984 # config.bind('gu', 'navigate up')
1985 # config.bind('h', 'scroll left')
1986 # config.bind('i', 'mode-enter insert')
1987 # config.bind('j', 'scroll down')
1988 # config.bind('k', 'scroll up')
1989 # config.bind('l', 'scroll right')
1990 config
.bind('m', 'spawn mpv {url}')
1991 # TODO: add hints.selector for ytdl compatible links
1992 config
.bind('M', 'hint links spawn mpv {hint-url}')
1993 # config.bind('n', 'search-next')
1994 # config.bind('o', 'cmd-set-text -s :open')
1995 # config.bind('pP', 'open -- {primary}')
1996 # config.bind('pp', 'open -- {clipboard}')
1997 # config.bind('q', 'macro-record')
1998 # config.bind('r', 'reload')
1999 # config.bind('sf', 'save')
2000 # config.bind('sk', 'cmd-set-text -s :bind')
2001 # config.bind('sl', 'cmd-set-text -s :set -t')
2002 # config.bind('ss', 'cmd-set-text -s :set')
2003 config
.bind('sq', 'quickmark-save')
2004 config
.bind('tCh', 'spawn --userscript config-cycle-tld -p content.cookies.accept no-3rdparty never all;; reload')
2005 config
.bind('tch', 'spawn --userscript config-cycle-tld -p -t content.cookies.accept no-3rdparty never all;; reload')
2006 config
.bind('tGh', 'spawn --userscript config-cycle-tld -p content.geolocation ;; reload')
2007 config
.bind('tgh', 'spawn --userscript config-cycle-tld -p -t content.geolocation ;; reload')
2008 # config.bind('tIH', 'config-cycle -p -u *://*.{url:host}/* content.images ;; reload')
2009 # config.bind('tIh', 'config-cycle -p -u *://{url:host}/* content.images ;; reload')
2010 # config.bind('tIu', 'config-cycle -p -u {url} content.images ;; reload')
2011 # config.bind('tPH', 'config-cycle -p -u *://*.{url:host}/* content.plugins ;; reload')
2012 # config.bind('tPh', 'config-cycle -p -u *://{url:host}/* content.plugins ;; reload')
2013 # config.bind('tPu', 'config-cycle -p -u {url} content.plugins ;; reload')
2014 # config.bind('tSH', 'config-cycle -p -u *://*.{url:host}/* content.javascript.enabled ;; reload')
2015 # config.bind('tSh', 'config-cycle -p -u *://{url:host}/* content.javascript.enabled ;; reload')
2016 # config.bind('tSu', 'config-cycle -p -u {url} content.javascript.enabled ;; reload')
2017 # config.bind('th', 'back -t')
2018 # config.bind('tiH', 'config-cycle -p -t -u *://*.{url:host}/* content.images ;; reload')
2019 # config.bind('tih', 'config-cycle -p -t -u *://{url:host}/* content.images ;; reload')
2020 # config.bind('tiu', 'config-cycle -p -t -u {url} content.images ;; reload')
2021 # config.bind('tl', 'forward -t')
2022 # config.bind('tpH', 'config-cycle -p -t -u *://*.{url:host}/* content.plugins ;; reload')
2023 # config.bind('tph', 'config-cycle -p -t -u *://{url:host}/* content.plugins ;; reload')
2024 # config.bind('tpu', 'config-cycle -p -t -u {url} content.plugins ;; reload')
2025 # config.bind('tsH', 'config-cycle -p -t -u *://*.{url:host}/* content.javascript.enabled ;; reload')
2026 # config.bind('tsh', 'config-cycle -p -t -u *://{url:host}/* content.javascript.enabled ;; reload')
2027 # config.bind('tsu', 'config-cycle -p -t -u {url} content.javascript.enabled ;; reload')
2028 # config.bind('u', 'undo')
2029 # config.bind('v', 'mode-enter caret')
2030 # config.bind('wB', 'cmd-set-text -s :bookmark-load -w')
2031 # config.bind('wIf', 'devtools-focus')
2032 # config.bind('wIh', 'devtools left')
2033 # config.bind('wIj', 'devtools bottom')
2034 # config.bind('wIk', 'devtools top')
2035 # config.bind('wIl', 'devtools right')
2036 # config.bind('wIw', 'devtools window')
2037 # config.bind('wO', 'cmd-set-text :open -w {url:pretty}')
2038 # config.bind('wP', 'open -w -- {primary}')
2039 # config.bind('wb', 'cmd-set-text -s :quickmark-load -w')
2040 # config.bind('wf', 'hint all window')
2041 # config.bind('wh', 'back -w')
2042 # config.bind('wi', 'devtools')
2043 # config.bind('wl', 'forward -w')
2044 # config.bind('wo', 'cmd-set-text -s :open -w')
2045 # config.bind('wp', 'open -w -- {clipboard}')
2046 # config.bind('xO', 'cmd-set-text :open -b -r {url:pretty}')
2047 # config.bind('xo', 'cmd-set-text -s :open -b')
2048 # config.bind('yD', 'yank domain -s')
2049 # config.bind('yM', 'yank inline [{title}]({url}) -s')
2050 # config.bind('yP', 'yank pretty-url -s')
2051 # config.bind('yT', 'yank title -s')
2052 # config.bind('yY', 'yank -s')
2053 # config.bind('yd', 'yank domain')
2054 # config.bind('ym', 'yank inline [{title}]({url})')
2055 # config.bind('yp', 'yank pretty-url')
2056 # config.bind('yt', 'yank title')
2057 # config.bind('yy', 'yank')
2058 config
.bind('zl', 'spawn --userscript qute-pass')
2059 config
.bind('zul', 'spawn --userscript qute-pass --username-only')
2060 config
.bind('zpl', 'spawn --userscript qute-pass --password-only')
2061 config
.bind('zol', 'spawn --userscript qute-pass --otp-only')
2062 config
.bind('zal', 'spawn --userscript qute-pass --unfiltered')
2063 config
.bind('zaul', 'spawn --userscript qute-pass --unfiltered --username-only')
2064 config
.bind('zapl', 'spawn --userscript qute-pass --unfiltered --password-only')
2065 config
.bind('zaol', 'spawn --userscript qute-pass --unfiltered --otp-only')
2066 # config.bind('{{', 'navigate prev -t')
2067 # config.bind('}}', 'navigate next -t')
2069 ## Bindings for caret mode
2070 # config.bind('$', 'move-to-end-of-line', mode='caret')
2071 # config.bind('0', 'move-to-start-of-line', mode='caret')
2072 # config.bind('<Ctrl-Space>', 'selection-drop', mode='caret')
2073 # config.bind('<Escape>', 'mode-leave', mode='caret')
2074 # config.bind('<Return>', 'yank selection', mode='caret')
2075 # config.bind('<Space>', 'selection-toggle', mode='caret')
2076 # config.bind('G', 'move-to-end-of-document', mode='caret')
2077 # config.bind('H', 'scroll left', mode='caret')
2078 # config.bind('J', 'scroll down', mode='caret')
2079 # config.bind('K', 'scroll up', mode='caret')
2080 # config.bind('L', 'scroll right', mode='caret')
2081 # config.bind('V', 'selection-toggle --line', mode='caret')
2082 # config.bind('Y', 'yank selection -s', mode='caret')
2083 # config.bind('[', 'move-to-start-of-prev-block', mode='caret')
2084 # config.bind(']', 'move-to-start-of-next-block', mode='caret')
2085 # config.bind('b', 'move-to-prev-word', mode='caret')
2086 # config.bind('c', 'mode-enter normal', mode='caret')
2087 # config.bind('e', 'move-to-end-of-word', mode='caret')
2088 # config.bind('gg', 'move-to-start-of-document', mode='caret')
2089 # config.bind('h', 'move-to-prev-char', mode='caret')
2090 # config.bind('j', 'move-to-next-line', mode='caret')
2091 # config.bind('k', 'move-to-prev-line', mode='caret')
2092 # config.bind('l', 'move-to-next-char', mode='caret')
2093 # config.bind('o', 'selection-reverse', mode='caret')
2094 # config.bind('v', 'selection-toggle', mode='caret')
2095 # config.bind('w', 'move-to-next-word', mode='caret')
2096 # config.bind('y', 'yank selection', mode='caret')
2097 # config.bind('{', 'move-to-end-of-prev-block', mode='caret')
2098 # config.bind('}', 'move-to-end-of-next-block', mode='caret')
2100 ## Bindings for command mode
2101 # config.bind('<Alt-B>', 'rl-backward-word', mode='command')
2102 # config.bind('<Alt-Backspace>', 'rl-backward-kill-word', mode='command')
2103 # config.bind('<Alt-D>', 'rl-kill-word', mode='command')
2104 # config.bind('<Alt-F>', 'rl-forward-word', mode='command')
2105 # config.bind('<Ctrl-?>', 'rl-delete-char', mode='command')
2106 # config.bind('<Ctrl-A>', 'rl-beginning-of-line', mode='command')
2107 # config.bind('<Ctrl-B>', 'rl-backward-char', mode='command')
2108 # config.bind('<Ctrl-C>', 'completion-item-yank', mode='command')
2109 # config.bind('<Ctrl-D>', 'completion-item-del', mode='command')
2110 # config.bind('<Ctrl-E>', 'rl-end-of-line', mode='command')
2111 # config.bind('<Ctrl-F>', 'rl-forward-char', mode='command')
2112 # config.bind('<Ctrl-H>', 'rl-backward-delete-char', mode='command')
2113 # config.bind('<Ctrl-K>', 'rl-kill-line', mode='command')
2114 # config.bind('<Ctrl-N>', 'command-history-next', mode='command')
2115 # config.bind('<Ctrl-P>', 'command-history-prev', mode='command')
2116 # config.bind('<Ctrl-Return>', 'command-accept --rapid', mode='command')
2117 # config.bind('<Ctrl-Shift-C>', 'completion-item-yank --sel', mode='command')
2118 # config.bind('<Ctrl-Shift-Tab>', 'completion-item-focus prev-category', mode='command')
2119 # config.bind('<Ctrl-Shift-W>', 'rl-filename-rubout', mode='command')
2120 # config.bind('<Ctrl-Tab>', 'completion-item-focus next-category', mode='command')
2121 # config.bind('<Ctrl-U>', 'rl-unix-line-discard', mode='command')
2122 # config.bind('<Ctrl-W>', 'rl-rubout " "', mode='command')
2123 # config.bind('<Ctrl-Y>', 'rl-yank', mode='command')
2124 # config.bind('<Down>', 'completion-item-focus --history next', mode='command')
2125 # config.bind('<Escape>', 'mode-leave', mode='command')
2126 # config.bind('<PgDown>', 'completion-item-focus next-page', mode='command')
2127 # config.bind('<PgUp>', 'completion-item-focus prev-page', mode='command')
2128 # config.bind('<Return>', 'command-accept', mode='command')
2129 # config.bind('<Shift-Delete>', 'completion-item-del', mode='command')
2130 # config.bind('<Shift-Tab>', 'completion-item-focus prev', mode='command')
2131 # config.bind('<Tab>', 'completion-item-focus next', mode='command')
2132 # config.bind('<Up>', 'completion-item-focus --history prev', mode='command')
2134 ## Bindings for hint mode
2135 # config.bind('<Ctrl-B>', 'hint all tab-bg', mode='hint')
2136 # config.bind('<Ctrl-F>', 'hint links', mode='hint')
2137 # config.bind('<Ctrl-R>', 'hint --rapid links tab-bg', mode='hint')
2138 # config.bind('<Escape>', 'mode-leave', mode='hint')
2139 # config.bind('<Return>', 'hint-follow', mode='hint')
2141 ## Bindings for insert mode
2142 # config.bind('<Ctrl-E>', 'edit-text', mode='insert')
2143 # config.bind('<Escape>', 'mode-leave', mode='insert')
2144 # config.bind('<Shift-Escape>', 'fake-key <Escape>', mode='insert')
2145 # config.bind('<Shift-Ins>', 'insert-text -- {primary}', mode='insert')
2147 ## Bindings for passthrough mode
2148 # config.bind('<Shift-Escape>', 'mode-leave', mode='passthrough')
2150 ## Bindings for prompt mode
2151 # config.bind('<Alt-B>', 'rl-backward-word', mode='prompt')
2152 # config.bind('<Alt-Backspace>', 'rl-backward-kill-word', mode='prompt')
2153 # config.bind('<Alt-D>', 'rl-kill-word', mode='prompt')
2154 # config.bind('<Alt-E>', 'prompt-fileselect-external', mode='prompt')
2155 # config.bind('<Alt-F>', 'rl-forward-word', mode='prompt')
2156 # config.bind('<Alt-Shift-Y>', 'prompt-yank --sel', mode='prompt')
2157 # config.bind('<Alt-Y>', 'prompt-yank', mode='prompt')
2158 # config.bind('<Ctrl-?>', 'rl-delete-char', mode='prompt')
2159 # config.bind('<Ctrl-A>', 'rl-beginning-of-line', mode='prompt')
2160 # config.bind('<Ctrl-B>', 'rl-backward-char', mode='prompt')
2161 # config.bind('<Ctrl-E>', 'rl-end-of-line', mode='prompt')
2162 # config.bind('<Ctrl-F>', 'rl-forward-char', mode='prompt')
2163 # config.bind('<Ctrl-H>', 'rl-backward-delete-char', mode='prompt')
2164 # config.bind('<Ctrl-K>', 'rl-kill-line', mode='prompt')
2165 # config.bind('<Ctrl-P>', 'prompt-open-download --pdfjs', mode='prompt')
2166 # config.bind('<Ctrl-Shift-W>', 'rl-filename-rubout', mode='prompt')
2167 # config.bind('<Ctrl-U>', 'rl-unix-line-discard', mode='prompt')
2168 # config.bind('<Ctrl-W>', 'rl-rubout " "', mode='prompt')
2169 # config.bind('<Ctrl-X>', 'prompt-open-download', mode='prompt')
2170 # config.bind('<Ctrl-Y>', 'rl-yank', mode='prompt')
2171 # config.bind('<Down>', 'prompt-item-focus next', mode='prompt')
2172 # config.bind('<Escape>', 'mode-leave', mode='prompt')
2173 # config.bind('<Return>', 'prompt-accept', mode='prompt')
2174 # config.bind('<Shift-Tab>', 'prompt-item-focus prev', mode='prompt')
2175 # config.bind('<Tab>', 'prompt-item-focus next', mode='prompt')
2176 # config.bind('<Up>', 'prompt-item-focus prev', mode='prompt')
2178 ## Bindings for register mode
2179 # config.bind('<Escape>', 'mode-leave', mode='register')
2181 ## Bindings for yesno mode
2182 # config.bind('<Alt-Shift-Y>', 'prompt-yank --sel', mode='yesno')
2183 # config.bind('<Alt-Y>', 'prompt-yank', mode='yesno')
2184 # config.bind('<Escape>', 'mode-leave', mode='yesno')
2185 # config.bind('<Return>', 'prompt-accept', mode='yesno')
2186 # config.bind('N', 'prompt-accept --save no', mode='yesno')
2187 # config.bind('Y', 'prompt-accept --save yes', mode='yesno')
2188 # config.bind('n', 'prompt-accept no', mode='yesno')
2189 # config.bind('y', 'prompt-accept yes', mode='yesno')
2191 config
.source('themes/nord-qutebrowser.py')