]> git.rmz.io Git - dotfiles.git/blobdiff - qutebrowser/config.py
qutebrowser: cycle through cookie settings for tld with user script
[dotfiles.git] / qutebrowser / config.py
index 8e6cfb2a6b32d0e9b21dce03526983079e50ce85..838ea5a205cd51f14a240064620d81ce218c11f6 100644 (file)
@@ -13,7 +13,9 @@
 c.aliases = {'w':    'session-save',
              'quit': 'close',
              'q':    'close',
 c.aliases = {'w':    'session-save',
              'quit': 'close',
              'q':    'close',
+             'qa':   'quit',
              'wq':   'quit --save',
              'wq':   'quit --save',
+             'wqa':  'quit --save',
              'mpv':  'spawn --userscript ~/src/qutebrowser/misc/userscripts/view_in_mpv'
              }
 
              'mpv':  'spawn --userscript ~/src/qutebrowser/misc/userscripts/view_in_mpv'
              }
 
@@ -82,7 +84,7 @@ c.auto_save.session = True
 ## Type: QssColor
 # c.colors.completion.item.selected.border.bottom = '#bbbb00'
 
 ## Type: QssColor
 # c.colors.completion.item.selected.border.bottom = '#bbbb00'
 
-## Top border color of the completion widget category headers.
+## Top border color of the selected completion item.
 ## Type: QssColor
 # c.colors.completion.item.selected.border.top = '#bbbb00'
 
 ## Type: QssColor
 # c.colors.completion.item.selected.border.top = '#bbbb00'
 
@@ -90,8 +92,12 @@ c.auto_save.session = True
 ## Type: QtColor
 # c.colors.completion.item.selected.fg = 'black'
 
 ## Type: QtColor
 # c.colors.completion.item.selected.fg = 'black'
 
+## Foreground color of the matched text in the selected completion item.
+## Type: QtColor
+# c.colors.completion.item.selected.match.fg = '#ff4444'
+
 ## Foreground color of the matched text in the completion.
 ## Foreground color of the matched text in the completion.
-## Type: QssColor
+## Type: QtColor
 # c.colors.completion.match.fg = '#ff4444'
 
 ## Background color of the completion widget for odd rows.
 # c.colors.completion.match.fg = '#ff4444'
 
 ## Background color of the completion widget for odd rows.
@@ -106,6 +112,26 @@ c.auto_save.session = True
 ## Type: QssColor
 # c.colors.completion.scrollbar.fg = 'white'
 
 ## Type: QssColor
 # c.colors.completion.scrollbar.fg = 'white'
 
+## Background color of the context menu. If set to null, the Qt default
+## is used.
+## Type: QssColor
+# c.colors.contextmenu.menu.bg = None
+
+## Foreground color of the context menu. If set to null, the Qt default
+## is used.
+## Type: QssColor
+# c.colors.contextmenu.menu.fg = None
+
+## Background color of the context menu's selected item. If set to null,
+## the Qt default is used.
+## Type: QssColor
+# c.colors.contextmenu.selected.bg = None
+
+## Foreground color of the context menu's selected item. If set to null,
+## the Qt default is used.
+## Type: QssColor
+# c.colors.contextmenu.selected.fg = None
+
 ## Background color for the download bar.
 ## Type: QssColor
 # c.colors.downloads.bar.bg = 'black'
 ## Background color for the download bar.
 ## Type: QssColor
 # c.colors.downloads.bar.bg = 'black'
@@ -162,7 +188,7 @@ c.auto_save.session = True
 # c.colors.hints.fg = 'black'
 
 ## Font color for the matched part of hints.
 # c.colors.hints.fg = 'black'
 
 ## Font color for the matched part of hints.
-## Type: QssColor
+## Type: QtColor
 # c.colors.hints.match.fg = 'green'
 
 ## Background color of the keyhint widget.
 # c.colors.hints.match.fg = 'green'
 
 ## Background color of the keyhint widget.
@@ -255,7 +281,7 @@ c.colors.prompts.bg = '#333333'
 
 ## Background color of the statusbar in private browsing + command mode.
 ## Type: QssColor
 
 ## Background color of the statusbar in private browsing + command mode.
 ## Type: QssColor
-# c.colors.statusbar.command.private.bg = 'grey'
+# c.colors.statusbar.command.private.bg = 'darkslategray'
 
 ## Foreground color of the statusbar in private browsing + command mode.
 ## Type: QssColor
 
 ## Foreground color of the statusbar in private browsing + command mode.
 ## Type: QssColor
@@ -324,7 +350,7 @@ c.colors.prompts.bg = '#333333'
 # c.colors.statusbar.url.warn.fg = 'yellow'
 
 ## Background color of the tab bar.
 # c.colors.statusbar.url.warn.fg = 'yellow'
 
 ## Background color of the tab bar.
-## Type: QtColor
+## Type: QssColor
 # c.colors.tabs.bar.bg = '#555555'
 
 ## Background color of unselected even tabs.
 # c.colors.tabs.bar.bg = '#555555'
 
 ## Background color of unselected even tabs.
@@ -364,6 +390,38 @@ c.colors.prompts.bg = '#333333'
 ## Type: QtColor
 # c.colors.tabs.odd.fg = 'white'
 
 ## Type: QtColor
 # c.colors.tabs.odd.fg = 'white'
 
+## Background color of pinned unselected even tabs.
+## Type: QtColor
+# c.colors.tabs.pinned.even.bg = 'darkseagreen'
+
+## Foreground color of pinned unselected even tabs.
+## Type: QtColor
+# c.colors.tabs.pinned.even.fg = 'white'
+
+## Background color of pinned unselected odd tabs.
+## Type: QtColor
+# c.colors.tabs.pinned.odd.bg = 'seagreen'
+
+## Foreground color of pinned unselected odd tabs.
+## Type: QtColor
+# c.colors.tabs.pinned.odd.fg = 'white'
+
+## Background color of pinned selected even tabs.
+## Type: QtColor
+# c.colors.tabs.pinned.selected.even.bg = 'black'
+
+## Foreground color of pinned selected even tabs.
+## Type: QtColor
+# c.colors.tabs.pinned.selected.even.fg = 'white'
+
+## Background color of pinned selected odd tabs.
+## Type: QtColor
+# c.colors.tabs.pinned.selected.odd.bg = 'black'
+
+## Foreground color of pinned selected odd tabs.
+## Type: QtColor
+# c.colors.tabs.pinned.selected.odd.fg = 'white'
+
 ## Background color of selected even tabs.
 ## Type: QtColor
 # c.colors.tabs.selected.even.bg = 'black'
 ## Background color of selected even tabs.
 ## Type: QtColor
 # c.colors.tabs.selected.even.bg = 'black'
@@ -385,6 +443,10 @@ c.colors.prompts.bg = '#333333'
 ## Type: QtColor
 # c.colors.webpage.bg = 'white'
 
 ## Type: QtColor
 # c.colors.webpage.bg = 'white'
 
+## Force `prefers-color-scheme: dark` colors for websites.
+## Type: Bool
+c.colors.webpage.prefers_color_scheme_dark = True
+
 ## Number of commands to save in the command history. 0: no history / -1:
 ## unlimited
 ## Type: Int
 ## Number of commands to save in the command history. 0: no history / -1:
 ## unlimited
 ## Type: Int
@@ -403,6 +465,15 @@ c.completion.height = 150
 ## Type: Int
 # c.completion.min_chars = 1
 
 ## Type: Int
 # c.completion.min_chars = 1
 
+## Which categories to show (in which order) in the :open completion.
+## Type: FlagList
+## Valid values:
+##   - searchengines
+##   - quickmarks
+##   - bookmarks
+##   - history
+# c.completion.open_categories = ['searchengines', 'quickmarks', 'bookmarks', 'history']
+
 ## Move on to the next part when there's only one possible completion
 ## left.
 ## Type: Bool
 ## Move on to the next part when there's only one possible completion
 ## left.
 ## Type: Bool
@@ -429,18 +500,27 @@ c.completion.quick = False
 ## Type: Bool
 c.completion.shrink = True
 
 ## Type: Bool
 c.completion.shrink = True
 
-## Format of timestamps (e.g. for the history completion).
-## Type: TimestampTemplate
+## Format of timestamps (e.g. for the history completion). See
+## https://sqlite.org/lang_datefunc.html for allowed substitutions.
+## Type: String
 # c.completion.timestamp_format = '%Y-%m-%d'
 
 ## Execute the best-matching command on a partial match.
 ## Type: Bool
 # c.completion.use_best_match = False
 
 # c.completion.timestamp_format = '%Y-%m-%d'
 
 ## Execute the best-matching command on a partial match.
 ## Type: Bool
 # c.completion.use_best_match = False
 
+## A list of patterns which should not be shown in the history. This only
+## affects the completion. Matching URLs are still saved in the history
+## (and visible on the qute://history page), but hidden in the
+## completion. Changing this setting will cause the completion history to
+## be regenerated on the next start, which will take a short while.
+## Type: List of UrlPattern
+# c.completion.web_history.exclude = []
+
 ## Number of URLs to show in the web history. 0: no history / -1:
 ## unlimited
 ## Type: Int
 ## Number of URLs to show in the web history. 0: no history / -1:
 ## unlimited
 ## Type: Int
-# c.completion.web_history_max_items = -1
+# c.completion.web_history.max_items = -1
 
 ## Require a confirmation before quitting the application.
 ## Type: ConfirmQuit
 
 ## Require a confirmation before quitting the application.
 ## Type: ConfirmQuit
@@ -451,6 +531,11 @@ c.completion.shrink = True
 ##   - never: Never show a confirmation.
 c.confirm_quit = ['downloads']
 
 ##   - never: Never show a confirmation.
 c.confirm_quit = ['downloads']
 
+## Automatically start playing `<video>` elements. Note: On Qt < 5.11,
+## this option needs a restart and does not support URL patterns.
+## Type: Bool
+# c.content.autoplay = True
+
 ## Enable support for the HTML 5 web application cache feature. An
 ## application cache acts like an HTTP cache in some sense. For documents
 ## that use the application cache via JavaScript, the loader engine will
 ## Enable support for the HTML 5 web application cache feature. An
 ## application cache acts like an HTTP cache in some sense. For documents
 ## that use the application cache via JavaScript, the loader engine will
@@ -473,14 +558,34 @@ c.confirm_quit = ['downloads']
 ## Type: Int
 # c.content.cache.size = None
 
 ## Type: Int
 # c.content.cache.size = None
 
-## Which cookies to accept.
+## Allow websites to read canvas elements. Note this is needed for some
+## websites to work properly.
+## Type: Bool
+# c.content.canvas_reading = True
+
+## Which cookies to accept. Note that with QtWebKit, only `all` and
+## `never` are supported as per-domain values. Setting `no-3rdparty` or
+## `no-unknown-3rdparty` per-domain on QtWebKit will have the same effect
+## as `all`.
 ## Type: String
 ## Valid values:
 ##   - all: Accept all cookies.
 ## Type: String
 ## Valid values:
 ##   - all: Accept all cookies.
-##   - no-3rdparty: Accept cookies from the same origin only.
-##   - no-unknown-3rdparty: Accept cookies from the same origin only, unless a cookie is already set for the domain.
+##   - no-3rdparty: Accept cookies from the same origin only. This is known to break some sites, such as GMail.
+##   - 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.
 ##   - never: Don't accept cookies at all.
 ##   - never: Don't accept cookies at all.
-# c.content.cookies.accept = 'no-3rdparty'
+c.content.cookies.accept = 'never'
+
+config.set('content.cookies.accept', 'no-3rdparty', '*://*.amazon.co.uk/*')
+config.set('content.cookies.accept', 'no-3rdparty', '*://*.amazon.de/*')
+config.set('content.cookies.accept', 'no-3rdparty', '*://*.duckduckgo.com/*')
+config.set('content.cookies.accept', 'no-3rdparty', '*://*.freedesktop.org/*')
+config.set('content.cookies.accept', 'no-3rdparty', '*://*.github.com/*')
+config.set('content.cookies.accept', 'no-3rdparty', '*://*.gitlab.com/*')
+config.set('content.cookies.accept', 'no-3rdparty', '*://*.google.com/*')
+config.set('content.cookies.accept', 'no-3rdparty', '*://*.humblebundle.com/*')
+config.set('content.cookies.accept', 'no-3rdparty', '*://*.mailfence.com/*')
+config.set('content.cookies.accept', 'no-3rdparty', '*://*.reddit.com/*')
+config.set('content.cookies.accept', 'no-3rdparty', '*://*.steampowered.com/*')
 
 ## Store cookies. Note this option needs a restart with QtWebEngine on Qt
 ## < 5.9.
 
 ## Store cookies. Note this option needs a restart with QtWebEngine on Qt
 ## < 5.9.
@@ -492,22 +597,34 @@ c.confirm_quit = ['downloads']
 ## Type: String
 # c.content.default_encoding = 'iso-8859-1'
 
 ## Type: String
 # c.content.default_encoding = 'iso-8859-1'
 
-## Enable extra tools for Web developers. This needs to be enabled for
-## `:inspector` to work and also adds an _Inspect_ entry to the context
-## menu. For QtWebEngine, see `--enable-webengine-inspector` in
-## `qutebrowser --help` instead.
-## Type: Bool
-# c.content.developer_extras = False
+## Allow websites to share screen content. On Qt < 5.10, a dialog box is
+## always displayed, even if this is set to "true".
+## Type: BoolAsk
+## Valid values:
+##   - true
+##   - false
+##   - ask
+# c.content.desktop_capture = 'ask'
 
 ## Try to pre-fetch DNS entries to speed up browsing.
 ## Type: Bool
 
 ## Try to pre-fetch DNS entries to speed up browsing.
 ## Type: Bool
-c.content.dns_prefetch = True
+c.content.dns_prefetch = True
 
 ## Expand each subframe to its contents. This will flatten all the frames
 ## to become one scrollable page.
 ## Type: Bool
 # c.content.frame_flattening = False
 
 
 ## Expand each subframe to its contents. This will flatten all the frames
 ## to become one scrollable page.
 ## Type: Bool
 # c.content.frame_flattening = False
 
+## Set fullscreen notification overlay timeout in milliseconds. If set to
+## 0, no overlay will be displayed.
+## Type: Int
+# c.content.fullscreen.overlay_timeout = 3000
+
+## Limit fullscreen to the browser window (does not expand to fill the
+## screen).
+## Type: Bool
+# c.content.fullscreen.window = False
+
 ## Allow websites to request geolocations.
 ## Type: BoolAsk
 ## Valid values:
 ## Allow websites to request geolocations.
 ## Type: BoolAsk
 ## Valid values:
@@ -516,9 +633,10 @@ c.confirm_quit = ['downloads']
 ##   - ask
 # c.content.geolocation = 'ask'
 
 ##   - ask
 # c.content.geolocation = 'ask'
 
-## Value to send in the `Accept-Language` header.
+## Value to send in the `Accept-Language` header. Note that the value
+## read from JavaScript is always the global value.
 ## Type: String
 ## Type: String
-c.content.headers.accept_language = 'en-US,en,de,fr'
+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'
 
 ## Custom headers for qutebrowser HTTP requests.
 ## Type: Dict
 
 ## Custom headers for qutebrowser HTTP requests.
 ## Type: Dict
@@ -531,17 +649,28 @@ c.content.headers.accept_language = 'en-US,en,de,fr'
 # c.content.headers.do_not_track = True
 
 ## When to send the Referer header. The Referer header tells websites
 # c.content.headers.do_not_track = True
 
 ## When to send the Referer header. The Referer header tells websites
-## from which website you were coming from when visiting them.
+## from which website you were coming from when visiting them. No restart
+## is needed with QtWebKit.
 ## Type: String
 ## Valid values:
 ##   - always: Always send the Referer.
 ##   - never: Never send the Referer. This is not recommended, as some sites may break.
 ## Type: String
 ## Valid values:
 ##   - always: Always send the Referer.
 ##   - never: Never send the Referer. This is not recommended, as some sites may break.
-##   - same-domain: Only send the Referer for the same domain. This will still protect your privacy, but shouldn't break any sites.
+##   - 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.
 # c.content.headers.referer = 'same-domain'
 
 # c.content.headers.referer = 'same-domain'
 
-## User agent to send. Unset to send the default.
-## Type: String
-# c.content.headers.user_agent = None
+## User agent to send.  The following placeholders are defined:  *
+## `{os_info}`: Something like "X11; Linux x86_64". * `{webkit_version}`:
+## The underlying WebKit version (set to a fixed value   with
+## QtWebEngine). * `{qt_key}`: "Qt" for QtWebKit, "QtWebEngine" for
+## QtWebEngine. * `{qt_version}`: The underlying Qt version. *
+## `{upstream_browser_key}`: "Version" for QtWebKit, "Chrome" for
+## QtWebEngine. * `{upstream_browser_version}`: The corresponding
+## Safari/Chrome version. * `{qutebrowser_version}`: The currently
+## running qutebrowser version.  The default value is equal to the
+## unchanged user agent of QtWebKit/QtWebEngine.  Note that the value
+## read from JavaScript is always the global value.
+## Type: FormatString
+# 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}'
 
 ## Enable host blocking.
 ## Type: Bool
 
 ## Enable host blocking.
 ## Type: Bool
@@ -550,16 +679,23 @@ c.content.headers.accept_language = 'en-US,en,de,fr'
 ## List of URLs of lists which contain hosts to block.  The file can be
 ## in one of the following formats:  - An `/etc/hosts`-like file - One
 ## host per line - A zip-file of any of the above, with either only one
 ## List of URLs of lists which contain hosts to block.  The file can be
 ## in one of the following formats:  - An `/etc/hosts`-like file - One
 ## host per line - A zip-file of any of the above, with either only one
-## file, or a file   named `hosts` (with any extension).
+## file, or a file   named `hosts` (with any extension).  It's also
+## possible to add a local file or directory via a `file://` URL. In case
+## of a directory, all files in the directory are read as adblock lists.
+## The file `~/.config/qutebrowser/blocked-hosts` is always read if it
+## exists.
 ## Type: List of Url
 # c.content.host_blocking.lists = ['https://raw.githubusercontent.com/StevenBlack/hosts/master/hosts']
 
 ## Type: List of Url
 # c.content.host_blocking.lists = ['https://raw.githubusercontent.com/StevenBlack/hosts/master/hosts']
 
-## List of domains that should always be loaded, despite being ad-
-## blocked. Domains may contain * and ? wildcards and are otherwise
-## required to exactly match the requested domain. Local domains are
-## always exempt from hostblocking.
-## Type: List of String
-# c.content.host_blocking.whitelist = ['piwik.org']
+## A list of patterns that should always be loaded, despite being ad-
+## blocked. Note this whitelists blocked hosts, not first-party URLs. As
+## an example, if `example.org` loads an ad from `ads.example.org`, the
+## whitelisted host should be `ads.example.org`. If you want to disable
+## the adblocker on a given page, use the `content.host_blocking.enabled`
+## setting with a URL pattern instead. Local domains are always exempt
+## from hostblocking.
+## Type: List of UrlPattern
+# c.content.host_blocking.whitelist = []
 
 ## Enable hyperlink auditing (`<a ping>`).
 ## Type: Bool
 
 ## Enable hyperlink auditing (`<a ping>`).
 ## Type: Bool
@@ -594,7 +730,9 @@ c.content.headers.accept_language = 'en-US,en,de,fr'
 ## Log levels to use for JavaScript console logging messages. When a
 ## JavaScript message with the level given in the dictionary key is
 ## logged, the corresponding dictionary value selects the qutebrowser
 ## Log levels to use for JavaScript console logging messages. When a
 ## JavaScript message with the level given in the dictionary key is
 ## logged, the corresponding dictionary value selects the qutebrowser
-## logger to use. On QtWebKit, the "unknown" setting is always used.
+## logger to use. On QtWebKit, the "unknown" setting is always used. The
+## following levels are valid: `none`, `debug`, `info`, `warning`,
+## `error`.
 ## Type: Dict
 # c.content.javascript.log = {'unknown': 'debug', 'info': 'debug', 'warning': 'debug', 'error': 'debug'}
 
 ## Type: Dict
 # c.content.javascript.log = {'unknown': 'debug', 'info': 'debug', 'warning': 'debug', 'error': 'debug'}
 
@@ -627,6 +765,20 @@ c.content.headers.accept_language = 'en-US,en,de,fr'
 ##   - ask
 # c.content.media_capture = 'ask'
 
 ##   - ask
 # c.content.media_capture = 'ask'
 
+## Allow websites to lock your mouse pointer.
+## Type: BoolAsk
+## Valid values:
+##   - true
+##   - false
+##   - ask
+# c.content.mouse_lock = 'ask'
+
+## Automatically mute tabs. Note that if the `:tab-mute` command is used,
+## the mute status for the affected tab is now controlled manually, and
+## this setting doesn't have any effect.
+## Type: Bool
+# c.content.mute = False
+
 ## Netrc-file for HTTP authentication. If unset, `~/.netrc` is used.
 ## Type: File
 # c.content.netrc_file = None
 ## Netrc-file for HTTP authentication. If unset, `~/.netrc` is used.
 ## Type: File
 # c.content.netrc_file = None
@@ -637,7 +789,9 @@ c.content.headers.accept_language = 'en-US,en,de,fr'
 ##   - true
 ##   - false
 ##   - ask
 ##   - true
 ##   - false
 ##   - ask
-# c.content.notifications = 'ask'
+c.content.notifications = 'ask'
+config.set('content.notifications', True, '*://*.gitlab.com/*')
+config.set('content.notifications', True, '*://*.google.com/*')
 
 ## Allow pdf.js to view PDF files in the browser. Note that the files can
 ## still be downloaded by clicking the download button in the pdf.js
 
 ## Allow pdf.js to view PDF files in the browser. Note that the files can
 ## still be downloaded by clicking the download button in the pdf.js
@@ -645,6 +799,15 @@ c.content.headers.accept_language = 'en-US,en,de,fr'
 ## Type: Bool
 # c.content.pdfjs = False
 
 ## Type: Bool
 # c.content.pdfjs = False
 
+## Allow websites to request persistent storage quota via
+## `navigator.webkitPersistentStorage.requestQuota`.
+## Type: BoolAsk
+## Valid values:
+##   - true
+##   - false
+##   - ask
+# c.content.persistent_storage = 'ask'
+
 ## Enable plugins in Web pages.
 ## Type: Bool
 # c.content.plugins = False
 ## Enable plugins in Web pages.
 ## Type: Bool
 # c.content.plugins = False
@@ -670,6 +833,24 @@ c.content.headers.accept_language = 'en-US,en,de,fr'
 ## Type: Bool
 # c.content.proxy_dns_requests = True
 
 ## Type: Bool
 # c.content.proxy_dns_requests = True
 
+## Allow websites to register protocol handlers via
+## `navigator.registerProtocolHandler`.
+## Type: BoolAsk
+## Valid values:
+##   - true
+##   - false
+##   - ask
+# c.content.register_protocol_handler = 'ask'
+with config.pattern('*://mail.google.com/*') as p:
+    p.content.register_protocol_handler = False
+with config.pattern('*://calendar.google.com/*') as p:
+    p.content.register_protocol_handler = False
+
+## Enable quirks (such as faked user agent headers) needed to get
+## specific sites to work properly.
+## Type: Bool
+# c.content.site_specific_quirks = True
+
 ## Validate SSL handshakes.
 ## Type: BoolAsk
 ## Valid values:
 ## Validate SSL handshakes.
 ## Type: BoolAsk
 ## Valid values:
@@ -678,6 +859,14 @@ c.content.headers.accept_language = 'en-US,en,de,fr'
 ##   - ask
 # c.content.ssl_strict = 'ask'
 
 ##   - ask
 # c.content.ssl_strict = 'ask'
 
+## How navigation requests to URLs with unknown schemes are handled.
+## Type: String
+## Valid values:
+##   - disallow: Disallows all navigation requests to URLs with unknown schemes.
+##   - 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.
+##   - allow-all: Allows all navigation requests to URLs with unknown schemes.
+# c.content.unknown_url_scheme_policy = 'allow-from-user-interaction'
+
 ## List of user stylesheet filenames to use.
 ## Type: List of File, or File
 # c.content.user_stylesheets = []
 ## List of user stylesheet filenames to use.
 ## Type: List of File, or File
 # c.content.user_stylesheets = []
@@ -686,14 +875,21 @@ c.content.headers.accept_language = 'en-US,en,de,fr'
 ## Type: Bool
 # c.content.webgl = True
 
 ## Type: Bool
 # c.content.webgl = True
 
-## Limit fullscreen to the browser window (does not expand to fill the
-## screen).
-## Type: Bool
-# c.content.windowed_fullscreen = False
+## Which interfaces to expose via WebRTC. On Qt 5.10, this option doesn't
+## work because of a Qt bug.
+## Type: String
+## Valid values:
+##   - all-interfaces: WebRTC has the right to enumerate all interfaces and bind them to discover public interfaces.
+##   - 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.
+##   - default-public-interface-only: WebRTC should only use the default route used by http. This doesn't expose any local addresses.
+##   - 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.
+# c.content.webrtc_ip_handling_policy = 'all-interfaces'
 
 ## Monitor load requests for cross-site scripting attempts. Suspicious
 ## scripts will be blocked and reported in the inspector's JavaScript
 
 ## Monitor load requests for cross-site scripting attempts. Suspicious
 ## scripts will be blocked and reported in the inspector's JavaScript
-## console. Enabling this feature might have an impact on performance.
+## console. Note that bypasses for the XSS auditor are widely known and
+## it can be abused for cross-site info leaks in some scenarios, see:
+## https://www.chromium.org/developers/design-documents/xss-auditor
 ## Type: Bool
 # c.content.xss_auditing = False
 
 ## Type: Bool
 # c.content.xss_auditing = False
 
@@ -738,7 +934,7 @@ c.downloads.open_dispatcher = "rifle"
 # c.downloads.remove_finished = -1
 
 ## Editor (and arguments) to use for the `open-editor` command. The
 # c.downloads.remove_finished = -1
 
 ## Editor (and arguments) to use for the `open-editor` command. The
-## following placeholders are defined: * `{file}`: Filename of the file
+## following placeholders are defined:  * `{file}`: Filename of the file
 ## to be edited. * `{line}`: Line in which the caret is found in the
 ## text. * `{column}`: Column in which the caret is found in the text. *
 ## `{line0}`: Same as `{line}`, but starting from index 0. * `{column0}`:
 ## to be edited. * `{line}`: Line in which the caret is found in the
 ## text. * `{column}`: Column in which the caret is found in the text. *
 ## `{line0}`: Same as `{line}`, but starting from index 0. * `{column0}`:
@@ -752,56 +948,69 @@ c.editor.command = ['urxvtc', '-e', 'vim', '{file}', '-c', 'normal {line}G{colum
 
 ## Font used in the completion categories.
 ## Type: Font
 
 ## Font used in the completion categories.
 ## Type: Font
-# c.fonts.completion.category = 'bold 10pt monospace'
+# c.fonts.completion.category = 'bold default_size default_family'
 
 ## Font used in the completion widget.
 ## Type: Font
 
 ## Font used in the completion widget.
 ## Type: Font
-# c.fonts.completion.entry = '10pt monospace'
+# c.fonts.completion.entry = 'default_size default_family'
+
+## Font used for the context menu. If set to null, the Qt default is
+## used.
+## Type: Font
+# c.fonts.contextmenu = None
 
 ## Font used for the debugging console.
 ## Type: QtFont
 
 ## Font used for the debugging console.
 ## Type: QtFont
-# c.fonts.debug_console = '10pt monospace'
+# c.fonts.debug_console = 'default_size default_family'
+
+## Default font families to use. Whenever "default_family" is used in a
+## font setting, it's replaced with the fonts listed here. If set to an
+## empty value, a system-specific monospace default is used.
+## Type: List of Font, or Font
+c.fonts.default_family = ["Hack"]
+
+## Default font size to use. Whenever "default_size" is used in a font
+## setting, it's replaced with the size listed here. Valid values are
+## either a float value with a "pt" suffix, or an integer value with a
+## "px" suffix.
+## Type: String
+# c.fonts.default_size = '10pt'
 
 ## Font used for the downloadbar.
 ## Type: Font
 
 ## Font used for the downloadbar.
 ## Type: Font
-# c.fonts.downloads = '10pt monospace'
+# c.fonts.downloads = 'default_size default_family'
 
 ## Font used for the hints.
 ## Type: Font
 
 ## Font used for the hints.
 ## Type: Font
-# c.fonts.hints = 'bold 10pt monospace'
+# c.fonts.hints = 'bold default_size default_family'
 
 ## Font used in the keyhint widget.
 ## Type: Font
 
 ## Font used in the keyhint widget.
 ## Type: Font
-# c.fonts.keyhint = '10pt monospace'
+# c.fonts.keyhint = 'default_size default_family'
 
 ## Font used for error messages.
 ## Type: Font
 
 ## Font used for error messages.
 ## Type: Font
-# c.fonts.messages.error = '10pt monospace'
+# c.fonts.messages.error = 'default_size default_family'
 
 ## Font used for info messages.
 ## Type: Font
 
 ## Font used for info messages.
 ## Type: Font
-# c.fonts.messages.info = '10pt monospace'
+# c.fonts.messages.info = 'default_size default_family'
 
 ## Font used for warning messages.
 ## Type: Font
 
 ## Font used for warning messages.
 ## Type: Font
-# c.fonts.messages.warning = '10pt monospace'
-
-## Default monospace fonts. Whenever "monospace" is used in a font
-## setting, it's replaced with the fonts listed here.
-## Type: Font
-c.fonts.monospace = 'Hack, "xos4 Terminus", Terminus, Monospace, "DejaVu Sans Mono", Monaco, "Bitstream Vera Sans Mono", "Andale Mono", "Courier New", Courier, "Liberation Mono", monospace, Fixed, Consolas, Terminal'
+# c.fonts.messages.warning = 'default_size default_family'
 
 ## Font used for prompts.
 ## Type: Font
 
 ## Font used for prompts.
 ## Type: Font
-# c.fonts.prompts = '10pt sans-serif'
+# c.fonts.prompts = 'default_size sans-serif'
 
 ## Font used in the statusbar.
 ## Type: Font
 
 ## Font used in the statusbar.
 ## Type: Font
-# c.fonts.statusbar = '10pt monospace'
+# c.fonts.statusbar = 'default_size default_family'
 
 ## Font used in the tab bar.
 ## Type: QtFont
 
 ## Font used in the tab bar.
 ## Type: QtFont
-# c.fonts.tabs = '10pt monospace'
+# c.fonts.tabs = 'default_size default_family'
 
 ## Font family for cursive fonts.
 ## Type: FontFamily
 
 ## Font family for cursive fonts.
 ## Type: FontFamily
@@ -881,6 +1090,10 @@ c.hints.chars = 'aoeuidhtns'
 ## Type: Bool
 # c.hints.hide_unmatched_rapid_hints = True
 
 ## Type: Bool
 # c.hints.hide_unmatched_rapid_hints = True
 
+## Leave hint mode when starting a new page load.
+## Type: Bool
+# c.hints.leave_on_load = True
+
 ## Minimum number of characters used for hint strings.
 ## Type: Int
 c.hints.min_chars = 2
 ## Minimum number of characters used for hint strings.
 ## Type: Int
 c.hints.min_chars = 2
@@ -897,15 +1110,28 @@ c.hints.min_chars = 2
 ## Type: List of Regex
 # c.hints.next_regexes = ['\\bnext\\b', '\\bmore\\b', '\\bnewer\\b', '\\b[>→≫]\\b', '\\b(>>|»)\\b', '\\bcontinue\\b']
 
 ## Type: List of Regex
 # c.hints.next_regexes = ['\\bnext\\b', '\\bmore\\b', '\\bnewer\\b', '\\b[>→≫]\\b', '\\b(>>|»)\\b', '\\bcontinue\\b']
 
+## Padding (in pixels) for hints.
+## Type: Padding
+# c.hints.padding = {'top': 0, 'bottom': 0, 'left': 3, 'right': 3}
+
 ## Comma-separated list of regular expressions to use for 'prev' links.
 ## Type: List of Regex
 # c.hints.prev_regexes = ['\\bprev(ious)?\\b', '\\bback\\b', '\\bolder\\b', '\\b[<←≪]\\b', '\\b(<<|«)\\b']
 
 ## Comma-separated list of regular expressions to use for 'prev' links.
 ## Type: List of Regex
 # c.hints.prev_regexes = ['\\bprev(ious)?\\b', '\\bback\\b', '\\bolder\\b', '\\b[<←≪]\\b', '\\b(<<|«)\\b']
 
+## Rounding radius (in pixels) for the edges of hints.
+## Type: Int
+# c.hints.radius = 3
+
 ## Scatter hint key chains (like Vimium) or not (like dwb). Ignored for
 ## number hints.
 ## Type: Bool
 c.hints.scatter = False
 
 ## Scatter hint key chains (like Vimium) or not (like dwb). Ignored for
 ## number hints.
 ## Type: Bool
 c.hints.scatter = False
 
+## CSS selectors used to determine which elements on a page should have
+## hints.
+## Type: Dict
+# c.hints.selectors = {'all': ['a', 'area', 'textarea', 'select', 'input:not([type="hidden"])', 'button', 'frame', 'iframe', 'img', 'link', 'summary', '[onclick]', '[onmousedown]', '[role="link"]', '[role="option"]', '[role="button"]', '[ng-click]', '[ngClick]', '[data-ng-click]', '[x-ng-click]', '[tabindex]'], 'links': ['a[href]', 'area[href]', 'link[href]', '[role="link"][href]'], 'images': ['img'], 'media': ['audio', 'img', 'video'], 'url': ['[src]', '[href]'], 'inputs': ['input[type="text"]', 'input[type="date"]', 'input[type="datetime-local"]', 'input[type="email"]', 'input[type="month"]', 'input[type="number"]', 'input[type="password"]', 'input[type="search"]', 'input[type="tel"]', 'input[type="time"]', 'input[type="url"]', 'input[type="week"]', 'input:not([type])', 'textarea']}
+
 ## Make characters in hint strings uppercase.
 ## Type: Bool
 # c.hints.uppercase = False
 ## Make characters in hint strings uppercase.
 ## Type: Bool
 # c.hints.uppercase = False
@@ -917,6 +1143,10 @@ c.hints.scatter = False
 ## Type: Int
 # c.history_gap_interval = 30
 
 ## Type: Int
 # c.history_gap_interval = 30
 
+## Allow Escape to quit the crash reporter.
+## Type: Bool
+# c.input.escape_quits_reporter = True
+
 ## Which unbound keys to forward to the webview in normal mode.
 ## Type: String
 ## Valid values:
 ## Which unbound keys to forward to the webview in normal mode.
 ## Type: String
 ## Valid values:
@@ -938,6 +1168,12 @@ c.hints.scatter = False
 ## Type: Bool
 # c.input.insert_mode.auto_load = False
 
 ## Type: Bool
 # c.input.insert_mode.auto_load = False
 
+## Leave insert mode when starting a new page load. Patterns may be
+## unreliable on this setting, and they may match the url you are
+## navigating to, or the URL you are navigating from.
+## Type: Bool
+# c.input.insert_mode.leave_on_load = True
+
 ## Switch to insert mode when clicking flash and other plugins.
 ## Type: Bool
 # c.input.insert_mode.plugins = False
 ## Switch to insert mode when clicking flash and other plugins.
 ## Type: Bool
 # c.input.insert_mode.plugins = False
@@ -1000,7 +1236,7 @@ c.hints.scatter = False
 # c.new_instance_open_target = 'tab'
 
 ## Which window to choose when opening links as new tabs. When
 # c.new_instance_open_target = 'tab'
 
 ## Which window to choose when opening links as new tabs. When
-## `new_instance_open_target` is not set to `window`, this is ignored.
+## `new_instance_open_target` is set to `window`, this is ignored.
 ## Type: String
 ## Valid values:
 ##   - first-opened: Open new tabs in the first (oldest) opened window.
 ## Type: String
 ## Valid values:
 ##   - first-opened: Open new tabs in the first (oldest) opened window.
@@ -1009,7 +1245,7 @@ c.hints.scatter = False
 ##   - last-visible: Open new tabs in the most recently visible window.
 # c.new_instance_open_target_window = 'last-focused'
 
 ##   - last-visible: Open new tabs in the most recently visible window.
 # c.new_instance_open_target_window = 'last-focused'
 
-## Show a filebrowser in upload/download prompts.
+## Show a filebrowser in download prompts.
 ## Type: Bool
 # c.prompt.filebrowser = True
 
 ## Type: Bool
 # c.prompt.filebrowser = True
 
@@ -1030,21 +1266,60 @@ c.hints.scatter = False
 ## Type: String
 # c.qt.force_platform = None
 
 ## Type: String
 # c.qt.force_platform = None
 
+## Force a Qt platformtheme to use. This sets the `QT_QPA_PLATFORMTHEME`
+## environment variable which controls dialogs like the filepicker. By
+## default, Qt determines the platform theme based on the desktop
+## environment.
+## Type: String
+# c.qt.force_platformtheme = None
+
 ## Force software rendering for QtWebEngine. This is needed for
 ## Force software rendering for QtWebEngine. This is needed for
-## QtWebEngine to work with Nouveau drivers.
-## Type: Bool
-# c.qt.force_software_rendering = False
+## QtWebEngine to work with Nouveau drivers and can be useful in other
+## scenarios related to graphic issues.
+## Type: String
+## Valid values:
+##   - software-opengl: Tell LibGL to use a software implementation of GL (`LIBGL_ALWAYS_SOFTWARE` / `QT_XCB_FORCE_SOFTWARE_OPENGL`)
+##   - qt-quick: Tell Qt Quick to use a software renderer instead of OpenGL. (`QT_QUICK_BACKEND=software`)
+##   - chromium: Tell Chromium to disable GPU support and use Skia software rendering instead. (`--disable-gpu`)
+##   - none: Don't force software rendering.
+# c.qt.force_software_rendering = 'none'
 
 ## Turn on Qt HighDPI scaling. This is equivalent to setting
 
 ## Turn on Qt HighDPI scaling. This is equivalent to setting
-## QT_AUTO_SCREEN_SCALE_FACTOR=1 in the environment. It's off by default
-## as it can cause issues with some bitmap fonts. As an alternative to
-## this, it's possible to set font sizes and the `zoom.default` setting.
+## QT_AUTO_SCREEN_SCALE_FACTOR=1 or QT_ENABLE_HIGHDPI_SCALING=1 (Qt >=
+## 5.14) in the environment. It's off by default as it can cause issues
+## with some bitmap fonts. As an alternative to this, it's possible to
+## set font sizes and the `zoom.default` setting.
 ## Type: Bool
 # c.qt.highdpi = False
 
 ## Type: Bool
 # c.qt.highdpi = False
 
-## Show a scrollbar.
-## Type: Bool
-# c.scrolling.bar = False
+## When to use Chromium's low-end device mode. This improves the RAM
+## usage of renderer processes, at the expense of performance.
+## Type: String
+## Valid values:
+##   - always: Always use low-end device mode.
+##   - auto: Decide automatically (uses low-end mode with < 1 GB available RAM).
+##   - never: Never use low-end device mode.
+# c.qt.low_end_device_mode = 'auto'
+
+## Which Chromium process model to use. Alternative process models use
+## less resources, but decrease security and robustness. See the
+## following pages for more details:    -
+## https://www.chromium.org/developers/design-documents/process-models
+## - https://doc.qt.io/qt-5/qtwebengine-features.html#process-models
+## Type: String
+## Valid values:
+##   - process-per-site-instance: Pages from separate sites are put into separate processes and separate visits to the same site are also isolated.
+##   - 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.
+##   - single-process: Run all tabs in a single process. This should be used for debugging purposes only, and it disables `:open --private`.
+# c.qt.process_model = 'process-per-site-instance'
+
+## When to show the scrollbar.
+## Type: String
+## Valid values:
+##   - always: Always show the scrollbar.
+##   - never: Never show the scrollbar.
+##   - when-searching: Show the scrollbar when searching for text in the webpage. With the QtWebKit backend, this is equal to `never`.
+c.scrolling.bar = 'when-searching'
 
 ## Enable smooth scrolling for web pages. Note smooth scrolling does not
 ## work with the `:scroll-px` command.
 
 ## Enable smooth scrolling for web pages. Note smooth scrolling does not
 ## work with the `:scroll-px` command.
@@ -1052,7 +1327,7 @@ c.hints.scatter = False
 # c.scrolling.smooth = False
 
 ## When to find text on a page case-insensitively.
 # c.scrolling.smooth = False
 
 ## When to find text on a page case-insensitively.
-## Type: String
+## Type: IgnoreCase
 ## Valid values:
 ##   - always: Search case-insensitively.
 ##   - never: Search case-sensitively.
 ## Valid values:
 ##   - always: Search case-insensitively.
 ##   - never: Search case-sensitively.
@@ -1064,6 +1339,11 @@ c.hints.scatter = False
 ## Type: Bool
 # c.search.incremental = True
 
 ## Type: Bool
 # c.search.incremental = True
 
+## Wrap around at the top and bottom of the page when advancing through
+## text matches using `:search-next` and `:search-prev`.
+## Type: Bool
+# c.search.wrap = True
+
 ## Name of the session to save by default. If this is set to null, the
 ## session which was last loaded is saved.
 ## Type: SessionName
 ## Name of the session to save by default. If this is set to null, the
 ## session which was last loaded is saved.
 ## Type: SessionName
@@ -1121,7 +1401,7 @@ c.session.lazy_restore = True
 ##   - tr-TR: Turkish (Turkey)
 ##   - uk-UA: Ukrainian (Ukraine)
 ##   - vi-VN: Vietnamese (Viet Nam)
 ##   - tr-TR: Turkish (Turkey)
 ##   - uk-UA: Ukrainian (Ukraine)
 ##   - vi-VN: Vietnamese (Viet Nam)
-# c.spellcheck.languages = []
+c.spellcheck.languages = ['en-GB']
 
 ## Hide the statusbar unless a message is shown.
 ## Type: Bool
 
 ## Hide the statusbar unless a message is shown.
 ## Type: Bool
@@ -1184,6 +1464,10 @@ c.session.lazy_restore = True
 ##   - pinned: Show favicons only on pinned tabs.
 # c.tabs.favicons.show = 'always'
 
 ##   - pinned: Show favicons only on pinned tabs.
 # c.tabs.favicons.show = 'always'
 
+## Maximum stack size to remember for tab switches (-1 for no maximum).
+## Type: Int
+# c.tabs.focus_stack_size = 10
+
 ## Padding (in pixels) for tab indicators.
 ## Type: Padding
 # c.tabs.indicator.padding = {'top': 2, 'bottom': 2, 'left': 0, 'right': 4}
 ## Padding (in pixels) for tab indicators.
 ## Type: Padding
 # c.tabs.indicator.padding = {'top': 2, 'bottom': 2, 'left': 0, 'right': 4}
@@ -1202,6 +1486,14 @@ c.session.lazy_restore = True
 ##   - close: Close the window.
 # c.tabs.last_close = 'ignore'
 
 ##   - close: Close the window.
 # c.tabs.last_close = 'ignore'
 
+## Maximum width (in pixels) of tabs (-1 for no maximum). This setting
+## only applies when tabs are horizontal. This setting does not apply to
+## pinned tabs, unless `tabs.pinned.shrink` is False. This setting may
+## not apply properly if max_width is smaller than the minimum size of
+## tab contents, or smaller than tabs.min_width.
+## Type: Int
+# c.tabs.max_width = -1
+
 ## Minimum width (in pixels) of tabs (-1 for the default minimum size
 ## behavior). This setting only applies when tabs are horizontal. This
 ## setting does not apply to pinned tabs, unless `tabs.pinned.shrink` is
 ## Minimum width (in pixels) of tabs (-1 for the default minimum size
 ## behavior). This setting only applies when tabs are horizontal. This
 ## setting does not apply to pinned tabs, unless `tabs.pinned.shrink` is
@@ -1221,7 +1513,8 @@ c.session.lazy_restore = True
 ## Type: Bool
 # c.tabs.mousewheel_switching = True
 
 ## Type: Bool
 # c.tabs.mousewheel_switching = True
 
-## Position of new tabs opened from another tab.
+## Position of new tabs opened from another tab. See
+## `tabs.new_position.stacking` for controlling stacking behavior.
 ## Type: NewTabPosition
 ## Valid values:
 ##   - prev: Before the current tab.
 ## Type: NewTabPosition
 ## Valid values:
 ##   - prev: Before the current tab.
@@ -1230,7 +1523,14 @@ c.session.lazy_restore = True
 ##   - last: At the end.
 # c.tabs.new_position.related = 'next'
 
 ##   - last: At the end.
 # c.tabs.new_position.related = 'next'
 
-## Position of new tabs which aren't opened from another tab.
+## Stack related tabs on top of each other when opened consecutively.
+## Only applies for `next` and `prev` values of
+## `tabs.new_position.related` and `tabs.new_position.unrelated`.
+## Type: Bool
+# c.tabs.new_position.stacking = True
+
+## Position of new tabs which are not opened from another tab. See
+## `tabs.new_position.stacking` for controlling stacking behavior.
 ## Type: NewTabPosition
 ## Valid values:
 ##   - prev: Before the current tab.
 ## Type: NewTabPosition
 ## Valid values:
 ##   - prev: Before the current tab.
@@ -1243,6 +1543,10 @@ c.tabs.new_position.unrelated = 'next'
 ## Type: Padding
 # c.tabs.padding = {'top': 0, 'bottom': 0, 'left': 5, 'right': 5}
 
 ## Type: Padding
 # c.tabs.padding = {'top': 0, 'bottom': 0, 'left': 5, 'right': 5}
 
+## Force pinned tabs to stay at fixed URL.
+## Type: Bool
+# c.tabs.pinned.frozen = True
+
 ## Shrink pinned tabs down to their contents.
 ## Type: Bool
 # c.tabs.pinned.shrink = True
 ## Shrink pinned tabs down to their contents.
 ## Type: Bool
 # c.tabs.pinned.shrink = True
@@ -1291,23 +1595,38 @@ c.tabs.select_on_remove = 'prev'
 # c.tabs.title.alignment = 'left'
 
 ## Format to use for the tab title. The following placeholders are
 # c.tabs.title.alignment = 'left'
 
 ## Format to use for the tab title. The following placeholders are
-## defined:  * `{perc}`: Percentage as a string like `[10%]`. *
-## `{perc_raw}`: Raw percentage, e.g. `10`. * `{title}`: Title of the
-## current web page. * `{title_sep}`: The string ` - ` if a title is set,
-## empty otherwise. * `{index}`: Index of this tab. * `{id}`: Internal
-## tab ID of this tab. * `{scroll_pos}`: Page scroll position. *
-## `{host}`: Host of the current web page. * `{backend}`: Either
-## ''webkit'' or ''webengine'' * `{private}`: Indicates when private mode
-## is enabled. * `{current_url}`: URL of the current web page. *
-## `{protocol}`: Protocol (http/https/...) of the current web page.
+## defined:
+##   * `{perc}`: Percentage as a string like `[10%]`.
+##   * `{perc_raw}`: Raw percentage, e.g. `10`.
+##   * `{current_title}`: Title of the current web page.
+##   * `{title_sep}`: The string ` - ` if a title is set, empty otherwise.
+##   * `{index}`: Index of this tab.
+##   * `{id}`: Internal tab ID of this tab.
+##   * `{scroll_pos}`: Page scroll position.
+##   * `{host}`: Host of the current web page.
+##   * `{backend}`: Either ''webkit'' or ''webengine''
+##   * `{private}`: Indicates when private mode is enabled.
+##   * `{current_url}`: URL of the current web page.
+##   * `{protocol}`: Protocol (http/https/...) of the current web page.
+##   * `{audio}`: Indicator for audio/mute status.
 ## Type: FormatString
 ## Type: FormatString
-# c.tabs.title.format = '{index}: {title}'
+# c.tabs.title.format = '{audio}{index}: {current_title}'
 
 ## Format to use for the tab title for pinned tabs. The same placeholders
 ## like for `tabs.title.format` are defined.
 ## Type: FormatString
 # c.tabs.title.format_pinned = '{index}'
 
 
 ## Format to use for the tab title for pinned tabs. The same placeholders
 ## like for `tabs.title.format` are defined.
 ## Type: FormatString
 # c.tabs.title.format_pinned = '{index}'
 
+## Show tooltips on tabs. Note this setting only affects windows opened
+## after it has been set.
+## Type: Bool
+# c.tabs.tooltips = True
+
+## Number of close tab actions to remember, per window (-1 for no
+## maximum).
+## Type: Int
+# c.tabs.undo_stack_size = 100
+
 ## Width (in pixels or as percentage of the window) of the tab bar if
 ## it's vertical.
 ## Type: PercOrInt
 ## Width (in pixels or as percentage of the window) of the tab bar if
 ## it's vertical.
 ## Type: PercOrInt
@@ -1346,21 +1665,30 @@ c.url.default_page = 'https://duckduckgo.com/?t=chakra'
 ## Type: Bool
 # c.url.open_base_url = False
 
 ## Type: Bool
 # c.url.open_base_url = False
 
-## Search engines which can be used via the address bar. Maps a search
+## Search engines which can be used via the address bar.  Maps a search
 ## engine name (such as `DEFAULT`, or `ddg`) to a URL with a `{}`
 ## placeholder. The placeholder will be replaced by the search term, use
 ## engine name (such as `DEFAULT`, or `ddg`) to a URL with a `{}`
 ## placeholder. The placeholder will be replaced by the search term, use
-## `{{` and `}}` for literal `{`/`}` signs. The search engine named
-## `DEFAULT` is used when `url.auto_search` is turned on and something
-## else than a URL was entered to be opened. Other search engines can be
-## used by prepending the search engine name to the search term, e.g.
-## `:open google qutebrowser`.
+## `{{` and `}}` for literal `{`/`}` braces.  The following further
+## placeholds are defined to configure how special characters in the
+## search terms are replaced by safe characters (called 'quoting'):
+##  * `{}` and `{semiquoted}` quote everything except slashes; this is the
+##    most sensible choice for almost all search engines (for the search
+##    term `slash/and&amp` this placeholder expands to `slash/and%26amp`).
+##  * `{quoted}` quotes all characters (for `slash/and&amp` this
+##    placeholder   expands to `slash%2Fand%26amp`).
+##  * `{unquoted}` quotes nothing (for `slash/and&amp` this placeholder
+##    expands to `slash/and&amp`).
+## The search engine named `DEFAULT` is used when
+## `url.auto_search` is turned on and something else than a URL was
+## entered to be opened. Other search engines can be used by prepending
+## the search engine name to the search term, e.g.  `:open google
+## qutebrowser`.
 ## Type: Dict
 c.url.searchengines = {'DEFAULT': 'https://duckduckgo.com/?t=chakra&q={}',
                        'ddg':     'https://duckduckgo.com/?t=chakra&q={}',
                        'slack':   'https://focalpointpositioning.slack.com/messages/{}',
 ## Type: Dict
 c.url.searchengines = {'DEFAULT': 'https://duckduckgo.com/?t=chakra&q={}',
                        'ddg':     'https://duckduckgo.com/?t=chakra&q={}',
                        'slack':   'https://focalpointpositioning.slack.com/messages/{}',
-                       'pcl':     'http://docs.pointclouds.org/trunk/search.php?query={}',
                        'std':     'http://en.cppreference.com/mwiki/index.php?title=Special%3ASearch&search={}',
                        'std':     'http://en.cppreference.com/mwiki/index.php?title=Special%3ASearch&search={}',
-                       'cv':      'http://docs.opencv.org/3.1.0/index.html#gsc.tab=0&gsc.ref=more%3A3.1&gsc.q={}' }
+                      }
 
 ## Page(s) to open at the start.
 ## Type: List of FuzzyUrl, or FuzzyUrl
 
 ## Page(s) to open at the start.
 ## Type: List of FuzzyUrl, or FuzzyUrl
@@ -1378,7 +1706,7 @@ c.url.searchengines = {'DEFAULT': 'https://duckduckgo.com/?t=chakra&q={}',
 ## Format to use for the window title. The same placeholders like for
 ## `tabs.title.format` are defined.
 ## Type: FormatString
 ## Format to use for the window title. The same placeholders like for
 ## `tabs.title.format` are defined.
 ## Type: FormatString
-# c.window.title_format = '{perc}{title}{title_sep}qutebrowser'
+# c.window.title_format = '{perc}{current_title}{title_sep}qutebrowser'
 
 ## Default zoom level.
 ## Type: Perc
 
 ## Default zoom level.
 ## Type: Perc
@@ -1416,7 +1744,6 @@ c.url.searchengines = {'DEFAULT': 'https://duckduckgo.com/?t=chakra&q={}',
 # config.bind(';r', 'hint --rapid links tab-bg')
 # config.bind(';t', 'hint inputs')
 # config.bind(';y', 'hint links yank')
 # config.bind(';r', 'hint --rapid links tab-bg')
 # config.bind(';t', 'hint inputs')
 # config.bind(';y', 'hint links yank')
-config.bind('M', 'hint links spawn mpv {hint-url}')
 # config.bind('<Alt-1>', 'tab-focus 1')
 # config.bind('<Alt-2>', 'tab-focus 2')
 # config.bind('<Alt-3>', 'tab-focus 3')
 # config.bind('<Alt-1>', 'tab-focus 1')
 # config.bind('<Alt-2>', 'tab-focus 2')
 # config.bind('<Alt-3>', 'tab-focus 3')
@@ -1426,6 +1753,7 @@ config.bind('M', 'hint links spawn mpv {hint-url}')
 # config.bind('<Alt-7>', 'tab-focus 7')
 # config.bind('<Alt-8>', 'tab-focus 8')
 # config.bind('<Alt-9>', 'tab-focus -1')
 # config.bind('<Alt-7>', 'tab-focus 7')
 # config.bind('<Alt-8>', 'tab-focus 8')
 # config.bind('<Alt-9>', 'tab-focus -1')
+# config.bind('<Alt-m>', 'tab-mute')
 # config.bind('<Ctrl-A>', 'navigate increment')
 # config.bind('<Ctrl-Alt-p>', 'print')
 # config.bind('<Ctrl-B>', 'scroll-page 0 -1')
 # config.bind('<Ctrl-A>', 'navigate increment')
 # config.bind('<Ctrl-Alt-p>', 'print')
 # config.bind('<Ctrl-B>', 'scroll-page 0 -1')
@@ -1439,6 +1767,7 @@ config.bind('M', 'hint links spawn mpv {hint-url}')
 # config.bind('<Ctrl-Return>', 'follow-selected -t')
 # config.bind('<Ctrl-Shift-N>', 'open -p')
 # config.bind('<Ctrl-Shift-T>', 'undo')
 # config.bind('<Ctrl-Return>', 'follow-selected -t')
 # config.bind('<Ctrl-Shift-N>', 'open -p')
 # config.bind('<Ctrl-Shift-T>', 'undo')
+# config.bind('<Ctrl-Shift-Tab>', 'nop')
 # config.bind('<Ctrl-Shift-W>', 'close')
 # config.bind('<Ctrl-T>', 'open -t')
 # config.bind('<Ctrl-Tab>', 'tab-focus last')
 # config.bind('<Ctrl-Shift-W>', 'close')
 # config.bind('<Ctrl-T>', 'open -t')
 # config.bind('<Ctrl-Tab>', 'tab-focus last')
@@ -1494,6 +1823,7 @@ config.bind('co', 'download-open')
 # config.bind('g0', 'tab-focus 1')
 # config.bind('gB', 'set-cmd-text -s :bookmark-load -t')
 # config.bind('gC', 'tab-clone')
 # config.bind('g0', 'tab-focus 1')
 # config.bind('gB', 'set-cmd-text -s :bookmark-load -t')
 # config.bind('gC', 'tab-clone')
+# config.bind('gD', 'tab-give')
 # config.bind('gO', 'set-cmd-text :open -t -r {url:pretty}')
 # config.bind('gU', 'navigate up -t')
 # config.bind('g^', 'tab-focus 1')
 # config.bind('gO', 'set-cmd-text :open -t -r {url:pretty}')
 # config.bind('gU', 'navigate up -t')
 # config.bind('g^', 'tab-focus 1')
@@ -1526,6 +1856,13 @@ config.bind('m', 'spawn mpv {url}')
 # config.bind('sk', 'set-cmd-text -s :bind')
 # config.bind('sl', 'set-cmd-text -s :set -t')
 # config.bind('ss', 'set-cmd-text -s :set')
 # config.bind('sk', 'set-cmd-text -s :bind')
 # config.bind('sl', 'set-cmd-text -s :set -t')
 # config.bind('ss', 'set-cmd-text -s :set')
+config.bind('tCH', 'spawn --userscript config-cycle-tld -p    content.cookies.accept no-3rdparty never;; reload')
+config.bind('tCh', 'spawn --userscript config-cycle-tld -p    content.cookies.accept no-3rdparty never;; reload')
+config.bind('tcH', 'spawn --userscript config-cycle-tld -p -t content.cookies.accept no-3rdparty never;; reload')
+config.bind('tch', 'spawn --userscript config-cycle-tld -p -t content.cookies.accept no-3rdparty never;; reload')
+# config.bind('tIH', 'config-cycle -p -u *://*.{url:host}/* content.images ;; reload')
+# config.bind('tIh', 'config-cycle -p -u *://{url:host}/* content.images ;; reload')
+# config.bind('tIu', 'config-cycle -p -u {url} content.images ;; reload')
 # config.bind('tPH', 'config-cycle -p -u *://*.{url:host}/* content.plugins ;; reload')
 # config.bind('tPh', 'config-cycle -p -u *://{url:host}/* content.plugins ;; reload')
 # config.bind('tPu', 'config-cycle -p -u {url} content.plugins ;; reload')
 # config.bind('tPH', 'config-cycle -p -u *://*.{url:host}/* content.plugins ;; reload')
 # config.bind('tPh', 'config-cycle -p -u *://{url:host}/* content.plugins ;; reload')
 # config.bind('tPu', 'config-cycle -p -u {url} content.plugins ;; reload')
@@ -1533,6 +1870,9 @@ config.bind('m', 'spawn mpv {url}')
 # config.bind('tSh', 'config-cycle -p -u *://{url:host}/* content.javascript.enabled ;; reload')
 # config.bind('tSu', 'config-cycle -p -u {url} content.javascript.enabled ;; reload')
 # config.bind('th', 'back -t')
 # config.bind('tSh', 'config-cycle -p -u *://{url:host}/* content.javascript.enabled ;; reload')
 # config.bind('tSu', 'config-cycle -p -u {url} content.javascript.enabled ;; reload')
 # config.bind('th', 'back -t')
+# config.bind('tiH', 'config-cycle -p -t -u *://*.{url:host}/* content.images ;; reload')
+# config.bind('tih', 'config-cycle -p -t -u *://{url:host}/* content.images ;; reload')
+# config.bind('tiu', 'config-cycle -p -t -u {url} content.images ;; reload')
 # config.bind('tl', 'forward -t')
 # config.bind('tpH', 'config-cycle -p -t -u *://*.{url:host}/* content.plugins ;; reload')
 # config.bind('tph', 'config-cycle -p -t -u *://{url:host}/* content.plugins ;; reload')
 # config.bind('tl', 'forward -t')
 # config.bind('tpH', 'config-cycle -p -t -u *://*.{url:host}/* content.plugins ;; reload')
 # config.bind('tph', 'config-cycle -p -t -u *://{url:host}/* content.plugins ;; reload')
@@ -1555,10 +1895,12 @@ config.bind('m', 'spawn mpv {url}')
 # config.bind('xO', 'set-cmd-text :open -b -r {url:pretty}')
 # config.bind('xo', 'set-cmd-text -s :open -b')
 # config.bind('yD', 'yank domain -s')
 # config.bind('xO', 'set-cmd-text :open -b -r {url:pretty}')
 # config.bind('xo', 'set-cmd-text -s :open -b')
 # config.bind('yD', 'yank domain -s')
+# config.bind('yM', 'yank inline [{title}]({url}) -s')
 # config.bind('yP', 'yank pretty-url -s')
 # config.bind('yT', 'yank title -s')
 # config.bind('yY', 'yank -s')
 # config.bind('yd', 'yank domain')
 # config.bind('yP', 'yank pretty-url -s')
 # config.bind('yT', 'yank title -s')
 # config.bind('yY', 'yank -s')
 # config.bind('yd', 'yank domain')
+# config.bind('ym', 'yank inline [{title}]({url})')
 # config.bind('yp', 'yank pretty-url')
 # config.bind('yt', 'yank title')
 # config.bind('yy', 'yank')
 # config.bind('yp', 'yank pretty-url')
 # config.bind('yt', 'yank title')
 # config.bind('yy', 'yank')
@@ -1588,6 +1930,7 @@ config.bind('m', 'spawn mpv {url}')
 # config.bind('j', 'move-to-next-line', mode='caret')
 # config.bind('k', 'move-to-prev-line', mode='caret')
 # config.bind('l', 'move-to-next-char', mode='caret')
 # config.bind('j', 'move-to-next-line', mode='caret')
 # config.bind('k', 'move-to-prev-line', mode='caret')
 # config.bind('l', 'move-to-next-char', mode='caret')
+# config.bind('o', 'reverse-selection', mode='caret')
 # config.bind('v', 'toggle-selection', mode='caret')
 # config.bind('w', 'move-to-next-word', mode='caret')
 # config.bind('y', 'yank selection', mode='caret')
 # config.bind('v', 'toggle-selection', mode='caret')
 # config.bind('w', 'move-to-next-word', mode='caret')
 # config.bind('y', 'yank selection', mode='caret')
@@ -1635,10 +1978,10 @@ config.bind('m', 'spawn mpv {url}')
 ## Bindings for insert mode
 # config.bind('<Ctrl-E>', 'open-editor', mode='insert')
 # config.bind('<Escape>', 'leave-mode', mode='insert')
 ## Bindings for insert mode
 # config.bind('<Ctrl-E>', 'open-editor', mode='insert')
 # config.bind('<Escape>', 'leave-mode', mode='insert')
-# config.bind('<Shift-Ins>', 'insert-text {primary}', mode='insert')
+# config.bind('<Shift-Ins>', 'insert-text -- {primary}', mode='insert')
 
 ## Bindings for passthrough mode
 
 ## Bindings for passthrough mode
-# config.bind('<Ctrl-V>', 'leave-mode', mode='passthrough')
+# config.bind('<Shift-Escape>', 'leave-mode', mode='passthrough')
 
 ## Bindings for prompt mode
 # config.bind('<Alt-B>', 'rl-backward-word', mode='prompt')
 
 ## Bindings for prompt mode
 # config.bind('<Alt-B>', 'rl-backward-word', mode='prompt')
@@ -1654,6 +1997,7 @@ config.bind('m', 'spawn mpv {url}')
 # config.bind('<Ctrl-F>', 'rl-forward-char', mode='prompt')
 # config.bind('<Ctrl-H>', 'rl-backward-delete-char', mode='prompt')
 # config.bind('<Ctrl-K>', 'rl-kill-line', mode='prompt')
 # config.bind('<Ctrl-F>', 'rl-forward-char', mode='prompt')
 # config.bind('<Ctrl-H>', 'rl-backward-delete-char', mode='prompt')
 # config.bind('<Ctrl-K>', 'rl-kill-line', mode='prompt')
+# config.bind('<Ctrl-P>', 'prompt-open-download --pdfjs', mode='prompt')
 # config.bind('<Ctrl-U>', 'rl-unix-line-discard', mode='prompt')
 # config.bind('<Ctrl-W>', 'rl-unix-word-rubout', mode='prompt')
 # config.bind('<Ctrl-X>', 'prompt-open-download', mode='prompt')
 # config.bind('<Ctrl-U>', 'rl-unix-line-discard', mode='prompt')
 # config.bind('<Ctrl-W>', 'rl-unix-word-rubout', mode='prompt')
 # config.bind('<Ctrl-X>', 'prompt-open-download', mode='prompt')
@@ -1673,5 +2017,7 @@ config.bind('m', 'spawn mpv {url}')
 # config.bind('<Alt-Y>', 'prompt-yank', mode='yesno')
 # config.bind('<Escape>', 'leave-mode', mode='yesno')
 # config.bind('<Return>', 'prompt-accept', mode='yesno')
 # config.bind('<Alt-Y>', 'prompt-yank', mode='yesno')
 # config.bind('<Escape>', 'leave-mode', mode='yesno')
 # config.bind('<Return>', 'prompt-accept', mode='yesno')
+# config.bind('N', 'prompt-accept --save no', mode='yesno')
+# config.bind('Y', 'prompt-accept --save yes', mode='yesno')
 # config.bind('n', 'prompt-accept no', mode='yesno')
 # config.bind('y', 'prompt-accept yes', mode='yesno')
 # config.bind('n', 'prompt-accept no', mode='yesno')
 # config.bind('y', 'prompt-accept yes', mode='yesno')