qutebrowser/config.py

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