qutebrowser/config.py

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