qutebrowser/config.py

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