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