|<<storage-download-directory,download-directory>>|The directory to save downloads to. An empty value selects a sensible os-specific default.
|<<storage-maximum-pages-in-cache,maximum-pages-in-cache>>|The maximum number of pages to hold in the memory page cache.
|<<storage-object-cache-capacities,object-cache-capacities>>|The capacities for the memory cache for dead objects such as stylesheets or scripts. Syntax: cacheMinDeadCapacity, cacheMaxDead, totalCapacity.
|<<storage-offline-storage-default-quota,offline-storage-default-quota>>|Default quota for new offline storage databases.
|<<storage-offline-web-application-cache-quota,offline-web-application-cache-quota>>|Quota for the offline web application cache.
|<<storage-offline-storage-database,offline-storage-database>>|Whether support for the HTML 5 offline storage feature is enabled.
|<<storage-offline-web-application-storage,offline-web-application-storage>>|Whether support for the HTML 5 web application cache feature is enabled.
|<<storage-local-storage,local-storage>>|Whether support for the HTML 5 local storage feature is enabled.
|<<storage-cache-size,cache-size>>|Size of the HTTP network cache.
|<<permissions-allow-images,allow-images>>|Whether images are automatically loaded in web pages.
|<<permissions-allow-javascript,allow-javascript>>|Enables or disables the running of JavaScript programs.
|<<permissions-allow-plugins,allow-plugins>>|Enables or disables plugins in Web pages.
|<<permissions-javascript-can-open-windows,javascript-can-open-windows>>|Whether JavaScript programs can open new windows.
|<<permissions-javascript-can-close-windows,javascript-can-close-windows>>|Whether JavaScript programs can close windows.
|<<permissions-javascript-can-access-clipboard,javascript-can-access-clipboard>>|Whether JavaScript programs can read or write to the clipboard.
|<<permissions-local-content-can-access-remote-urls,local-content-can-access-remote-urls>>|Whether locally loaded documents are allowed to access remote urls.
|<<permissions-local-content-can-access-file-urls,local-content-can-access-file-urls>>|Whether locally loaded documents are allowed to access other local urls.
|<<permissions-cookies-accept,cookies-accept>>|Whether to accept cookies.
|<<permissions-cookies-store,cookies-store>>|Whether to store cookies.
In addition to the listed values, you can use a `socks://...` or `http://...` URL.
Valid values:
* +system+: Use the system wide proxy.
* +none+: Don't use any proxy
Default: +pass:[system]+
[[network-ssl-strict]]
=== ssl-strict
Whether to validate SSL handshakes.
Default: +pass:[true]+
[[network-dns-prefetch]]
=== dns-prefetch
Whether to try to pre-fetch DNS entries to speed up browsing.
Default: +pass:[true]+
== completion
Options related to completion and command history.
[[completion-show]]
=== show
Whether to show the autocompletion window.
Default: +pass:[true]+
[[completion-height]]
=== height
The height of the completion, in px or as percentage of the window.
Default: +pass:[50%]+
[[completion-history-length]]
=== history-length
How many commands to save in the history.
0: no history / -1: unlimited
Default: +pass:[100]+
[[completion-quick-complete]]
=== quick-complete
Whether to move on to the next part when there's only one possible completion left.
Default: +pass:[true]+
[[completion-shrink]]
=== shrink
Whether to shrink the completion to be smaller than the configured size if there are no scrollbars.
Default: +pass:[false]+
== input
Options related to input modes.
[[input-timeout]]
=== timeout
Timeout for ambiguous keybindings.
Default: +pass:[500]+
[[input-insert-mode-on-plugins]]
=== insert-mode-on-plugins
Whether to switch to insert mode when clicking flash and other plugins.
Default: +pass:[false]+
[[input-auto-leave-insert-mode]]
=== auto-leave-insert-mode
Whether to leave insert mode if a non-editable element is clicked.
Default: +pass:[true]+
[[input-auto-insert-mode]]
=== auto-insert-mode
Whether to automatically enter insert mode if an editable element is focused after page load.
Default: +pass:[false]+
[[input-forward-unbound-keys]]
=== forward-unbound-keys
Whether to forward unbound keys to the webview in normal mode.
Valid values:
* +all+: Forward all unbound keys.
* +auto+: Forward unbound non-alphanumeric keys.
* +none+: Don't forward any keys.
Default: +pass:[auto]+
[[input-spatial-navigation]]
=== spatial-navigation
Enables or disables the Spatial Navigation feature
Spatial navigation consists in the ability to navigate between focusable elements in a Web page, such as hyperlinks and form controls, by using Left, Right, Up and Down arrow keys. For example, if a user presses the Right key, heuristics determine whether there is an element he might be trying to reach towards the right and which element he probably wants.
Default: +pass:[false]+
[[input-links-included-in-focus-chain]]
=== links-included-in-focus-chain
Whether hyperlinks should be included in the keyboard focus chain.
Default: +pass:[true]+
== tabs
Configuration of the tab bar.
[[tabs-background-tabs]]
=== background-tabs
Whether to open new tabs (middleclick/ctrl+click) in background.
Default: +pass:[false]+
[[tabs-select-on-remove]]
=== select-on-remove
Which tab to select when the focused tab is removed.
The width of the tab bar if it's vertical, in px or as percentage of the window.
Default: +pass:[20%]+
[[tabs-indicator-width]]
=== indicator-width
Width of the progress indicator (0 to disable).
Default: +pass:[3]+
[[tabs-indicator-space]]
=== indicator-space
Spacing between tab edge and indicator.
Default: +pass:[3]+
== storage
Settings related to cache and storage.
[[storage-download-directory]]
=== download-directory
The directory to save downloads to. An empty value selects a sensible os-specific default.
Default: empty
[[storage-maximum-pages-in-cache]]
=== maximum-pages-in-cache
The maximum number of pages to hold in the memory page cache.
The Page Cache allows for a nicer user experience when navigating forth or back to pages in the forward/back history, by pausing and resuming up to _n_ pages.
For more information about the feature, please refer to: http://webkit.org/blog/427/webkit-page-cache-i-the-basics/
Default: empty
[[storage-object-cache-capacities]]
=== object-cache-capacities
The capacities for the memory cache for dead objects such as stylesheets or scripts. Syntax: cacheMinDeadCapacity, cacheMaxDead, totalCapacity.
The _cacheMinDeadCapacity_ specifies the minimum number of bytes that dead objects should consume when the cache is under pressure.
_cacheMaxDead_ is the maximum number of bytes that dead objects should consume when the cache is *not* under pressure.
_totalCapacity_ specifies the maximum number of bytes that the cache should consume *overall*.
Default: empty
[[storage-offline-storage-default-quota]]
=== offline-storage-default-quota
Default quota for new offline storage databases.
Default: empty
[[storage-offline-web-application-cache-quota]]
=== offline-web-application-cache-quota
Quota for the offline web application cache.
Default: empty
[[storage-offline-storage-database]]
=== offline-storage-database
Whether support for the HTML 5 offline storage feature is enabled.
Default: +pass:[true]+
[[storage-offline-web-application-storage]]
=== offline-web-application-storage
Whether support for the HTML 5 web application cache feature is enabled.
An application cache acts like an HTTP cache in some sense. For documents that use the application cache via JavaScript, the loader engine will first ask the application cache for the contents, before hitting the network.
The feature is described in details at: http://dev.w3.org/html5/spec/Overview.html#appcache
Default: +pass:[true]+
[[storage-local-storage]]
=== local-storage
Whether support for the HTML 5 local storage feature is enabled.
Default: +pass:[true]+
[[storage-cache-size]]
=== cache-size
Size of the HTTP network cache.
Default: +pass:[52428800]+
== permissions
Loaded plugins/scripts and allowed actions.
[[permissions-allow-images]]
=== allow-images
Whether images are automatically loaded in web pages.
Default: +pass:[true]+
[[permissions-allow-javascript]]
=== allow-javascript
Enables or disables the running of JavaScript programs.
Default: +pass:[true]+
[[permissions-allow-plugins]]
=== allow-plugins
Enables or disables plugins in Web pages.
Qt plugins with a mimetype such as "application/x-qt-plugin" are not affected by this setting.
Default: +pass:[false]+
[[permissions-javascript-can-open-windows]]
=== javascript-can-open-windows
Whether JavaScript programs can open new windows.
Default: +pass:[false]+
[[permissions-javascript-can-close-windows]]
=== javascript-can-close-windows
Whether JavaScript programs can close windows.
Default: +pass:[false]+
[[permissions-javascript-can-access-clipboard]]
=== javascript-can-access-clipboard
Whether JavaScript programs can read or write to the clipboard.
Definitions of search engines which can be used via the address bar.
The searchengine named `DEFAULT` is used when `general -> auto-search` is true and something else than a URL was entered to be opened. Other search engines can be used via the bang-syntax, e.g. `:open qutebrowser !google`. The string `{}` will be replaced by the search term, use `{{` and `}}` for literal `{`/`}` signs.
== aliases
Aliases for commands.
By default, no aliases are defined. Example which adds a new command `:qtb` to open qutebrowsers website:
`qtb = open http://www.qutebrowser.org/`
== colors
Colors used in the UI.
A value can be in one of the following format:
* `#RGB`/`#RRGGBB`/`#RRRGGGBBB`/`#RRRRGGGGBBBB`
* A SVG color name as specified in http://www.w3.org/TR/SVG/types.html#ColorKeywords[the W3C specification].
* A gradient as explained in http://qt-project.org/doc/qt-4.8/stylesheet-reference.html#list-of-property-types[the Qt documentation] under ``Gradient''.
The `hints.*` values are a special case as they're real CSS colors, not Qt-CSS colors. There, for a gradient, you need to use `-webkit-gradient`, see https://www.webkit.org/blog/175/introducing-css-gradients/[the WebKit documentation].
[[colors-completion.fg]]
=== completion.fg
Text color of the completion widget.
Default: +pass:[white]+
[[colors-completion.bg]]
=== completion.bg
Background color of the completion widget.
Default: +pass:[#333333]+
[[colors-completion.item.bg]]
=== completion.item.bg
Background color of completion widget items.
Default: +pass:[${completion.bg}]+
[[colors-completion.category.fg]]
=== completion.category.fg
Foreground color of completion widget category headers.
Default: +pass:[white]+
[[colors-completion.category.bg]]
=== completion.category.bg
Background color of the completion widget category headers.
