]> git.rmz.io Git - dotfiles.git/blob - qutebrowser/config.py
qutebrowser: update config.py to newer version
[dotfiles.git] / qutebrowser / config.py
1 ## Autogenerated config.py
2 ##
3 ## NOTE: config.py is intended for advanced users who are comfortable
4 ## with manually migrating the config file on qutebrowser upgrades. If
5 ## you prefer, you can also configure qutebrowser using the
6 ## :set/:bind/:config-* commands without having to write a config.py
7 ## file.
8 ##
9 ## Documentation:
10 ## qute://help/configuring.html
11 ## qute://help/settings.html
12
13 def in_terminal(cmd: list):
14 """Wraps cmd to be run in the default TERMINAL, as set by environment.
15
16 :cmd: cmd to execute in TERMINAL
17 :returns: A shell command as a list
18 """
19 from os import getenv
20 t = getenv('TERMINAL', 'xterm')
21 return [t, '-e'] + cmd
22
23 try:
24 from qutebrowser.api import interceptor, message
25 from PyQt5.QtCore import QUrl
26
27 def intercept(info: interceptor.Request):
28 url = info.request_url
29 if url.host() == "twitter.com":
30 url.setHost("nitter.eu")
31 message.info("Redirecting to " + url.toString())
32 info.redirect(url)
33 if url.host() == "xkcd.com":
34 url.setHost("m.xkcd.com")
35 message.info("Redirecting to " + url.toString())
36 info.redirect(url)
37 if url.host() == "www.bristolpost.co.uk":
38 url.setUrl("https://outline.com/" + url.toString())
39 message.info("Redirecting to " + url.toString())
40 info.redirect(url)
41
42 interceptor.register(intercept)
43 except ImportError:
44 pass
45
46 ## This is here so configs done via the GUI are still loaded.
47 ## Remove it to not load settings done via the GUI.
48 config.load_autoconfig(True)
49
50 ## Aliases for commands. The keys of the given dictionary are the
51 ## aliases, while the values are the commands they map to.
52 ## Type: Dict
53 c.aliases = {'w': 'session-save',
54 'quit': 'close',
55 'q': 'close',
56 'qa': 'quit',
57 'wq': 'quit --save',
58 'wqa': 'quit --save',
59 'mpv': 'spawn --userscript ~/src/qutebrowser/misc/userscripts/view_in_mpv'
60 }
61
62 ## Time interval (in milliseconds) between auto-saves of
63 ## config/cookies/etc.
64 ## Type: Int
65 # c.auto_save.interval = 15000
66
67 ## Always restore open sites when qutebrowser is reopened. Without this
68 ## option set, `:wq` (`:quit --save`) needs to be used to save open tabs
69 ## (and restore them), while quitting qutebrowser in any other way will
70 ## not save/restore the session. By default, this will save to the
71 ## session which was last loaded. This behavior can be customized via the
72 ## `session.default_name` setting.
73 ## Type: Bool
74 c.auto_save.session = True
75
76 ## Backend to use to display websites. qutebrowser supports two different
77 ## web rendering engines / backends, QtWebEngine and QtWebKit (not
78 ## recommended). QtWebEngine is Qt's official successor to QtWebKit, and
79 ## both the default/recommended backend. It's based on a stripped-down
80 ## Chromium and regularly updated with security fixes and new features by
81 ## the Qt project: https://wiki.qt.io/QtWebEngine QtWebKit was
82 ## qutebrowser's original backend when the project was started. However,
83 ## support for QtWebKit was discontinued by the Qt project with Qt 5.6 in
84 ## 2016. The development of QtWebKit was picked up in an official fork:
85 ## https://github.com/qtwebkit/qtwebkit - however, the project seems to
86 ## have stalled again. The latest release (5.212.0 Alpha 4) from March
87 ## 2020 is based on a WebKit version from 2016, with many known security
88 ## vulnerabilities. Additionally, there is no process isolation and
89 ## sandboxing. Due to all those issues, while support for QtWebKit is
90 ## still available in qutebrowser for now, using it is strongly
91 ## discouraged.
92 ## Type: String
93 ## Valid values:
94 ## - webengine: Use QtWebEngine (based on Chromium - recommended).
95 ## - webkit: Use QtWebKit (based on WebKit, similar to Safari - many known security issues!).
96 # c.backend = 'webengine'
97
98 ## Map keys to other keys, so that they are equivalent in all modes. When
99 ## the key used as dictionary-key is pressed, the binding for the key
100 ## used as dictionary-value is invoked instead. This is useful for global
101 ## remappings of keys, for example to map <Ctrl-[> to <Escape>. NOTE:
102 ## This should only be used if two keys should always be equivalent, i.e.
103 ## for things like <Enter> (keypad) and <Return> (non-keypad). For normal
104 ## command bindings, qutebrowser works differently to vim: You always
105 ## bind keys to commands, usually via `:bind` or `config.bind()`. Instead
106 ## of using this setting, consider finding the command a key is bound to
107 ## (e.g. via `:bind gg`) and then binding the same command to the desired
108 ## key. Note that when a key is bound (via `bindings.default` or
109 ## `bindings.commands`), the mapping is ignored.
110 ## Type: Dict
111 # c.bindings.key_mappings = {'<Ctrl-[>': '<Escape>', '<Ctrl-6>': '<Ctrl-^>', '<Ctrl-M>': '<Return>', '<Ctrl-J>': '<Return>', '<Ctrl-I>': '<Tab>', '<Shift-Return>': '<Return>', '<Enter>': '<Return>', '<Shift-Enter>': '<Return>', '<Ctrl-Enter>': '<Ctrl-Return>'}
112
113 #TODO
114 ## Which algorithm to use for modifying how colors are rendered with
115 ## darkmode. The `lightness-cielab` value was added with QtWebEngine 5.14
116 ## and is treated like `lightness-hsl` with older QtWebEngine versions.
117 ## Type: String
118 ## Valid values:
119 ## - lightness-cielab: Modify colors by converting them to CIELAB color space and inverting the L value. Not available with Qt < 5.14.
120 ## - lightness-hsl: Modify colors by converting them to the HSL color space and inverting the lightness (i.e. the "L" in HSL).
121 ## - brightness-rgb: Modify colors by subtracting each of r, g, and b from their maximum value.
122 # c.colors.webpage.darkmode.algorithm = 'lightness-cielab'
123
124 ## Contrast for dark mode. This only has an effect when
125 ## `colors.webpage.darkmode.algorithm` is set to `lightness-hsl` or
126 ## `brightness-rgb`.
127 ## Type: Float
128 # c.colors.webpage.darkmode.contrast = 0.0
129
130 ## Render all web contents using a dark theme. Example configurations
131 ## from Chromium's `chrome://flags`: - "With simple HSL/CIELAB/RGB-based
132 ## inversion": Set `colors.webpage.darkmode.algorithm` accordingly. -
133 ## "With selective image inversion": Set
134 ## `colors.webpage.darkmode.policy.images` to `smart`. - "With selective
135 ## inversion of non-image elements": Set
136 ## `colors.webpage.darkmode.threshold.text` to 150 and
137 ## `colors.webpage.darkmode.threshold.background` to 205. - "With
138 ## selective inversion of everything": Combines the two variants above.
139 ## Type: Bool
140 # c.colors.webpage.darkmode.enabled = False
141
142 ## Render all colors as grayscale. This only has an effect when
143 ## `colors.webpage.darkmode.algorithm` is set to `lightness-hsl` or
144 ## `brightness-rgb`.
145 ## Type: Bool
146 # c.colors.webpage.darkmode.grayscale.all = False
147
148 ## Desaturation factor for images in dark mode. If set to 0, images are
149 ## left as-is. If set to 1, images are completely grayscale. Values
150 ## between 0 and 1 desaturate the colors accordingly.
151 ## Type: Float
152 # c.colors.webpage.darkmode.grayscale.images = 0.0
153
154 ## Which images to apply dark mode to. With QtWebEngine 5.15.0, this
155 ## setting can cause frequent renderer process crashes due to a
156 ## https://codereview.qt-project.org/c/qt/qtwebengine-
157 ## chromium/+/304211[bug in Qt].
158 ## Type: String
159 ## Valid values:
160 ## - always: Apply dark mode filter to all images.
161 ## - never: Never apply dark mode filter to any images.
162 ## - smart: Apply dark mode based on image content. Not available with Qt 5.15.0.
163 # c.colors.webpage.darkmode.policy.images = 'smart'
164
165 ## Which pages to apply dark mode to. The underlying Chromium setting has
166 ## been removed in QtWebEngine 5.15.3, thus this setting is ignored
167 ## there. Instead, every element is now classified individually.
168 ## Type: String
169 ## Valid values:
170 ## - always: Apply dark mode filter to all frames, regardless of content.
171 ## - smart: Apply dark mode filter to frames based on background color.
172 # c.colors.webpage.darkmode.policy.page = 'smart'
173
174 ## Threshold for inverting background elements with dark mode. Background
175 ## elements with brightness above this threshold will be inverted, and
176 ## below it will be left as in the original, non-dark-mode page. Set to
177 ## 256 to never invert the color or to 0 to always invert it. Note: This
178 ## behavior is the opposite of `colors.webpage.darkmode.threshold.text`!
179 ## Type: Int
180 # c.colors.webpage.darkmode.threshold.background = 0
181
182 ## Threshold for inverting text with dark mode. Text colors with
183 ## brightness below this threshold will be inverted, and above it will be
184 ## left as in the original, non-dark-mode page. Set to 256 to always
185 ## invert text color or to 0 to never invert text color.
186 ## Type: Int
187 # c.colors.webpage.darkmode.threshold.text = 256
188
189 ## Value to use for `prefers-color-scheme:` for websites. The "light"
190 ## value is only available with QtWebEngine 5.15.2+. On older versions,
191 ## it is the same as "auto". The "auto" value is broken on QtWebEngine
192 ## 5.15.2 due to a Qt bug. There, it will fall back to "light"
193 ## unconditionally.
194 ## Type: String
195 ## Valid values:
196 ## - auto: Use the system-wide color scheme setting.
197 ## - light: Force a light theme.
198 ## - dark: Force a dark theme.
199 # c.colors.webpage.preferred_color_scheme = 'auto'
200
201 ## Number of commands to save in the command history. 0: no history / -1:
202 ## unlimited
203 ## Type: Int
204 # c.completion.cmd_history_max_items = 100
205
206 ## Delay (in milliseconds) before updating completions after typing a
207 ## character.
208 ## Type: Int
209 # c.completion.delay = 0
210
211 ## Default filesystem autocomplete suggestions for :open. The elements of
212 ## this list show up in the completion window under the Filesystem
213 ## category when the command line contains `:open` but no argument.
214 ## Type: List of String
215 # c.completion.favorite_paths = []
216
217 ## Height (in pixels or as percentage of the window) of the completion.
218 ## Type: PercOrInt
219 c.completion.height = 150
220
221 ## Minimum amount of characters needed to update completions.
222 ## Type: Int
223 # c.completion.min_chars = 1
224
225 ## Which categories to show (in which order) in the :open completion.
226 ## Type: FlagList
227 ## Valid values:
228 ## - searchengines
229 ## - quickmarks
230 ## - bookmarks
231 ## - history
232 ## - filesystem
233 # c.completion.open_categories = ['searchengines', 'quickmarks', 'bookmarks', 'history', 'filesystem']
234
235 ## Move on to the next part when there's only one possible completion
236 ## left.
237 ## Type: Bool
238 c.completion.quick = False
239
240 ## Padding (in pixels) of the scrollbar handle in the completion window.
241 ## Type: Int
242 # c.completion.scrollbar.padding = 2
243
244 ## Width (in pixels) of the scrollbar in the completion window.
245 ## Type: Int
246 # c.completion.scrollbar.width = 12
247
248 ## When to show the autocompletion window.
249 ## Type: String
250 ## Valid values:
251 ## - always: Whenever a completion is available.
252 ## - auto: Whenever a completion is requested.
253 ## - never: Never.
254 # c.completion.show = 'always'
255
256 ## Shrink the completion to be smaller than the configured size if there
257 ## are no scrollbars.
258 ## Type: Bool
259 c.completion.shrink = True
260
261 ## Format of timestamps (e.g. for the history completion). See
262 ## https://sqlite.org/lang_datefunc.html and
263 ## https://docs.python.org/3/library/datetime.html#strftime-strptime-
264 ## behavior for allowed substitutions, qutebrowser uses both sqlite and
265 ## Python to format its timestamps.
266 ## Type: String
267 # c.completion.timestamp_format = '%Y-%m-%d %H:%M'
268
269 ## Execute the best-matching command on a partial match.
270 ## Type: Bool
271 # c.completion.use_best_match = False
272
273 ## A list of patterns which should not be shown in the history. This only
274 ## affects the completion. Matching URLs are still saved in the history
275 ## (and visible on the `:history` page), but hidden in the completion.
276 ## Changing this setting will cause the completion history to be
277 ## regenerated on the next start, which will take a short while.
278 ## Type: List of UrlPattern
279 # c.completion.web_history.exclude = []
280
281 ## Number of URLs to show in the web history. 0: no history / -1:
282 ## unlimited
283 ## Type: Int
284 # c.completion.web_history.max_items = -1
285
286 ## Require a confirmation before quitting the application.
287 ## Type: ConfirmQuit
288 ## Valid values:
289 ## - always: Always show a confirmation.
290 ## - multiple-tabs: Show a confirmation if multiple tabs are opened.
291 ## - downloads: Show a confirmation if downloads are running
292 ## - never: Never show a confirmation.
293 c.confirm_quit = ['downloads']
294
295 ## Automatically start playing `<video>` elements.
296 ## Type: Bool
297 # c.content.autoplay = True
298
299 ## List of URLs to ABP-style adblocking rulesets. Only used when Brave's
300 ## ABP-style adblocker is used (see `content.blocking.method`). You can
301 ## find an overview of available lists here:
302 ## https://adblockplus.org/en/subscriptions - note that the special
303 ## `subscribe.adblockplus.org` links aren't handled by qutebrowser, you
304 ## will instead need to find the link to the raw `.txt` file (e.g. by
305 ## extracting it from the `location` parameter of the subscribe URL and
306 ## URL-decoding it).
307 ## Type: List of Url
308 # c.content.blocking.adblock.lists = ['https://easylist.to/easylist/easylist.txt', 'https://easylist.to/easylist/easyprivacy.txt']
309
310 ## Enable the ad/host blocker
311 ## Type: Bool
312 # c.content.blocking.enabled = True
313
314 ## Block subdomains of blocked hosts. Note: If only a single subdomain is
315 ## blocked but should be allowed, consider using
316 ## `content.blocking.whitelist` instead.
317 ## Type: Bool
318 # c.content.blocking.hosts.block_subdomains = True
319
320 ## List of URLs to host blocklists for the host blocker. Only used when
321 ## the simple host-blocker is used (see `content.blocking.method`). The
322 ## file can be in one of the following formats: - An `/etc/hosts`-like
323 ## file - One host per line - A zip-file of any of the above, with either
324 ## only one file, or a file named `hosts` (with any extension). It's
325 ## also possible to add a local file or directory via a `file://` URL. In
326 ## case of a directory, all files in the directory are read as adblock
327 ## lists. The file `~/.config/qutebrowser/blocked-hosts` is always read
328 ## if it exists.
329 ## Type: List of Url
330 # c.content.blocking.hosts.lists = ['https://raw.githubusercontent.com/StevenBlack/hosts/master/hosts']
331
332 ## Which method of blocking ads should be used. Support for Adblock Plus
333 ## (ABP) syntax blocklists using Brave's Rust library requires the
334 ## `adblock` Python package to be installed, which is an optional
335 ## dependency of qutebrowser. It is required when either `adblock` or
336 ## `both` are selected.
337 ## Type: String
338 ## Valid values:
339 ## - auto: Use Brave's ABP-style adblocker if available, host blocking otherwise
340 ## - adblock: Use Brave's ABP-style adblocker
341 ## - hosts: Use hosts blocking
342 ## - both: Use both hosts blocking and Brave's ABP-style adblocker
343 # c.content.blocking.method = 'auto'
344
345 ## A list of patterns that should always be loaded, despite being blocked
346 ## by the ad-/host-blocker. Local domains are always exempt from
347 ## adblocking. Note this whitelists otherwise blocked requests, not
348 ## first-party URLs. As an example, if `example.org` loads an ad from
349 ## `ads.example.org`, the whitelist entry could be
350 ## `https://ads.example.org/*`. If you want to disable the adblocker on a
351 ## given page, use the `content.blocking.enabled` setting with a URL
352 ## pattern instead.
353 ## Type: List of UrlPattern
354 # c.content.blocking.whitelist = []
355
356 ## Enable support for the HTML 5 web application cache feature. An
357 ## application cache acts like an HTTP cache in some sense. For documents
358 ## that use the application cache via JavaScript, the loader engine will
359 ## first ask the application cache for the contents, before hitting the
360 ## network.
361 ## Type: Bool
362 # c.content.cache.appcache = True
363
364 ## Maximum number of pages to hold in the global memory page cache. The
365 ## page cache allows for a nicer user experience when navigating forth or
366 ## back to pages in the forward/back history, by pausing and resuming up
367 ## to _n_ pages. For more information about the feature, please refer to:
368 ## https://webkit.org/blog/427/webkit-page-cache-i-the-basics/
369 ## Type: Int
370 # c.content.cache.maximum_pages = 0
371
372 ## Size (in bytes) of the HTTP network cache. Null to use the default
373 ## value. With QtWebEngine, the maximum supported value is 2147483647 (~2
374 ## GB).
375 ## Type: Int
376 # c.content.cache.size = None
377
378 ## Allow websites to read canvas elements. Note this is needed for some
379 ## websites to work properly.
380 ## Type: Bool
381 # c.content.canvas_reading = True
382
383 ## Which cookies to accept. With QtWebEngine, this setting also controls
384 ## other features with tracking capabilities similar to those of cookies;
385 ## including IndexedDB, DOM storage, filesystem API, service workers, and
386 ## AppCache. Note that with QtWebKit, only `all` and `never` are
387 ## supported as per-domain values. Setting `no-3rdparty` or `no-
388 ## unknown-3rdparty` per-domain on QtWebKit will have the same effect as
389 ## `all`. If this setting is used with URL patterns, the pattern gets
390 ## applied to the origin/first party URL of the page making the request,
391 ## not the request URL. With QtWebEngine 5.15.0+, paths will be stripped
392 ## from URLs, so URL patterns using paths will not match. With
393 ## QtWebEngine 5.15.2+, subdomains are additionally stripped as well, so
394 ## you will typically need to set this setting for `example.com` when the
395 ## cookie is set on `somesubdomain.example.com` for it to work properly.
396 ## To debug issues with this setting, start qutebrowser with `--debug
397 ## --logfilter network --debug-flag log-cookies` which will show all
398 ## cookies being set.
399 ## Type: String
400 ## Valid values:
401 ## - all: Accept all cookies.
402 ## - no-3rdparty: Accept cookies from the same origin only. This is known to break some sites, such as GMail.
403 ## - 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.
404 ## - never: Don't accept cookies at all.
405 c.content.cookies.accept = 'no-3rdparty'
406
407 ## Store cookies.
408 ## Type: Bool
409 # c.content.cookies.store = True
410
411 ## Default encoding to use for websites. The encoding must be a string
412 ## describing an encoding such as _utf-8_, _iso-8859-1_, etc.
413 ## Type: String
414 # c.content.default_encoding = 'iso-8859-1'
415
416 ## Allow websites to share screen content.
417 ## Type: BoolAsk
418 ## Valid values:
419 ## - true
420 ## - false
421 ## - ask
422 # c.content.desktop_capture = 'ask'
423
424 ## Try to pre-fetch DNS entries to speed up browsing.
425 ## Type: Bool
426 # c.content.dns_prefetch = True
427
428 ## Expand each subframe to its contents. This will flatten all the frames
429 ## to become one scrollable page.
430 ## Type: Bool
431 # c.content.frame_flattening = False
432
433 ## Set fullscreen notification overlay timeout in milliseconds. If set to
434 ## 0, no overlay will be displayed.
435 ## Type: Int
436 # c.content.fullscreen.overlay_timeout = 3000
437
438 ## Limit fullscreen to the browser window (does not expand to fill the
439 ## screen).
440 ## Type: Bool
441 # c.content.fullscreen.window = False
442
443 ## Allow websites to request geolocations.
444 ## Type: BoolAsk
445 ## Valid values:
446 ## - true
447 ## - false
448 ## - ask
449 c.content.geolocation = False
450
451 ## Value to send in the `Accept-Language` header. Note that the value
452 ## read from JavaScript is always the global value.
453 ## Type: String
454 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'
455
456 ## Custom headers for qutebrowser HTTP requests.
457 ## Type: Dict
458 # c.content.headers.custom = {}
459
460 ## Value to send in the `DNT` header. When this is set to true,
461 ## qutebrowser asks websites to not track your identity. If set to null,
462 ## the DNT header is not sent at all.
463 ## Type: Bool
464 # c.content.headers.do_not_track = True
465
466 ## When to send the Referer header. The Referer header tells websites
467 ## from which website you were coming from when visiting them. Note that
468 ## with QtWebEngine, websites can override this preference by setting the
469 ## `Referrer-Policy:` header, so that any websites visited from them get
470 ## the full referer. No restart is needed with QtWebKit.
471 ## Type: String
472 ## Valid values:
473 ## - always: Always send the Referer.
474 ## - never: Never send the Referer. This is not recommended, as some sites may break.
475 ## - 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.
476 # c.content.headers.referer = 'same-domain'
477
478 ## User agent to send. The following placeholders are defined: *
479 ## `{os_info}`: Something like "X11; Linux x86_64". * `{webkit_version}`:
480 ## The underlying WebKit version (set to a fixed value with
481 ## QtWebEngine). * `{qt_key}`: "Qt" for QtWebKit, "QtWebEngine" for
482 ## QtWebEngine. * `{qt_version}`: The underlying Qt version. *
483 ## `{upstream_browser_key}`: "Version" for QtWebKit, "Chrome" for
484 ## QtWebEngine. * `{upstream_browser_version}`: The corresponding
485 ## Safari/Chrome version. * `{qutebrowser_version}`: The currently
486 ## running qutebrowser version. The default value is equal to the
487 ## unchanged user agent of QtWebKit/QtWebEngine. Note that the value
488 ## read from JavaScript is always the global value. With QtWebEngine
489 ## between 5.12 and 5.14 (inclusive), changing the value exposed to
490 ## JavaScript requires a restart.
491 ## Type: FormatString
492 # 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}'
493
494 ## Enable hyperlink auditing (`<a ping>`).
495 ## Type: Bool
496 # c.content.hyperlink_auditing = False
497
498 ## Load images automatically in web pages.
499 ## Type: Bool
500 # c.content.images = True
501
502 ## Show javascript alerts.
503 ## Type: Bool
504 # c.content.javascript.alert = True
505
506 ## Allow JavaScript to read from or write to the clipboard. With
507 ## QtWebEngine, writing the clipboard as response to a user interaction
508 ## is always allowed.
509 ## Type: Bool
510 # c.content.javascript.can_access_clipboard = False
511
512 ## Allow JavaScript to close tabs.
513 ## Type: Bool
514 # c.content.javascript.can_close_tabs = False
515
516 ## Allow JavaScript to open new tabs without user interaction.
517 ## Type: Bool
518 # c.content.javascript.can_open_tabs_automatically = False
519
520 ## Enable JavaScript.
521 ## Type: Bool
522 # c.content.javascript.enabled = True
523
524 ## Log levels to use for JavaScript console logging messages. When a
525 ## JavaScript message with the level given in the dictionary key is
526 ## logged, the corresponding dictionary value selects the qutebrowser
527 ## logger to use. On QtWebKit, the "unknown" setting is always used. The
528 ## following levels are valid: `none`, `debug`, `info`, `warning`,
529 ## `error`.
530 ## Type: Dict
531 # c.content.javascript.log = {'unknown': 'debug', 'info': 'debug', 'warning': 'debug', 'error': 'debug'}
532
533 ## Use the standard JavaScript modal dialog for `alert()` and
534 ## `confirm()`.
535 ## Type: Bool
536 # c.content.javascript.modal_dialog = False
537
538 ## Show javascript prompts.
539 ## Type: Bool
540 # c.content.javascript.prompt = True
541
542 ## Allow locally loaded documents to access other local URLs.
543 ## Type: Bool
544 # c.content.local_content_can_access_file_urls = True
545
546 ## Allow locally loaded documents to access remote URLs.
547 ## Type: Bool
548 # c.content.local_content_can_access_remote_urls = False
549
550 ## Enable support for HTML 5 local storage and Web SQL.
551 ## Type: Bool
552 # c.content.local_storage = True
553
554 ## Allow websites to record audio.
555 ## Type: BoolAsk
556 ## Valid values:
557 ## - true
558 ## - false
559 ## - ask
560 # c.content.media.audio_capture = 'ask'
561
562 ## Allow websites to record audio and video.
563 ## Type: BoolAsk
564 ## Valid values:
565 ## - true
566 ## - false
567 ## - ask
568 # c.content.media.audio_video_capture = 'ask'
569
570 ## Allow websites to record video.
571 ## Type: BoolAsk
572 ## Valid values:
573 ## - true
574 ## - false
575 ## - ask
576 # c.content.media.video_capture = 'ask'
577
578 ## Allow websites to lock your mouse pointer.
579 ## Type: BoolAsk
580 ## Valid values:
581 ## - true
582 ## - false
583 ## - ask
584 # c.content.mouse_lock = 'ask'
585
586 ## Automatically mute tabs. Note that if the `:tab-mute` command is used,
587 ## the mute status for the affected tab is now controlled manually, and
588 ## this setting doesn't have any effect.
589 ## Type: Bool
590 # c.content.mute = False
591
592 ## Netrc-file for HTTP authentication. If unset, `~/.netrc` is used.
593 ## Type: File
594 # c.content.netrc_file = None
595
596 ## Allow websites to show notifications.
597 ## Type: BoolAsk
598 ## Valid values:
599 ## - true
600 ## - false
601 ## - ask
602 c.content.notifications.enabled = 'ask'
603 config.set('content.notifications.enabled', True, '*://*.gitlab.com/*')
604 config.set('content.notifications.enabled', True, '*://*.google.com/*')
605
606 ## What notification presenter to use for web notifications. Note that
607 ## not all implementations support all features of notifications: - With
608 ## PyQt 5.14, any setting other than `qt` does not support the `click`
609 ## and `close` events, as well as the `tag` option to replace existing
610 ## notifications. - The `qt` and `systray` options only support showing
611 ## one notification at the time and ignore the `tag` option to replace
612 ## existing notifications. - The `herbe` option only supports showing one
613 ## notification at the time and doesn't show icons. - The `messages`
614 ## option doesn't show icons and doesn't support the `click` and
615 ## `close` events.
616 ## Type: String
617 ## Valid values:
618 ## - auto: Tries `libnotify`, `systray` and `messages`, uses the first one available without showing error messages.
619 ## - qt: Use Qt's native notification presenter, based on a system tray icon. Switching from or to this value requires a restart of qutebrowser. Recommended over `systray` on PyQt 5.14.
620 ## - 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.
621 ## - 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.
622 ## - messages: Show notifications as qutebrowser messages. Most notification features aren't available.
623 ## - herbe: (experimental!) Show notifications using herbe (github.com/dudik/herbe). Most notification features aren't available.
624 # c.content.notifications.presenter = 'auto'
625
626 ## Whether to show the origin URL for notifications. Note that URL
627 ## patterns with this setting only get matched against the origin part of
628 ## the URL, so e.g. paths in patterns will never match. Note that with
629 ## the `qt` presenter, origins are never shown.
630 ## Type: Bool
631 # c.content.notifications.show_origin = True
632
633 ## Allow pdf.js to view PDF files in the browser. Note that the files can
634 ## still be downloaded by clicking the download button in the pdf.js
635 ## viewer.
636 ## Type: Bool
637 # c.content.pdfjs = False
638
639 ## Allow websites to request persistent storage quota via
640 ## `navigator.webkitPersistentStorage.requestQuota`.
641 ## Type: BoolAsk
642 ## Valid values:
643 ## - true
644 ## - false
645 ## - ask
646 # c.content.persistent_storage = 'ask'
647
648 ## Enable plugins in Web pages.
649 ## Type: Bool
650 # c.content.plugins = False
651
652 ## Request websites to minimize non-essentials animations and motion.
653 ## This results in the `prefers-reduced-motion` CSS media query to
654 ## evaluate to `reduce` (rather than `no-preference`). On Windows, if
655 ## this setting is set to False, the system-wide animation setting is
656 ## considered.
657 ## Type: Bool
658 # c.content.prefers_reduced_motion = False
659
660 ## Draw the background color and images also when the page is printed.
661 ## Type: Bool
662 # c.content.print_element_backgrounds = True
663
664 ## Open new windows in private browsing mode which does not record
665 ## visited pages.
666 ## Type: Bool
667 # c.content.private_browsing = False
668
669 ## Proxy to use. In addition to the listed values, you can use a
670 ## `socks://...` or `http://...` URL. Note that with QtWebEngine, it will
671 ## take a couple of seconds until the change is applied, if this value is
672 ## changed at runtime.
673 ## Type: Proxy
674 ## Valid values:
675 ## - system: Use the system wide proxy.
676 ## - none: Don't use any proxy
677 # c.content.proxy = 'system'
678
679 ## Send DNS requests over the configured proxy.
680 ## Type: Bool
681 # c.content.proxy_dns_requests = True
682
683 ## Allow websites to register protocol handlers via
684 ## `navigator.registerProtocolHandler`.
685 ## Type: BoolAsk
686 ## Valid values:
687 ## - true
688 ## - false
689 ## - ask
690 # c.content.register_protocol_handler = 'ask'
691 with config.pattern('*://mail.google.com/*') as p:
692 p.content.register_protocol_handler = False
693 with config.pattern('*://calendar.google.com/*') as p:
694 p.content.register_protocol_handler = False
695
696 ## Enable quirks (such as faked user agent headers) needed to get
697 ## specific sites to work properly.
698 ## Type: Bool
699 # c.content.site_specific_quirks.enabled = True
700
701 ## Disable a list of named quirks. The js-string-replaceall quirk is
702 ## needed for Nextcloud Calendar < 2.2.0 with QtWebEngine < 5.15.3.
703 ## However, the workaround is not fully compliant to the ECMAScript spec
704 ## and might cause issues on other websites, so it's disabled by default.
705 ## Type: FlagList
706 ## Valid values:
707 ## - ua-whatsapp
708 ## - ua-google
709 ## - ua-slack
710 ## - ua-googledocs
711 ## - js-whatsapp-web
712 ## - js-discord
713 ## - js-string-replaceall
714 ## - js-globalthis
715 ## - js-object-fromentries
716 ## - misc-krunker
717 ## - misc-mathml-darkmode
718 # c.content.site_specific_quirks.skip = ['js-string-replaceall']
719
720 ## How to proceed on TLS certificate errors.
721 ## Type: String
722 ## Valid values:
723 ## - ask: Ask how to proceed for every certificate error (unless non-overridable due to HSTS).
724 ## - ask-block-thirdparty: Ask how to proceed for normal page loads, but silently block resource loads.
725 ## - block: Automatically block loading on certificate errors.
726 ## - 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.
727 # c.content.tls.certificate_errors = 'ask'
728
729 ## How navigation requests to URLs with unknown schemes are handled.
730 ## Type: String
731 ## Valid values:
732 ## - disallow: Disallows all navigation requests to URLs with unknown schemes.
733 ## - 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.
734 ## - allow-all: Allows all navigation requests to URLs with unknown schemes.
735 # c.content.unknown_url_scheme_policy = 'allow-from-user-interaction'
736
737 ## List of user stylesheet filenames to use.
738 ## Type: List of File, or File
739 # c.content.user_stylesheets = []
740
741 ## Enable WebGL.
742 ## Type: Bool
743 # c.content.webgl = True
744
745 ## Which interfaces to expose via WebRTC.
746 ## Type: String
747 ## Valid values:
748 ## - all-interfaces: WebRTC has the right to enumerate all interfaces and bind them to discover public interfaces.
749 ## - 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.
750 ## - default-public-interface-only: WebRTC should only use the default route used by http. This doesn't expose any local addresses.
751 ## - 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.
752 # c.content.webrtc_ip_handling_policy = 'all-interfaces'
753
754 ## Monitor load requests for cross-site scripting attempts. Suspicious
755 ## scripts will be blocked and reported in the devtools JavaScript
756 ## console. Note that bypasses for the XSS auditor are widely known and
757 ## it can be abused for cross-site info leaks in some scenarios, see:
758 ## https://www.chromium.org/developers/design-documents/xss-auditor
759 ## Type: Bool
760 # c.content.xss_auditing = False
761
762 ## Directory to save downloads to. If unset, a sensible OS-specific
763 ## default is used.
764 ## Type: Directory
765 c.downloads.location.directory = "~/downloads"
766
767 ## Prompt the user for the download location. If set to false,
768 ## `downloads.location.directory` will be used.
769 ## Type: Bool
770 # c.downloads.location.prompt = True
771
772 ## Remember the last used download directory.
773 ## Type: Bool
774 # c.downloads.location.remember = True
775
776 ## What to display in the download filename input.
777 ## Type: String
778 ## Valid values:
779 ## - path: Show only the download path.
780 ## - filename: Show only download filename.
781 ## - both: Show download path and filename.
782 # c.downloads.location.suggestion = 'path'
783
784 ## Default program used to open downloads. If null, the default internal
785 ## handler is used. Any `{}` in the string will be expanded to the
786 ## filename, else the filename will be appended.
787 ## Type: String
788 c.downloads.open_dispatcher = "rifle"
789
790 ## Where to show the downloaded files.
791 ## Type: VerticalPosition
792 ## Valid values:
793 ## - top
794 ## - bottom
795 # c.downloads.position = 'top'
796
797 ## Automatically abort insecure (HTTP) downloads originating from secure
798 ## (HTTPS) pages. For per-domain settings, the relevant URL is the URL
799 ## initiating the download, not the URL the download itself is coming
800 ## from. It's not recommended to set this setting to false globally.
801 ## Type: Bool
802 # c.downloads.prevent_mixed_content = True
803
804 ## Duration (in milliseconds) to wait before removing finished downloads.
805 ## If set to -1, downloads are never removed.
806 ## Type: Int
807 # c.downloads.remove_finished = -1
808
809 ## Editor (and arguments) to use for the `edit-*` commands. The following
810 ## placeholders are defined: * `{file}`: Filename of the file to be
811 ## edited. * `{line}`: Line in which the caret is found in the text. *
812 ## `{column}`: Column in which the caret is found in the text. *
813 ## `{line0}`: Same as `{line}`, but starting from index 0. * `{column0}`:
814 ## Same as `{column}`, but starting from index 0.
815 ## Type: ShellCommand
816 c.editor.command = in_terminal(['vim', '{file}', '-c', 'normal {line}G{column0}l'])
817
818 ## Encoding to use for the editor.
819 ## Type: Encoding
820 # c.editor.encoding = 'utf-8'
821
822 ## Handler for selecting file(s) in forms. If `external`, then the
823 ## commands specified by `fileselect.single_file.command` and
824 ## `fileselect.multiple_files.command` are used to select one or multiple
825 ## files respectively.
826 ## Type: String
827 ## Valid values:
828 ## - default: Use the default file selector.
829 ## - external: Use an external command.
830 c.fileselect.handler = 'external'
831
832 ## Command (and arguments) to use for selecting multiple files in forms.
833 ## The command should write the selected file paths to the specified file
834 ## or to stdout, separated by newlines. The following placeholders are
835 ## defined: * `{}`: Filename of the file to be written to. If not
836 ## contained in any argument, the standard output of the command is
837 ## read instead.
838 ## Type: ShellCommand
839 c.fileselect.multiple_files.command = in_terminal(['ranger', '--choosefiles={}'])
840
841 ## Command (and arguments) to use for selecting a single file in forms.
842 ## The command should write the selected file path to the specified file
843 ## or stdout. The following placeholders are defined: * `{}`: Filename of
844 ## the file to be written to. If not contained in any argument, the
845 ## standard output of the command is read instead.
846 ## Type: ShellCommand
847 c.fileselect.multiple_files.command = in_terminal(['ranger', '--choosefile={}'])
848
849 ## Font used in the completion categories.
850 ## Type: Font
851 # c.fonts.completion.category = 'bold default_size default_family'
852
853 ## Font used in the completion widget.
854 ## Type: Font
855 # c.fonts.completion.entry = 'default_size default_family'
856
857 ## Font used for the context menu. If set to null, the Qt default is
858 ## used.
859 ## Type: Font
860 # c.fonts.contextmenu = None
861
862 ## Font used for the debugging console.
863 ## Type: Font
864 # c.fonts.debug_console = 'default_size default_family'
865
866 ## Default font families to use. Whenever "default_family" is used in a
867 ## font setting, it's replaced with the fonts listed here. If set to an
868 ## empty value, a system-specific monospace default is used.
869 ## Type: List of Font, or Font
870 c.fonts.default_family = ["Fira Code"]
871
872 ## Default font size to use. Whenever "default_size" is used in a font
873 ## setting, it's replaced with the size listed here. Valid values are
874 ## either a float value with a "pt" suffix, or an integer value with a
875 ## "px" suffix.
876 ## Type: String
877 # c.fonts.default_size = '10pt'
878
879 ## Font used for the downloadbar.
880 ## Type: Font
881 # c.fonts.downloads = 'default_size default_family'
882
883 ## Font used for the hints.
884 ## Type: Font
885 # c.fonts.hints = 'bold default_size default_family'
886
887 ## Font used in the keyhint widget.
888 ## Type: Font
889 # c.fonts.keyhint = 'default_size default_family'
890
891 ## Font used for error messages.
892 ## Type: Font
893 # c.fonts.messages.error = 'default_size default_family'
894
895 ## Font used for info messages.
896 ## Type: Font
897 # c.fonts.messages.info = 'default_size default_family'
898
899 ## Font used for warning messages.
900 ## Type: Font
901 # c.fonts.messages.warning = 'default_size default_family'
902
903 ## Font used for prompts.
904 ## Type: Font
905 # c.fonts.prompts = 'default_size sans-serif'
906
907 ## Font used in the statusbar.
908 ## Type: Font
909 # c.fonts.statusbar = 'default_size default_family'
910
911 ## Font used for selected tabs.
912 ## Type: Font
913 # c.fonts.tabs.selected = 'default_size default_family'
914
915 ## Font used for unselected tabs.
916 ## Type: Font
917 # c.fonts.tabs.unselected = 'default_size default_family'
918
919 ## Font family for cursive fonts.
920 ## Type: FontFamily
921 # c.fonts.web.family.cursive = ''
922
923 ## Font family for fantasy fonts.
924 ## Type: FontFamily
925 # c.fonts.web.family.fantasy = ''
926
927 ## Font family for fixed fonts.
928 ## Type: FontFamily
929 # c.fonts.web.family.fixed = ''
930
931 ## Font family for sans-serif fonts.
932 ## Type: FontFamily
933 # c.fonts.web.family.sans_serif = ''
934
935 ## Font family for serif fonts.
936 ## Type: FontFamily
937 # c.fonts.web.family.serif = ''
938
939 ## Font family for standard fonts.
940 ## Type: FontFamily
941 # c.fonts.web.family.standard = ''
942
943 ## Default font size (in pixels) for regular text.
944 ## Type: Int
945 # c.fonts.web.size.default = 16
946
947 ## Default font size (in pixels) for fixed-pitch text.
948 ## Type: Int
949 # c.fonts.web.size.default_fixed = 13
950
951 ## Hard minimum font size (in pixels).
952 ## Type: Int
953 # c.fonts.web.size.minimum = 0
954
955 ## Minimum logical font size (in pixels) that is applied when zooming
956 ## out.
957 ## Type: Int
958 # c.fonts.web.size.minimum_logical = 6
959
960 ## When a hint can be automatically followed without pressing Enter.
961 ## Type: String
962 ## Valid values:
963 ## - always: Auto-follow whenever there is only a single hint on a page.
964 ## - unique-match: Auto-follow whenever there is a unique non-empty match in either the hint string (word mode) or filter (number mode).
965 ## - 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).
966 ## - never: The user will always need to press Enter to follow a hint.
967 # c.hints.auto_follow = 'unique-match'
968
969 ## Duration (in milliseconds) to ignore normal-mode key bindings after a
970 ## successful auto-follow.
971 ## Type: Int
972 # c.hints.auto_follow_timeout = 0
973
974 ## CSS border value for hints.
975 ## Type: String
976 # c.hints.border = '1px solid #E3BE23'
977
978 ## Characters used for hint strings.
979 ## Type: UniqueCharString
980 c.hints.chars = 'aoeuidhtns'
981
982 ## Dictionary file to be used by the word hints.
983 ## Type: File
984 # c.hints.dictionary = '/usr/share/dict/words'
985
986 ## Which implementation to use to find elements to hint.
987 ## Type: String
988 ## Valid values:
989 ## - javascript: Better but slower
990 ## - python: Slightly worse but faster
991 # c.hints.find_implementation = 'python'
992
993 ## Hide unmatched hints in rapid mode.
994 ## Type: Bool
995 # c.hints.hide_unmatched_rapid_hints = True
996
997 ## Leave hint mode when starting a new page load.
998 ## Type: Bool
999 # c.hints.leave_on_load = False
1000
1001 ## Minimum number of characters used for hint strings.
1002 ## Type: Int
1003 c.hints.min_chars = 2
1004
1005 ## Mode to use for hints.
1006 ## Type: String
1007 ## Valid values:
1008 ## - 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.)
1009 ## - letter: Use the characters in the `hints.chars` setting.
1010 ## - word: Use hints words based on the html elements and the extra words.
1011 # c.hints.mode = 'letter'
1012
1013 ## Comma-separated list of regular expressions to use for 'next' links.
1014 ## Type: List of Regex
1015 # c.hints.next_regexes = ['\\bnext\\b', '\\bmore\\b', '\\bnewer\\b', '\\b[>→≫]\\b', '\\b(>>|»)\\b', '\\bcontinue\\b']
1016
1017 ## Padding (in pixels) for hints.
1018 ## Type: Padding
1019 # c.hints.padding = {'top': 0, 'bottom': 0, 'left': 3, 'right': 3}
1020
1021 ## Comma-separated list of regular expressions to use for 'prev' links.
1022 ## Type: List of Regex
1023 # c.hints.prev_regexes = ['\\bprev(ious)?\\b', '\\bback\\b', '\\bolder\\b', '\\b[<←≪]\\b', '\\b(<<|«)\\b']
1024
1025 ## Rounding radius (in pixels) for the edges of hints.
1026 ## Type: Int
1027 # c.hints.radius = 3
1028
1029 ## Scatter hint key chains (like Vimium) or not (like dwb). Ignored for
1030 ## number hints.
1031 ## Type: Bool
1032 c.hints.scatter = False
1033
1034 ## CSS selectors used to determine which elements on a page should have
1035 ## hints.
1036 ## Type: Dict
1037 # 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']}
1038
1039 ## Make characters in hint strings uppercase.
1040 ## Type: Bool
1041 # c.hints.uppercase = False
1042
1043 ## Maximum time (in minutes) between two history items for them to be
1044 ## considered being from the same browsing session. Items with less time
1045 ## between them are grouped when being displayed in `:history`. Use -1 to
1046 ## disable separation.
1047 ## Type: Int
1048 # c.history_gap_interval = 30
1049
1050 ## Allow Escape to quit the crash reporter.
1051 ## Type: Bool
1052 # c.input.escape_quits_reporter = True
1053
1054 ## Which unbound keys to forward to the webview in normal mode.
1055 ## Type: String
1056 ## Valid values:
1057 ## - all: Forward all unbound keys.
1058 ## - auto: Forward unbound non-alphanumeric keys.
1059 ## - none: Don't forward any keys.
1060 # c.input.forward_unbound_keys = 'auto'
1061
1062 ## Enter insert mode if an editable element is clicked.
1063 ## Type: Bool
1064 # c.input.insert_mode.auto_enter = True
1065
1066 ## Leave insert mode if a non-editable element is clicked.
1067 ## Type: Bool
1068 # c.input.insert_mode.auto_leave = True
1069
1070 ## Automatically enter insert mode if an editable element is focused
1071 ## after loading the page.
1072 ## Type: Bool
1073 # c.input.insert_mode.auto_load = False
1074
1075 ## Leave insert mode when starting a new page load. Patterns may be
1076 ## unreliable on this setting, and they may match the url you are
1077 ## navigating to, or the URL you are navigating from.
1078 ## Type: Bool
1079 c.input.insert_mode.leave_on_load = True
1080
1081 ## Switch to insert mode when clicking flash and other plugins.
1082 ## Type: Bool
1083 # c.input.insert_mode.plugins = False
1084
1085 ## Include hyperlinks in the keyboard focus chain when tabbing.
1086 ## Type: Bool
1087 # c.input.links_included_in_focus_chain = True
1088
1089 ## Whether the underlying Chromium should handle media keys. On Linux,
1090 ## disabling this also disables Chromium's MPRIS integration.
1091 ## Type: Bool
1092 # c.input.media_keys = True
1093
1094 ## Enable back and forward buttons on the mouse.
1095 ## Type: Bool
1096 # c.input.mouse.back_forward_buttons = True
1097
1098 ## Enable Opera-like mouse rocker gestures. This disables the context
1099 ## menu.
1100 ## Type: Bool
1101 # c.input.mouse.rocker_gestures = False
1102
1103 ## Timeout (in milliseconds) for partially typed key bindings. If the
1104 ## current input forms only partial matches, the keystring will be
1105 ## cleared after this time. If set to 0, partially typed bindings are
1106 ## never cleared.
1107 ## Type: Int
1108 # c.input.partial_timeout = 0
1109
1110 ## Enable spatial navigation. Spatial navigation consists in the ability
1111 ## to navigate between focusable elements in a Web page, such as
1112 ## hyperlinks and form controls, by using Left, Right, Up and Down arrow
1113 ## keys. For example, if the user presses the Right key, heuristics
1114 ## determine whether there is an element he might be trying to reach
1115 ## towards the right and which element he probably wants.
1116 ## Type: Bool
1117 # c.input.spatial_navigation = False
1118
1119 ## Keychains that shouldn't be shown in the keyhint dialog. Globs are
1120 ## supported, so `;*` will blacklist all keychains starting with `;`. Use
1121 ## `*` to disable keyhints.
1122 ## Type: List of String
1123 # c.keyhint.blacklist = []
1124
1125 ## Time (in milliseconds) from pressing a key to seeing the keyhint
1126 ## dialog.
1127 ## Type: Int
1128 # c.keyhint.delay = 500
1129
1130 ## Rounding radius (in pixels) for the edges of the keyhint dialog.
1131 ## Type: Int
1132 # c.keyhint.radius = 6
1133
1134 ## Level for console (stdout/stderr) logs. Ignored if the `--loglevel` or
1135 ## `--debug` CLI flags are used.
1136 ## Type: LogLevel
1137 ## Valid values:
1138 ## - vdebug
1139 ## - debug
1140 ## - info
1141 ## - warning
1142 ## - error
1143 ## - critical
1144 # c.logging.level.console = 'info'
1145
1146 ## Level for in-memory logs.
1147 ## Type: LogLevel
1148 ## Valid values:
1149 ## - vdebug
1150 ## - debug
1151 ## - info
1152 ## - warning
1153 ## - error
1154 ## - critical
1155 # c.logging.level.ram = 'debug'
1156
1157 ## Duration (in milliseconds) to show messages in the statusbar for. Set
1158 ## to 0 to never clear messages.
1159 ## Type: Int
1160 # c.messages.timeout = 3000
1161
1162 ## How to open links in an existing instance if a new one is launched.
1163 ## This happens when e.g. opening a link from a terminal. See
1164 ## `new_instance_open_target_window` to customize in which window the
1165 ## link is opened in.
1166 ## Type: String
1167 ## Valid values:
1168 ## - tab: Open a new tab in the existing window and activate the window.
1169 ## - tab-bg: Open a new background tab in the existing window and activate the window.
1170 ## - tab-silent: Open a new tab in the existing window without activating the window.
1171 ## - tab-bg-silent: Open a new background tab in the existing window without activating the window.
1172 ## - window: Open in a new window.
1173 ## - private-window: Open in a new private window.
1174 # c.new_instance_open_target = 'tab'
1175
1176 ## Which window to choose when opening links as new tabs. When
1177 ## `new_instance_open_target` is set to `window`, this is ignored.
1178 ## Type: String
1179 ## Valid values:
1180 ## - first-opened: Open new tabs in the first (oldest) opened window.
1181 ## - last-opened: Open new tabs in the last (newest) opened window.
1182 ## - last-focused: Open new tabs in the most recently focused window.
1183 ## - last-visible: Open new tabs in the most recently visible window.
1184 # c.new_instance_open_target_window = 'last-focused'
1185
1186 ## Show a filebrowser in download prompts.
1187 ## Type: Bool
1188 # c.prompt.filebrowser = True
1189
1190 ## Rounding radius (in pixels) for the edges of prompts.
1191 ## Type: Int
1192 # c.prompt.radius = 8
1193
1194 ## Additional arguments to pass to Qt, without leading `--`. With
1195 ## QtWebEngine, some Chromium arguments (see
1196 ## https://peter.sh/experiments/chromium-command-line-switches/ for a
1197 ## list) will work.
1198 ## Type: List of String
1199 c.qt.args = ['proxy-pac-url=file://' + str(config.configdir / 'proxy.pac')]
1200
1201 ## Additional environment variables to set. Setting an environment
1202 ## variable to null/None will unset it.
1203 ## Type: Dict
1204 # c.qt.environ = {}
1205
1206 ## Force a Qt platform to use. This sets the `QT_QPA_PLATFORM`
1207 ## environment variable and is useful to force using the XCB plugin when
1208 ## running QtWebEngine on Wayland.
1209 ## Type: String
1210 # c.qt.force_platform = None
1211
1212 ## Force a Qt platformtheme to use. This sets the `QT_QPA_PLATFORMTHEME`
1213 ## environment variable which controls dialogs like the filepicker. By
1214 ## default, Qt determines the platform theme based on the desktop
1215 ## environment.
1216 ## Type: String
1217 # c.qt.force_platformtheme = None
1218
1219 ## Force software rendering for QtWebEngine. This is needed for
1220 ## QtWebEngine to work with Nouveau drivers and can be useful in other
1221 ## scenarios related to graphic issues.
1222 ## Type: String
1223 ## Valid values:
1224 ## - software-opengl: Tell LibGL to use a software implementation of GL (`LIBGL_ALWAYS_SOFTWARE` / `QT_XCB_FORCE_SOFTWARE_OPENGL`)
1225 ## - qt-quick: Tell Qt Quick to use a software renderer instead of OpenGL. (`QT_QUICK_BACKEND=software`)
1226 ## - chromium: Tell Chromium to disable GPU support and use Skia software rendering instead. (`--disable-gpu`)
1227 ## - none: Don't force software rendering.
1228 # c.qt.force_software_rendering = 'none'
1229
1230 ## Turn on Qt HighDPI scaling. This is equivalent to setting
1231 ## QT_AUTO_SCREEN_SCALE_FACTOR=1 or QT_ENABLE_HIGHDPI_SCALING=1 (Qt >=
1232 ## 5.14) in the environment. It's off by default as it can cause issues
1233 ## with some bitmap fonts. As an alternative to this, it's possible to
1234 ## set font sizes and the `zoom.default` setting.
1235 ## Type: Bool
1236 # c.qt.highdpi = False
1237
1238 ## When to use Chromium's low-end device mode. This improves the RAM
1239 ## usage of renderer processes, at the expense of performance.
1240 ## Type: String
1241 ## Valid values:
1242 ## - always: Always use low-end device mode.
1243 ## - auto: Decide automatically (uses low-end mode with < 1 GB available RAM).
1244 ## - never: Never use low-end device mode.
1245 # c.qt.low_end_device_mode = 'auto'
1246
1247 ## Which Chromium process model to use. Alternative process models use
1248 ## less resources, but decrease security and robustness. See the
1249 ## following pages for more details: -
1250 ## https://www.chromium.org/developers/design-documents/process-models
1251 ## - https://doc.qt.io/qt-5/qtwebengine-features.html#process-models
1252 ## Type: String
1253 ## Valid values:
1254 ## - process-per-site-instance: Pages from separate sites are put into separate processes and separate visits to the same site are also isolated.
1255 ## - 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.
1256 ## - single-process: Run all tabs in a single process. This should be used for debugging purposes only, and it disables `:open --private`.
1257 # c.qt.process_model = 'process-per-site-instance'
1258
1259 ## Work around locale parsing issues in QtWebEngine 5.15.3. With some
1260 ## locales, QtWebEngine 5.15.3 is unusable without this workaround. In
1261 ## affected scenarios, QtWebEngine will log "Network service crashed,
1262 ## restarting service." and only display a blank page. However, It is
1263 ## expected that distributions shipping QtWebEngine 5.15.3 follow up with
1264 ## a proper fix soon, so it is disabled by default.
1265 ## Type: Bool
1266 # c.qt.workarounds.locale = False
1267
1268 ## Delete the QtWebEngine Service Worker directory on every start. This
1269 ## workaround can help with certain crashes caused by an unknown
1270 ## QtWebEngine bug related to Service Workers. Those crashes happen
1271 ## seemingly immediately on Windows; after one hour of operation on other
1272 ## systems. Note however that enabling this option *can lead to data
1273 ## loss* on some pages (as Service Worker data isn't persisted) and will
1274 ## negatively impact start-up time.
1275 ## Type: Bool
1276 # c.qt.workarounds.remove_service_workers = False
1277
1278 ## When/how to show the scrollbar.
1279 ## Type: String
1280 ## Valid values:
1281 ## - always: Always show the scrollbar.
1282 ## - never: Never show the scrollbar.
1283 ## - when-searching: Show the scrollbar when searching for text in the webpage. With the QtWebKit backend, this is equal to `never`.
1284 ## - 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.
1285 # c.scrolling.bar = 'overlay'
1286
1287 ## Enable smooth scrolling for web pages. Note smooth scrolling does not
1288 ## work with the `:scroll-px` command.
1289 ## Type: Bool
1290 # c.scrolling.smooth = False
1291
1292 ## When to find text on a page case-insensitively.
1293 ## Type: IgnoreCase
1294 ## Valid values:
1295 ## - always: Search case-insensitively.
1296 ## - never: Search case-sensitively.
1297 ## - smart: Search case-sensitively if there are capital characters.
1298 # c.search.ignore_case = 'smart'
1299
1300 ## Find text on a page incrementally, renewing the search for each typed
1301 ## character.
1302 ## Type: Bool
1303 # c.search.incremental = True
1304
1305 ## Wrap around at the top and bottom of the page when advancing through
1306 ## text matches using `:search-next` and `:search-prev`.
1307 ## Type: Bool
1308 # c.search.wrap = True
1309
1310 ## Name of the session to save by default. If this is set to null, the
1311 ## session which was last loaded is saved.
1312 ## Type: SessionName
1313 # c.session.default_name = None
1314
1315 ## Load a restored tab as soon as it takes focus.
1316 ## Type: Bool
1317 c.session.lazy_restore = True
1318
1319 ## Whether to automatically save a session when it is closed.
1320 ## Type: Bool
1321 # c.session.save_when_close = True
1322
1323 ## Which sessions to load on startup. None will load the last saved
1324 ## sessions from the sate file, if you want to not load any sessions,
1325 ## pass an empty list.
1326 ## Type: List of String
1327 # c.session.startup_sessions = None
1328
1329 ## Languages to use for spell checking. You can check for available
1330 ## languages and install dictionaries using scripts/dictcli.py. Run the
1331 ## script with -h/--help for instructions.
1332 ## Type: List of String
1333 ## Valid values:
1334 ## - af-ZA: Afrikaans (South Africa)
1335 ## - bg-BG: Bulgarian (Bulgaria)
1336 ## - ca-ES: Catalan (Spain)
1337 ## - cs-CZ: Czech (Czech Republic)
1338 ## - da-DK: Danish (Denmark)
1339 ## - de-DE: German (Germany)
1340 ## - el-GR: Greek (Greece)
1341 ## - en-AU: English (Australia)
1342 ## - en-CA: English (Canada)
1343 ## - en-GB: English (United Kingdom)
1344 ## - en-US: English (United States)
1345 ## - es-ES: Spanish (Spain)
1346 ## - et-EE: Estonian (Estonia)
1347 ## - fa-IR: Farsi (Iran)
1348 ## - fo-FO: Faroese (Faroe Islands)
1349 ## - fr-FR: French (France)
1350 ## - he-IL: Hebrew (Israel)
1351 ## - hi-IN: Hindi (India)
1352 ## - hr-HR: Croatian (Croatia)
1353 ## - hu-HU: Hungarian (Hungary)
1354 ## - id-ID: Indonesian (Indonesia)
1355 ## - it-IT: Italian (Italy)
1356 ## - ko: Korean
1357 ## - lt-LT: Lithuanian (Lithuania)
1358 ## - lv-LV: Latvian (Latvia)
1359 ## - nb-NO: Norwegian (Norway)
1360 ## - nl-NL: Dutch (Netherlands)
1361 ## - pl-PL: Polish (Poland)
1362 ## - pt-BR: Portuguese (Brazil)
1363 ## - pt-PT: Portuguese (Portugal)
1364 ## - ro-RO: Romanian (Romania)
1365 ## - ru-RU: Russian (Russia)
1366 ## - sh: Serbo-Croatian
1367 ## - sk-SK: Slovak (Slovakia)
1368 ## - sl-SI: Slovenian (Slovenia)
1369 ## - sq: Albanian
1370 ## - sr: Serbian
1371 ## - sv-SE: Swedish (Sweden)
1372 ## - ta-IN: Tamil (India)
1373 ## - tg-TG: Tajik (Tajikistan)
1374 ## - tr-TR: Turkish (Turkey)
1375 ## - uk-UA: Ukrainian (Ukraine)
1376 ## - vi-VN: Vietnamese (Viet Nam)
1377 c.spellcheck.languages = ['en-GB']
1378
1379 ## Padding (in pixels) for the statusbar.
1380 ## Type: Padding
1381 # c.statusbar.padding = {'top': 1, 'bottom': 1, 'left': 0, 'right': 0}
1382
1383 ## Position of the status bar.
1384 ## Type: VerticalPosition
1385 ## Valid values:
1386 ## - top
1387 ## - bottom
1388 # c.statusbar.position = 'bottom'
1389
1390 ## When to show the statusbar.
1391 ## Type: String
1392 ## Valid values:
1393 ## - always: Always show the statusbar.
1394 ## - never: Always hide the statusbar.
1395 ## - in-mode: Show the statusbar when in modes other than normal mode.
1396 # c.statusbar.show = 'always'
1397
1398 ## List of widgets displayed in the statusbar.
1399 ## Type: List of StatusbarWidget
1400 ## Valid values:
1401 ## - url: Current page URL.
1402 ## - scroll: Percentage of the current page position like `10%`.
1403 ## - scroll_raw: Raw percentage of the current page position like `10`.
1404 ## - history: Display an arrow when possible to go back/forward in history.
1405 ## - tabs: Current active tab, e.g. `2`.
1406 ## - keypress: Display pressed keys when composing a vi command.
1407 ## - progress: Progress bar for the current page loading.
1408 ## - text:foo: Display the static text after the colon, `foo` in the example.
1409 # c.statusbar.widgets = ['keypress', 'url', 'scroll', 'history', 'tabs', 'progress']
1410
1411 ## Open new tabs (middleclick/ctrl+click) in the background.
1412 ## Type: Bool
1413 # c.tabs.background = True
1414
1415 ## Mouse button with which to close tabs.
1416 ## Type: String
1417 ## Valid values:
1418 ## - right: Close tabs on right-click.
1419 ## - middle: Close tabs on middle-click.
1420 ## - none: Don't close tabs using the mouse.
1421 # c.tabs.close_mouse_button = 'middle'
1422
1423 ## How to behave when the close mouse button is pressed on the tab bar.
1424 ## Type: String
1425 ## Valid values:
1426 ## - new-tab: Open a new tab.
1427 ## - close-current: Close the current tab.
1428 ## - close-last: Close the last tab.
1429 ## - ignore: Don't do anything.
1430 # c.tabs.close_mouse_button_on_bar = 'new-tab'
1431
1432 ## Scaling factor for favicons in the tab bar. The tab size is unchanged,
1433 ## so big favicons also require extra `tabs.padding`.
1434 ## Type: Float
1435 # c.tabs.favicons.scale = 1.0
1436
1437 ## When to show favicons in the tab bar. When switching this from never
1438 ## to always/pinned, note that favicons might not be loaded yet, thus
1439 ## tabs might require a reload to display them.
1440 ## Type: String
1441 ## Valid values:
1442 ## - always: Always show favicons.
1443 ## - never: Always hide favicons.
1444 ## - pinned: Show favicons only on pinned tabs.
1445 # c.tabs.favicons.show = 'always'
1446
1447 ## Maximum stack size to remember for tab switches (-1 for no maximum).
1448 ## Type: Int
1449 # c.tabs.focus_stack_size = 10
1450
1451 ## Padding (in pixels) for tab indicators.
1452 ## Type: Padding
1453 # c.tabs.indicator.padding = {'top': 2, 'bottom': 2, 'left': 0, 'right': 4}
1454
1455 ## Width (in pixels) of the progress indicator (0 to disable).
1456 ## Type: Int
1457 # c.tabs.indicator.width = 3
1458
1459 ## How to behave when the last tab is closed. If the
1460 ## `tabs.tabs_are_windows` setting is set, this is ignored and the
1461 ## behavior is always identical to the `close` value.
1462 ## Type: String
1463 ## Valid values:
1464 ## - ignore: Don't do anything.
1465 ## - blank: Load a blank page.
1466 ## - startpage: Load the start page.
1467 ## - default-page: Load the default page.
1468 ## - close: Close the window.
1469 # c.tabs.last_close = 'ignore'
1470
1471 ## Maximum width (in pixels) of tabs (-1 for no maximum). This setting
1472 ## only applies when tabs are horizontal. This setting does not apply to
1473 ## pinned tabs, unless `tabs.pinned.shrink` is False. This setting may
1474 ## not apply properly if max_width is smaller than the minimum size of
1475 ## tab contents, or smaller than tabs.min_width.
1476 ## Type: Int
1477 # c.tabs.max_width = -1
1478
1479 ## Minimum width (in pixels) of tabs (-1 for the default minimum size
1480 ## behavior). This setting only applies when tabs are horizontal. This
1481 ## setting does not apply to pinned tabs, unless `tabs.pinned.shrink` is
1482 ## False.
1483 ## Type: Int
1484 # c.tabs.min_width = -1
1485
1486 ## When switching tabs, what input mode is applied.
1487 ## Type: String
1488 ## Valid values:
1489 ## - persist: Retain the current mode.
1490 ## - restore: Restore previously saved mode.
1491 ## - normal: Always revert to normal mode.
1492 # c.tabs.mode_on_change = 'normal'
1493
1494 ## Switch between tabs using the mouse wheel.
1495 ## Type: Bool
1496 # c.tabs.mousewheel_switching = True
1497
1498 ## Position of new tabs opened from another tab. See
1499 ## `tabs.new_position.stacking` for controlling stacking behavior.
1500 ## Type: NewTabPosition
1501 ## Valid values:
1502 ## - prev: Before the current tab.
1503 ## - next: After the current tab.
1504 ## - first: At the beginning.
1505 ## - last: At the end.
1506 # c.tabs.new_position.related = 'next'
1507
1508 ## Stack related tabs on top of each other when opened consecutively.
1509 ## Only applies for `next` and `prev` values of
1510 ## `tabs.new_position.related` and `tabs.new_position.unrelated`.
1511 ## Type: Bool
1512 # c.tabs.new_position.stacking = True
1513
1514 ## Position of new tabs which are not opened from another tab. See
1515 ## `tabs.new_position.stacking` for controlling stacking behavior.
1516 ## Type: NewTabPosition
1517 ## Valid values:
1518 ## - prev: Before the current tab.
1519 ## - next: After the current tab.
1520 ## - first: At the beginning.
1521 ## - last: At the end.
1522 c.tabs.new_position.unrelated = 'next'
1523
1524 ## Padding (in pixels) around text for tabs.
1525 ## Type: Padding
1526 # c.tabs.padding = {'top': 0, 'bottom': 0, 'left': 5, 'right': 5}
1527
1528 ## Force pinned tabs to stay at fixed URL.
1529 ## Type: Bool
1530 # c.tabs.pinned.frozen = True
1531
1532 ## Shrink pinned tabs down to their contents.
1533 ## Type: Bool
1534 # c.tabs.pinned.shrink = True
1535
1536 ## Position of the tab bar.
1537 ## Type: Position
1538 ## Valid values:
1539 ## - top
1540 ## - bottom
1541 ## - left
1542 ## - right
1543 # c.tabs.position = 'top'
1544
1545 ## Which tab to select when the focused tab is removed.
1546 ## Type: SelectOnRemove
1547 ## Valid values:
1548 ## - prev: Select the tab which came before the closed one (left in horizontal, above in vertical).
1549 ## - next: Select the tab which came after the closed one (right in horizontal, below in vertical).
1550 ## - last-used: Select the previously selected tab.
1551 c.tabs.select_on_remove = 'prev'
1552
1553 ## When to show the tab bar.
1554 ## Type: String
1555 ## Valid values:
1556 ## - always: Always show the tab bar.
1557 ## - never: Always hide the tab bar.
1558 ## - multiple: Hide the tab bar if only one tab is open.
1559 ## - switching: Show the tab bar when switching tabs.
1560 # c.tabs.show = 'always'
1561
1562 ## Duration (in milliseconds) to show the tab bar before hiding it when
1563 ## tabs.show is set to 'switching'.
1564 ## Type: Int
1565 # c.tabs.show_switching_delay = 800
1566
1567 ## Open a new window for every tab.
1568 ## Type: Bool
1569 # c.tabs.tabs_are_windows = False
1570
1571 ## Alignment of the text inside of tabs.
1572 ## Type: TextAlignment
1573 ## Valid values:
1574 ## - left
1575 ## - right
1576 ## - center
1577 # c.tabs.title.alignment = 'left'
1578
1579 ## Format to use for the tab title. The following placeholders are
1580 ## defined:
1581 ## * `{perc}`: Percentage as a string like `[10%]`.
1582 ## * `{perc_raw}`: Raw percentage, e.g. `10`.
1583 ## * `{current_title}`: Title of the current web page.
1584 ## * `{title_sep}`: The string `" - "` if a title is set, empty otherwise.
1585 ## * `{index}`: Index of this tab.
1586 ## * `{aligned_index}`: Index of this tab padded with spaces to have the same width.
1587 ## * `{id}`: Internal tab ID of this tab.
1588 ## * `{scroll_pos}`: Page scroll position.
1589 ## * `{host}`: Host of the current web page.
1590 ## * `{backend}`: Either `webkit` or `webengine`
1591 ## * `{private}`: Indicates when private mode is enabled.
1592 ## * `{current_url}`: URL of the current web page.
1593 ## * `{protocol}`: Protocol (http/https/...) of the current web page.
1594 ## * `{audio}`: Indicator for audio/mute status.
1595 ## Type: FormatString
1596 # c.tabs.title.format = '{audio}{index}: {current_title}'
1597
1598 ## Format to use for the tab title for pinned tabs. The same placeholders
1599 ## like for `tabs.title.format` are defined.
1600 ## Type: FormatString
1601 # c.tabs.title.format_pinned = '{index}'
1602
1603 ## Show tooltips on tabs. Note this setting only affects windows opened
1604 ## after it has been set.
1605 ## Type: Bool
1606 # c.tabs.tooltips = True
1607
1608 ## Number of closed tabs (per window) and closed windows to remember for
1609 ## :undo (-1 for no maximum).
1610 ## Type: Int
1611 # c.tabs.undo_stack_size = 100
1612
1613 ## Width (in pixels or as percentage of the window) of the tab bar if
1614 ## it's vertical.
1615 ## Type: PercOrInt
1616 # c.tabs.width = '15%'
1617
1618 ## Wrap when changing tabs.
1619 ## Type: Bool
1620 # c.tabs.wrap = True
1621
1622 ## What search to start when something else than a URL is entered.
1623 ## Type: String
1624 ## Valid values:
1625 ## - naive: Use simple/naive check.
1626 ## - dns: Use DNS requests (might be slow!).
1627 ## - never: Never search automatically.
1628 ## - schemeless: Always search automatically unless URL explicitly contains a scheme.
1629 # c.url.auto_search = 'naive'
1630
1631 ## Page to open if :open -t/-b/-w is used without URL. Use `about:blank`
1632 ## for a blank page.
1633 ## Type: FuzzyUrl
1634 c.url.default_page = 'https://duckduckgo.com/?t=chakra'
1635
1636 ## URL segments where `:navigate increment/decrement` will search for a
1637 ## number.
1638 ## Type: FlagList
1639 ## Valid values:
1640 ## - host
1641 ## - port
1642 ## - path
1643 ## - query
1644 ## - anchor
1645 # c.url.incdec_segments = ['path', 'query']
1646
1647 ## Open base URL of the searchengine if a searchengine shortcut is
1648 ## invoked without parameters.
1649 ## Type: Bool
1650 # c.url.open_base_url = False
1651
1652 ## Search engines which can be used via the address bar. Maps a search
1653 ## engine name (such as `DEFAULT`, or `ddg`) to a URL with a `{}`
1654 ## placeholder. The placeholder will be replaced by the search term, use
1655 ## `{{` and `}}` for literal `{`/`}` braces. The following further
1656 ## placeholds are defined to configure how special characters in the
1657 ## search terms are replaced by safe characters (called 'quoting'):
1658 ## * `{}` and `{semiquoted}` quote everything except slashes; this is the
1659 ## most sensible choice for almost all search engines (for the search
1660 ## term `slash/and&amp` this placeholder expands to `slash/and%26amp`).
1661 ## * `{quoted}` quotes all characters (for `slash/and&amp` this
1662 ## placeholder expands to `slash%2Fand%26amp`).
1663 ## * `{unquoted}` quotes nothing (for `slash/and&amp` this placeholder
1664 ## expands to `slash/and&amp`).
1665 ## * `{0}` means the same as `{}`, but can be used multiple times. The search
1666 ## engine named `DEFAULT` is used when
1667 ## `url.auto_search` is turned on and something else than a URL was
1668 ## entered to be opened. Other search engines can be used by prepending
1669 ## the search engine name to the search term, e.g. `:open google
1670 ## qutebrowser`.
1671 ## Type: Dict
1672 c.url.searchengines = {'DEFAULT': 'https://duckduckgo.com/?t=chakra&q={}',
1673 'ddg': 'https://duckduckgo.com/?t=chakra&q={}',
1674 'cdda': 'https://nornagon.github.io/cdda-guide/?v=0.F-2#/search/{}',
1675 'slack': 'https://focalpointpositioning.slack.com/messages/{}',
1676 'std': 'http://en.cppreference.com/mwiki/index.php?title=Special%3ASearch&search={}',
1677 'hoogle': 'https://hoogle.haskell.org/?hoogle={}',
1678 'h': 'https://hoogle.haskell.org/?hoogle={}',
1679 }
1680
1681 ## Page(s) to open at the start.
1682 ## Type: List of FuzzyUrl, or FuzzyUrl
1683 # c.url.start_pages = ['https://start.duckduckgo.com']
1684
1685 ## URL parameters to strip with `:yank url`.
1686 ## Type: List of String
1687 # c.url.yank_ignored_parameters = ['ref', 'utm_source', 'utm_medium', 'utm_campaign', 'utm_term', 'utm_content']
1688
1689 ## Hide the window decoration. This setting requires a restart on
1690 ## Wayland.
1691 ## Type: Bool
1692 # c.window.hide_decoration = False
1693
1694 ## Format to use for the window title. The same placeholders like for
1695 ## `tabs.title.format` are defined.
1696 ## Type: FormatString
1697 # c.window.title_format = '{perc}{current_title}{title_sep}qutebrowser'
1698
1699 ## Set the main window background to transparent. This allows having a
1700 ## transparent tab- or statusbar (might require a compositor such as
1701 ## picom). However, it breaks some functionality such as dmenu embedding
1702 ## via its `-w` option. On some systems, it was additionally reported
1703 ## that main window transparency negatively affects performance. Note
1704 ## this setting only affects windows opened after setting it.
1705 ## Type: Bool
1706 # c.window.transparent = False
1707
1708 ## Default zoom level.
1709 ## Type: Perc
1710 # c.zoom.default = '100%'
1711
1712 ## Available zoom levels.
1713 ## Type: List of Perc
1714 # c.zoom.levels = ['25%', '33%', '50%', '67%', '75%', '90%', '100%', '110%', '125%', '150%', '175%', '200%', '250%', '300%', '400%', '500%']
1715
1716 ## Number of zoom increments to divide the mouse wheel movements to.
1717 ## Type: Int
1718 # c.zoom.mouse_divider = 512
1719
1720 ## Apply the zoom factor on a frame only to the text or to all content.
1721 ## Type: Bool
1722 # c.zoom.text_only = False
1723
1724 ## Bindings for normal mode
1725 # config.bind("'", 'mode-enter jump_mark')
1726 # config.bind('+', 'zoom-in')
1727 # config.bind('-', 'zoom-out')
1728 # config.bind('.', 'repeat-command')
1729 # config.bind('/', 'set-cmd-text /')
1730 # config.bind(':', 'set-cmd-text :')
1731 # config.bind(';I', 'hint images tab')
1732 # config.bind(';O', 'hint links fill :open -t -r {hint-url}')
1733 # config.bind(';R', 'hint --rapid links window')
1734 # config.bind(';Y', 'hint links yank-primary')
1735 # config.bind(';b', 'hint all tab-bg')
1736 # config.bind(';d', 'hint links download')
1737 # config.bind(';f', 'hint all tab-fg')
1738 # config.bind(';h', 'hint all hover')
1739 # config.bind(';i', 'hint images')
1740 # config.bind(';o', 'hint links fill :open {hint-url}')
1741 # config.bind(';r', 'hint --rapid links tab-bg')
1742 # config.bind(';t', 'hint inputs')
1743 # config.bind(';y', 'hint links yank')
1744 # config.bind('<Alt-1>', 'tab-focus 1')
1745 # config.bind('<Alt-2>', 'tab-focus 2')
1746 # config.bind('<Alt-3>', 'tab-focus 3')
1747 # config.bind('<Alt-4>', 'tab-focus 4')
1748 # config.bind('<Alt-5>', 'tab-focus 5')
1749 # config.bind('<Alt-6>', 'tab-focus 6')
1750 # config.bind('<Alt-7>', 'tab-focus 7')
1751 # config.bind('<Alt-8>', 'tab-focus 8')
1752 # config.bind('<Alt-9>', 'tab-focus -1')
1753 # config.bind('<Alt-m>', 'tab-mute')
1754 # config.bind('<Ctrl-A>', 'navigate increment')
1755 # config.bind('<Ctrl-Alt-p>', 'print')
1756 # config.bind('<Ctrl-B>', 'scroll-page 0 -1')
1757 # config.bind('<Ctrl-D>', 'scroll-page 0 0.5')
1758 # config.bind('<Ctrl-F5>', 'reload -f')
1759 # config.bind('<Ctrl-F>', 'scroll-page 0 1')
1760 # config.bind('<Ctrl-N>', 'open -w')
1761 # config.bind('<Ctrl-PgDown>', 'tab-next')
1762 # config.bind('<Ctrl-PgUp>', 'tab-prev')
1763 # config.bind('<Ctrl-Q>', 'quit')
1764 # config.bind('<Ctrl-Return>', 'selection-follow -t')
1765 # config.bind('<Ctrl-Shift-N>', 'open -p')
1766 # config.bind('<Ctrl-Shift-T>', 'undo')
1767 # config.bind('<Ctrl-Shift-Tab>', 'nop')
1768 # config.bind('<Ctrl-Shift-W>', 'close')
1769 # config.bind('<Ctrl-T>', 'open -t')
1770 # config.bind('<Ctrl-Tab>', 'tab-focus last')
1771 # config.bind('<Ctrl-U>', 'scroll-page 0 -0.5')
1772 # config.bind('<Ctrl-V>', 'mode-enter passthrough')
1773 # config.bind('<Ctrl-W>', 'tab-close')
1774 # config.bind('<Ctrl-X>', 'navigate decrement')
1775 # config.bind('<Ctrl-^>', 'tab-focus last')
1776 # config.bind('<Ctrl-h>', 'home')
1777 # config.bind('<Ctrl-p>', 'tab-pin')
1778 # config.bind('<Ctrl-s>', 'stop')
1779 config.bind('<Escape>', 'clear-keychain ;; search ;; fullscreen --leave ;; fake-key <Escape>')
1780 # config.bind('<F11>', 'fullscreen')
1781 # config.bind('<F5>', 'reload')
1782 # config.bind('<Return>', 'selection-follow')
1783 # config.bind('<back>', 'back')
1784 # config.bind('<forward>', 'forward')
1785 # config.bind('=', 'zoom')
1786 # config.bind('?', 'set-cmd-text ?')
1787 # config.bind('@', 'macro-run')
1788 # config.bind('B', 'set-cmd-text -s :quickmark-load -t')
1789 # config.bind('D', 'tab-close -o')
1790 # config.bind('F', 'hint all tab')
1791 # config.bind('G', 'scroll-to-perc')
1792 # config.bind('H', 'back')
1793 config.bind('K', 'tab-next')
1794 config.bind('J', 'tab-prev')
1795 # config.bind('L', 'forward')
1796 # config.bind('M', 'bookmark-add')
1797 # config.bind('N', 'search-prev')
1798 # config.bind('O', 'set-cmd-text -s :open -t')
1799 # config.bind('PP', 'open -t -- {primary}')
1800 # config.bind('Pp', 'open -t -- {clipboard}')
1801 # config.bind('R', 'reload -f')
1802 # config.bind('Sb', 'bookmark-list --jump')
1803 # config.bind('Sh', 'history')
1804 # config.bind('Sq', 'bookmark-list')
1805 # config.bind('Ss', 'set')
1806 # config.bind('T', 'set-cmd-text -sr :tab-focus')
1807 # config.bind('U', 'undo -w')
1808 # config.bind('V', 'mode-enter caret ;; selection-toggle --line')
1809 # config.bind('ZQ', 'quit')
1810 # config.bind('ZZ', 'quit --save')
1811 # config.bind('[[', 'navigate prev')
1812 # config.bind(']]', 'navigate next')
1813 # config.bind('`', 'mode-enter set_mark')
1814 # config.bind('ad', 'download-cancel')
1815 # config.bind('b', 'set-cmd-text -s :quickmark-load')
1816 # config.bind('cd', 'download-clear')
1817 config.unbind('co')
1818 config.bind('co', 'download-open')
1819 # config.bind('d', 'tab-close')
1820 # config.bind('f', 'hint')
1821 # config.bind('g$', 'tab-focus -1')
1822 # config.bind('g0', 'tab-focus 1')
1823 # config.bind('gB', 'set-cmd-text -s :bookmark-load -t')
1824 # config.bind('gC', 'tab-clone')
1825 # config.bind('gD', 'tab-give')
1826 # config.bind('gJ', 'tab-move +')
1827 # config.bind('gK', 'tab-move -')
1828 # config.bind('gO', 'set-cmd-text :open -t -r {url:pretty}')
1829 # config.bind('gU', 'navigate up -t')
1830 # config.bind('g^', 'tab-focus 1')
1831 # config.bind('ga', 'open -t')
1832 # config.bind('gb', 'set-cmd-text -s :bookmark-load')
1833 # config.bind('gd', 'download')
1834 # config.bind('gf', 'view-source')
1835 # config.bind('gg', 'scroll-to-perc 0')
1836 # config.bind('gi', 'hint inputs --first')
1837 # config.bind('gm', 'tab-move')
1838 # config.bind('go', 'set-cmd-text :open {url:pretty}')
1839 # config.bind('gt', 'set-cmd-text -s :tab-select')
1840 # config.bind('gu', 'navigate up')
1841 # config.bind('h', 'scroll left')
1842 # config.bind('i', 'mode-enter insert')
1843 # config.bind('j', 'scroll down')
1844 # config.bind('k', 'scroll up')
1845 # config.bind('l', 'scroll right')
1846 # config.bind('m', 'quickmark-save')
1847 config.bind('m', 'spawn mpv {url}')
1848 # config.bind('n', 'search-next')
1849 # config.bind('o', 'set-cmd-text -s :open')
1850 # config.bind('pP', 'open -- {primary}')
1851 # config.bind('pp', 'open -- {clipboard}')
1852 # config.bind('q', 'macro-record')
1853 # config.bind('r', 'reload')
1854 # config.bind('sf', 'save')
1855 # config.bind('sk', 'set-cmd-text -s :bind')
1856 # config.bind('sl', 'set-cmd-text -s :set -t')
1857 # config.bind('ss', 'set-cmd-text -s :set')
1858 config.bind('tCh', 'spawn --userscript config-cycle-tld -p content.cookies.accept no-3rdparty never;; reload')
1859 config.bind('tch', 'spawn --userscript config-cycle-tld -p -t content.cookies.accept no-3rdparty never;; reload')
1860 config.bind('tGh', 'spawn --userscript config-cycle-tld -p content.geolocation ;; reload')
1861 config.bind('tgh', 'spawn --userscript config-cycle-tld -p -t content.geolocation ;; reload')
1862 # config.bind('tIH', 'config-cycle -p -u *://*.{url:host}/* content.images ;; reload')
1863 # config.bind('tIh', 'config-cycle -p -u *://{url:host}/* content.images ;; reload')
1864 # config.bind('tIu', 'config-cycle -p -u {url} content.images ;; reload')
1865 # config.bind('tPH', 'config-cycle -p -u *://*.{url:host}/* content.plugins ;; reload')
1866 # config.bind('tPh', 'config-cycle -p -u *://{url:host}/* content.plugins ;; reload')
1867 # config.bind('tPu', 'config-cycle -p -u {url} content.plugins ;; reload')
1868 # config.bind('tSH', 'config-cycle -p -u *://*.{url:host}/* content.javascript.enabled ;; reload')
1869 # config.bind('tSh', 'config-cycle -p -u *://{url:host}/* content.javascript.enabled ;; reload')
1870 # config.bind('tSu', 'config-cycle -p -u {url} content.javascript.enabled ;; reload')
1871 # config.bind('th', 'back -t')
1872 # config.bind('tiH', 'config-cycle -p -t -u *://*.{url:host}/* content.images ;; reload')
1873 # config.bind('tih', 'config-cycle -p -t -u *://{url:host}/* content.images ;; reload')
1874 # config.bind('tiu', 'config-cycle -p -t -u {url} content.images ;; reload')
1875 # config.bind('tl', 'forward -t')
1876 # config.bind('tpH', 'config-cycle -p -t -u *://*.{url:host}/* content.plugins ;; reload')
1877 # config.bind('tph', 'config-cycle -p -t -u *://{url:host}/* content.plugins ;; reload')
1878 # config.bind('tpu', 'config-cycle -p -t -u {url} content.plugins ;; reload')
1879 # config.bind('tsH', 'config-cycle -p -t -u *://*.{url:host}/* content.javascript.enabled ;; reload')
1880 # config.bind('tsh', 'config-cycle -p -t -u *://{url:host}/* content.javascript.enabled ;; reload')
1881 # config.bind('tsu', 'config-cycle -p -t -u {url} content.javascript.enabled ;; reload')
1882 # config.bind('u', 'undo')
1883 # config.bind('v', 'mode-enter caret')
1884 # config.bind('wB', 'set-cmd-text -s :bookmark-load -w')
1885 # config.bind('wIf', 'devtools-focus')
1886 # config.bind('wIh', 'devtools left')
1887 # config.bind('wIj', 'devtools bottom')
1888 # config.bind('wIk', 'devtools top')
1889 # config.bind('wIl', 'devtools right')
1890 # config.bind('wIw', 'devtools window')
1891 # config.bind('wO', 'set-cmd-text :open -w {url:pretty}')
1892 # config.bind('wP', 'open -w -- {primary}')
1893 # config.bind('wb', 'set-cmd-text -s :quickmark-load -w')
1894 # config.bind('wf', 'hint all window')
1895 # config.bind('wh', 'back -w')
1896 # config.bind('wi', 'devtools')
1897 # config.bind('wl', 'forward -w')
1898 # config.bind('wo', 'set-cmd-text -s :open -w')
1899 # config.bind('wp', 'open -w -- {clipboard}')
1900 # config.bind('xO', 'set-cmd-text :open -b -r {url:pretty}')
1901 # config.bind('xo', 'set-cmd-text -s :open -b')
1902 # config.bind('yD', 'yank domain -s')
1903 # config.bind('yM', 'yank inline [{title}]({url}) -s')
1904 # config.bind('yP', 'yank pretty-url -s')
1905 # config.bind('yT', 'yank title -s')
1906 # config.bind('yY', 'yank -s')
1907 # config.bind('yd', 'yank domain')
1908 # config.bind('ym', 'yank inline [{title}]({url})')
1909 # config.bind('yp', 'yank pretty-url')
1910 # config.bind('yt', 'yank title')
1911 # config.bind('yy', 'yank')
1912 config.bind('zl', 'spawn --userscript qute-pass')
1913 config.bind('zul', 'spawn --userscript qute-pass --username-only')
1914 config.bind('zpl', 'spawn --userscript qute-pass --password-only')
1915 config.bind('zol', 'spawn --userscript qute-pass --otp-only')
1916 # config.bind('{{', 'navigate prev -t')
1917 # config.bind('}}', 'navigate next -t')
1918
1919 ## Bindings for caret mode
1920 # config.bind('$', 'move-to-end-of-line', mode='caret')
1921 # config.bind('0', 'move-to-start-of-line', mode='caret')
1922 # config.bind('<Ctrl-Space>', 'selection-drop', mode='caret')
1923 # config.bind('<Escape>', 'mode-leave', mode='caret')
1924 # config.bind('<Return>', 'yank selection', mode='caret')
1925 # config.bind('<Space>', 'selection-toggle', mode='caret')
1926 # config.bind('G', 'move-to-end-of-document', mode='caret')
1927 # config.bind('H', 'scroll left', mode='caret')
1928 # config.bind('J', 'scroll down', mode='caret')
1929 # config.bind('K', 'scroll up', mode='caret')
1930 # config.bind('L', 'scroll right', mode='caret')
1931 # config.bind('V', 'selection-toggle --line', mode='caret')
1932 # config.bind('Y', 'yank selection -s', mode='caret')
1933 # config.bind('[', 'move-to-start-of-prev-block', mode='caret')
1934 # config.bind(']', 'move-to-start-of-next-block', mode='caret')
1935 # config.bind('b', 'move-to-prev-word', mode='caret')
1936 # config.bind('c', 'mode-enter normal', mode='caret')
1937 # config.bind('e', 'move-to-end-of-word', mode='caret')
1938 # config.bind('gg', 'move-to-start-of-document', mode='caret')
1939 # config.bind('h', 'move-to-prev-char', mode='caret')
1940 # config.bind('j', 'move-to-next-line', mode='caret')
1941 # config.bind('k', 'move-to-prev-line', mode='caret')
1942 # config.bind('l', 'move-to-next-char', mode='caret')
1943 # config.bind('o', 'selection-reverse', mode='caret')
1944 # config.bind('v', 'selection-toggle', mode='caret')
1945 # config.bind('w', 'move-to-next-word', mode='caret')
1946 # config.bind('y', 'yank selection', mode='caret')
1947 # config.bind('{', 'move-to-end-of-prev-block', mode='caret')
1948 # config.bind('}', 'move-to-end-of-next-block', mode='caret')
1949
1950 ## Bindings for command mode
1951 # config.bind('<Alt-B>', 'rl-backward-word', mode='command')
1952 # config.bind('<Alt-Backspace>', 'rl-backward-kill-word', mode='command')
1953 # config.bind('<Alt-D>', 'rl-kill-word', mode='command')
1954 # config.bind('<Alt-F>', 'rl-forward-word', mode='command')
1955 # config.bind('<Ctrl-?>', 'rl-delete-char', mode='command')
1956 # config.bind('<Ctrl-A>', 'rl-beginning-of-line', mode='command')
1957 # config.bind('<Ctrl-B>', 'rl-backward-char', mode='command')
1958 # config.bind('<Ctrl-C>', 'completion-item-yank', mode='command')
1959 # config.bind('<Ctrl-D>', 'completion-item-del', mode='command')
1960 # config.bind('<Ctrl-E>', 'rl-end-of-line', mode='command')
1961 # config.bind('<Ctrl-F>', 'rl-forward-char', mode='command')
1962 # config.bind('<Ctrl-H>', 'rl-backward-delete-char', mode='command')
1963 # config.bind('<Ctrl-K>', 'rl-kill-line', mode='command')
1964 # config.bind('<Ctrl-N>', 'command-history-next', mode='command')
1965 # config.bind('<Ctrl-P>', 'command-history-prev', mode='command')
1966 # config.bind('<Ctrl-Return>', 'command-accept --rapid', mode='command')
1967 # config.bind('<Ctrl-Shift-C>', 'completion-item-yank --sel', mode='command')
1968 # config.bind('<Ctrl-Shift-Tab>', 'completion-item-focus prev-category', mode='command')
1969 # config.bind('<Ctrl-Tab>', 'completion-item-focus next-category', mode='command')
1970 # config.bind('<Ctrl-U>', 'rl-unix-line-discard', mode='command')
1971 # config.bind('<Ctrl-W>', 'rl-unix-word-rubout', mode='command')
1972 # config.bind('<Ctrl-Y>', 'rl-yank', mode='command')
1973 # config.bind('<Down>', 'completion-item-focus --history next', mode='command')
1974 # config.bind('<Escape>', 'mode-leave', mode='command')
1975 # config.bind('<PgDown>', 'completion-item-focus next-page', mode='command')
1976 # config.bind('<PgUp>', 'completion-item-focus prev-page', mode='command')
1977 # config.bind('<Return>', 'command-accept', mode='command')
1978 # config.bind('<Shift-Delete>', 'completion-item-del', mode='command')
1979 # config.bind('<Shift-Tab>', 'completion-item-focus prev', mode='command')
1980 # config.bind('<Tab>', 'completion-item-focus next', mode='command')
1981 # config.bind('<Up>', 'completion-item-focus --history prev', mode='command')
1982
1983 ## Bindings for hint mode
1984 # config.bind('<Ctrl-B>', 'hint all tab-bg', mode='hint')
1985 # config.bind('<Ctrl-F>', 'hint links', mode='hint')
1986 # config.bind('<Ctrl-R>', 'hint --rapid links tab-bg', mode='hint')
1987 # config.bind('<Escape>', 'mode-leave', mode='hint')
1988 # config.bind('<Return>', 'hint-follow', mode='hint')
1989
1990 ## Bindings for insert mode
1991 # config.bind('<Ctrl-E>', 'edit-text', mode='insert')
1992 # config.bind('<Escape>', 'mode-leave', mode='insert')
1993 # config.bind('<Shift-Escape>', 'fake-key <Escape>', mode='insert')
1994 # config.bind('<Shift-Ins>', 'insert-text -- {primary}', mode='insert')
1995
1996 ## Bindings for passthrough mode
1997 # config.bind('<Shift-Escape>', 'mode-leave', mode='passthrough')
1998
1999 ## Bindings for prompt mode
2000 # config.bind('<Alt-B>', 'rl-backward-word', mode='prompt')
2001 # config.bind('<Alt-Backspace>', 'rl-backward-kill-word', mode='prompt')
2002 # config.bind('<Alt-D>', 'rl-kill-word', mode='prompt')
2003 # config.bind('<Alt-F>', 'rl-forward-word', mode='prompt')
2004 # config.bind('<Alt-Shift-Y>', 'prompt-yank --sel', mode='prompt')
2005 # config.bind('<Alt-Y>', 'prompt-yank', mode='prompt')
2006 # config.bind('<Ctrl-?>', 'rl-delete-char', mode='prompt')
2007 # config.bind('<Ctrl-A>', 'rl-beginning-of-line', mode='prompt')
2008 # config.bind('<Ctrl-B>', 'rl-backward-char', mode='prompt')
2009 # config.bind('<Ctrl-E>', 'rl-end-of-line', mode='prompt')
2010 # config.bind('<Ctrl-F>', 'rl-forward-char', mode='prompt')
2011 # config.bind('<Ctrl-H>', 'rl-backward-delete-char', mode='prompt')
2012 # config.bind('<Ctrl-K>', 'rl-kill-line', mode='prompt')
2013 # config.bind('<Ctrl-P>', 'prompt-open-download --pdfjs', mode='prompt')
2014 # config.bind('<Ctrl-U>', 'rl-unix-line-discard', mode='prompt')
2015 # config.bind('<Ctrl-W>', 'rl-unix-word-rubout', mode='prompt')
2016 # config.bind('<Ctrl-X>', 'prompt-open-download', mode='prompt')
2017 # config.bind('<Ctrl-Y>', 'rl-yank', mode='prompt')
2018 # config.bind('<Down>', 'prompt-item-focus next', mode='prompt')
2019 # config.bind('<Escape>', 'mode-leave', mode='prompt')
2020 # config.bind('<Return>', 'prompt-accept', mode='prompt')
2021 # config.bind('<Shift-Tab>', 'prompt-item-focus prev', mode='prompt')
2022 # config.bind('<Tab>', 'prompt-item-focus next', mode='prompt')
2023 # config.bind('<Up>', 'prompt-item-focus prev', mode='prompt')
2024
2025 ## Bindings for register mode
2026 # config.bind('<Escape>', 'mode-leave', mode='register')
2027
2028 ## Bindings for yesno mode
2029 # config.bind('<Alt-Shift-Y>', 'prompt-yank --sel', mode='yesno')
2030 # config.bind('<Alt-Y>', 'prompt-yank', mode='yesno')
2031 # config.bind('<Escape>', 'mode-leave', mode='yesno')
2032 # config.bind('<Return>', 'prompt-accept', mode='yesno')
2033 # config.bind('N', 'prompt-accept --save no', mode='yesno')
2034 # config.bind('Y', 'prompt-accept --save yes', mode='yesno')
2035 # config.bind('n', 'prompt-accept no', mode='yesno')
2036 # config.bind('y', 'prompt-accept yes', mode='yesno')
2037
2038 config.source('themes/nord-qutebrowser.py')