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