qutebrowser’s Template config.py
Updated  2022-June-3

Page contents

News

Ongoing  According to Repology, the latest packaged qutebrowser is version latest packaged version of qutebrowser. To keep up with qutebrowser releases, see github.com/qutebrowser/qutebrowser/releases, listi.jpberlin.de/pipermail/qutebrowser/, or old.reddit.com/r/qutebrowser/.

2021-August-31  As of today, this evolving⁠[1] article has been on the web for 2 years.🎂🎂

 

Prerequisites

This article assumes you know the basics about the qutebrowser web browser. To learn about qutebrowser, see Infinite Ink’s #qutebrowser Portal.

 

:config-write-py --defaults

Within qutebrowser you can create a template config.py by running one of the following colon commands.

:config-write-py --defaults
:config-write-py -d

These equivalent commands create a file named config.py in your qutebrowser config[2] directory that contains most of qutebrowser’s default settings. For more about this, see…

Uncommented default configuration settings

The template config.py that qutebrowser v2.5.1 creates is 2431 lines of comments. Below are these 2431 lines with each default configuration setting uncommented. I removed the leading from these lines so they are displayed with Python syntax highlighting.

 

Starting with qutebrowser v2.0.0, which was released 2021-⁠January-⁠28, if you use a config.py file, you must explicitly specify one of the following in it.

  • config.load_autoconfig(False)

  • config.load_autoconfig(True), which is equivalent to config.load_autoconfig()

The second setting (True) is emphasized in line 15 below.

 

💡
  • In your config.py, leave most default settings commented out because there is no need for qutebrowser to read and process default settings.

  • qutebrowser’s default key bindings are specified starting at line 2122. To learn about these, see Infinite Ink’s qutebrowser Key Bindings.

 

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

 

See also

Endnotes


1. Many Infinite Ink articles, including this one, are evergreen and regularly updated.
2. To find out your qutebrowser config and data directories, run the :version command from within qutebrowser.

Comments and questions 📝 🤔 👎 👍

Your public comment or question might immediately improve this page or help me to (eventually) improve this page.