diff --git a/qutebrowser/config/configdata.yml b/qutebrowser/config/configdata.yml
index 90f401db3..734307d24 100644
--- a/qutebrowser/config/configdata.yml
+++ b/qutebrowser/config/configdata.yml
@@ -1,54 +1,15 @@
-# general
+## general
-ignore_case:
+aliases:
+ default: {}
type:
- name: String
- valid_values:
- - always: Search case-insensitively
- - never: Search case-sensitively
- - smart: Search case-sensitively if there are capital chars
- default: smart
- desc: Whether to find text on a page case-insensitively.
-
-start_page:
- type:
- name: List
- valtype: String
- default: ["https://start.duckduckgo.com"]
- desc: The default page(s) to open at the start.
-
-yank_ignored_url_parameters:
- type:
- name: List
- valtype: String
+ name: Dict
+ keytype:
+ name: String
+ forbidden: ' '
+ valtype: Command
none_ok: true
- default:
- - ref
- - utm_source
- - utm_medium
- - utm_campaign
- - utm_term
- - utm_content
- desc: The URL parameters to strip with :yank url.
-
-downloads.open_dispatcher:
- type:
- name: String
- none_ok: true
- default: null
- desc: >-
- The default program used to open downloads. If unset, the default internal
- handler is used.
-
- Any `{}` in the string will be expanded to the filename, else the filename
- will be appended.
-
-default_page:
- type: FuzzyUrl
- default: https://start.duckduckgo.com/
- desc: >-
- The page to open if :open -t/-b/-w is used without URL. Use `about:blank`
- for a blank page.
+ desc: Command aliases FIXME
auto_search:
type:
@@ -60,85 +21,33 @@ auto_search:
default: naive
desc: Whether to start a search when something else than a URL is entered.
-auto_save.config:
- type: Bool
- default: true
- desc: Whether to save the config automatically on quit.
+confirm_quit:
+ type: ConfirmQuit
+ default: [never]
+ desc: Whether to confirm quitting the application.
-auto_save.interval:
+default_page:
+ type: FuzzyUrl
+ default: https://start.duckduckgo.com/
+ desc: >-
+ The page to open if :open -t/-b/-w is used without URL. Use `about:blank`
+ for a blank page.
+
+history_session_interval:
+ type: Int
+ default: 30
+ desc: The maximum time in minutes between two history items for them to be considered
+ being from the same session. Use -1 to disable separation.
+
+ignore_case:
type:
- name: Int
- minval: 0
- maxval: maxint
- default: 15000
- desc: How often (in milliseconds) to auto-save config/cookies/etc.
-
-editor.command:
- type:
- name: ShellCommand
- placeholder: true
- default: ["gvim", "-f", "{}"]
- desc: >-
- The editor (and arguments) to use for the `open-editor` command.
-
- The arguments get split like in a shell, so you can use `\"` or `\'` to quote
- them.
-
- `{}` gets replaced by the filename of the file to be edited.
-
-editor.encoding:
- type: Encoding
- default: utf-8
- desc : Encoding to use for the editor.
-
-content.private_browsing:
- type: Bool
- default: false
- desc: Open new windows in private browsing mode which does not record visited
- pages.
-
-content.developer_extras:
- type: Bool
- default: false
- backend: QtWebKit
- desc: >-
- 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 `qutebrowser --help`
- instead.
-
-content.print_element_backgrounds:
- type: Bool
- default: true
- backend:
- QtWebKit: true
- QtWebEngine: Qt 5.8
- desc: >-
- Whether the background color and images are also drawn when the page is
- printed.
-
- # FIXME:conf This should be added automatically:
- # This setting only works with Qt 5.8 or newer when using the QtWebEngine backend.
-
-content.xss_auditing:
- type: Bool
- default: false
- desc: >-
- 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.
-
-content.default_encoding:
- type: String
- default: iso-8859-1
- desc: >-
- Default encoding to use for websites.
-
- The encoding must be a string describing an encoding such as _utf-8_,
- _iso-8859-1_, etc.
+ name: String
+ valid_values:
+ - always: Search case-insensitively
+ - never: Search case-sensitively
+ - smart: Search case-sensitively if there are capital chars
+ default: smart
+ desc: Whether to find text on a page case-insensitively.
new_instance_open_target:
type:
@@ -166,20 +75,15 @@ new_instance_open_target_window:
default: last-focused
desc: Which window to choose when opening links as new tabs.
-content.javascript.log:
+searchengines:
+ default:
+ # FIXME:conf what if the user deletes/renames DEFAULT?
+ DEFAULT: https://duckduckgo.com/?q={}
type:
- name: String
- valid_values:
- - none: "Don't log messages."
- - debug: Log messages with debug level.
- - info: Log messages with info level.
- default: debug
- desc: How to log javascript console messages.
-
-auto_save.session:
- type: Bool
- default: false
- desc: Whether to always save the open pages.
+ name: Dict
+ keytype: String
+ valtype: SearchEngineUrl
+ desc: FIXME
session_default_name:
type:
@@ -189,6 +93,13 @@ session_default_name:
desc: The name of the session to save by default, or unset for the last loaded
session.
+start_page:
+ type:
+ name: List
+ valtype: String
+ default: ["https://start.duckduckgo.com"]
+ desc: The default page(s) to open at the start.
+
url_incdec_segments:
type:
name: FlagList
@@ -197,81 +108,118 @@ url_incdec_segments:
desc: The URL segments where `:navigate increment/decrement` will search for a
number.
-
-# ui
-
-history_session_interval:
- type: Int
- default: 30
- desc: The maximum time in minutes between two history items for them to be considered
- being from the same session. Use -1 to disable separation.
-
-zoom.levels:
+yank_ignored_url_parameters:
type:
name: List
- valtype:
- name: Perc
- minval: 0
+ valtype: String
+ none_ok: true
default:
- - 25%
- - 33%
- - 50%
- - 67%
- - 75%
- - 90%
- - 100%
- - 110%
- - 125%
- - 150%
- - 175%
- - 200%
- - 250%
- - 300%
- - 400%
- - 500%
- desc: The available zoom levels.
+ - ref
+ - utm_source
+ - utm_medium
+ - utm_campaign
+ - utm_term
+ - utm_content
+ desc: The URL parameters to strip with :yank url.
-zoom.default:
- type: Perc
- default: 100%
- desc: The default zoom level.
+## auto_save
-downloads.position:
- type: VerticalPosition
- default: top
- desc: Where to show the downloaded files.
+auto_save.config:
+ type: Bool
+ default: true
+ desc: Whether to save the config automatically on quit.
-statusbar.position:
- type: VerticalPosition
- default: bottom
- desc: The position of the status bar.
-
-messages.timeout:
+auto_save.interval:
type:
name: Int
minval: 0
- default: 2000
- desc: >-
- Time (in ms) to show messages in the statusbar for.
+ maxval: maxint
+ default: 15000
+ desc: How often (in milliseconds) to auto-save config/cookies/etc.
- Set to 0 to never clear messages.
-
-messages.unfocused:
+auto_save.session:
type: Bool
default: false
- desc: Whether to show messages in unfocused windows.
+ desc: Whether to always save the open pages.
-confirm_quit:
- type: ConfirmQuit
- default: [never]
- desc: Whether to confirm quitting the application.
+## content
-zoom.text_only:
+content.accept_language:
+ type: String
+ default: en-US,en
+ desc: Value to send in the `accept-language` header.
+
+content.cache_size:
+ default: null
+ type:
+ name: Int
+ none_ok: true
+ minval: 0
+ maxval: maxint64
+ desc: Size of the HTTP network cache. Empty to use the default value.
+
+content.cookies.accept:
+ default: no-3rdparty
+ backend: QtWebKit
+ type:
+ name: 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."
+ - never: "Don't accept cookies at all."
+ desc: Control which cookies to accept.
+
+content.cookies.store:
+ default: true
+ type: Bool
+ desc: Whether to store cookies. Note this option needs a restart with QtWebEngine
+ on Qt < 5.9.
+
+content.custom_headers:
+ default: {}
+ type:
+ name: Dict
+ keytype:
+ name: String
+ encoding: ascii
+ valtype:
+ name: String
+ encoding: ascii
+ none_ok: true
+ desc: Set custom headers for qutebrowser HTTP requests.
+
+content.default_encoding:
+ type: String
+ default: iso-8859-1
+ desc: >-
+ Default encoding to use for websites.
+
+ The encoding must be a string describing an encoding such as _utf-8_,
+ _iso-8859-1_, etc.
+
+content.developer_extras:
type: Bool
default: false
backend: QtWebKit
- desc: Whether the zoom factor on a frame applies only to the text or to all
- content.
+ desc: >-
+ 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 `qutebrowser --help`
+ instead.
+
+content.dns_prefetch:
+ default: true
+ type: Bool
+ backend: QtWebKit
+ desc: Whether to try to pre-fetch DNS entries to speed up browsing.
+
+content.do_not_track:
+ type: Bool
+ default: true
+ desc: Value to send in the `DNT` header.
content.frame_flattening:
default: false
@@ -282,130 +230,232 @@ content.frame_flattening:
This will flatten all the frames to become one scrollable page.
-content.user_stylesheet:
- type:
- name: File
- none_ok: True
- default: null
- desc: User stylesheet to use (absolute filename or filename relative to the config
- directory). Will expand environment variables.
+content.geolocation:
+ default: ask
+ type: BoolAsk
+ desc: Allow websites to request geolocations.
-scrolling.bar:
- # FIXME:conf meaning changed!
+content.host_blocking.enabled:
+ default: true
type: Bool
- default: false
- desc: Show a scrollbar.
+ desc: Whether host blocking is enabled.
-scrolling.smooth:
- type: Bool
- default: false
- desc: Whether to enable smooth scrolling for web pages. Note smooth scrolling does
- not work with the `:scroll-px` command.
-
-downloads.remove_finished:
- default: -1
- type:
- name: Int
- minval: -1
- desc: Number of milliseconds to wait before removing finished downloads. Will not
- be removed if value is -1.
-
-statusbar.hide:
- type: Bool
- default: false
- desc: Whether to hide the statusbar unless a message is shown.
-
-statusbar.padding:
- type: Padding
+content.host_blocking.lists:
default:
- top: 1
- bottom: 1
- left: 0
- right: 0
- desc: Padding for the statusbar.
-
-window.title_format:
+ - "https://www.malwaredomainlist.com/hostslist/hosts.txt"
+ - "http://someonewhocares.org/hosts/hosts"
+ - "http://winhelp2002.mvps.org/hosts.zip"
+ - "http://malwaredomains.lehigh.edu/files/justdomains.zip"
+ - "https://pgl.yoyo.org/adservers/serverlist.php?hostformat=hosts&mimetype=plaintext"
type:
- name: FormatString
- fields:
- - perc
- - perc_raw
- - title
- - title_sep
- - id
- - scroll_pos
- - host
- - backend
- - private
- default: '{perc}{title}{title_sep}qutebrowser'
+ name: List
+ valtype: Url
+ none_ok: true
desc: |
- The format to use for the window title. The following placeholders are defined:
+ List of URLs of lists which contain hosts to block.
- * `{perc}`: The percentage as a string like `[10%]`.
- * `{perc_raw}`: The raw percentage, e.g. `10`
- * `{title}`: The title of the current web page
- * `{title_sep}`: The string ` - ` if a title is set, empty otherwise.
- * `{id}`: The internal window ID of this window.
- * `{scroll_pos}`: The page scroll position.
- * `{host}`: The host of the current web page.
- * `{backend}`: Either ''webkit'' or ''webengine''
- * `{private}` : Indicates when private mode is enabled.
+ 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).
+
+content.host_blocking.whitelist:
+ default:
+ - piwik.org
+ type:
+ name: List
+ valtype: String
+ none_ok: true
+ desc: >-
+ 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.
+
+content.hyperlink_auditing:
+ default: false
+ type: Bool
+ desc: Enable or disable hyperlink auditing (``).
+
+content.images:
+ default: true
+ type: Bool
+ desc: Whether images are automatically loaded in web pages.
+
+content.javascript.alert:
+ default: false
+ type: Bool
+ desc: Show javascript.
+
+content.javascript.can_access_clipboard:
+ default: false
+ type: Bool
+ desc: >-
+ Whether JavaScript programs can read or write to the clipboard.
+
+ With QtWebEngine, writing the clipboard as response to a user interaction is always
+ allowed.
+
+content.javascript.can_close_windows:
+ default: false
+ type: Bool
+ backend: QtWebKit
+ desc: Whether JavaScript programs can close windows.
+
+content.javascript.can_open_windows_automatically:
+ default: false
+ type: Bool
+ desc: Whether JavaScript programs can open new windows without user
+ interaction.
+
+content.javascript.enabled:
+ default: true
+ type: Bool
+ desc: Enables or disables the running of JavaScript programs.
+
+content.javascript.log:
+ type:
+ name: String
+ valid_values:
+ - none: "Don't log messages."
+ - debug: Log messages with debug level.
+ - info: Log messages with info level.
+ default: debug
+ desc: How to log javascript console messages.
content.javascript.modal_dialog:
type: Bool
default: false
desc: Use the standard JavaScript modal dialog for `alert()` and `confirm()`
-window.hide_wayland_decoration:
+content.javascript.prompt:
+ default: true
+ type: Bool
+ desc: Show javascript prompts.
+
+content.local_content_can_access_remote_urls:
+ default: false
+ type: Bool
+ desc: Whether locally loaded documents are allowed to access remote urls.
+
+content.local_content_can_access_file_urls:
+ default: true
+ type: Bool
+ desc: Whether locally loaded documents are allowed to access other local urls.
+
+content.local_storage:
+ default: true
+ type: Bool
+ desc: Whether support for HTML 5 local storage and Web SQL is enabled.
+
+# Defaults from QWebSettings::QWebSettings() in
+# qtwebkit/Source/WebKit/qt/Api/qwebsettings.cpp
+
+content.maximum_pages_in_cache:
+ default: 0
+ type:
+ name: Int
+ minval: 0
+ maxval: maxint
+ backend: QtWebKit
+ desc: >-
+ The maximum number of pages to hold in the global 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/
+
+content.media_capture:
+ default: ask
+ type: BoolAsk
+ backend: QtWebEngine
+ desc: Allow websites to record audio/video.
+
+content.netrc_file:
+ default: null
+ type:
+ name: File
+ none_ok: true
+ desc: Set location of a netrc-file for HTTP authentication. If unset, ~/.netrc
+ is used.
+
+content.notifications:
+ default: ask
+ type: BoolAsk
+ desc: Allow websites to show notifications.
+
+content.offline_web_application_cache:
+ default: true
+ type: Bool
+ backend: QtWebKit
+ desc: >-
+ 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
+
+content.pdfjs:
+ default: false
+ type: Bool
+ desc: >-
+ Enable 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 viewer.
+
+content.plugins:
+ default: false
+ type: Bool
+ desc: Enables or disables plugins in Web pages.
+
+content.print_element_backgrounds:
+ type: Bool
+ default: true
+ backend:
+ QtWebKit: true
+ QtWebEngine: Qt 5.8
+ desc: >-
+ Whether the background color and images are also drawn when the page is
+ printed.
+
+ # FIXME:conf This should be added automatically:
+ # This setting only works with Qt 5.8 or newer when using the QtWebEngine backend.
+
+content.private_browsing:
type: Bool
default: false
- desc: Hide the window decoration when using wayland (requires restart)
+ desc: Open new windows in private browsing mode which does not record visited
+ pages.
-keyhint.blacklist:
- type:
- name: List
- none_ok: true
- valtype:
- name: String
- default: null
+content.proxy:
+ default: system
+ type: Proxy
+ backend:
+ QtWebKit: true
+ QtWebEngine: Qt 5.8
desc: >-
- Keychains that shouldn\'t be shown in the keyhint dialog.
+ The proxy to use.
- Globs are supported, so `;*` will blacklist all keychains starting with `;`.
- Use `*` to disable keyhints.
+ In addition to the listed values, you can use a `socks://...` or `http://...`
+ URL.
-keyhint.delay:
- type:
- name: Int
- minval: 0
- default: 500
- desc: Time from pressing a key to seeing the keyhint dialog (ms)
+ # FIXME:conf This should be added automatically:
+ # This setting only works with Qt 5.8 or newer when using the QtWebEngine
+ # backend.
-prompt.radius:
- type:
- name: Int
- minval: 0
- default: 8
- desc: The rounding radius for the edges of prompts.
-
-prompt.filebrowser:
- type: Bool
+content.proxy_dns_requests:
default: true
- desc: Show a filebrowser in upload/download prompts.
-
-
-# network
-
-content.do_not_track:
type: Bool
- default: true
- desc: Value to send in the `DNT` header.
-
-content.accept_language:
- type: String
- default: en-US,en
- desc: Value to send in the `accept-language` header.
+ backend: QtWebKit
+ desc: Whether to send DNS requests over the configured proxy.
content.referer_header:
default: same-domain
@@ -419,6 +469,11 @@ content.referer_header:
backend: QtWebKit
desc: Send the Referer header
+content.ssl_strict:
+ default: ask
+ type: BoolAsk
+ desc: Whether to validate SSL handshakes.
+
content.user_agent:
default: null
type:
@@ -470,88 +525,30 @@ content.user_agent:
desc: User agent to send. Unset to send the default.
-content.proxy:
- default: system
- type: Proxy
- backend:
- QtWebKit: true
- QtWebEngine: Qt 5.8
- desc: >-
- The proxy to use.
-
- In addition to the listed values, you can use a `socks://...` or `http://...`
- URL.
-
- # FIXME:conf This should be added automatically:
- # This setting only works with Qt 5.8 or newer when using the QtWebEngine
- # backend.
-
-content.proxy_dns_requests:
- default: true
- type: Bool
- backend: QtWebKit
- desc: Whether to send DNS requests over the configured proxy.
-
-content.ssl_strict:
- default: ask
- type: BoolAsk
- desc: Whether to validate SSL handshakes.
-
-content.dns_prefetch:
- default: true
- type: Bool
- backend: QtWebKit
- desc: Whether to try to pre-fetch DNS entries to speed up browsing.
-
-content.custom_headers:
- default: {}
- type:
- name: Dict
- keytype:
- name: String
- encoding: ascii
- valtype:
- name: String
- encoding: ascii
- none_ok: true
- desc: Set custom headers for qutebrowser HTTP requests.
-
-content.netrc_file:
- default: null
+content.user_stylesheet:
type:
name: File
- none_ok: true
- desc: Set location of a netrc-file for HTTP authentication. If unset, ~/.netrc
- is used.
+ none_ok: True
+ default: null
+ desc: User stylesheet to use (absolute filename or filename relative to the config
+ directory). Will expand environment variables.
+content.webgl:
+ default: true
+ type: Bool
+ desc: Enables or disables WebGL.
-# completion
+content.xss_auditing:
+ type: Bool
+ default: false
+ desc: >-
+ Whether load requests should be monitored for cross-site scripting attempts.
-completion.show:
- default: always
- type:
- name: String
- valid_values:
- - always: Whenever a completion is available.
- - auto: Whenever a completion is requested.
- - never: Never.
- desc: When to show the autocompletion window.
+ Suspicious scripts will be blocked and reported in the inspector\'s
+ JavaScript console. Enabling this feature might have an impact on
+ performance.
-completion.timestamp_format:
- type:
- name: TimestampTemplate
- none_ok: true
- default: '%Y-%m-%d'
- desc: How to format timestamps (e.g. for history)
-
-completion.height:
- type:
- name: PercOrInt
- minperc: 0
- maxperc: 100
- minint: 1
- default: 50%
- desc: The height of the completion, in px or as percentage of the window.
+## completion
completion.cmd_history_max_items:
default: 100
@@ -563,15 +560,14 @@ completion.cmd_history_max_items:
0: no history / -1: unlimited
-completion.web_history_max_items:
- default: 1000
+completion.height:
type:
- name: Int
- minval: -1
- desc: >-
- How many URLs to show in the web history.
-
- 0: no history / -1: unlimited
+ name: PercOrInt
+ minperc: 0
+ maxperc: 100
+ minint: 1
+ default: 50%
+ desc: The height of the completion, in px or as percentage of the window.
completion.quick:
default: true
@@ -579,6 +575,16 @@ completion.quick:
desc: "Whether to move on to the next part when there's only one possible completion
left."
+completion.show:
+ default: always
+ type:
+ name: String
+ valid_values:
+ - always: Whenever a completion is available.
+ - auto: Whenever a completion is requested.
+ - never: Never.
+ desc: When to show the autocompletion window.
+
completion.shrink:
default: false
type: Bool
@@ -599,8 +605,220 @@ completion.scrollbar.padding:
minval: 0
desc: Padding of scrollbar handle in completion window (in px).
+completion.timestamp_format:
+ type:
+ name: TimestampTemplate
+ none_ok: true
+ default: '%Y-%m-%d'
+ desc: How to format timestamps (e.g. for history)
-# input
+completion.web_history_max_items:
+ default: 1000
+ type:
+ name: Int
+ minval: -1
+ desc: >-
+ How many URLs to show in the web history.
+
+ 0: no history / -1: unlimited
+
+## downloads
+
+downloads.location.directory:
+ default: null
+ type:
+ name: Directory
+ none_ok: true
+ desc: The directory to save downloads to. If unset, a sensible os-specific
+ default is used. Will expand environment variables.
+
+downloads.location.prompt:
+ default: true
+ type: Bool
+ desc: >-
+ Whether to prompt the user for the download location.
+
+ If set to false, `download-directory` will be used.
+
+downloads.location.remember:
+ default: true
+ type: Bool
+ desc: Whether to remember the last used download directory.
+
+downloads.location.suggestion:
+ default: path
+ type:
+ name: String
+ valid_values:
+ - path: Show only the download path.
+ - filename: Show only download filename.
+ - both: Show download path and filename.
+ desc: What to display in the download filename input.
+
+downloads.open_dispatcher:
+ type:
+ name: String
+ none_ok: true
+ default: null
+ desc: >-
+ The default program used to open downloads. If unset, the default internal
+ handler is used.
+
+ Any `{}` in the string will be expanded to the filename, else the filename
+ will be appended.
+
+downloads.position:
+ type: VerticalPosition
+ default: top
+ desc: Where to show the downloaded files.
+
+downloads.remove_finished:
+ default: -1
+ type:
+ name: Int
+ minval: -1
+ desc: Number of milliseconds to wait before removing finished downloads. Will not
+ be removed if value is -1.
+
+## editor
+
+editor.command:
+ type:
+ name: ShellCommand
+ placeholder: true
+ default: ["gvim", "-f", "{}"]
+ desc: >-
+ The editor (and arguments) to use for the `open-editor` command.
+
+ The arguments get split like in a shell, so you can use `\"` or `\'` to quote
+ them.
+
+ `{}` gets replaced by the filename of the file to be edited.
+
+editor.encoding:
+ type: Encoding
+ default: utf-8
+ desc : Encoding to use for the editor.
+
+## hints
+
+hints.auto_follow:
+ default: unique-match
+ type:
+ name: String
+ valid_values:
+ - always: "Auto-follow whenever there is only a single hint on a page."
+ - unique-match: "Auto-follow whenever there is a unique non-empty match in
+ either the hint string (word mode) or filter (number mode)."
+ - full-match: "Follow the hint when the user typed the whole hint (letter,
+ word or number mode) or the element's text (only in number mode)."
+ - never: "The user will always need to press Enter to follow a hint."
+ desc: Controls when a hint can be automatically followed without the user
+ pressing Enter.
+
+hints.auto_follow_timeout:
+ default: 0
+ type: Int
+ desc: A timeout (in milliseconds) to inhibit normal-mode key bindings after a
+ successful auto-follow.
+
+hints.border:
+ default: '1px solid #E3BE23'
+ type: String
+ desc: CSS border value for hints.
+
+hints.chars:
+ default: asdfghjkl
+ type:
+ name: UniqueCharString
+ minlen: 2
+ completions:
+ - ['asdfghjkl', "Home row"]
+ - ['aoeuidnths', "Home row (Dvorak)"]
+ - ['abcdefghijklmnopqrstuvwxyz', "All letters"]
+ desc: Chars used for hint strings.
+
+hints.dictionary:
+ default: /usr/share/dict/words
+ type:
+ name: File
+ required: false
+ desc: The dictionary file to be used by the word hints.
+
+hints.find_implementation:
+ default: python
+ type:
+ name: String
+ valid_values:
+ - javascript: Better but slower
+ - python: Slightly worse but faster
+ desc: Which implementation to use to find elements to hint.
+
+hints.hide_unmatched_rapid_hints:
+ default: true
+ type: Bool
+ desc: Controls hiding unmatched hints in rapid mode.
+
+hints.min_chars:
+ default: 1
+ type:
+ name: Int
+ minval: 1
+ desc: Minimum number of chars used for hint strings.
+
+hints.mode:
+ default: letter
+ type:
+ name: String
+ valid_values:
+ - number: Use numeric hints. (In this mode you can also type letters from
+ the hinted element to filter and reduce the number of elements that
+ are hinted.)
+ - letter: Use the chars in the hints -> chars setting.
+ - word: Use hints words based on the html elements and the extra words.
+ desc: Mode to use for hints.
+
+hints.next_regexes:
+ default:
+ - "\\bnext\\b"
+ - "\\bmore\\b"
+ - "\\bnewer\\b"
+ - "\\b[>\u2192\u226B]\\b"
+ - "\\b(>>|\xBB)\\b"
+ - "\\bcontinue\\b"
+ type:
+ name: List
+ valtype:
+ name: Regex
+ flags: IGNORECASE
+ desc: "A comma-separated list of regexes to use for 'next' links."
+
+hints.prev_regexes:
+ default:
+ - "\\bprev(ious)?\\b"
+ - "\\bback\\b"
+ - "\\bolder\\b"
+ - "\\b[<\u2190\u226A]\\b"
+ - "\\b(<<|\xAB)\\b"
+ type:
+ name: List
+ valtype:
+ name: Regex
+ flags: IGNORECASE
+ desc: A comma-separated list of regexes to use for 'prev' links.
+
+hints.scatter:
+ default: true
+ type: Bool
+ desc: Whether to scatter hint key chains (like Vimium) or not (like dwb). Ignored
+ for number hints.
+
+hints.uppercase:
+ default: false
+ type: Bool
+ desc: Make chars in hint strings uppercase.
+
+## input
# FIXME:conf get rid of this?
input.ambiguous_timeout:
@@ -615,6 +833,37 @@ input.ambiguous_timeout:
If the current input forms both a complete match and a partial match, the complete
match will be executed after this time.
+input.forward_unbound_keys:
+ default: auto
+ type:
+ name: String
+ valid_values:
+ - all: "Forward all unbound keys."
+ - auto: "Forward unbound non-alphanumeric keys."
+ - none: "Don't forward any keys."
+ desc: Whether to forward unbound keys to the webview in normal mode.
+
+input.insert_mode.auto_focused:
+ default: false
+ type: Bool
+ desc: Whether to automatically enter insert mode if an editable element is focused
+ after page load.
+
+input.insert_mode.auto_leave:
+ default: true
+ type: Bool
+ desc: Whether to leave insert mode if a non-editable element is clicked.
+
+input.insert_mode.plugins:
+ default: false
+ type: Bool
+ desc: Whether to switch to insert mode when clicking flash and other plugins.
+
+input.links_included_in_focus_chain:
+ default: true
+ type: Bool
+ desc: Whether hyperlinks should be included in the keyboard focus chain.
+
input.partial_timeout:
default: 5000
type:
@@ -627,31 +876,11 @@ input.partial_timeout:
If the current input forms only partial matches, the keystring will be cleared
after this time.
-input.insert_mode.plugins:
+input.rocker_gestures:
default: false
type: Bool
- desc: Whether to switch to insert mode when clicking flash and other plugins.
-
-input.insert_mode.auto_leave:
- default: true
- type: Bool
- desc: Whether to leave insert mode if a non-editable element is clicked.
-
-input.insert_mode.auto_focused:
- default: false
- type: Bool
- desc: Whether to automatically enter insert mode if an editable element is focused
- after page load.
-
-input.forward_unbound_keys:
- default: auto
- type:
- name: String
- valid_values:
- - all: "Forward all unbound keys."
- - auto: "Forward unbound non-alphanumeric keys."
- - none: "Don't forward any keys."
- desc: Whether to forward unbound keys to the webview in normal mode.
+ desc: Whether to enable Opera-like mouse rocker gestures. This disables the context
+ menu.
input.spatial_navigation:
default: false
@@ -665,46 +894,130 @@ input.spatial_navigation:
determine whether there is an element he might be trying to reach towards the
right and which element he probably wants.
-input.links_included_in_focus_chain:
- default: true
- type: Bool
- desc: Whether hyperlinks should be included in the keyboard focus chain.
+## keyhint
-input.rocker_gestures:
- default: false
- type: Bool
- desc: Whether to enable Opera-like mouse rocker gestures. This disables the context
- menu.
+keyhint.blacklist:
+ type:
+ name: List
+ none_ok: true
+ valtype:
+ name: String
+ default: null
+ desc: >-
+ Keychains that shouldn\'t be shown in the keyhint dialog.
-zoom.mouse_divider:
- default: 512
+ Globs are supported, so `;*` will blacklist all keychains starting with `;`.
+ Use `*` to disable keyhints.
+
+keyhint.delay:
type:
name: Int
minval: 0
- desc: How much to divide the mouse wheel movements to translate them into zoom increments.
+ default: 500
+ desc: Time from pressing a key to seeing the keyhint dialog (ms)
+## messages
-# tabs
+messages.timeout:
+ type:
+ name: Int
+ minval: 0
+ default: 2000
+ desc: >-
+ Time (in ms) to show messages in the statusbar for.
+
+ Set to 0 to never clear messages.
+
+messages.unfocused:
+ type: Bool
+ default: false
+ desc: Whether to show messages in unfocused windows.
+
+## prompt
+
+prompt.filebrowser:
+ type: Bool
+ default: true
+ desc: Show a filebrowser in upload/download prompts.
+
+prompt.radius:
+ type:
+ name: Int
+ minval: 0
+ default: 8
+ desc: The rounding radius for the edges of prompts.
+
+## scrolling
+
+scrolling.bar:
+ # FIXME:conf meaning changed!
+ type: Bool
+ default: false
+ desc: Show a scrollbar.
+
+statusbar.hide:
+ type: Bool
+ default: false
+ desc: Whether to hide the statusbar unless a message is shown.
+
+statusbar.padding:
+ type: Padding
+ default:
+ top: 1
+ bottom: 1
+ left: 0
+ right: 0
+ desc: Padding for the statusbar.
+
+statusbar.position:
+ type: VerticalPosition
+ default: bottom
+ desc: The position of the status bar.
+
+scrolling.smooth:
+ type: Bool
+ default: false
+ desc: Whether to enable smooth scrolling for web pages. Note smooth scrolling does
+ not work with the `:scroll-px` command.
+
+## tabs
tabs.background:
default: false
type: Bool
desc: Whether to open new tabs (middleclick/ctrl+click) in background.
-tabs.select_on_remove:
- default: 'next'
- type: SelectOnRemove
- desc: Which tab to select when the focused tab is removed.
+tabs.close_mouse_button:
+ default: middle
+ type:
+ name: String
+ valid_values:
+ - right: "Close tabs on right-click."
+ - middle: "Close tabs on middle-click."
+ - none: "Don't close tabs using the mouse."
+ desc: On which mouse button to close tabs.
-tabs.new_position:
- default: next
- type: NewTabPosition
- desc: How new tabs are positioned.
+tabs.favicons.scale:
+ default: 1.0
+ type:
+ name: Float
+ minval: 0.0
+ desc: Scale for favicons in the tab bar. The tab size is unchanged, so big favicons
+ also require extra `tabs->padding`.
-tabs.new_position_explicit:
- default: last
- type: NewTabPosition
- desc: How new tabs opened explicitly are positioned.
+tabs.favicons.show:
+ default: true
+ desc: Whether to show favicons in the tab bar.
+ type: Bool
+
+tabs.indicator_padding:
+ default:
+ top: 2
+ bottom: 2
+ left: 0
+ right: 4
+ type: Padding
+ desc: Padding for indicators
tabs.last_close:
default: ignore
@@ -718,6 +1031,45 @@ tabs.last_close:
- close: "Close the window."
desc: Behavior when the last tab is closed.
+tabs.mousewheel_switching:
+ default: true
+ type: Bool
+ desc: Switch between tabs using the mouse wheel.
+
+tabs.movable:
+ default: true
+ type: Bool
+ desc: Whether tabs should be movable.
+
+tabs.new_position:
+ default: next
+ type: NewTabPosition
+ desc: How new tabs are positioned.
+
+tabs.new_position_explicit:
+ default: last
+ type: NewTabPosition
+ desc: How new tabs opened explicitly are positioned.
+
+tabs.padding:
+ default:
+ top: 0
+ bottom: 0
+ left: 5
+ right: 5
+ type: Padding
+ desc: Padding for tabs
+
+tabs.position:
+ default: top
+ type: Position
+ desc: The position of the tab bar.
+
+tabs.select_on_remove:
+ default: 'next'
+ type: SelectOnRemove
+ desc: Which tab to select when the focused tab is removed.
+
tabs.show:
default: always
type:
@@ -735,72 +1087,16 @@ tabs.show_switching_delay:
desc: "Time to show the tab bar before hiding it when tabs->show is set to
'switching'."
-tabs.wrap:
- default: true
- type: Bool
- desc: Whether to wrap when changing tabs.
-
-tabs.movable:
- default: true
- type: Bool
- desc: Whether tabs should be movable.
-
-tabs.close_mouse_button:
- default: middle
- type:
- name: String
- valid_values:
- - right: "Close tabs on right-click."
- - middle: "Close tabs on middle-click."
- - none: "Don't close tabs using the mouse."
- desc: On which mouse button to close tabs.
-
-tabs.position:
- default: top
- type: Position
- desc: The position of the tab bar.
-
-tabs.favicons.show:
- default: true
- desc: Whether to show favicons in the tab bar.
- type: Bool
-
-tabs.favicons.scale:
- default: 1.0
- type:
- name: Float
- minval: 0.0
- desc: Scale for favicons in the tab bar. The tab size is unchanged, so big favicons
- also require extra `tabs->padding`.
-
-tabs.width.bar:
- default: 20%
- type:
- name: PercOrInt
- minperc: 0
- maxperc: 100
- minint: 1
- desc: "The width of the tab bar if it's vertical, in px or as percentage of the window."
-
-tabs.width.pinned:
- default: 43
- type:
- name: Int
- minval: 10
- desc: The width for pinned tabs with a horizontal tabbar, in px.
-
-tabs.width.indicator:
- default: 3
- type:
- name: Int
- minval: 0
- desc: Width of the progress indicator (0 to disable).
-
tabs.tabs_are_windows:
default: false
type: Bool
desc: Whether to open windows instead of tabs.
+tabs.title.alignment:
+ default: left
+ type: TextAlignment
+ desc: Alignment of the text inside of tabs
+
tabs.title.format:
default: '{index}: {title}'
type:
@@ -848,413 +1144,115 @@ tabs.title.format_pinned:
desc: The format to use for the tab title for pinned tabs. The same placeholders
like for title-format are defined.
-tabs.title.alignment:
- default: left
- type: TextAlignment
- desc: Alignment of the text inside of tabs
-
-tabs.mousewheel_switching:
- default: true
- type: Bool
- desc: Switch between tabs using the mouse wheel.
-
-tabs.padding:
- default:
- top: 0
- bottom: 0
- left: 5
- right: 5
- type: Padding
- desc: Padding for tabs
-
-tabs.indicator_padding:
- default:
- top: 2
- bottom: 2
- left: 0
- right: 4
- type: Padding
- desc: Padding for indicators
-
-
-# storage
-
-downloads.location.directory:
- default: null
+tabs.width.bar:
+ default: 20%
type:
- name: Directory
- none_ok: true
- desc: The directory to save downloads to. If unset, a sensible os-specific
- default is used. Will expand environment variables.
+ name: PercOrInt
+ minperc: 0
+ maxperc: 100
+ minint: 1
+ desc: "The width of the tab bar if it's vertical, in px or as percentage of the window."
-downloads.location.prompt:
- default: true
- type: Bool
- desc: >-
- Whether to prompt the user for the download location.
-
- If set to false, `download-directory` will be used.
-
-downloads.location.remember:
- default: true
- type: Bool
- desc: Whether to remember the last used download directory.
-
-downloads.location.suggestion:
- default: path
- type:
- name: String
- valid_values:
- - path: Show only the download path.
- - filename: Show only download filename.
- - both: Show download path and filename.
- desc: What to display in the download filename input.
-
-
-# Defaults from QWebSettings::QWebSettings() in
-# qtwebkit/Source/WebKit/qt/Api/qwebsettings.cpp
-
-content.maximum_pages_in_cache:
- default: 0
+tabs.width.indicator:
+ default: 3
type:
name: Int
minval: 0
- maxval: maxint
- backend: QtWebKit
- desc: >-
- The maximum number of pages to hold in the global memory page cache.
+ desc: Width of the progress indicator (0 to disable).
- 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/
-
-content.offline_web_application_cache:
- default: true
- type: Bool
- backend: QtWebKit
- desc: >-
- 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
-
-content.local_storage:
- default: true
- type: Bool
- desc: Whether support for HTML 5 local storage and Web SQL is enabled.
-
-content.cache_size:
- default: null
+tabs.width.pinned:
+ default: 43
type:
name: Int
- none_ok: true
- minval: 0
- maxval: maxint64
- desc: Size of the HTTP network cache. Empty to use the default value.
+ minval: 10
+ desc: The width for pinned tabs with a horizontal tabbar, in px.
-
-# content
-
-content.images:
+tabs.wrap:
default: true
type: Bool
- desc: Whether images are automatically loaded in web pages.
+ desc: Whether to wrap when changing tabs.
-content.javascript.enabled:
- default: true
+## window
+
+window.hide_wayland_decoration:
type: Bool
- desc: Enables or disables the running of JavaScript programs.
-
-content.plugins:
default: false
- type: Bool
- desc: Enables or disables plugins in Web pages.
+ desc: Hide the window decoration when using wayland (requires restart)
-content.webgl:
- default: true
- type: Bool
- desc: Enables or disables WebGL.
-
-content.hyperlink_auditing:
- default: false
- type: Bool
- desc: Enable or disable hyperlink auditing (``).
-
-content.geolocation:
- default: ask
- type: BoolAsk
- desc: Allow websites to request geolocations.
-
-content.notifications:
- default: ask
- type: BoolAsk
- desc: Allow websites to show notifications.
-
-content.media_capture:
- default: ask
- type: BoolAsk
- backend: QtWebEngine
- desc: Allow websites to record audio/video.
-
-content.javascript.can_open_windows_automatically:
- default: false
- type: Bool
- desc: Whether JavaScript programs can open new windows without user
- interaction.
-
-content.javascript.can_close_windows:
- default: false
- type: Bool
- backend: QtWebKit
- desc: Whether JavaScript programs can close windows.
-
-content.javascript.can_access_clipboard:
- default: false
- type: Bool
- desc: >-
- Whether JavaScript programs can read or write to the clipboard.
-
- With QtWebEngine, writing the clipboard as response to a user interaction is always
- allowed.
-
-content.javascript.prompt:
- default: true
- type: Bool
- desc: Show javascript prompts.
-
-content.javascript.alert:
- default: false
- type: Bool
- desc: Show javascript.
-
-content.local_content_can_access_remote_urls:
- default: false
- type: Bool
- desc: Whether locally loaded documents are allowed to access remote urls.
-
-content.local_content_can_access_file_urls:
- default: true
- type: Bool
- desc: Whether locally loaded documents are allowed to access other local urls.
-
-content.cookies.accept:
- default: no-3rdparty
- backend: QtWebKit
+window.title_format:
type:
- name: 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."
- - never: "Don't accept cookies at all."
- desc: Control which cookies to accept.
-
-content.cookies.store:
- default: true
- type: Bool
- desc: Whether to store cookies. Note this option needs a restart with QtWebEngine
- on Qt < 5.9.
-
-content.host_blocking.lists:
- default:
- - "https://www.malwaredomainlist.com/hostslist/hosts.txt"
- - "http://someonewhocares.org/hosts/hosts"
- - "http://winhelp2002.mvps.org/hosts.zip"
- - "http://malwaredomains.lehigh.edu/files/justdomains.zip"
- - "https://pgl.yoyo.org/adservers/serverlist.php?hostformat=hosts&mimetype=plaintext"
- type:
- name: List
- valtype: Url
- none_ok: true
+ name: FormatString
+ fields:
+ - perc
+ - perc_raw
+ - title
+ - title_sep
+ - id
+ - scroll_pos
+ - host
+ - backend
+ - private
+ default: '{perc}{title}{title_sep}qutebrowser'
desc: |
- List of URLs of lists which contain hosts to block.
+ The format to use for the window title. The following placeholders are defined:
- The file can be in one of the following formats:
+ * `{perc}`: The percentage as a string like `[10%]`.
+ * `{perc_raw}`: The raw percentage, e.g. `10`
+ * `{title}`: The title of the current web page
+ * `{title_sep}`: The string ` - ` if a title is set, empty otherwise.
+ * `{id}`: The internal window ID of this window.
+ * `{scroll_pos}`: The page scroll position.
+ * `{host}`: The host of the current web page.
+ * `{backend}`: Either ''webkit'' or ''webengine''
+ * `{private}` : Indicates when private mode is enabled.
- - 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).
+## zoom
-content.host_blocking.enabled:
- default: true
- type: Bool
- desc: Whether host blocking is enabled.
+zoom.default:
+ type: Perc
+ default: 100%
+ desc: The default zoom level.
-content.host_blocking.whitelist:
- default:
- - piwik.org
+zoom.levels:
type:
name: List
- valtype: String
- none_ok: true
- desc: >-
- List of domains that should always be loaded, despite being ad-blocked.
+ valtype:
+ name: Perc
+ minval: 0
+ default:
+ - 25%
+ - 33%
+ - 50%
+ - 67%
+ - 75%
+ - 90%
+ - 100%
+ - 110%
+ - 125%
+ - 150%
+ - 175%
+ - 200%
+ - 250%
+ - 300%
+ - 400%
+ - 500%
+ desc: The available zoom levels.
- Domains may contain * and ? wildcards and are otherwise required to exactly match
- the requested domain.
-
- Local domains are always exempt from hostblocking.
-
-content.pdfjs:
- default: false
- type: Bool
- desc: >-
- Enable 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 viewer.
-
-
-# hints
-
-hints.border:
- default: '1px solid #E3BE23'
- type: String
- desc: CSS border value for hints.
-
-hints.mode:
- default: letter
- type:
- name: String
- valid_values:
- - number: Use numeric hints. (In this mode you can also type letters from
- the hinted element to filter and reduce the number of elements that
- are hinted.)
- - letter: Use the chars in the hints -> chars setting.
- - word: Use hints words based on the html elements and the extra words.
- desc: Mode to use for hints.
-
-hints.chars:
- default: asdfghjkl
- type:
- name: UniqueCharString
- minlen: 2
- completions:
- - ['asdfghjkl', "Home row"]
- - ['aoeuidnths', "Home row (Dvorak)"]
- - ['abcdefghijklmnopqrstuvwxyz', "All letters"]
- desc: Chars used for hint strings.
-
-hints.min_chars:
- default: 1
+zoom.mouse_divider:
+ default: 512
type:
name: Int
- minval: 1
- desc: Minimum number of chars used for hint strings.
+ minval: 0
+ desc: How much to divide the mouse wheel movements to translate them into zoom increments.
-hints.scatter:
- default: true
+zoom.text_only:
type: Bool
- desc: Whether to scatter hint key chains (like Vimium) or not (like dwb). Ignored
- for number hints.
-
-hints.uppercase:
default: false
- type: Bool
- desc: Make chars in hint strings uppercase.
+ backend: QtWebKit
+ desc: Whether the zoom factor on a frame applies only to the text or to all
+ content.
-hints.dictionary:
- default: /usr/share/dict/words
- type:
- name: File
- required: false
- desc: The dictionary file to be used by the word hints.
-
-hints.auto_follow:
- default: unique-match
- type:
- name: String
- valid_values:
- - always: "Auto-follow whenever there is only a single hint on a page."
- - unique-match: "Auto-follow whenever there is a unique non-empty match in
- either the hint string (word mode) or filter (number mode)."
- - full-match: "Follow the hint when the user typed the whole hint (letter,
- word or number mode) or the element's text (only in number mode)."
- - never: "The user will always need to press Enter to follow a hint."
- desc: Controls when a hint can be automatically followed without the user
- pressing Enter.
-
-hints.auto_follow_timeout:
- default: 0
- type: Int
- desc: A timeout (in milliseconds) to inhibit normal-mode key bindings after a
- successful auto-follow.
-
-hints.next_regexes:
- default:
- - "\\bnext\\b"
- - "\\bmore\\b"
- - "\\bnewer\\b"
- - "\\b[>\u2192\u226B]\\b"
- - "\\b(>>|\xBB)\\b"
- - "\\bcontinue\\b"
- type:
- name: List
- valtype:
- name: Regex
- flags: IGNORECASE
- desc: "A comma-separated list of regexes to use for 'next' links."
-
-hints.prev_regexes:
- default:
- - "\\bprev(ious)?\\b"
- - "\\bback\\b"
- - "\\bolder\\b"
- - "\\b[<\u2190\u226A]\\b"
- - "\\b(<<|\xAB)\\b"
- type:
- name: List
- valtype:
- name: Regex
- flags: IGNORECASE
- desc: A comma-separated list of regexes to use for 'prev' links.
-
-hints.find_implementation:
- default: python
- type:
- name: String
- valid_values:
- - javascript: Better but slower
- - python: Slightly worse but faster
- desc: Which implementation to use to find elements to hint.
-
-hints.hide_unmatched_rapid_hints:
- default: true
- type: Bool
- desc: Controls hiding unmatched hints in rapid mode.
-
-# searchengines
-
-searchengines:
- default:
- # FIXME:conf what if the user deletes/renames DEFAULT?
- DEFAULT: https://duckduckgo.com/?q={}
- type:
- name: Dict
- keytype: String
- valtype: SearchEngineUrl
- desc: FIXME
-
-# aliases
-
-aliases:
- default: {}
- type:
- name: Dict
- keytype:
- name: String
- forbidden: ' '
- valtype: Command
- none_ok: true
- desc: Command aliases FIXME
-
-# colors
+## colors
colors.completion.fg:
default: white
@@ -1291,6 +1289,16 @@ colors.completion.category.border.bottom:
type: QssColor
desc: Bottom border color of the completion widget category headers.
+colors.statusbar.insert.fg:
+ default: white
+ type: QssColor
+ desc: Foreground color of the statusbar in insert mode.
+
+colors.statusbar.insert.bg:
+ default: darkgreen
+ type: QssColor
+ desc: Background color of the statusbar in insert mode.
+
colors.completion.item.selected.fg:
default: black
type: QtColor
@@ -1326,193 +1334,6 @@ colors.completion.scrollbar.bg:
type: QssColor
desc: Color of the scrollbar in completion view
-colors.statusbar.normal.fg:
- default: white
- type: QssColor
- desc: Foreground color of the statusbar.
-
-colors.statusbar.normal.bg:
- default: black
- type: QssColor
- desc: Background color of the statusbar.
-
-colors.statusbar.private.fg:
- default: white
- type: QssColor
- desc: Foreground color of the statusbar in private browsing mode.
-
-colors.statusbar.private.bg:
- default: '#666666'
- type: QssColor
- desc: Background color of the statusbar in private browsing mode.
-
-colors.statusbar.insert.fg:
- default: white
- type: QssColor
- desc: Foreground color of the statusbar in insert mode.
-
-colors.statusbar.insert.bg:
- default: darkgreen
- type: QssColor
- desc: Background color of the statusbar in insert mode.
-
-colors.statusbar.command.fg:
- default: white
- type: QssColor
- desc: Foreground color of the statusbar in command mode.
-
-colors.statusbar.command.bg:
- default: black
- type: QssColor
- desc: Background color of the statusbar in command mode.
-
-colors.statusbar.command.private.fg:
- default: white
- type: QssColor
- desc: Foreground color of the statusbar in private browsing + command mode.
-
-colors.statusbar.command.private.bg:
- default: grey
- type: QssColor
- desc: Background color of the statusbar in private browsing + command mode.
-
-colors.statusbar.caret.fg:
- default: white
- type: QssColor
- desc: Foreground color of the statusbar in caret mode.
-
-colors.statusbar.caret.bg:
- default: purple
- type: QssColor
- desc: Background color of the statusbar in caret mode.
-
-colors.statusbar.caret.selection.fg:
- default: white
- type: QssColor
- desc: Foreground color of the statusbar in caret mode with a selection
-
-colors.statusbar.caret.selection.bg:
- default: '#a12dff'
- type: QssColor
- desc: Background color of the statusbar in caret mode with a selection
-
-colors.statusbar.progress.bg:
- default: white
- type: QssColor
- desc: Background color of the progress bar.
-
-colors.statusbar.url.fg:
- default: white
- type: QssColor
- desc: Default foreground color of the URL in the statusbar.
-
-colors.statusbar.url.success.http.fg:
- default: white
- type: QssColor
- desc: Foreground color of the URL in the statusbar on successful load (http).
-
-colors.statusbar.url.success.https.fg:
- default: lime
- type: QssColor
- desc: Foreground color of the URL in the statusbar on successful load (https).
-
-colors.statusbar.url.error.fg:
- default: orange
- type: QssColor
- desc: Foreground color of the URL in the statusbar on error.
-
-colors.statusbar.url.warn.fg:
- default: yellow
- type: QssColor
- desc: "Foreground color of the URL in the statusbar when there's a warning."
-
-colors.statusbar.url.hover.fg:
- default: aqua
- desc: Foreground color of the URL in the statusbar for hovered links.
- type: QssColor
-
-colors.tabs.odd.fg:
- default: white
- type: QtColor
- desc: Foreground color of unselected odd tabs.
-
-colors.tabs.odd.bg:
- default: grey
- type: QtColor
- desc: Background color of unselected odd tabs.
-
-colors.tabs.even.fg:
- default: white
- type: QtColor
- desc: Foreground color of unselected even tabs.
-
-colors.tabs.even.bg:
- default: darkgrey
- type: QtColor
- desc: Background color of unselected even tabs.
-
-colors.tabs.selected.odd.fg:
- default: white
- type: QtColor
- desc: Foreground color of selected odd tabs.
-
-colors.tabs.selected.odd.bg:
- default: black
- type: QtColor
- desc: Background color of selected odd tabs.
-
-colors.tabs.selected.even.fg:
- default: white
- type: QtColor
- desc: Foreground color of selected even tabs.
-
-colors.tabs.selected.even.bg:
- default: black
- type: QtColor
- desc: Background color of selected even tabs.
-
-colors.tabs.bar.bg:
- default: '#555555'
- type: QtColor
- desc: Background color of the tab bar.
-
-colors.tabs.indicator.start:
- default: '#0000aa'
- type: QtColor
- desc: Color gradient start for the tab indicator.
-
-colors.tabs.indicator.stop:
- default: '#00aa00'
- type: QtColor
- desc: Color gradient end for the tab indicator.
-
-colors.tabs.indicator.error:
- default: '#ff0000'
- type: QtColor
- desc: Color for the tab indicator on errors..
-
-colors.tabs.indicator.system:
- default: rgb
- type: ColorSystem
- desc: Color gradient interpolation system for the tab indicator.
-
-colors.hints.fg:
- default: black
- type: QssColor
- desc: Font color for hints.
-
-colors.hints.bg:
- default: qlineargradient(x1:0, y1:0, x2:0, y2:1, stop:0 rgba(255, 247, 133, 0.8),
- stop:1 rgba(255, 197, 66, 0.8))
- type: QssColor
- desc: Background color for hints. Note that you can use a `rgba(...)` value for
- transparency.
-
-colors.hints.match.fg:
- default: green
- type: QssColor
- desc: Font color for the matched part of hints.
-
colors.downloads.bar.bg:
default: black
type: QssColor
@@ -1558,12 +1379,22 @@ colors.downloads.error.bg:
type: QtColor
desc: Background color for downloads with errors.
-colors.webpage.bg:
- default: white
- type:
- name: QtColor
- none_ok: true
- desc: "Background color for webpages if unset (or empty to use the theme's color)"
+colors.hints.fg:
+ default: black
+ type: QssColor
+ desc: Font color for hints.
+
+colors.hints.bg:
+ default: qlineargradient(x1:0, y1:0, x2:0, y2:1, stop:0 rgba(255, 247, 133, 0.8),
+ stop:1 rgba(255, 197, 66, 0.8))
+ type: QssColor
+ desc: Background color for hints. Note that you can use a `rgba(...)` value for
+ transparency.
+
+colors.hints.match.fg:
+ default: green
+ type: QssColor
+ desc: Font color for the matched part of hints.
colors.keyhint.fg:
default: '#FFFFFF'
@@ -1640,8 +1471,174 @@ colors.prompts.selected.bg:
type: QssColor
desc: Background color for the selected item in filename prompts.
+colors.statusbar.normal.fg:
+ default: white
+ type: QssColor
+ desc: Foreground color of the statusbar.
-# fonts
+colors.statusbar.normal.bg:
+ default: black
+ type: QssColor
+ desc: Background color of the statusbar.
+
+colors.statusbar.private.fg:
+ default: white
+ type: QssColor
+ desc: Foreground color of the statusbar in private browsing mode.
+
+colors.statusbar.private.bg:
+ default: '#666666'
+ type: QssColor
+ desc: Background color of the statusbar in private browsing mode.
+
+colors.statusbar.command.fg:
+ default: white
+ type: QssColor
+ desc: Foreground color of the statusbar in command mode.
+
+colors.statusbar.command.bg:
+ default: black
+ type: QssColor
+ desc: Background color of the statusbar in command mode.
+
+colors.statusbar.command.private.fg:
+ default: white
+ type: QssColor
+ desc: Foreground color of the statusbar in private browsing + command mode.
+
+colors.statusbar.command.private.bg:
+ default: grey
+ type: QssColor
+ desc: Background color of the statusbar in private browsing + command mode.
+
+colors.statusbar.caret.fg:
+ default: white
+ type: QssColor
+ desc: Foreground color of the statusbar in caret mode.
+
+colors.statusbar.caret.bg:
+ default: purple
+ type: QssColor
+ desc: Background color of the statusbar in caret mode.
+
+colors.statusbar.caret.selection.fg:
+ default: white
+ type: QssColor
+ desc: Foreground color of the statusbar in caret mode with a selection
+
+colors.statusbar.caret.selection.bg:
+ default: '#a12dff'
+ type: QssColor
+ desc: Background color of the statusbar in caret mode with a selection
+
+colors.statusbar.progress.bg:
+ default: white
+ type: QssColor
+ desc: Background color of the progress bar.
+
+colors.statusbar.url.fg:
+ default: white
+ type: QssColor
+ desc: Default foreground color of the URL in the statusbar.
+
+colors.statusbar.url.error.fg:
+ default: orange
+ type: QssColor
+ desc: Foreground color of the URL in the statusbar on error.
+
+colors.statusbar.url.hover.fg:
+ default: aqua
+ desc: Foreground color of the URL in the statusbar for hovered links.
+ type: QssColor
+
+colors.statusbar.url.success.http.fg:
+ default: white
+ type: QssColor
+ desc: Foreground color of the URL in the statusbar on successful load (http).
+
+colors.statusbar.url.success.https.fg:
+ default: lime
+ type: QssColor
+ desc: Foreground color of the URL in the statusbar on successful load (https).
+
+colors.statusbar.url.warn.fg:
+ default: yellow
+ type: QssColor
+ desc: "Foreground color of the URL in the statusbar when there's a warning."
+
+colors.tabs.bar.bg:
+ default: '#555555'
+ type: QtColor
+ desc: Background color of the tab bar.
+
+colors.tabs.indicator.start:
+ default: '#0000aa'
+ type: QtColor
+ desc: Color gradient start for the tab indicator.
+
+colors.tabs.indicator.stop:
+ default: '#00aa00'
+ type: QtColor
+ desc: Color gradient end for the tab indicator.
+
+colors.tabs.indicator.error:
+ default: '#ff0000'
+ type: QtColor
+ desc: Color for the tab indicator on errors..
+
+colors.tabs.indicator.system:
+ default: rgb
+ type: ColorSystem
+ desc: Color gradient interpolation system for the tab indicator.
+
+colors.tabs.odd.fg:
+ default: white
+ type: QtColor
+ desc: Foreground color of unselected odd tabs.
+
+colors.tabs.odd.bg:
+ default: grey
+ type: QtColor
+ desc: Background color of unselected odd tabs.
+
+colors.tabs.even.fg:
+ default: white
+ type: QtColor
+ desc: Foreground color of unselected even tabs.
+
+colors.tabs.even.bg:
+ default: darkgrey
+ type: QtColor
+ desc: Background color of unselected even tabs.
+
+colors.tabs.selected.odd.fg:
+ default: white
+ type: QtColor
+ desc: Foreground color of selected odd tabs.
+
+colors.tabs.selected.odd.bg:
+ default: black
+ type: QtColor
+ desc: Background color of selected odd tabs.
+
+colors.tabs.selected.even.fg:
+ default: white
+ type: QtColor
+ desc: Foreground color of selected even tabs.
+
+colors.tabs.selected.even.bg:
+ default: black
+ type: QtColor
+ desc: Background color of selected even tabs.
+
+colors.webpage.bg:
+ default: white
+ type:
+ name: QtColor
+ none_ok: true
+ desc: "Background color for webpages if unset (or empty to use the theme's color)"
+
+## fonts
fonts.monospace:
default: xos4 Terminus, Terminus, Monospace, "DejaVu Sans Mono", Monaco, "Bitstream
@@ -1660,15 +1657,10 @@ fonts.completion.category:
type: Font
desc: Font used in the completion categories.
-fonts.tabbar:
+fonts.debug_console:
default: 8pt monospace
type: QtFont
- desc: Font used in the tab bar.
-
-fonts.statusbar:
- default: 8pt monospace
- type: Font
- desc: Font used in the statusbar.
+ desc: Font used for the debugging console.
fonts.downloads:
default: 8pt monospace
@@ -1680,10 +1672,40 @@ fonts.hints:
type: Font
desc: Font used for the hints.
-fonts.debug_console:
+fonts.keyhint:
+ default: 8pt monospace
+ type: Font
+ desc: Font used in the keyhint widget.
+
+fonts.messages.error:
+ default: 8pt monospace
+ type: Font
+ desc: Font used for error messages.
+
+fonts.messages.info:
+ default: 8pt monospace
+ type: Font
+ desc: Font used for info messages.
+
+fonts.messages.warning:
+ default: 8pt monospace
+ type: Font
+ desc: Font used for warning messages.
+
+fonts.prompts:
+ default: 8pt sans-serif
+ type: Font
+ desc: Font used for prompts.
+
+fonts.statusbar:
+ default: 8pt monospace
+ type: Font
+ desc: Font used in the statusbar.
+
+fonts.tabbar:
default: 8pt monospace
type: QtFont
- desc: Font used for the debugging console.
+ desc: Font used in the tab bar.
fonts.web.family.standard:
default: ''
@@ -1732,6 +1754,22 @@ fonts.web.family.fantasy:
# QWebSettings::QWebSettings() in
# qtwebkit/Source/WebKit/qt/Api/qwebsettings.cpp
+fonts.web.size.default:
+ default: 16
+ type:
+ name: Int
+ minval: 1
+ maxval: maxint
+ desc: The default font size for regular text.
+
+fonts.web.size.default_fixed:
+ default: 13
+ type:
+ name: Int
+ minval: 1
+ maxval: maxint
+ desc: The default font size for fixed-pitch text.
+
fonts.web.size.minimum:
default: 0
type:
@@ -1749,44 +1787,3 @@ fonts.web.size.minimum_logical:
minval: 0
maxval: maxint
desc: The minimum logical font size that is applied when zooming out.
-
-fonts.web.size.default:
- default: 16
- type:
- name: Int
- minval: 1
- maxval: maxint
- desc: The default font size for regular text.
-
-fonts.web.size.default_fixed:
- default: 13
- type:
- name: Int
- minval: 1
- maxval: maxint
- desc: The default font size for fixed-pitch text.
-
-fonts.keyhint:
- default: 8pt monospace
- type: Font
- desc: Font used in the keyhint widget.
-
-fonts.messages.error:
- default: 8pt monospace
- type: Font
- desc: Font used for error messages.
-
-fonts.messages.warning:
- default: 8pt monospace
- type: Font
- desc: Font used for warning messages.
-
-fonts.messages.info:
- default: 8pt monospace
- type: Font
- desc: Font used for info messages.
-
-fonts.prompts:
- default: 8pt sans-serif
- type: Font
- desc: Font used for prompts.