# Configfile for qutebrowser.
#
-# WARNING:
-#
-# This config file will be OVERWRITTEN when closing qutebrowser.
-# Close qutebrowser before changing this file, or YOUR CHANGES WILL BE LOST.
-#
# This configfile is parsed by python's configparser in extended
# interpolation mode. The format is very INI-like, so there are
# categories like [general] with "key = value"-pairs.
# Interpolation looks like ${value} or ${section:value} and will be
# replaced by the respective value.
#
+# Some settings will expand environment variables. Note that, since
+# interpolation is run first, you will need to escape the $ char as
+# described below.
+#
# This is the default config, so if you want to remove anything from
-# here (as opposed to change/add), for example a keybinding, set it to
+# here (as opposed to change/add), for example a key binding, set it to
# an empty value.
#
# You will need to escape the following values:
# The default page(s) to open at the start, separated by commas.
# Default: https://www.duckduckgo.com
#
+# default-page:
+# The page to open if :open -t/-b/-w is used without URL. Use
+# `about:blank` for a blank page.
+# Default: ${startpage}
+#
# auto-search:
# Whether to start a search when something else than a URL is
# entered.
# Valid values: true, false
# Default: true
#
+# auto-save-interval (int):
+# How often (in milliseconds) to auto-save config/cookies/etc.
+# Default: 15000
+#
# editor (shell-command):
# The editor (and arguments) to use for the `open-editor` command.
# Use `{}` for the filename. The value gets split like in a shell,
# How to open links in an existing instance if a new one is
# launched.
# tab: Open a new tab in the existing window and activate it.
+# tab-bg: Open a new background tab in the existing window and
+# activate it.
# tab-silent: Open a new tab in the existing window without
# activating it.
+# tab-bg-silent: Open a new background tab in the existing
+# window without activating it.
# window: Open in a new window.
# Default: window
+#
+# log-javascript-console (bool):
+# Whether to log javascript console messages.
+# Valid values: true, false
+# Default: false
+#
+# save-session (bool):
+# Whether to always save the open pages.
+# Valid values: true, false
+# Default: false
+#
+# session-default-name (session):
+# The name of the session to save by default, or empty for the last
+# loaded session.
+# Default:
ignore-case = smart
wrap-search = true
startpage = https://www.duckduckgo.com
+default-page = ${startpage}
auto-search = naive
auto-save-config = true
+auto-save-interval = 15000
editor = urxvt -e vim "{}"
editor-encoding = utf-8
private-browsing = false
site-specific-quirks = true
default-encoding =
new-instance-open-target = tab
+log-javascript-console = false
+save-session = true
+session-default-name =
[ui]
# General options related to the user interface.
# Time (in ms) to show messages in the statusbar for.
# Default: 2000
#
+# message-unfocused (bool):
+# Whether to show messages in unfocused windows.
+# Valid values: true, false
+# Default: false
+#
# confirm-quit (string-list):
# Whether to confirm quitting the application.
# always: Always show a confirmation.
# Default: false
#
# user-stylesheet (user-stylesheet):
-# User stylesheet to use (absolute filename or CSS string).
+# User stylesheet to use (absolute filename or CSS string). Will
+# expand environment variables.
# Default: ::-webkit-scrollbar { width: 0px; height: 0px; }
#
# css-media-type (string):
# Whether to remove finished downloads automatically.
# Valid values: true, false
# Default: false
+#
+# hide-statusbar (bool):
+# Whether to hide the statusbar unless a message is shown.
+# Valid values: true, false
+# Default: false
+#
+# window-title-format (format-string):
+# 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 web page
+# * `{title_sep}`: The string ` - ` if a title is set, empty
+# otherwise.
+# * `{id}`: The internal window ID of this window.
+# Default: {perc}{title}{title_sep}qutebrowser
zoom-levels = 25%,33%,50%,67%,75%,90%,100%,110%,125%,150%,175%,200%,250%,300%,400%,500%
default-zoom = 100%
message-timeout = 2000
+message-unfocused = false
confirm-quit = downloads
display-statusbar-messages = false
zoom-text-only = false
frame-flattening = false
-user-stylesheet = ::-webkit-scrollbar { width: 0px; height: 0px; }
+user-stylesheet = $$XDG_CONFIG_HOME/qutebrowser/css/default.css
css-media-type =
remove-finished-downloads = false
+hide-statusbar = false
+window-title-format = {perc}{title}{title_sep}qutebrowser
[network]
# Settings related to the network.
# Value to send in the `accept-language` header.
# Default: en-US,en
#
-# user-agent (string):
+# user-agent (user-agent):
# User agent to send. Empty to send the default.
# Default:
#
[completion]
# Options related to completion and command history.
#
+# download-path-suggestion:
+# What to display in the download filename input.
+# path: Show only the download path.
+# filename: Show only download filename.
+# both: Show download path and filename.
+# Default: path
+#
+# timestamp-format (string):
+# How to format timestamps (e.g. for history)
+# Default: %Y-%m-%d
+#
# show (bool):
# Whether to show the autocompletion window.
# Valid values: true, false
# window.
# Default: 50%
#
-# history-length (int):
-# How many commands to save in the history.
+# cmd-history-max-items (int):
+# How many commands to save in the command history.
# 0: no history / -1: unlimited
# Default: 100
#
+# web-history-max-items (int):
+# How many URLs to show in the web history.
+# 0: no history / -1: unlimited
+# Default: 1000
+#
# quick-complete (bool):
# Whether to move on to the next part when there's only one possible
# completion left.
# size if there are no scrollbars.
# Valid values: true, false
# Default: false
+download-path-suggestion = path
+timestamp-format = %Y-%m-%d
show = true
height = 150
-history-length = 100
+cmd-history-max-items = 100
+web-history-max-items = 1000
quick-complete = false
shrink = true
# Options related to input modes.
#
# timeout (int):
-# Timeout for ambiguous keybindings.
+# Timeout for ambiguous key bindings.
# Default: 500
#
+# partial-timeout (int):
+# Timeout for partially typed key bindings.
+# Default: 1000
+#
# insert-mode-on-plugins (bool):
# Whether to switch to insert mode when clicking flash and other
# plugins.
# Whether hyperlinks should be included in the keyboard focus chain.
# Valid values: true, false
# Default: true
+#
+# rocker-gestures (bool):
+# Whether to enable Opera-like mouse rocker gestures. This disables
+# the context menu.
+# Valid values: true, false
+# Default: false
+#
+# mouse-zoom-divider (int):
+# How much to divide the mouse wheel movements to translate them
+# into zoom increments.
+# Default: 512
timeout = 500
+partial-timeout = 1000
insert-mode-on-plugins = false
auto-leave-insert-mode = true
auto-insert-mode = false
forward-unbound-keys = auto
spatial-navigation = false
links-included-in-focus-chain = true
+rocker-gestures = false
+mouse-zoom-divider = 512
[tabs]
# Configuration of the tab bar.
# Default: right
#
# new-tab-position-explicit:
-# How new tabs opened explicitely are positioned.
+# How new tabs opened explicitly are positioned.
# left: On the left of the current tab.
# right: On the right of the current tab.
# first: At the left end.
# close: Close the window.
# Default: ignore
#
-# auto-hide (bool):
-# Hide the tabbar if only one tab is open.
+# hide-auto (bool):
+# Hide the tab bar if only one tab is open.
+# Valid values: true, false
+# Default: false
+#
+# hide-always (bool):
+# Always hide the tab bar.
# Valid values: true, false
# Default: false
#
# Whether to open windows instead of tabs.
# Valid values: true, false
# Default: false
+#
+# title-format (format-string):
+# 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 web page
+# * `{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: {index}: {title}
background-tabs = false
select-on-remove = left
new-tab-position = right
new-tab-position-explicit = last
last-close = ignore
-auto-hide = false
+hide-auto = false
+hide-always = false
wrap = true
movable = true
close-mouse-button = middle
indicator-width = 3
indicator-space = 3
tabs-are-windows = false
+title-format = {index}: {title}
[storage]
# Settings related to cache and storage.
#
# download-directory (directory):
# The directory to save downloads to. An empty value selects a
-# sensible os-specific default.
+# sensible os-specific default. Will expand environment variables.
# Default:
#
# maximum-pages-in-cache (int):
-# The maximum number of pages to hold in the memory page cache.
+# 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.
# Default:
#
# object-cache-capacities (bytes-list):
-# The capacities for the memory cache for dead objects such as
-# stylesheets or scripts. Syntax: cacheMinDeadCapacity,
+# The capacities for the global 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.
# Valid values: true, false
# Default: false
#
+# geolocation:
+# Allow websites to request geolocations.
+# Valid values: false, ask
+# Default: ask
+#
+# notifications:
+# Allow websites to show notifications.
+# Valid values: false, ask
+# Default: ask
+#
# javascript-can-open-windows (bool):
# Whether JavaScript programs can open new windows.
# Valid values: true, false
# Valid values: true, false
# Default: false
#
+# ignore-javascript-prompt (bool):
+# Whether all javascript prompts should be ignored.
+# Valid values: true, false
+# Default: false
+#
+# ignore-javascript-alert (bool):
+# Whether all javascript alerts should be ignored.
+# Valid values: true, false
+# Default: false
+#
# local-content-can-access-remote-urls (bool):
# Whether locally loaded documents are allowed to access remote
# urls.
#
# cookies-accept:
# Whether to accept cookies.
-# default: Default QtWebKit behaviour.
+# default: Default QtWebKit behavior.
# never: Don't accept cookies at all.
# Default: default
#
# file named 'hosts' (with any extension).
# Default:
# 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
+#
+# host-blocking-enabled (bool):
+# Whether host blocking is enabled.
+# Valid values: true, false
+# Default: true
allow-images = true
allow-javascript = true
allow-plugins = false
+geolocation = ask
+notifications = ask
javascript-can-open-windows = true
javascript-can-close-windows = true
javascript-can-access-clipboard = false
+ignore-javascript-prompt = false
+ignore-javascript-alert = false
local-content-can-access-remote-urls = false
local-content-can-access-file-urls = true
cookies-accept = default
cookies-store = true
host-block-lists = 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
+host-blocking-enabled = true
[hints]
# Hinting settings.
# Chars used for hint strings.
# Default: asdfghjkl
#
+# min-chars (int):
+# Mininum number of chars used for hint strings.
+# Default: 1
+#
+# scatter (bool):
+# Whether to scatter hint key chains (like Vimium) or not (like
+# dwb).
+# Valid values: true, false
+# Default: true
+#
# uppercase (bool):
# Make chars in hint strings uppercase.
# Valid values: true, false
opacity = 0.7
mode = letter
chars = aoeuidhtns
+min-chars = 1
+scatter = true
uppercase = true
auto-follow = true
next-regexes = \bnext\b,\bmore\b,\bnewer\b,\b[>→≫]\b,\b(>>|»)\b
# 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.
+# search engines can be used by prepending the search engine name to the
+# search term, e.g. `:open google qutebrowser`. The string `{}` will be
+# replaced by the search term, use `{{` and `}}` for literal `{`/`}`
+# signs.
DEFAULT = ${duckduckgo}
duckduckgo = https://duckduckgo.com/?q={}
ddg = ${duckduckgo}
# By default, no aliases are defined. Example which adds a new command
# `:qtb` to open qutebrowsers website:
# `qtb = open http://www.qutebrowser.org/`
+quit = close
+q = close
+exit = quit
[colors]
# Colors used in the UI.
# Background color of the completion widget.
# Default: #333333
#
-# completion.item.bg (qss-color):
-# Background color of completion widget items.
-# Default: ${completion.bg}
+# completion.alternate-bg (qss-color):
+# Alternating background color of the completion widget.
+# Default: #444444
#
# completion.category.fg (qcolor):
# Foreground color of completion widget category headers.
# Background color of the statusbar if there was an error.
# Default: red
#
+# statusbar.bg.warning (qss-color):
+# Background color of the statusbar if there is a warning.
+# Default: darkorange
+#
# statusbar.bg.prompt (qss-color):
# Background color of the statusbar if there is a prompt.
# Default: darkblue
# Default: black
#
# tabs.bg.bar (qcolor):
-# Background color of the tabbar.
+# Background color of the tab bar.
# Default: #555555
#
# tabs.indicator.start (qcolor):
# hsl: Interpolate in the HSL color system.
# Default: rgb
#
-# tabs.seperator (qss-color):
-# Color for the tab seperator.
-# Default: #555555
-#
# hints.fg (css-color):
# Font color for hints.
# Default: black
# Default: red
completion.fg = white
completion.bg = #333333
-completion.item.bg = ${completion.bg}
+completion.alternate-bg = #444444
completion.category.fg = white
completion.category.bg = qlineargradient(x1:0, y1:0, x2:0, y2:1, stop:0 #888888, stop:1 #505050)
completion.category.border.top = black
statusbar.bg = black
statusbar.fg = white
statusbar.bg.error = red
+statusbar.bg.warning = darkorange
statusbar.bg.prompt = darkblue
statusbar.bg.insert = darkgreen
statusbar.progress.bg = white
tabs.indicator.stop = #00aa00
tabs.indicator.error = #ff0000
tabs.indicator.system = rgb
-tabs.seperator = #555555
hints.fg = black
hints.fg.match = green
hints.bg = -webkit-gradient(linear, left top, left bottom, color-stop(0%,#FFF785), color-stop(100%,#FFC542))
# Default: 8pt ${_monospace}
#
# tabbar (font):
-# Font used in the tabbar.
+# Font used in the tab bar.
# Default: 8pt ${_monospace}
#
# statusbar (font):
# Font used for the debugging console.
# Default: 8pt ${_monospace}
#
-# web-family-standard (string):
+# web-family-standard (font):
# Font family for standard fonts.
# Default:
#
-# web-family-fixed (string):
+# web-family-fixed (font):
# Font family for fixed fonts.
# Default:
#
-# web-family-serif (string):
+# web-family-serif (font):
# Font family for serif fonts.
# Default:
#
-# web-family-sans-serif (string):
+# web-family-sans-serif (font):
# Font family for sans-serif fonts.
# Default:
#
-# web-family-cursive (string):
+# web-family-cursive (font):
# Font family for cursive fonts.
# Default:
#
-# web-family-fantasy (string):
+# web-family-fantasy (font):
# Font family for fantasy fonts.
# Default:
#