qutebrowser’s Template config.py
Updated  2023-February-19

   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##   - js-array-at
1088##   - misc-krunker
1089##   - misc-mathml-darkmode
1090c.content.site_specific_quirks.skip = ['js-string-replaceall']
1091
1092## How to proceed on TLS certificate errors.
1093## Type: String
1094## Valid values:
1095##   - ask: Ask how to proceed for every certificate error (unless non-overridable due to HSTS).
1096##   - ask-block-thirdparty: Ask how to proceed for normal page loads, but silently block resource loads.
1097##   - block: Automatically block loading on certificate errors.
1098##   - 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.
1099c.content.tls.certificate_errors = 'ask'
1100
1101## How navigation requests to URLs with unknown schemes are handled.
1102## Type: String
1103## Valid values:
1104##   - disallow: Disallows all navigation requests to URLs with unknown schemes.
1105##   - 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.
1106##   - allow-all: Allows all navigation requests to URLs with unknown schemes.
1107c.content.unknown_url_scheme_policy = 'allow-from-user-interaction'
1108
1109## List of user stylesheet filenames to use.
1110## Type: List of File, or File
1111c.content.user_stylesheets = []
1112
1113## Enable WebGL.
1114## Type: Bool
1115c.content.webgl = True
1116
1117## Which interfaces to expose via WebRTC.
1118## Type: String
1119## Valid values:
1120##   - all-interfaces: WebRTC has the right to enumerate all interfaces and bind them to discover public interfaces.
1121##   - 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.
1122##   - default-public-interface-only: WebRTC should only use the default route used by http. This doesn't expose any local addresses.
1123##   - 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.
1124c.content.webrtc_ip_handling_policy = 'all-interfaces'
1125
1126## Monitor load requests for cross-site scripting attempts. Suspicious
1127## scripts will be blocked and reported in the devtools JavaScript
1128## console. Note that bypasses for the XSS auditor are widely known and
1129## it can be abused for cross-site info leaks in some scenarios, see:
1130## https://www.chromium.org/developers/design-documents/xss-auditor
1131## Type: Bool
1132c.content.xss_auditing = False
1133
1134## Directory to save downloads to. If unset, a sensible OS-specific
1135## default is used.
1136## Type: Directory
1137c.downloads.location.directory = None
1138
1139## Prompt the user for the download location. If set to false,
1140## `downloads.location.directory` will be used.
1141## Type: Bool
1142c.downloads.location.prompt = True
1143
1144## Remember the last used download directory.
1145## Type: Bool
1146c.downloads.location.remember = True
1147
1148## What to display in the download filename input.
1149## Type: String
1150## Valid values:
1151##   - path: Show only the download path.
1152##   - filename: Show only download filename.
1153##   - both: Show download path and filename.
1154c.downloads.location.suggestion = 'path'
1155
1156## Default program used to open downloads. If null, the default internal
1157## handler is used. Any `{}` in the string will be expanded to the
1158## filename, else the filename will be appended.
1159## Type: String
1160c.downloads.open_dispatcher = None
1161
1162## Where to show the downloaded files.
1163## Type: VerticalPosition
1164## Valid values:
1165##   - top
1166##   - bottom
1167c.downloads.position = 'top'
1168
1169## Automatically abort insecure (HTTP) downloads originating from secure
1170## (HTTPS) pages. For per-domain settings, the relevant URL is the URL
1171## initiating the download, not the URL the download itself is coming
1172## from. It's not recommended to set this setting to false globally.
1173## Type: Bool
1174c.downloads.prevent_mixed_content = True
1175
1176## Duration (in milliseconds) to wait before removing finished downloads.
1177## If set to -1, downloads are never removed.
1178## Type: Int
1179c.downloads.remove_finished = -1
1180
1181## Editor (and arguments) to use for the `edit-*` commands. The following
1182## placeholders are defined:  * `{file}`: Filename of the file to be
1183## edited. * `{line}`: Line in which the caret is found in the text. *
1184## `{column}`: Column in which the caret is found in the text. *
1185## `{line0}`: Same as `{line}`, but starting from index 0. * `{column0}`:
1186## Same as `{column}`, but starting from index 0.
1187## Type: ShellCommand
1188c.editor.command = ['gvim', '-f', '{file}', '-c', 'normal {line}G{column0}l']
1189
1190## Encoding to use for the editor.
1191## Type: Encoding
1192c.editor.encoding = 'utf-8'
1193
1194## Delete the temporary file upon closing the editor.
1195## Type: Bool
1196c.editor.remove_file = True
1197
1198## Command (and arguments) to use for selecting a single folder in forms.
1199## The command should write the selected folder path to the specified
1200## file or stdout. The following placeholders are defined: * `{}`:
1201## Filename of the file to be written to. If not contained in any
1202## argument, the   standard output of the command is read instead.
1203## Type: ShellCommand
1204c.fileselect.folder.command = ['xterm', '-e', 'ranger', '--choosedir={}']
1205
1206## Handler for selecting file(s) in forms. If `external`, then the
1207## commands specified by `fileselect.single_file.command` and
1208## `fileselect.multiple_files.command` are used to select one or multiple
1209## files respectively.
1210## Type: String
1211## Valid values:
1212##   - default: Use the default file selector.
1213##   - external: Use an external command.
1214c.fileselect.handler = 'default'
1215
1216## Command (and arguments) to use for selecting multiple files in forms.
1217## The command should write the selected file paths to the specified file
1218## or to stdout, separated by newlines. The following placeholders are
1219## defined: * `{}`: Filename of the file to be written to. If not
1220## contained in any argument, the   standard output of the command is
1221## read instead.
1222## Type: ShellCommand
1223c.fileselect.multiple_files.command = ['xterm', '-e', 'ranger', '--choosefiles={}']
1224
1225## Command (and arguments) to use for selecting a single file in forms.
1226## The command should write the selected file path to the specified file
1227## or stdout. The following placeholders are defined: * `{}`: Filename of
1228## the file to be written to. If not contained in any argument, the
1229## standard output of the command is read instead.
1230## Type: ShellCommand
1231c.fileselect.single_file.command = ['xterm', '-e', 'ranger', '--choosefile={}']
1232
1233## Font used in the completion categories.
1234## Type: Font
1235c.fonts.completion.category = 'bold default_size default_family'
1236
1237## Font used in the completion widget.
1238## Type: Font
1239c.fonts.completion.entry = 'default_size default_family'
1240
1241## Font used for the context menu. If set to null, the Qt default is
1242## used.
1243## Type: Font
1244c.fonts.contextmenu = None
1245
1246## Font used for the debugging console.
1247## Type: Font
1248c.fonts.debug_console = 'default_size default_family'
1249
1250## Default font families to use. Whenever "default_family" is used in a
1251## font setting, it's replaced with the fonts listed here. If set to an
1252## empty value, a system-specific monospace default is used.
1253## Type: List of Font, or Font
1254c.fonts.default_family = []
1255
1256## Default font size to use. Whenever "default_size" is used in a font
1257## setting, it's replaced with the size listed here. Valid values are
1258## either a float value with a "pt" suffix, or an integer value with a
1259## "px" suffix.
1260## Type: String
1261c.fonts.default_size = '10pt'
1262
1263## Font used for the downloadbar.
1264## Type: Font
1265c.fonts.downloads = 'default_size default_family'
1266
1267## Font used for the hints.
1268## Type: Font
1269c.fonts.hints = 'bold default_size default_family'
1270
1271## Font used in the keyhint widget.
1272## Type: Font
1273c.fonts.keyhint = 'default_size default_family'
1274
1275## Font used for error messages.
1276## Type: Font
1277c.fonts.messages.error = 'default_size default_family'
1278
1279## Font used for info messages.
1280## Type: Font
1281c.fonts.messages.info = 'default_size default_family'
1282
1283## Font used for warning messages.
1284## Type: Font
1285c.fonts.messages.warning = 'default_size default_family'
1286
1287## Font used for prompts.
1288## Type: Font
1289c.fonts.prompts = 'default_size sans-serif'
1290
1291## Font used in the statusbar.
1292## Type: Font
1293c.fonts.statusbar = 'default_size default_family'
1294
1295## Font used for selected tabs.
1296## Type: Font
1297c.fonts.tabs.selected = 'default_size default_family'
1298
1299## Font used for unselected tabs.
1300## Type: Font
1301c.fonts.tabs.unselected = 'default_size default_family'
1302
1303## Font family for cursive fonts.
1304## Type: FontFamily
1305c.fonts.web.family.cursive = ''
1306
1307## Font family for fantasy fonts.
1308## Type: FontFamily
1309c.fonts.web.family.fantasy = ''
1310
1311## Font family for fixed fonts.
1312## Type: FontFamily
1313c.fonts.web.family.fixed = ''
1314
1315## Font family for sans-serif fonts.
1316## Type: FontFamily
1317c.fonts.web.family.sans_serif = ''
1318
1319## Font family for serif fonts.
1320## Type: FontFamily
1321c.fonts.web.family.serif = ''
1322
1323## Font family for standard fonts.
1324## Type: FontFamily
1325c.fonts.web.family.standard = ''
1326
1327## Default font size (in pixels) for regular text.
1328## Type: Int
1329c.fonts.web.size.default = 16
1330
1331## Default font size (in pixels) for fixed-pitch text.
1332## Type: Int
1333c.fonts.web.size.default_fixed = 13
1334
1335## Hard minimum font size (in pixels).
1336## Type: Int
1337c.fonts.web.size.minimum = 0
1338
1339## Minimum logical font size (in pixels) that is applied when zooming
1340## out.
1341## Type: Int
1342c.fonts.web.size.minimum_logical = 6
1343
1344## When a hint can be automatically followed without pressing Enter.
1345## Type: String
1346## Valid values:
1347##   - always: Auto-follow whenever there is only a single hint on a page.
1348##   - unique-match: Auto-follow whenever there is a unique non-empty match in either the hint string (word mode) or filter (number mode).
1349##   - 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).
1350##   - never: The user will always need to press Enter to follow a hint.
1351c.hints.auto_follow = 'unique-match'
1352
1353## Duration (in milliseconds) to ignore normal-mode key bindings after a
1354## successful auto-follow.
1355## Type: Int
1356c.hints.auto_follow_timeout = 0
1357
1358## CSS border value for hints.
1359## Type: String
1360c.hints.border = '1px solid #E3BE23'
1361
1362## Characters used for hint strings.
1363## Type: UniqueCharString
1364c.hints.chars = 'asdfghjkl'
1365
1366## Dictionary file to be used by the word hints.
1367## Type: File
1368c.hints.dictionary = '/usr/share/dict/words'
1369
1370## Which implementation to use to find elements to hint.
1371## Type: String
1372## Valid values:
1373##   - javascript: Better but slower
1374##   - python: Slightly worse but faster
1375c.hints.find_implementation = 'python'
1376
1377## Hide unmatched hints in rapid mode.
1378## Type: Bool
1379c.hints.hide_unmatched_rapid_hints = True
1380
1381## Leave hint mode when starting a new page load.
1382## Type: Bool
1383c.hints.leave_on_load = False
1384
1385## Minimum number of characters used for hint strings.
1386## Type: Int
1387c.hints.min_chars = 1
1388
1389## Mode to use for hints.
1390## Type: String
1391## Valid values:
1392##   - 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.)
1393##   - letter: Use the characters in the `hints.chars` setting.
1394##   - word: Use hints words based on the html elements and the extra words.
1395c.hints.mode = 'letter'
1396
1397## Comma-separated list of regular expressions to use for 'next' links.
1398## Type: List of Regex
1399c.hints.next_regexes = ['\\bnext\\b', '\\bmore\\b', '\\bnewer\\b', '\\b[>→≫]\\b', '\\b(>>|»)\\b', '\\bcontinue\\b']
1400
1401## Padding (in pixels) for hints.
1402## Type: Padding
1403c.hints.padding = {'top': 0, 'bottom': 0, 'left': 3, 'right': 3}
1404
1405## Comma-separated list of regular expressions to use for 'prev' links.
1406## Type: List of Regex
1407c.hints.prev_regexes = ['\\bprev(ious)?\\b', '\\bback\\b', '\\bolder\\b', '\\b[<←≪]\\b', '\\b(<<|«)\\b']
1408
1409## Rounding radius (in pixels) for the edges of hints.
1410## Type: Int
1411c.hints.radius = 3
1412
1413## Scatter hint key chains (like Vimium) or not (like dwb). Ignored for
1414## number hints.
1415## Type: Bool
1416c.hints.scatter = True
1417
1418## CSS selectors used to determine which elements on a page should have
1419## hints.
1420## Type: Dict
1421c.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']}
1422
1423## Make characters in hint strings uppercase.
1424## Type: Bool
1425c.hints.uppercase = False
1426
1427## Maximum time (in minutes) between two history items for them to be
1428## considered being from the same browsing session. Items with less time
1429## between them are grouped when being displayed in `:history`. Use -1 to
1430## disable separation.
1431## Type: Int
1432c.history_gap_interval = 30
1433
1434## Allow Escape to quit the crash reporter.
1435## Type: Bool
1436c.input.escape_quits_reporter = True
1437
1438## Which unbound keys to forward to the webview in normal mode.
1439## Type: String
1440## Valid values:
1441##   - all: Forward all unbound keys.
1442##   - auto: Forward unbound non-alphanumeric keys.
1443##   - none: Don't forward any keys.
1444c.input.forward_unbound_keys = 'auto'
1445
1446## Enter insert mode if an editable element is clicked.
1447## Type: Bool
1448c.input.insert_mode.auto_enter = True
1449
1450## Leave insert mode if a non-editable element is clicked.
1451## Type: Bool
1452c.input.insert_mode.auto_leave = True
1453
1454## Automatically enter insert mode if an editable element is focused
1455## after loading the page.
1456## Type: Bool
1457c.input.insert_mode.auto_load = False
1458
1459## Leave insert mode when starting a new page load. Patterns may be
1460## unreliable on this setting, and they may match the url you are
1461## navigating to, or the URL you are navigating from.
1462## Type: Bool
1463c.input.insert_mode.leave_on_load = True
1464
1465## Switch to insert mode when clicking flash and other plugins.
1466## Type: Bool
1467c.input.insert_mode.plugins = False
1468
1469## Include hyperlinks in the keyboard focus chain when tabbing.
1470## Type: Bool
1471c.input.links_included_in_focus_chain = True
1472
1473## Interpret number prefixes as counts for bindings. This enables for vi-
1474## like bindings that can be prefixed with a number to indicate a count.
1475## Disabling it allows for emacs-like bindings where number keys are
1476## passed through (according to `input.forward_unbound_keys`) instead.
1477## Type: Bool
1478c.input.match_counts = True
1479
1480## Whether the underlying Chromium should handle media keys. On Linux,
1481## disabling this also disables Chromium's MPRIS integration.
1482## Type: Bool
1483c.input.media_keys = True
1484
1485## Mode to change to when focusing on a tab/URL changes.
1486## Type: String
1487## Valid values:
1488##   - normal
1489##   - insert
1490##   - passthrough
1491c.input.mode_override = None
1492
1493## Enable back and forward buttons on the mouse.
1494## Type: Bool
1495c.input.mouse.back_forward_buttons = True
1496
1497## Enable Opera-like mouse rocker gestures. This disables the context
1498## menu.
1499## Type: Bool
1500c.input.mouse.rocker_gestures = False
1501
1502## Timeout (in milliseconds) for partially typed key bindings. If the
1503## current input forms only partial matches, the keystring will be
1504## cleared after this time. If set to 0, partially typed bindings are
1505## never cleared.
1506## Type: Int
1507c.input.partial_timeout = 0
1508
1509## Enable spatial navigation. Spatial navigation consists in the ability
1510## to navigate between focusable elements, such as hyperlinks and form
1511## controls, on a web page by using the Left, Right, Up and Down arrow
1512## keys. For example, if a user presses the Right key, heuristics
1513## determine whether there is an element they might be trying to reach
1514## towards the right and which element they probably want.
1515## Type: Bool
1516c.input.spatial_navigation = False
1517
1518## Keychains that shouldn't be shown in the keyhint dialog. Globs are
1519## supported, so `;*` will blacklist all keychains starting with `;`. Use
1520## `*` to disable keyhints.
1521## Type: List of String
1522c.keyhint.blacklist = []
1523
1524## Time (in milliseconds) from pressing a key to seeing the keyhint
1525## dialog.
1526## Type: Int
1527c.keyhint.delay = 500
1528
1529## Rounding radius (in pixels) for the edges of the keyhint dialog.
1530## Type: Int
1531c.keyhint.radius = 6
1532
1533## Level for console (stdout/stderr) logs. Ignored if the `--loglevel` or
1534## `--debug` CLI flags are used.
1535## Type: LogLevel
1536## Valid values:
1537##   - vdebug
1538##   - debug
1539##   - info
1540##   - warning
1541##   - error
1542##   - critical
1543c.logging.level.console = 'info'
1544
1545## Level for in-memory logs.
1546## Type: LogLevel
1547## Valid values:
1548##   - vdebug
1549##   - debug
1550##   - info
1551##   - warning
1552##   - error
1553##   - critical
1554c.logging.level.ram = 'debug'
1555
1556## Duration (in milliseconds) to show messages in the statusbar for. Set
1557## to 0 to never clear messages.
1558## Type: Int
1559c.messages.timeout = 3000
1560
1561## How to open links in an existing instance if a new one is launched.
1562## This happens when e.g. opening a link from a terminal. See
1563## `new_instance_open_target_window` to customize in which window the
1564## link is opened in.
1565## Type: String
1566## Valid values:
1567##   - tab: Open a new tab in the existing window and activate the window.
1568##   - tab-bg: Open a new background tab in the existing window and activate the window.
1569##   - tab-silent: Open a new tab in the existing window without activating the window.
1570##   - tab-bg-silent: Open a new background tab in the existing window without activating the window.
1571##   - window: Open in a new window.
1572##   - private-window: Open in a new private window.
1573c.new_instance_open_target = 'tab'
1574
1575## Which window to choose when opening links as new tabs. When
1576## `new_instance_open_target` is set to `window`, this is ignored.
1577## Type: String
1578## Valid values:
1579##   - first-opened: Open new tabs in the first (oldest) opened window.
1580##   - last-opened: Open new tabs in the last (newest) opened window.
1581##   - last-focused: Open new tabs in the most recently focused window.
1582##   - last-visible: Open new tabs in the most recently visible window.
1583c.new_instance_open_target_window = 'last-focused'
1584
1585## Show a filebrowser in download prompts.
1586## Type: Bool
1587c.prompt.filebrowser = True
1588
1589## Rounding radius (in pixels) for the edges of prompts.
1590## Type: Int
1591c.prompt.radius = 8
1592
1593## Additional arguments to pass to Qt, without leading `--`. With
1594## QtWebEngine, some Chromium arguments (see
1595## https://peter.sh/experiments/chromium-command-line-switches/ for a
1596## list) will work.
1597## Type: List of String
1598c.qt.args = []
1599
1600## When to use Chromium's low-end device mode. This improves the RAM
1601## usage of renderer processes, at the expense of performance.
1602## Type: String
1603## Valid values:
1604##   - always: Always use low-end device mode.
1605##   - auto: Decide automatically (uses low-end mode with < 1 GB available RAM).
1606##   - never: Never use low-end device mode.
1607c.qt.chromium.low_end_device_mode = 'auto'
1608
1609## Which Chromium process model to use. Alternative process models use
1610## less resources, but decrease security and robustness. See the
1611## following pages for more details:    -
1612## https://www.chromium.org/developers/design-documents/process-models
1613## - https://doc.qt.io/qt-5/qtwebengine-features.html#process-models
1614## Type: String
1615## Valid values:
1616##   - process-per-site-instance: Pages from separate sites are put into separate processes and separate visits to the same site are also isolated.
1617##   - 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.
1618##   - single-process: Run all tabs in a single process. This should be used for debugging purposes only, and it disables `:open --private`.
1619c.qt.chromium.process_model = 'process-per-site-instance'
1620
1621## What sandboxing mechanisms in Chromium to use. Chromium has various
1622## sandboxing layers, which should be enabled for normal browser usage.
1623## Mainly for testing and development, it's possible to disable
1624## individual sandboxing layers via this setting. Open `chrome://sandbox`
1625## to see the current sandbox status. Changing this setting is only
1626## recommended if you know what you're doing, as it **disables one of
1627## Chromium's security layers**. To avoid sandboxing being accidentally
1628## disabled persistently, this setting can only be set via `config.py`,
1629## not via `:set`. See the Chromium documentation for more details: - htt
1630## ps://chromium.googlesource.com/chromium/src/\+/HEAD/docs/linux/sandbox
1631## ing.md[Linux] - https://chromium.googlesource.com/chromium/src/\+/HEAD
1632## /docs/design/sandbox.md[Windows] - https://chromium.googlesource.com/c
1633## hromium/src/\+/HEAD/docs/design/sandbox_faq.md[FAQ (Windows-centric)]
1634## Type: String
1635## Valid values:
1636##   - enable-all: Enable all available sandboxing mechanisms.
1637##   - disable-seccomp-bpf: Disable the Seccomp BPF filter sandbox (Linux only).
1638##   - disable-all: Disable all sandboxing (**not recommended!**).
1639c.qt.chromium.sandboxing = 'enable-all'
1640
1641## Additional environment variables to set. Setting an environment
1642## variable to null/None will unset it.
1643## Type: Dict
1644c.qt.environ = {}
1645
1646## Force a Qt platform to use. This sets the `QT_QPA_PLATFORM`
1647## environment variable and is useful to force using the XCB plugin when
1648## running QtWebEngine on Wayland.
1649## Type: String
1650c.qt.force_platform = None
1651
1652## Force a Qt platformtheme to use. This sets the `QT_QPA_PLATFORMTHEME`
1653## environment variable which controls dialogs like the filepicker. By
1654## default, Qt determines the platform theme based on the desktop
1655## environment.
1656## Type: String
1657c.qt.force_platformtheme = None
1658
1659## Force software rendering for QtWebEngine. This is needed for
1660## QtWebEngine to work with Nouveau drivers and can be useful in other
1661## scenarios related to graphic issues.
1662## Type: String
1663## Valid values:
1664##   - software-opengl: Tell LibGL to use a software implementation of GL (`LIBGL_ALWAYS_SOFTWARE` / `QT_XCB_FORCE_SOFTWARE_OPENGL`)
1665##   - qt-quick: Tell Qt Quick to use a software renderer instead of OpenGL. (`QT_QUICK_BACKEND=software`)
1666##   - chromium: Tell Chromium to disable GPU support and use Skia software rendering instead. (`--disable-gpu`)
1667##   - none: Don't force software rendering.
1668c.qt.force_software_rendering = 'none'
1669
1670## Turn on Qt HighDPI scaling. This is equivalent to setting
1671## QT_AUTO_SCREEN_SCALE_FACTOR=1 or QT_ENABLE_HIGHDPI_SCALING=1 (Qt >=
1672## 5.14) in the environment. It's off by default as it can cause issues
1673## with some bitmap fonts. As an alternative to this, it's possible to
1674## set font sizes and the `zoom.default` setting.
1675## Type: Bool
1676c.qt.highdpi = False
1677
1678## Work around locale parsing issues in QtWebEngine 5.15.3. With some
1679## locales, QtWebEngine 5.15.3 is unusable without this workaround. In
1680## affected scenarios, QtWebEngine will log "Network service crashed,
1681## restarting service." and only display a blank page. However, It is
1682## expected that distributions shipping QtWebEngine 5.15.3 follow up with
1683## a proper fix soon, so it is disabled by default.
1684## Type: Bool
1685c.qt.workarounds.locale = False
1686
1687## Delete the QtWebEngine Service Worker directory on every start. This
1688## workaround can help with certain crashes caused by an unknown
1689## QtWebEngine bug related to Service Workers. Those crashes happen
1690## seemingly immediately on Windows; after one hour of operation on other
1691## systems. Note however that enabling this option *can lead to data
1692## loss* on some pages (as Service Worker data isn't persisted) and will
1693## negatively impact start-up time.
1694## Type: Bool
1695c.qt.workarounds.remove_service_workers = False
1696
1697## When/how to show the scrollbar.
1698## Type: String
1699## Valid values:
1700##   - always: Always show the scrollbar.
1701##   - never: Never show the scrollbar.
1702##   - when-searching: Show the scrollbar when searching for text in the webpage. With the QtWebKit backend, this is equal to `never`.
1703##   - 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.
1704c.scrolling.bar = 'overlay'
1705
1706## Enable smooth scrolling for web pages. Note smooth scrolling does not
1707## work with the `:scroll-px` command.
1708## Type: Bool
1709c.scrolling.smooth = False
1710
1711## When to find text on a page case-insensitively.
1712## Type: IgnoreCase
1713## Valid values:
1714##   - always: Search case-insensitively.
1715##   - never: Search case-sensitively.
1716##   - smart: Search case-sensitively if there are capital characters.
1717c.search.ignore_case = 'smart'
1718
1719## Find text on a page incrementally, renewing the search for each typed
1720## character.
1721## Type: Bool
1722c.search.incremental = True
1723
1724## Wrap around at the top and bottom of the page when advancing through
1725## text matches using `:search-next` and `:search-prev`.
1726## Type: Bool
1727c.search.wrap = True
1728
1729## Name of the session to save by default. If this is set to null, the
1730## session which was last loaded is saved.
1731## Type: SessionName
1732c.session.default_name = None
1733
1734## Load a restored tab as soon as it takes focus.
1735## Type: Bool
1736c.session.lazy_restore = False
1737
1738## Languages to use for spell checking. You can check for available
1739## languages and install dictionaries using scripts/dictcli.py. Run the
1740## script with -h/--help for instructions.
1741## Type: List of String
1742## Valid values:
1743##   - af-ZA: Afrikaans (South Africa)
1744##   - bg-BG: Bulgarian (Bulgaria)
1745##   - ca-ES: Catalan (Spain)
1746##   - cs-CZ: Czech (Czech Republic)
1747##   - da-DK: Danish (Denmark)
1748##   - de-DE: German (Germany)
1749##   - el-GR: Greek (Greece)
1750##   - en-AU: English (Australia)
1751##   - en-CA: English (Canada)
1752##   - en-GB: English (United Kingdom)
1753##   - en-US: English (United States)
1754##   - es-ES: Spanish (Spain)
1755##   - et-EE: Estonian (Estonia)
1756##   - fa-IR: Farsi (Iran)
1757##   - fo-FO: Faroese (Faroe Islands)
1758##   - fr-FR: French (France)
1759##   - he-IL: Hebrew (Israel)
1760##   - hi-IN: Hindi (India)
1761##   - hr-HR: Croatian (Croatia)
1762##   - hu-HU: Hungarian (Hungary)
1763##   - id-ID: Indonesian (Indonesia)
1764##   - it-IT: Italian (Italy)
1765##   - ko: Korean
1766##   - lt-LT: Lithuanian (Lithuania)
1767##   - lv-LV: Latvian (Latvia)
1768##   - nb-NO: Norwegian (Norway)
1769##   - nl-NL: Dutch (Netherlands)
1770##   - pl-PL: Polish (Poland)
1771##   - pt-BR: Portuguese (Brazil)
1772##   - pt-PT: Portuguese (Portugal)
1773##   - ro-RO: Romanian (Romania)
1774##   - ru-RU: Russian (Russia)
1775##   - sh: Serbo-Croatian
1776##   - sk-SK: Slovak (Slovakia)
1777##   - sl-SI: Slovenian (Slovenia)
1778##   - sq: Albanian
1779##   - sr: Serbian
1780##   - sv-SE: Swedish (Sweden)
1781##   - ta-IN: Tamil (India)
1782##   - tg-TG: Tajik (Tajikistan)
1783##   - tr-TR: Turkish (Turkey)
1784##   - uk-UA: Ukrainian (Ukraine)
1785##   - vi-VN: Vietnamese (Viet Nam)
1786c.spellcheck.languages = []
1787
1788## Padding (in pixels) for the statusbar.
1789## Type: Padding
1790c.statusbar.padding = {'top': 1, 'bottom': 1, 'left': 0, 'right': 0}
1791
1792## Position of the status bar.
1793## Type: VerticalPosition
1794## Valid values:
1795##   - top
1796##   - bottom
1797c.statusbar.position = 'bottom'
1798
1799## When to show the statusbar.
1800## Type: String
1801## Valid values:
1802##   - always: Always show the statusbar.
1803##   - never: Always hide the statusbar.
1804##   - in-mode: Show the statusbar when in modes other than normal mode.
1805c.statusbar.show = 'always'
1806
1807## List of widgets displayed in the statusbar.
1808## Type: List of StatusbarWidget
1809## Valid values:
1810##   - url: Current page URL.
1811##   - scroll: Percentage of the current page position like `10%`.
1812##   - scroll_raw: Raw percentage of the current page position like `10`.
1813##   - history: Display an arrow when possible to go back/forward in history.
1814##   - tabs: Current active tab, e.g. `2`.
1815##   - keypress: Display pressed keys when composing a vi command.
1816##   - progress: Progress bar for the current page loading.
1817##   - text:foo: Display the static text after the colon, `foo` in the example.
1818c.statusbar.widgets = ['keypress', 'url', 'scroll', 'history', 'tabs', 'progress']
1819
1820## Open new tabs (middleclick/ctrl+click) in the background.
1821## Type: Bool
1822c.tabs.background = True
1823
1824## Mouse button with which to close tabs.
1825## Type: String
1826## Valid values:
1827##   - right: Close tabs on right-click.
1828##   - middle: Close tabs on middle-click.
1829##   - none: Don't close tabs using the mouse.
1830c.tabs.close_mouse_button = 'middle'
1831
1832## How to behave when the close mouse button is pressed on the tab bar.
1833## Type: String
1834## Valid values:
1835##   - new-tab: Open a new tab.
1836##   - close-current: Close the current tab.
1837##   - close-last: Close the last tab.
1838##   - ignore: Don't do anything.
1839c.tabs.close_mouse_button_on_bar = 'new-tab'
1840
1841## Scaling factor for favicons in the tab bar. The tab size is unchanged,
1842## so big favicons also require extra `tabs.padding`.
1843## Type: Float
1844c.tabs.favicons.scale = 1.0
1845
1846## When to show favicons in the tab bar. When switching this from never
1847## to always/pinned, note that favicons might not be loaded yet, thus
1848## tabs might require a reload to display them.
1849## Type: String
1850## Valid values:
1851##   - always: Always show favicons.
1852##   - never: Always hide favicons.
1853##   - pinned: Show favicons only on pinned tabs.
1854c.tabs.favicons.show = 'always'
1855
1856## Maximum stack size to remember for tab switches (-1 for no maximum).
1857## Type: Int
1858c.tabs.focus_stack_size = 10
1859
1860## Padding (in pixels) for tab indicators.
1861## Type: Padding
1862c.tabs.indicator.padding = {'top': 2, 'bottom': 2, 'left': 0, 'right': 4}
1863
1864## Width (in pixels) of the progress indicator (0 to disable).
1865## Type: Int
1866c.tabs.indicator.width = 3
1867
1868## How to behave when the last tab is closed. If the
1869## `tabs.tabs_are_windows` setting is set, this is ignored and the
1870## behavior is always identical to the `close` value.
1871## Type: String
1872## Valid values:
1873##   - ignore: Don't do anything.
1874##   - blank: Load a blank page.
1875##   - startpage: Load the start page.
1876##   - default-page: Load the default page.
1877##   - close: Close the window.
1878c.tabs.last_close = 'ignore'
1879
1880## Maximum width (in pixels) of tabs (-1 for no maximum). This setting
1881## only applies when tabs are horizontal. This setting does not apply to
1882## pinned tabs, unless `tabs.pinned.shrink` is False. This setting may
1883## not apply properly if max_width is smaller than the minimum size of
1884## tab contents, or smaller than tabs.min_width.
1885## Type: Int
1886c.tabs.max_width = -1
1887
1888## Minimum width (in pixels) of tabs (-1 for the default minimum size
1889## behavior). This setting only applies when tabs are horizontal. This
1890## setting does not apply to pinned tabs, unless `tabs.pinned.shrink` is
1891## False.
1892## Type: Int
1893c.tabs.min_width = -1
1894
1895## When switching tabs, what input mode is applied.
1896## Type: String
1897## Valid values:
1898##   - persist: Retain the current mode.
1899##   - restore: Restore previously saved mode.
1900##   - normal: Always revert to normal mode.
1901c.tabs.mode_on_change = 'normal'
1902
1903## Switch between tabs using the mouse wheel.
1904## Type: Bool
1905c.tabs.mousewheel_switching = True
1906
1907## Position of new tabs opened from another tab. See
1908## `tabs.new_position.stacking` for controlling stacking behavior.
1909## Type: NewTabPosition
1910## Valid values:
1911##   - prev: Before the current tab.
1912##   - next: After the current tab.
1913##   - first: At the beginning.
1914##   - last: At the end.
1915c.tabs.new_position.related = 'next'
1916
1917## Stack related tabs on top of each other when opened consecutively.
1918## Only applies for `next` and `prev` values of
1919## `tabs.new_position.related` and `tabs.new_position.unrelated`.
1920## Type: Bool
1921c.tabs.new_position.stacking = True
1922
1923## Position of new tabs which are not opened from another tab. See
1924## `tabs.new_position.stacking` for controlling stacking behavior.
1925## Type: NewTabPosition
1926## Valid values:
1927##   - prev: Before the current tab.
1928##   - next: After the current tab.
1929##   - first: At the beginning.
1930##   - last: At the end.
1931c.tabs.new_position.unrelated = 'last'
1932
1933## Padding (in pixels) around text for tabs.
1934## Type: Padding
1935c.tabs.padding = {'top': 0, 'bottom': 0, 'left': 5, 'right': 5}
1936
1937## Force pinned tabs to stay at fixed URL.
1938## Type: Bool
1939c.tabs.pinned.frozen = True
1940
1941## Shrink pinned tabs down to their contents.
1942## Type: Bool
1943c.tabs.pinned.shrink = True
1944
1945## Position of the tab bar.
1946## Type: Position
1947## Valid values:
1948##   - top
1949##   - bottom
1950##   - left
1951##   - right
1952c.tabs.position = 'top'
1953
1954## Which tab to select when the focused tab is removed.
1955## Type: SelectOnRemove
1956## Valid values:
1957##   - prev: Select the tab which came before the closed one (left in horizontal, above in vertical).
1958##   - next: Select the tab which came after the closed one (right in horizontal, below in vertical).
1959##   - last-used: Select the previously selected tab.
1960c.tabs.select_on_remove = 'next'
1961
1962## When to show the tab bar.
1963## Type: String
1964## Valid values:
1965##   - always: Always show the tab bar.
1966##   - never: Always hide the tab bar.
1967##   - multiple: Hide the tab bar if only one tab is open.
1968##   - switching: Show the tab bar when switching tabs.
1969c.tabs.show = 'always'
1970
1971## Duration (in milliseconds) to show the tab bar before hiding it when
1972## tabs.show is set to 'switching'.
1973## Type: Int
1974c.tabs.show_switching_delay = 800
1975
1976## Open a new window for every tab.
1977## Type: Bool
1978c.tabs.tabs_are_windows = False
1979
1980## Alignment of the text inside of tabs.
1981## Type: TextAlignment
1982## Valid values:
1983##   - left
1984##   - right
1985##   - center
1986c.tabs.title.alignment = 'left'
1987
1988## Format to use for the tab title. The following placeholders are
1989## defined:  * `{perc}`: Percentage as a string like `[10%]`. *
1990## `{perc_raw}`: Raw percentage, e.g. `10`. * `{current_title}`: Title of
1991## the current web page. * `{title_sep}`: The string `" - "` if a title
1992## is set, empty otherwise. * `{index}`: Index of this tab. *
1993## `{aligned_index}`: Index of this tab padded with spaces to have the
1994## same   width. * `{relative_index}`: Index of this tab relative to the
1995## current tab. * `{id}`: Internal tab ID of this tab. * `{scroll_pos}`:
1996## Page scroll position. * `{host}`: Host of the current web page. *
1997## `{backend}`: Either `webkit` or `webengine` * `{private}`: Indicates
1998## when private mode is enabled. * `{current_url}`: URL of the current
1999## web page. * `{protocol}`: Protocol (http/https/...) of the current web
2000## page. * `{audio}`: Indicator for audio/mute status.
2001## Type: FormatString
2002c.tabs.title.format = '{audio}{index}: {current_title}'
2003
2004## Format to use for the tab title for pinned tabs. The same placeholders
2005## like for `tabs.title.format` are defined.
2006## Type: FormatString
2007c.tabs.title.format_pinned = '{index}'
2008
2009## Show tooltips on tabs. Note this setting only affects windows opened
2010## after it has been set.
2011## Type: Bool
2012c.tabs.tooltips = True
2013
2014## Number of closed tabs (per window) and closed windows to remember for
2015## :undo (-1 for no maximum).
2016## Type: Int
2017c.tabs.undo_stack_size = 100
2018
2019## Width (in pixels or as percentage of the window) of the tab bar if
2020## it's vertical.
2021## Type: PercOrInt
2022c.tabs.width = '15%'
2023
2024## Wrap when changing tabs.
2025## Type: Bool
2026c.tabs.wrap = True
2027
2028## What search to start when something else than a URL is entered.
2029## Type: String
2030## Valid values:
2031##   - naive: Use simple/naive check.
2032##   - dns: Use DNS requests (might be slow!).
2033##   - never: Never search automatically.
2034##   - schemeless: Always search automatically unless URL explicitly contains a scheme.
2035c.url.auto_search = 'naive'
2036
2037## Page to open if :open -t/-b/-w is used without URL. Use `about:blank`
2038## for a blank page.
2039## Type: FuzzyUrl
2040c.url.default_page = 'https://start.duckduckgo.com/'
2041
2042## URL segments where `:navigate increment/decrement` will search for a
2043## number.
2044## Type: FlagList
2045## Valid values:
2046##   - host
2047##   - port
2048##   - path
2049##   - query
2050##   - anchor
2051c.url.incdec_segments = ['path', 'query']
2052
2053## Open base URL of the searchengine if a searchengine shortcut is
2054## invoked without parameters.
2055## Type: Bool
2056c.url.open_base_url = False
2057
2058## Search engines which can be used via the address bar.  Maps a search
2059## engine name (such as `DEFAULT`, or `ddg`) to a URL with a `{}`
2060## placeholder. The placeholder will be replaced by the search term, use
2061## `{{` and `}}` for literal `{`/`}` braces.  The following further
2062## placeholds are defined to configure how special characters in the
2063## search terms are replaced by safe characters (called 'quoting'):  *
2064## `{}` and `{semiquoted}` quote everything except slashes; this is the
2065## most   sensible choice for almost all search engines (for the search
2066## term   `slash/and&` this placeholder expands to `slash/and%26amp`).
2067## * `{quoted}` quotes all characters (for `slash/and&` this
2068## placeholder   expands to `slash%2Fand%26amp`). * `{unquoted}` quotes
2069## nothing (for `slash/and&` this placeholder   expands to
2070## `slash/and&`). * `{0}` means the same as `{}`, but can be used
2071## multiple times.  The search engine named `DEFAULT` is used when
2072## `url.auto_search` is turned on and something else than a URL was
2073## entered to be opened. Other search engines can be used by prepending
2074## the search engine name to the search term, e.g. `:open google
2075## qutebrowser`.
2076## Type: Dict
2077c.url.searchengines = {'DEFAULT': 'https://duckduckgo.com/?q={}'}
2078
2079## Page(s) to open at the start.
2080## Type: List of FuzzyUrl, or FuzzyUrl
2081c.url.start_pages = ['https://start.duckduckgo.com']
2082
2083## URL parameters to strip with `:yank url`.
2084## Type: List of String
2085c.url.yank_ignored_parameters = ['ref', 'utm_source', 'utm_medium', 'utm_campaign', 'utm_term', 'utm_content']
2086
2087## Hide the window decoration.  This setting requires a restart on
2088## Wayland.
2089## Type: Bool
2090c.window.hide_decoration = False
2091
2092## Format to use for the window title. The same placeholders like for
2093## `tabs.title.format` are defined.
2094## Type: FormatString
2095c.window.title_format = '{perc}{current_title}{title_sep}qutebrowser'
2096
2097## Set the main window background to transparent.  This allows having a
2098## transparent tab- or statusbar (might require a compositor such as
2099## picom). However, it breaks some functionality such as dmenu embedding
2100## via its `-w` option. On some systems, it was additionally reported
2101## that main window transparency negatively affects performance.  Note
2102## this setting only affects windows opened after setting it.
2103## Type: Bool
2104c.window.transparent = False
2105
2106## Default zoom level.
2107## Type: Perc
2108c.zoom.default = '100%'
2109
2110## Available zoom levels.
2111## Type: List of Perc
2112c.zoom.levels = ['25%', '33%', '50%', '67%', '75%', '90%', '100%', '110%', '125%', '150%', '175%', '200%', '250%', '300%', '400%', '500%']
2113
2114## Number of zoom increments to divide the mouse wheel movements to.
2115## Type: Int
2116c.zoom.mouse_divider = 512
2117
2118## Apply the zoom factor on a frame only to the text or to all content.
2119## Type: Bool
2120c.zoom.text_only = False
2121
2122## Bindings for normal mode
2123config.bind("'", 'mode-enter jump_mark')
2124config.bind('+', 'zoom-in')
2125config.bind('-', 'zoom-out')
2126config.bind('.', 'repeat-command')
2127config.bind('/', 'set-cmd-text /')
2128config.bind(':', 'set-cmd-text :')
2129config.bind(';I', 'hint images tab')
2130config.bind(';O', 'hint links fill :open -t -r {hint-url}')
2131config.bind(';R', 'hint --rapid links window')
2132config.bind(';Y', 'hint links yank-primary')
2133config.bind(';b', 'hint all tab-bg')
2134config.bind(';d', 'hint links download')
2135config.bind(';f', 'hint all tab-fg')
2136config.bind(';h', 'hint all hover')
2137config.bind(';i', 'hint images')
2138config.bind(';o', 'hint links fill :open {hint-url}')
2139config.bind(';r', 'hint --rapid links tab-bg')
2140config.bind(';t', 'hint inputs')
2141config.bind(';y', 'hint links yank')
2142config.bind('<Alt-1>', 'tab-focus 1')
2143config.bind('<Alt-2>', 'tab-focus 2')
2144config.bind('<Alt-3>', 'tab-focus 3')
2145config.bind('<Alt-4>', 'tab-focus 4')
2146config.bind('<Alt-5>', 'tab-focus 5')
2147config.bind('<Alt-6>', 'tab-focus 6')
2148config.bind('<Alt-7>', 'tab-focus 7')
2149config.bind('<Alt-8>', 'tab-focus 8')
2150config.bind('<Alt-9>', 'tab-focus -1')
2151config.bind('<Alt-m>', 'tab-mute')
2152config.bind('<Ctrl-A>', 'navigate increment')
2153config.bind('<Ctrl-Alt-p>', 'print')
2154config.bind('<Ctrl-B>', 'scroll-page 0 -1')
2155config.bind('<Ctrl-D>', 'scroll-page 0 0.5')
2156config.bind('<Ctrl-F5>', 'reload -f')
2157config.bind('<Ctrl-F>', 'scroll-page 0 1')
2158config.bind('<Ctrl-N>', 'open -w')
2159config.bind('<Ctrl-PgDown>', 'tab-next')
2160config.bind('<Ctrl-PgUp>', 'tab-prev')
2161config.bind('<Ctrl-Q>', 'quit')
2162config.bind('<Ctrl-Return>', 'selection-follow -t')
2163config.bind('<Ctrl-Shift-N>', 'open -p')
2164config.bind('<Ctrl-Shift-T>', 'undo')
2165config.bind('<Ctrl-Shift-Tab>', 'nop')
2166config.bind('<Ctrl-Shift-W>', 'close')
2167config.bind('<Ctrl-T>', 'open -t')
2168config.bind('<Ctrl-Tab>', 'tab-focus last')
2169config.bind('<Ctrl-U>', 'scroll-page 0 -0.5')
2170config.bind('<Ctrl-V>', 'mode-enter passthrough')
2171config.bind('<Ctrl-W>', 'tab-close')
2172config.bind('<Ctrl-X>', 'navigate decrement')
2173config.bind('<Ctrl-^>', 'tab-focus last')
2174config.bind('<Ctrl-h>', 'home')
2175config.bind('<Ctrl-p>', 'tab-pin')
2176config.bind('<Ctrl-s>', 'stop')
2177config.bind('<Escape>', 'clear-keychain ;; search ;; fullscreen --leave')
2178config.bind('<F11>', 'fullscreen')
2179config.bind('<F5>', 'reload')
2180config.bind('<Return>', 'selection-follow')
2181config.bind('<back>', 'back')
2182config.bind('<forward>', 'forward')
2183config.bind('=', 'zoom')
2184config.bind('?', 'set-cmd-text ?')
2185config.bind('@', 'macro-run')
2186config.bind('B', 'set-cmd-text -s :quickmark-load -t')
2187config.bind('D', 'tab-close -o')
2188config.bind('F', 'hint all tab')
2189config.bind('G', 'scroll-to-perc')
2190config.bind('H', 'back')
2191config.bind('J', 'tab-next')
2192config.bind('K', 'tab-prev')
2193config.bind('L', 'forward')
2194config.bind('M', 'bookmark-add')
2195config.bind('N', 'search-prev')
2196config.bind('O', 'set-cmd-text -s :open -t')
2197config.bind('PP', 'open -t -- {primary}')
2198config.bind('Pp', 'open -t -- {clipboard}')
2199config.bind('R', 'reload -f')
2200config.bind('Sb', 'bookmark-list --jump')
2201config.bind('Sh', 'history')
2202config.bind('Sq', 'bookmark-list')
2203config.bind('Ss', 'set')
2204config.bind('T', 'set-cmd-text -sr :tab-focus')
2205config.bind('U', 'undo -w')
2206config.bind('V', 'mode-enter caret ;; selection-toggle --line')
2207config.bind('ZQ', 'quit')
2208config.bind('ZZ', 'quit --save')
2209config.bind('[[', 'navigate prev')
2210config.bind(']]', 'navigate next')
2211config.bind('`', 'mode-enter set_mark')
2212config.bind('ad', 'download-cancel')
2213config.bind('b', 'set-cmd-text -s :quickmark-load')
2214config.bind('cd', 'download-clear')
2215config.bind('co', 'tab-only')
2216config.bind('d', 'tab-close')
2217config.bind('f', 'hint')
2218config.bind('g$', 'tab-focus -1')
2219config.bind('g0', 'tab-focus 1')
2220config.bind('gB', 'set-cmd-text -s :bookmark-load -t')
2221config.bind('gC', 'tab-clone')
2222config.bind('gD', 'tab-give')
2223config.bind('gJ', 'tab-move +')
2224config.bind('gK', 'tab-move -')
2225config.bind('gO', 'set-cmd-text :open -t -r {url:pretty}')
2226config.bind('gU', 'navigate up -t')
2227config.bind('g^', 'tab-focus 1')
2228config.bind('ga', 'open -t')
2229config.bind('gb', 'set-cmd-text -s :bookmark-load')
2230config.bind('gd', 'download')
2231config.bind('gf', 'view-source')
2232config.bind('gg', 'scroll-to-perc 0')
2233config.bind('gi', 'hint inputs --first')
2234config.bind('gm', 'tab-move')
2235config.bind('go', 'set-cmd-text :open {url:pretty}')
2236config.bind('gt', 'set-cmd-text -s :tab-select')
2237config.bind('gu', 'navigate up')
2238config.bind('h', 'scroll left')
2239config.bind('i', 'mode-enter insert')
2240config.bind('j', 'scroll down')
2241config.bind('k', 'scroll up')
2242config.bind('l', 'scroll right')
2243config.bind('m', 'quickmark-save')
2244config.bind('n', 'search-next')
2245config.bind('o', 'set-cmd-text -s :open')
2246config.bind('pP', 'open -- {primary}')
2247config.bind('pp', 'open -- {clipboard}')
2248config.bind('q', 'macro-record')
2249config.bind('r', 'reload')
2250config.bind('sf', 'save')
2251config.bind('sk', 'set-cmd-text -s :bind')
2252config.bind('sl', 'set-cmd-text -s :set -t')
2253config.bind('ss', 'set-cmd-text -s :set')
2254config.bind('tCH', 'config-cycle -p -u *://*.{url:host}/* content.cookies.accept all no-3rdparty never ;; reload')
2255config.bind('tCh', 'config-cycle -p -u *://{url:host}/* content.cookies.accept all no-3rdparty never ;; reload')
2256config.bind('tCu', 'config-cycle -p -u {url} content.cookies.accept all no-3rdparty never ;; reload')
2257config.bind('tIH', 'config-cycle -p -u *://*.{url:host}/* content.images ;; reload')
2258config.bind('tIh', 'config-cycle -p -u *://{url:host}/* content.images ;; reload')
2259config.bind('tIu', 'config-cycle -p -u {url} content.images ;; reload')
2260config.bind('tPH', 'config-cycle -p -u *://*.{url:host}/* content.plugins ;; reload')
2261config.bind('tPh', 'config-cycle -p -u *://{url:host}/* content.plugins ;; reload')
2262config.bind('tPu', 'config-cycle -p -u {url} content.plugins ;; reload')
2263config.bind('tSH', 'config-cycle -p -u *://*.{url:host}/* content.javascript.enabled ;; reload')
2264config.bind('tSh', 'config-cycle -p -u *://{url:host}/* content.javascript.enabled ;; reload')
2265config.bind('tSu', 'config-cycle -p -u {url} content.javascript.enabled ;; reload')
2266config.bind('tcH', 'config-cycle -p -t -u *://*.{url:host}/* content.cookies.accept all no-3rdparty never ;; reload')
2267config.bind('tch', 'config-cycle -p -t -u *://{url:host}/* content.cookies.accept all no-3rdparty never ;; reload')
2268config.bind('tcu', 'config-cycle -p -t -u {url} content.cookies.accept all no-3rdparty never ;; reload')
2269config.bind('th', 'back -t')
2270config.bind('tiH', 'config-cycle -p -t -u *://*.{url:host}/* content.images ;; reload')
2271config.bind('tih', 'config-cycle -p -t -u *://{url:host}/* content.images ;; reload')
2272config.bind('tiu', 'config-cycle -p -t -u {url} content.images ;; reload')
2273config.bind('tl', 'forward -t')
2274config.bind('tpH', 'config-cycle -p -t -u *://*.{url:host}/* content.plugins ;; reload')
2275config.bind('tph', 'config-cycle -p -t -u *://{url:host}/* content.plugins ;; reload')
2276config.bind('tpu', 'config-cycle -p -t -u {url} content.plugins ;; reload')
2277config.bind('tsH', 'config-cycle -p -t -u *://*.{url:host}/* content.javascript.enabled ;; reload')
2278config.bind('tsh', 'config-cycle -p -t -u *://{url:host}/* content.javascript.enabled ;; reload')
2279config.bind('tsu', 'config-cycle -p -t -u {url} content.javascript.enabled ;; reload')
2280config.bind('u', 'undo')
2281config.bind('v', 'mode-enter caret')
2282config.bind('wB', 'set-cmd-text -s :bookmark-load -w')
2283config.bind('wIf', 'devtools-focus')
2284config.bind('wIh', 'devtools left')
2285config.bind('wIj', 'devtools bottom')
2286config.bind('wIk', 'devtools top')
2287config.bind('wIl', 'devtools right')
2288config.bind('wIw', 'devtools window')
2289config.bind('wO', 'set-cmd-text :open -w {url:pretty}')
2290config.bind('wP', 'open -w -- {primary}')
2291config.bind('wb', 'set-cmd-text -s :quickmark-load -w')
2292config.bind('wf', 'hint all window')
2293config.bind('wh', 'back -w')
2294config.bind('wi', 'devtools')
2295config.bind('wl', 'forward -w')
2296config.bind('wo', 'set-cmd-text -s :open -w')
2297config.bind('wp', 'open -w -- {clipboard}')
2298config.bind('xO', 'set-cmd-text :open -b -r {url:pretty}')
2299config.bind('xo', 'set-cmd-text -s :open -b')
2300config.bind('yD', 'yank domain -s')
2301config.bind('yM', 'yank inline [{title}]({url}) -s')
2302config.bind('yP', 'yank pretty-url -s')
2303config.bind('yT', 'yank title -s')
2304config.bind('yY', 'yank -s')
2305config.bind('yd', 'yank domain')
2306config.bind('ym', 'yank inline [{title}]({url})')
2307config.bind('yp', 'yank pretty-url')
2308config.bind('yt', 'yank title')
2309config.bind('yy', 'yank')
2310config.bind('{{', 'navigate prev -t')
2311config.bind('}}', 'navigate next -t')
2312
2313## Bindings for caret mode
2314config.bind('$', 'move-to-end-of-line', mode='caret')
2315config.bind('0', 'move-to-start-of-line', mode='caret')
2316config.bind('<Ctrl-Space>', 'selection-drop', mode='caret')
2317config.bind('<Escape>', 'mode-leave', mode='caret')
2318config.bind('<Return>', 'yank selection', mode='caret')
2319config.bind('<Space>', 'selection-toggle', mode='caret')
2320config.bind('G', 'move-to-end-of-document', mode='caret')
2321config.bind('H', 'scroll left', mode='caret')
2322config.bind('J', 'scroll down', mode='caret')
2323config.bind('K', 'scroll up', mode='caret')
2324config.bind('L', 'scroll right', mode='caret')
2325config.bind('V', 'selection-toggle --line', mode='caret')
2326config.bind('Y', 'yank selection -s', mode='caret')
2327config.bind('[', 'move-to-start-of-prev-block', mode='caret')
2328config.bind(']', 'move-to-start-of-next-block', mode='caret')
2329config.bind('b', 'move-to-prev-word', mode='caret')
2330config.bind('c', 'mode-enter normal', mode='caret')
2331config.bind('e', 'move-to-end-of-word', mode='caret')
2332config.bind('gg', 'move-to-start-of-document', mode='caret')
2333config.bind('h', 'move-to-prev-char', mode='caret')
2334config.bind('j', 'move-to-next-line', mode='caret')
2335config.bind('k', 'move-to-prev-line', mode='caret')
2336config.bind('l', 'move-to-next-char', mode='caret')
2337config.bind('o', 'selection-reverse', mode='caret')
2338config.bind('v', 'selection-toggle', mode='caret')
2339config.bind('w', 'move-to-next-word', mode='caret')
2340config.bind('y', 'yank selection', mode='caret')
2341config.bind('{', 'move-to-end-of-prev-block', mode='caret')
2342config.bind('}', 'move-to-end-of-next-block', mode='caret')
2343
2344## Bindings for command mode
2345config.bind('<Alt-B>', 'rl-backward-word', mode='command')
2346config.bind('<Alt-Backspace>', 'rl-backward-kill-word', mode='command')
2347config.bind('<Alt-D>', 'rl-kill-word', mode='command')
2348config.bind('<Alt-F>', 'rl-forward-word', mode='command')
2349config.bind('<Ctrl-?>', 'rl-delete-char', mode='command')
2350config.bind('<Ctrl-A>', 'rl-beginning-of-line', mode='command')
2351config.bind('<Ctrl-B>', 'rl-backward-char', mode='command')
2352config.bind('<Ctrl-C>', 'completion-item-yank', mode='command')
2353config.bind('<Ctrl-D>', 'completion-item-del', mode='command')
2354config.bind('<Ctrl-E>', 'rl-end-of-line', mode='command')
2355config.bind('<Ctrl-F>', 'rl-forward-char', mode='command')
2356config.bind('<Ctrl-H>', 'rl-backward-delete-char', mode='command')
2357config.bind('<Ctrl-K>', 'rl-kill-line', mode='command')
2358config.bind('<Ctrl-N>', 'command-history-next', mode='command')
2359config.bind('<Ctrl-P>', 'command-history-prev', mode='command')
2360config.bind('<Ctrl-Return>', 'command-accept --rapid', mode='command')
2361config.bind('<Ctrl-Shift-C>', 'completion-item-yank --sel', mode='command')
2362config.bind('<Ctrl-Shift-Tab>', 'completion-item-focus prev-category', mode='command')
2363config.bind('<Ctrl-Shift-W>', 'rl-filename-rubout', mode='command')
2364config.bind('<Ctrl-Tab>', 'completion-item-focus next-category', mode='command')
2365config.bind('<Ctrl-U>', 'rl-unix-line-discard', mode='command')
2366config.bind('<Ctrl-W>', 'rl-rubout " "', mode='command')
2367config.bind('<Ctrl-Y>', 'rl-yank', mode='command')
2368config.bind('<Down>', 'completion-item-focus --history next', mode='command')
2369config.bind('<Escape>', 'mode-leave', mode='command')
2370config.bind('<PgDown>', 'completion-item-focus next-page', mode='command')
2371config.bind('<PgUp>', 'completion-item-focus prev-page', mode='command')
2372config.bind('<Return>', 'command-accept', mode='command')
2373config.bind('<Shift-Delete>', 'completion-item-del', mode='command')
2374config.bind('<Shift-Tab>', 'completion-item-focus prev', mode='command')
2375config.bind('<Tab>', 'completion-item-focus next', mode='command')
2376config.bind('<Up>', 'completion-item-focus --history prev', mode='command')
2377
2378## Bindings for hint mode
2379config.bind('<Ctrl-B>', 'hint all tab-bg', mode='hint')
2380config.bind('<Ctrl-F>', 'hint links', mode='hint')
2381config.bind('<Ctrl-R>', 'hint --rapid links tab-bg', mode='hint')
2382config.bind('<Escape>', 'mode-leave', mode='hint')
2383config.bind('<Return>', 'hint-follow', mode='hint')
2384
2385## Bindings for insert mode
2386config.bind('<Ctrl-E>', 'edit-text', mode='insert')
2387config.bind('<Escape>', 'mode-leave', mode='insert')
2388config.bind('<Shift-Escape>', 'fake-key <Escape>', mode='insert')
2389config.bind('<Shift-Ins>', 'insert-text -- {primary}', mode='insert')
2390
2391## Bindings for passthrough mode
2392config.bind('<Shift-Escape>', 'mode-leave', mode='passthrough')
2393
2394## Bindings for prompt mode
2395config.bind('<Alt-B>', 'rl-backward-word', mode='prompt')
2396config.bind('<Alt-Backspace>', 'rl-backward-kill-word', mode='prompt')
2397config.bind('<Alt-D>', 'rl-kill-word', mode='prompt')
2398config.bind('<Alt-F>', 'rl-forward-word', mode='prompt')
2399config.bind('<Alt-Shift-Y>', 'prompt-yank --sel', mode='prompt')
2400config.bind('<Alt-Y>', 'prompt-yank', mode='prompt')
2401config.bind('<Ctrl-?>', 'rl-delete-char', mode='prompt')
2402config.bind('<Ctrl-A>', 'rl-beginning-of-line', mode='prompt')
2403config.bind('<Ctrl-B>', 'rl-backward-char', mode='prompt')
2404config.bind('<Ctrl-E>', 'rl-end-of-line', mode='prompt')
2405config.bind('<Ctrl-F>', 'rl-forward-char', mode='prompt')
2406config.bind('<Ctrl-H>', 'rl-backward-delete-char', mode='prompt')
2407config.bind('<Ctrl-K>', 'rl-kill-line', mode='prompt')
2408config.bind('<Ctrl-P>', 'prompt-open-download --pdfjs', mode='prompt')
2409config.bind('<Ctrl-Shift-W>', 'rl-filename-rubout', mode='prompt')
2410config.bind('<Ctrl-U>', 'rl-unix-line-discard', mode='prompt')
2411config.bind('<Ctrl-W>', 'rl-rubout " "', mode='prompt')
2412config.bind('<Ctrl-X>', 'prompt-open-download', mode='prompt')
2413config.bind('<Ctrl-Y>', 'rl-yank', mode='prompt')
2414config.bind('<Down>', 'prompt-item-focus next', mode='prompt')
2415config.bind('<Escape>', 'mode-leave', mode='prompt')
2416config.bind('<Return>', 'prompt-accept', mode='prompt')
2417config.bind('<Shift-Tab>', 'prompt-item-focus prev', mode='prompt')
2418config.bind('<Tab>', 'prompt-item-focus next', mode='prompt')
2419config.bind('<Up>', 'prompt-item-focus prev', mode='prompt')
2420
2421## Bindings for register mode
2422config.bind('<Escape>', 'mode-leave', mode='register')
2423
2424## Bindings for yesno mode
2425config.bind('<Alt-Shift-Y>', 'prompt-yank --sel', mode='yesno')
2426config.bind('<Alt-Y>', 'prompt-yank', mode='yesno')
2427config.bind('<Escape>', 'mode-leave', mode='yesno')
2428config.bind('<Return>', 'prompt-accept', mode='yesno')
2429config.bind('N', 'prompt-accept --save no', mode='yesno')
2430config.bind('Y', 'prompt-accept --save yes', mode='yesno')
2431config.bind('n', 'prompt-accept no', mode='yesno')
2432config.bind('y', 'prompt-accept yes', mode='yesno')