= Settings .Quick reference for section ``general'' [options="header",width="75%",cols="25%,75%"] |============== |Setting|Description |<>|Whether to find text on a page case-insensitively. |<>|Whether to wrap finding text to the top when arriving at the end. |<>|The default page(s) to open at the start, separated by commas. |<>|The page to open if :open -t/-b/-w is used without URL. |<>|Whether to start a search when something else than a URL is entered. |<>|Whether to save the config automatically on quit. |<>|How often (in milliseconds) to auto-save config/cookies/etc. |<>|The editor (and arguments) to use for the `open-editor` command. |<>|Encoding to use for editor. |<>|Do not record visited pages in the history or store web page icons. |<>|Enable extra tools for Web developers. |<>|Whether the background color and images are also drawn when the page is printed. |<>|Whether load requests should be monitored for cross-site scripting attempts. |<>|Enable workarounds for broken sites. |<>|Default encoding to use for websites. |<>|How to open links in an existing instance if a new one is launched. |<>|Whether to log javascript console messages. |<>|Whether to always save the open pages. |============== .Quick reference for section ``ui'' [options="header",width="75%",cols="25%,75%"] |============== |Setting|Description |<>|The available zoom levels, separated by commas. |<>|The default zoom level. |<>|Time (in ms) to show messages in the statusbar for. |<>|Whether to confirm quitting the application. |<>|Whether to display javascript statusbar messages. |<>|Whether the zoom factor on a frame applies only to the text or to all content. |<>|Whether to expand each subframe to its contents. |<>|User stylesheet to use (absolute filename or CSS string). Will expand environment variables. |<>|Set the CSS media type. |<>|Whether to remove finished downloads automatically. |<>|Whether to hide the statusbar unless a message is shown. |<>|The format to use for the window title. The following placeholders are defined: |============== .Quick reference for section ``network'' [options="header",width="75%",cols="25%,75%"] |============== |Setting|Description |<>|Value to send in the `DNT` header. |<>|Value to send in the `accept-language` header. |<>|User agent to send. Empty to send the default. |<>|The proxy to use. |<>|Whether to send DNS requests over the configured proxy. |<>|Whether to validate SSL handshakes. |<>|Whether to try to pre-fetch DNS entries to speed up browsing. |============== .Quick reference for section ``completion'' [options="header",width="75%",cols="25%,75%"] |============== |Setting|Description |<>|What to display in the download filename input. |<>|Whether to show the autocompletion window. |<>|The height of the completion, in px or as percentage of the window. |<>|How many commands to save in the history. |<>|Whether to move on to the next part when there's only one possible completion left. |<>|Whether to shrink the completion to be smaller than the configured size if there are no scrollbars. |============== .Quick reference for section ``input'' [options="header",width="75%",cols="25%,75%"] |============== |Setting|Description |<>|Timeout for ambiguous keybindings. |<>|Timeout for partially typed keybindings. |<>|Whether to switch to insert mode when clicking flash and other plugins. |<>|Whether to leave insert mode if a non-editable element is clicked. |<>|Whether to automatically enter insert mode if an editable element is focused after page load. |<>|Whether to forward unbound keys to the webview in normal mode. |<>|Enables or disables the Spatial Navigation feature |<>|Whether hyperlinks should be included in the keyboard focus chain. |<>|Whether to enable Opera-like mouse rocker gestures. This disables the context menu. |============== .Quick reference for section ``tabs'' [options="header",width="75%",cols="25%,75%"] |============== |Setting|Description |<>|Whether to open new tabs (middleclick/ctrl+click) in background. |<>|Which tab to select when the focused tab is removed. |<>|How new tabs are positioned. |<>|How new tabs opened explicitely are positioned. |<>|Behaviour when the last tab is closed. |<>|Hide the tabbar if only one tab is open. |<>|Always hide the tabbar. |<>|Whether to wrap when changing tabs. |<>|Whether tabs should be movable. |<>|On which mouse button to close tabs. |<>|The position of the tab bar. |<>|Whether to show favicons in the tab bar. |<>|The width of the tab bar if it's vertical, in px or as percentage of the window. |<>|Width of the progress indicator (0 to disable). |<>|Spacing between tab edge and indicator. |<>|Whether to open windows instead of tabs. |<>|The format to use for the tab title. The following placeholders are defined: |============== .Quick reference for section ``storage'' [options="header",width="75%",cols="25%,75%"] |============== |Setting|Description |<>|The directory to save downloads to. An empty value selects a sensible os-specific default. Will expand environment variables. |<>|The maximum number of pages to hold in the memory page cache. |<>|The capacities for the memory cache for dead objects such as stylesheets or scripts. Syntax: cacheMinDeadCapacity, cacheMaxDead, totalCapacity. |<>|Default quota for new offline storage databases. |<>|Quota for the offline web application cache. |<>|Whether support for the HTML 5 offline storage feature is enabled. |<>|Whether support for the HTML 5 web application cache feature is enabled. |<>|Whether support for the HTML 5 local storage feature is enabled. |<>|Size of the HTTP network cache. |============== .Quick reference for section ``content'' [options="header",width="75%",cols="25%,75%"] |============== |Setting|Description |<>|Whether images are automatically loaded in web pages. |<>|Enables or disables the running of JavaScript programs. |<>|Enables or disables plugins in Web pages. |<>|Allow websites to request geolocations. |<>|Allow websites to show notifications. |<>|Whether JavaScript programs can open new windows. |<>|Whether JavaScript programs can close windows. |<>|Whether JavaScript programs can read or write to the clipboard. |<>|Whether all javascript prompts should be ignored. |<>|Whether all javascript alerts should be ignored. |<>|Whether locally loaded documents are allowed to access remote urls. |<>|Whether locally loaded documents are allowed to access other local urls. |<>|Whether to accept cookies. |<>|Whether to store cookies. |<>|List of URLs of lists which contain hosts to block. |============== .Quick reference for section ``hints'' [options="header",width="75%",cols="25%,75%"] |============== |Setting|Description |<>|CSS border value for hints. |<>|Opacity for hints. |<>|Mode to use for hints. |<>|Chars used for hint strings. |<>|Mininum number of chars used for hint strings. |<>|Whether to scatter hint key chains (like Vimium) or not (like dwb). |<>|Make chars in hint strings uppercase. |<>|Whether to auto-follow a hint if there's only one left. |<>|A comma-separated list of regexes to use for 'next' links. |<>|A comma-separated list of regexes to use for 'prev' links. |============== .Quick reference for section ``colors'' [options="header",width="75%",cols="25%,75%"] |============== |Setting|Description |<>|Text color of the completion widget. |<>|Background color of the completion widget. |<>|Background color of completion widget items. |<>|Foreground color of completion widget category headers. |<>|Background color of the completion widget category headers. |<>|Top border color of the completion widget category headers. |<>|Bottom border color of the completion widget category headers. |<>|Foreground color of the selected completion item. |<>|Background color of the selected completion item. |<>|Top border color of the completion widget category headers. |<>|Bottom border color of the selected completion item. |<>|Foreground color of the matched text in the completion. |<>|Foreground color of the statusbar. |<>|Foreground color of the statusbar. |<>|Background color of the statusbar if there was an error. |<>|Background color of the statusbar if there is a warning. |<>|Background color of the statusbar if there is a prompt. |<>|Background color of the statusbar in insert mode. |<>|Background color of the progress bar. |<>|Default foreground color of the URL in the statusbar. |<>|Foreground color of the URL in the statusbar on successful load. |<>|Foreground color of the URL in the statusbar on error. |<>|Foreground color of the URL in the statusbar when there's a warning. |<>|Foreground color of the URL in the statusbar for hovered links. |<>|Foreground color of unselected odd tabs. |<>|Foreground color of unselected even tabs. |<>|Foreground color of selected tabs. |<>|Background color of unselected odd tabs. |<>|Background color of unselected even tabs. |<>|Background color of selected tabs. |<>|Background color of the tabbar. |<>|Color gradient start for the tab indicator. |<>|Color gradient end for the tab indicator. |<>|Color for the tab indicator on errors.. |<>|Color gradient interpolation system for the tab indicator. |<>|Font color for hints. |<>|Font color for the matched part of hints. |<>|Background color for hints. |<>|Foreground color for downloads. |<>|Background color for the download bar. |<>|Color gradient start for downloads. |<>|Color gradient end for downloads. |<>|Color gradient interpolation system for downloads. |<>|Background color for downloads with errors. |============== .Quick reference for section ``fonts'' [options="header",width="75%",cols="25%,75%"] |============== |Setting|Description |<>|Default monospace fonts. |<>|Font used in the completion widget. |<>|Font used in the tabbar. |<>|Font used in the statusbar. |<>|Font used for the downloadbar. |<>|Font used for the hints. |<>|Font used for the debugging console. |<>|Font family for standard fonts. |<>|Font family for fixed fonts. |<>|Font family for serif fonts. |<>|Font family for sans-serif fonts. |<>|Font family for cursive fonts. |<>|Font family for fantasy fonts. |<>|The hard minimum font size. |<>|The minimum logical font size that is applied when zooming out. |<>|The default font size for regular text. |<>|The default font size for fixed-pitch text. |============== == general General/miscellaneous options. [[general-ignore-case]] === ignore-case Whether to find text on a page case-insensitively. Valid values: * +true+: Search case-insensitively * +false+: Search case-sensitively * +smart+: Search case-sensitively if there are capital chars Default: +pass:[smart]+ [[general-wrap-search]] === wrap-search Whether to wrap finding text to the top when arriving at the end. Valid values: * +true+ * +false+ Default: +pass:[true]+ [[general-startpage]] === startpage The default page(s) to open at the start, separated by commas. Default: +pass:[https://www.duckduckgo.com]+ [[general-default-page]] === default-page The page to open if :open -t/-b/-w is used without URL. Default: +pass:[${startpage}]+ [[general-auto-search]] === auto-search Whether to start a search when something else than a URL is entered. Valid values: * +naive+: Use simple/naive check. * +dns+: Use DNS requests (might be slow!). * +false+: Never search automatically. Default: +pass:[naive]+ [[general-auto-save-config]] === auto-save-config Whether to save the config automatically on quit. Valid values: * +true+ * +false+ Default: +pass:[true]+ [[general-auto-save-interval]] === auto-save-interval How often (in milliseconds) to auto-save config/cookies/etc. Default: +pass:[15000]+ [[general-editor]] === editor The editor (and arguments) to use for the `open-editor` command. Use `{}` for the filename. The value gets split like in a shell, so you can use `"` or `'` to quote arguments. Default: +pass:[gvim -f "{}"]+ [[general-editor-encoding]] === editor-encoding Encoding to use for editor. Default: +pass:[utf-8]+ [[general-private-browsing]] === private-browsing Do not record visited pages in the history or store web page icons. Valid values: * +true+ * +false+ Default: +pass:[false]+ [[general-developer-extras]] === developer-extras 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. Valid values: * +true+ * +false+ Default: +pass:[false]+ [[general-print-element-backgrounds]] === print-element-backgrounds Whether the background color and images are also drawn when the page is printed. Valid values: * +true+ * +false+ Default: +pass:[true]+ [[general-xss-auditing]] === xss-auditing Whether load requests should be monitored 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. Valid values: * +true+ * +false+ Default: +pass:[false]+ [[general-site-specific-quirks]] === site-specific-quirks Enable workarounds for broken sites. Valid values: * +true+ * +false+ Default: +pass:[true]+ [[general-default-encoding]] === default-encoding Default encoding to use for websites. The encoding must be a string describing an encoding such as _utf-8_, _iso-8859-1_, etc. If left empty a default value will be used. Default: empty [[general-new-instance-open-target]] === new-instance-open-target How to open links in an existing instance if a new one is launched. Valid values: * +tab+: Open a new tab in the existing window and activate it. * +tab-silent+: Open a new tab in the existing window without activating it. * +window+: Open in a new window. Default: +pass:[window]+ [[general-log-javascript-console]] === log-javascript-console Whether to log javascript console messages. Valid values: * +true+ * +false+ Default: +pass:[false]+ [[general-save-session]] === save-session Whether to always save the open pages. Valid values: * +true+ * +false+ Default: +pass:[false]+ == ui General options related to the user interface. [[ui-zoom-levels]] === zoom-levels The available zoom levels, separated by commas. Default: +pass:[25%,33%,50%,67%,75%,90%,100%,110%,125%,150%,175%,200%,250%,300%,400%,500%]+ [[ui-default-zoom]] === default-zoom The default zoom level. Default: +pass:[100%]+ [[ui-message-timeout]] === message-timeout Time (in ms) to show messages in the statusbar for. Default: +pass:[2000]+ [[ui-confirm-quit]] === confirm-quit Whether to confirm quitting the application. Valid values: * +always+: Always show a confirmation. * +multiple-tabs+: Show a confirmation if multiple tabs are opened. * +downloads+: Show a confirmation if downloads are running * +never+: Never show a confirmation. Default: +pass:[never]+ [[ui-display-statusbar-messages]] === display-statusbar-messages Whether to display javascript statusbar messages. Valid values: * +true+ * +false+ Default: +pass:[false]+ [[ui-zoom-text-only]] === zoom-text-only Whether the zoom factor on a frame applies only to the text or to all content. Valid values: * +true+ * +false+ Default: +pass:[false]+ [[ui-frame-flattening]] === frame-flattening Whether to expand each subframe to its contents. This will flatten all the frames to become one scrollable page. Valid values: * +true+ * +false+ Default: +pass:[false]+ [[ui-user-stylesheet]] === user-stylesheet User stylesheet to use (absolute filename or CSS string). Will expand environment variables. Default: +pass:[::-webkit-scrollbar { width: 0px; height: 0px; }]+ [[ui-css-media-type]] === css-media-type Set the CSS media type. Default: empty [[ui-remove-finished-downloads]] === remove-finished-downloads Whether to remove finished downloads automatically. Valid values: * +true+ * +false+ Default: +pass:[false]+ [[ui-hide-statusbar]] === hide-statusbar Whether to hide the statusbar unless a message is shown. Valid values: * +true+ * +false+ Default: +pass:[false]+ [[ui-window-title-format]] === window-title-format The format to use for the window title. The following placeholders are defined: * `{perc}`: The percentage as a string like `[10%]`. * `{perc_raw}`: The raw percentage, e.g. `10` * `{title}`: The title of the current webpage * `{title_sep}`: The string ` - ` if a title is set, empty otherwise. * `{id}`: The internal window ID of this window. Default: +pass:[{perc}{title}{title_sep}qutebrowser]+ == network Settings related to the network. [[network-do-not-track]] === do-not-track Value to send in the `DNT` header. Valid values: * +true+ * +false+ Default: +pass:[true]+ [[network-accept-language]] === accept-language Value to send in the `accept-language` header. Default: +pass:[en-US,en]+ [[network-user-agent]] === user-agent User agent to send. Empty to send the default. Default: empty [[network-proxy]] === proxy The proxy to use. 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-proxy-dns-requests]] === proxy-dns-requests Whether to send DNS requests over the configured proxy. Valid values: * +true+ * +false+ Default: +pass:[true]+ [[network-ssl-strict]] === ssl-strict Whether to validate SSL handshakes. Valid values: * +true+ * +false+ * +ask+ Default: +pass:[ask]+ [[network-dns-prefetch]] === dns-prefetch Whether to try to pre-fetch DNS entries to speed up browsing. Valid values: * +true+ * +false+ Default: +pass:[true]+ == completion Options related to completion and command history. [[completion-download-path-suggestion]] === download-path-suggestion What to display in the download filename input. Valid values: * +path+: Show only the download path. * +filename+: Show only download filename. * +both+: Show download path and filename. Default: +pass:[path]+ [[completion-show]] === show Whether to show the autocompletion window. Valid values: * +true+ * +false+ 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. Valid values: * +true+ * +false+ Default: +pass:[true]+ [[completion-shrink]] === shrink Whether to shrink the completion to be smaller than the configured size if there are no scrollbars. Valid values: * +true+ * +false+ Default: +pass:[false]+ == input Options related to input modes. [[input-timeout]] === timeout Timeout for ambiguous keybindings. Default: +pass:[500]+ [[input-partial-timeout]] === partial-timeout Timeout for partially typed keybindings. Default: +pass:[1000]+ [[input-insert-mode-on-plugins]] === insert-mode-on-plugins Whether to switch to insert mode when clicking flash and other plugins. Valid values: * +true+ * +false+ Default: +pass:[false]+ [[input-auto-leave-insert-mode]] === auto-leave-insert-mode Whether to leave insert mode if a non-editable element is clicked. Valid values: * +true+ * +false+ 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. Valid values: * +true+ * +false+ 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. Valid values: * +true+ * +false+ Default: +pass:[false]+ [[input-links-included-in-focus-chain]] === links-included-in-focus-chain Whether hyperlinks should be included in the keyboard focus chain. Valid values: * +true+ * +false+ Default: +pass:[true]+ [[input-rocker-gestures]] === rocker-gestures Whether to enable Opera-like mouse rocker gestures. This disables the context menu. Valid values: * +true+ * +false+ Default: +pass:[false]+ == tabs Configuration of the tab bar. [[tabs-background-tabs]] === background-tabs Whether to open new tabs (middleclick/ctrl+click) in background. Valid values: * +true+ * +false+ Default: +pass:[false]+ [[tabs-select-on-remove]] === select-on-remove Which tab to select when the focused tab is removed. Valid values: * +left+: Select the tab on the left. * +right+: Select the tab on the right. * +previous+: Select the previously selected tab. Default: +pass:[right]+ [[tabs-new-tab-position]] === new-tab-position How new tabs are positioned. Valid values: * +left+: On the left of the current tab. * +right+: On the right of the current tab. * +first+: At the left end. * +last+: At the right end. Default: +pass:[right]+ [[tabs-new-tab-position-explicit]] === new-tab-position-explicit How new tabs opened explicitely are positioned. Valid values: * +left+: On the left of the current tab. * +right+: On the right of the current tab. * +first+: At the left end. * +last+: At the right end. Default: +pass:[last]+ [[tabs-last-close]] === last-close Behaviour when the last tab is closed. Valid values: * +ignore+: Don't do anything. * +blank+: Load a blank page. * +close+: Close the window. Default: +pass:[ignore]+ [[tabs-hide-auto]] === hide-auto Hide the tabbar if only one tab is open. Valid values: * +true+ * +false+ Default: +pass:[false]+ [[tabs-hide-always]] === hide-always Always hide the tabbar. Valid values: * +true+ * +false+ Default: +pass:[false]+ [[tabs-wrap]] === wrap Whether to wrap when changing tabs. Valid values: * +true+ * +false+ Default: +pass:[true]+ [[tabs-movable]] === movable Whether tabs should be movable. Valid values: * +true+ * +false+ Default: +pass:[true]+ [[tabs-close-mouse-button]] === close-mouse-button On which mouse button to close tabs. Valid values: * +right+: Close tabs on right-click. * +middle+: Close tabs on middle-click. * +none+: Don't close tabs using the mouse. Default: +pass:[middle]+ [[tabs-position]] === position The position of the tab bar. Valid values: * +north+ * +south+ * +east+ * +west+ Default: +pass:[north]+ [[tabs-show-favicons]] === show-favicons Whether to show favicons in the tab bar. Valid values: * +true+ * +false+ Default: +pass:[true]+ [[tabs-width]] === width 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]+ [[tabs-tabs-are-windows]] === tabs-are-windows Whether to open windows instead of tabs. Valid values: * +true+ * +false+ Default: +pass:[false]+ [[tabs-title-format]] === title-format The format to use for the tab title. The following placeholders are defined: * `{perc}`: The percentage as a string like `[10%]`. * `{perc_raw}`: The raw percentage, e.g. `10` * `{title}`: The title of the current webpage * `{title_sep}`: The string ` - ` if a title is set, empty otherwise. * `{index}`: The index of this tab. * `{id}`: The internal tab ID of this tab. Default: +pass:[{index}: {title}]+ == 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. Will expand environment variables. 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. Valid values: * +true+ * +false+ 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 Valid values: * +true+ * +false+ Default: +pass:[true]+ [[storage-local-storage]] === local-storage Whether support for the HTML 5 local storage feature is enabled. Valid values: * +true+ * +false+ Default: +pass:[true]+ [[storage-cache-size]] === cache-size Size of the HTTP network cache. Default: +pass:[52428800]+ == content Loaded plugins/scripts and allowed actions. [[content-allow-images]] === allow-images Whether images are automatically loaded in web pages. Valid values: * +true+ * +false+ Default: +pass:[true]+ [[content-allow-javascript]] === allow-javascript Enables or disables the running of JavaScript programs. Valid values: * +true+ * +false+ Default: +pass:[true]+ [[content-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. Valid values: * +true+ * +false+ Default: +pass:[false]+ [[content-geolocation]] === geolocation Allow websites to request geolocations. Valid values: * +false+ * +ask+ Default: +pass:[ask]+ [[content-notifications]] === notifications Allow websites to show notifications. Valid values: * +false+ * +ask+ Default: +pass:[ask]+ [[content-javascript-can-open-windows]] === javascript-can-open-windows Whether JavaScript programs can open new windows. Valid values: * +true+ * +false+ Default: +pass:[false]+ [[content-javascript-can-close-windows]] === javascript-can-close-windows Whether JavaScript programs can close windows. Valid values: * +true+ * +false+ Default: +pass:[false]+ [[content-javascript-can-access-clipboard]] === javascript-can-access-clipboard Whether JavaScript programs can read or write to the clipboard. Valid values: * +true+ * +false+ Default: +pass:[false]+ [[content-ignore-javascript-prompt]] === ignore-javascript-prompt Whether all javascript prompts should be ignored. Valid values: * +true+ * +false+ Default: +pass:[false]+ [[content-ignore-javascript-alert]] === ignore-javascript-alert Whether all javascript alerts should be ignored. Valid values: * +true+ * +false+ Default: +pass:[false]+ [[content-local-content-can-access-remote-urls]] === local-content-can-access-remote-urls Whether locally loaded documents are allowed to access remote urls. Valid values: * +true+ * +false+ Default: +pass:[false]+ [[content-local-content-can-access-file-urls]] === local-content-can-access-file-urls Whether locally loaded documents are allowed to access other local urls. Valid values: * +true+ * +false+ Default: +pass:[true]+ [[content-cookies-accept]] === cookies-accept Whether to accept cookies. Valid values: * +default+: Default QtWebKit behaviour. * +never+: Don't accept cookies at all. Default: +pass:[default]+ [[content-cookies-store]] === cookies-store Whether to store cookies. Valid values: * +true+ * +false+ Default: +pass:[true]+ [[content-host-block-lists]] === host-block-lists 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). Default: +pass:[http://www.malwaredomainlist.com/hostslist/hosts.txt,http://someonewhocares.org/hosts/hosts,http://winhelp2002.mvps.org/hosts.zip,http://malwaredomains.lehigh.edu/files/justdomains.zip,http://pgl.yoyo.org/adservers/serverlist.php?hostformat=hosts&mimetype=plaintext]+ == hints Hinting settings. [[hints-border]] === border CSS border value for hints. Default: +pass:[1px solid #E3BE23]+ [[hints-opacity]] === opacity Opacity for hints. Default: +pass:[0.7]+ [[hints-mode]] === mode Mode to use for hints. Valid values: * +number+: Use numeric hints. * +letter+: Use the chars in the hints -> chars setting. Default: +pass:[letter]+ [[hints-chars]] === chars Chars used for hint strings. Default: +pass:[asdfghjkl]+ [[hints-min-chars]] === min-chars Mininum number of chars used for hint strings. Default: +pass:[1]+ [[hints-scatter]] === scatter Whether to scatter hint key chains (like Vimium) or not (like dwb). Valid values: * +true+ * +false+ Default: +pass:[true]+ [[hints-uppercase]] === uppercase Make chars in hint strings uppercase. Valid values: * +true+ * +false+ Default: +pass:[false]+ [[hints-auto-follow]] === auto-follow Whether to auto-follow a hint if there's only one left. Valid values: * +true+ * +false+ Default: +pass:[true]+ [[hints-next-regexes]] === next-regexes A comma-separated list of regexes to use for 'next' links. Default: +pass:[\bnext\b,\bmore\b,\bnewer\b,\b[>→≫]\b,\b(>>|»)\b]+ [[hints-prev-regexes]] === prev-regexes A comma-separated list of regexes to use for 'prev' links. Default: +pass:[\bprev(ious)?\b,\bback\b,\bolder\b,\b[<←≪]\b,\b(<<|«)\b]+ == searchengines 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]. * transparent (no color) * `rgb(r, g, b)` / `rgba(r, g, b, a)` (values 0-255 or percentages) * `hsv(h, s, v)` / `hsva(h, s, v, a)` (values 0-255, hue 0-359) * 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. Default: +pass:[qlineargradient(x1:0, y1:0, x2:0, y2:1, stop:0 #888888, stop:1 #505050)]+ [[colors-completion.category.border.top]] === completion.category.border.top Top border color of the completion widget category headers. Default: +pass:[black]+ [[colors-completion.category.border.bottom]] === completion.category.border.bottom Bottom border color of the completion widget category headers. Default: +pass:[${completion.category.border.top}]+ [[colors-completion.item.selected.fg]] === completion.item.selected.fg Foreground color of the selected completion item. Default: +pass:[black]+ [[colors-completion.item.selected.bg]] === completion.item.selected.bg Background color of the selected completion item. Default: +pass:[#e8c000]+ [[colors-completion.item.selected.border.top]] === completion.item.selected.border.top Top border color of the completion widget category headers. Default: +pass:[#bbbb00]+ [[colors-completion.item.selected.border.bottom]] === completion.item.selected.border.bottom Bottom border color of the selected completion item. Default: +pass:[${completion.item.selected.border.top}]+ [[colors-completion.match.fg]] === completion.match.fg Foreground color of the matched text in the completion. Default: +pass:[#ff4444]+ [[colors-statusbar.bg]] === statusbar.bg Foreground color of the statusbar. Default: +pass:[black]+ [[colors-statusbar.fg]] === statusbar.fg Foreground color of the statusbar. Default: +pass:[white]+ [[colors-statusbar.bg.error]] === statusbar.bg.error Background color of the statusbar if there was an error. Default: +pass:[red]+ [[colors-statusbar.bg.warning]] === statusbar.bg.warning Background color of the statusbar if there is a warning. Default: +pass:[darkorange]+ [[colors-statusbar.bg.prompt]] === statusbar.bg.prompt Background color of the statusbar if there is a prompt. Default: +pass:[darkblue]+ [[colors-statusbar.bg.insert]] === statusbar.bg.insert Background color of the statusbar in insert mode. Default: +pass:[darkgreen]+ [[colors-statusbar.progress.bg]] === statusbar.progress.bg Background color of the progress bar. Default: +pass:[white]+ [[colors-statusbar.url.fg]] === statusbar.url.fg Default foreground color of the URL in the statusbar. Default: +pass:[${statusbar.fg}]+ [[colors-statusbar.url.fg.success]] === statusbar.url.fg.success Foreground color of the URL in the statusbar on successful load. Default: +pass:[lime]+ [[colors-statusbar.url.fg.error]] === statusbar.url.fg.error Foreground color of the URL in the statusbar on error. Default: +pass:[orange]+ [[colors-statusbar.url.fg.warn]] === statusbar.url.fg.warn Foreground color of the URL in the statusbar when there's a warning. Default: +pass:[yellow]+ [[colors-statusbar.url.fg.hover]] === statusbar.url.fg.hover Foreground color of the URL in the statusbar for hovered links. Default: +pass:[aqua]+ [[colors-tabs.fg.odd]] === tabs.fg.odd Foreground color of unselected odd tabs. Default: +pass:[white]+ [[colors-tabs.fg.even]] === tabs.fg.even Foreground color of unselected even tabs. Default: +pass:[white]+ [[colors-tabs.fg.selected]] === tabs.fg.selected Foreground color of selected tabs. Default: +pass:[white]+ [[colors-tabs.bg.odd]] === tabs.bg.odd Background color of unselected odd tabs. Default: +pass:[grey]+ [[colors-tabs.bg.even]] === tabs.bg.even Background color of unselected even tabs. Default: +pass:[darkgrey]+ [[colors-tabs.bg.selected]] === tabs.bg.selected Background color of selected tabs. Default: +pass:[black]+ [[colors-tabs.bg.bar]] === tabs.bg.bar Background color of the tabbar. Default: +pass:[#555555]+ [[colors-tabs.indicator.start]] === tabs.indicator.start Color gradient start for the tab indicator. Default: +pass:[#0000aa]+ [[colors-tabs.indicator.stop]] === tabs.indicator.stop Color gradient end for the tab indicator. Default: +pass:[#00aa00]+ [[colors-tabs.indicator.error]] === tabs.indicator.error Color for the tab indicator on errors.. Default: +pass:[#ff0000]+ [[colors-tabs.indicator.system]] === tabs.indicator.system Color gradient interpolation system for the tab indicator. Valid values: * +rgb+: Interpolate in the RGB color system. * +hsv+: Interpolate in the HSV color system. * +hsl+: Interpolate in the HSL color system. Default: +pass:[rgb]+ [[colors-hints.fg]] === hints.fg Font color for hints. Default: +pass:[black]+ [[colors-hints.fg.match]] === hints.fg.match Font color for the matched part of hints. Default: +pass:[green]+ [[colors-hints.bg]] === hints.bg Background color for hints. Default: +pass:[-webkit-gradient(linear, left top, left bottom, color-stop(0%,#FFF785), color-stop(100%,#FFC542))]+ [[colors-downloads.fg]] === downloads.fg Foreground color for downloads. Default: +pass:[#ffffff]+ [[colors-downloads.bg.bar]] === downloads.bg.bar Background color for the download bar. Default: +pass:[black]+ [[colors-downloads.bg.start]] === downloads.bg.start Color gradient start for downloads. Default: +pass:[#0000aa]+ [[colors-downloads.bg.stop]] === downloads.bg.stop Color gradient end for downloads. Default: +pass:[#00aa00]+ [[colors-downloads.bg.system]] === downloads.bg.system Color gradient interpolation system for downloads. Valid values: * +rgb+: Interpolate in the RGB color system. * +hsv+: Interpolate in the HSV color system. * +hsl+: Interpolate in the HSL color system. Default: +pass:[rgb]+ [[colors-downloads.bg.error]] === downloads.bg.error Background color for downloads with errors. Default: +pass:[red]+ == fonts Fonts used for the UI, with optional style/weight/size. * Style: `normal`/`italic`/`oblique` * Weight: `normal`, `bold`, `100`..`900` * Size: _number_ `px`/`pt` [[fonts-_monospace]] === _monospace Default monospace fonts. Default: +pass:[Terminus, Monospace, "DejaVu Sans Mono", Monaco, "Bitstream Vera Sans Mono", "Andale Mono", "Liberation Mono", "Courier New", Courier, monospace, Fixed, Consolas, Terminal]+ [[fonts-completion]] === completion Font used in the completion widget. Default: +pass:[8pt ${_monospace}]+ [[fonts-tabbar]] === tabbar Font used in the tabbar. Default: +pass:[8pt ${_monospace}]+ [[fonts-statusbar]] === statusbar Font used in the statusbar. Default: +pass:[8pt ${_monospace}]+ [[fonts-downloads]] === downloads Font used for the downloadbar. Default: +pass:[8pt ${_monospace}]+ [[fonts-hints]] === hints Font used for the hints. Default: +pass:[bold 12px Monospace]+ [[fonts-debug-console]] === debug-console Font used for the debugging console. Default: +pass:[8pt ${_monospace}]+ [[fonts-web-family-standard]] === web-family-standard Font family for standard fonts. Default: empty [[fonts-web-family-fixed]] === web-family-fixed Font family for fixed fonts. Default: empty [[fonts-web-family-serif]] === web-family-serif Font family for serif fonts. Default: empty [[fonts-web-family-sans-serif]] === web-family-sans-serif Font family for sans-serif fonts. Default: empty [[fonts-web-family-cursive]] === web-family-cursive Font family for cursive fonts. Default: empty [[fonts-web-family-fantasy]] === web-family-fantasy Font family for fantasy fonts. Default: empty [[fonts-web-size-minimum]] === web-size-minimum The hard minimum font size. Default: empty [[fonts-web-size-minimum-logical]] === web-size-minimum-logical The minimum logical font size that is applied when zooming out. Default: empty [[fonts-web-size-default]] === web-size-default The default font size for regular text. Default: empty [[fonts-web-size-default-fixed]] === web-size-default-fixed The default font size for fixed-pitch text. Default: empty