]> git.rmz.io Git - dotfiles.git/blobdiff - qutebrowser/qutebrowser.conf
qutebrowser: update configs
[dotfiles.git] / qutebrowser / qutebrowser.conf
index 7c95f9820cfaea0c5238ba509d3b9662b2d8c90b..30bc73d0c5bc99900ec3e54d2c02bdb9d1dc2bf6 100644 (file)
@@ -2,11 +2,6 @@
 
 # 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
@@ -129,6 +158,9 @@ xss-auditing = 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.
@@ -146,6 +178,11 @@ new-instance-open-target = tab
 #     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.
@@ -173,7 +210,8 @@ new-instance-open-target = tab
 #     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):
@@ -184,16 +222,35 @@ new-instance-open-target = tab
 #     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.
@@ -207,7 +264,7 @@ remove-finished-downloads = false
 #     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:
 #
@@ -244,6 +301,17 @@ dns-prefetch = true
 [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
@@ -254,11 +322,16 @@ dns-prefetch = true
 #     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.
@@ -270,9 +343,12 @@ dns-prefetch = true
 #     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
 
@@ -280,9 +356,13 @@ 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.
@@ -322,13 +402,27 @@ shrink = true
 #     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.
@@ -354,7 +448,7 @@ links-included-in-focus-chain = true
 #     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.
@@ -368,8 +462,13 @@ links-included-in-focus-chain = true
 #         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
 #
@@ -417,12 +516,25 @@ links-included-in-focus-chain = true
 #     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
@@ -432,17 +544,19 @@ width = 20%
 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.
@@ -451,8 +565,8 @@ tabs-are-windows = false
 #     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.
@@ -525,6 +639,16 @@ cache-size = 52428800
 #     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
@@ -540,6 +664,16 @@ cache-size = 52428800
 #     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.
@@ -554,7 +688,7 @@ cache-size = 52428800
 #
 # cookies-accept:
 #     Whether to accept cookies.
-#         default: Default QtWebKit behaviour.
+#         default: Default QtWebKit behavior.
 #         never: Don't accept cookies at all.
 #     Default: default
 #
@@ -572,17 +706,27 @@ cache-size = 52428800
 #     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.
@@ -605,6 +749,16 @@ host-block-lists = http://www.malwaredomainlist.com/hostslist/hosts.txt,http://s
 #     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
@@ -626,6 +780,8 @@ border = 1px solid #E3BE23
 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
@@ -635,9 +791,10 @@ prev-regexes = \bprev(ious)?\b,\bback\b,\bolder\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}
@@ -651,6 +808,9 @@ wiki = ${wikipedia}
 # 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.
@@ -671,9 +831,9 @@ wiki = ${wikipedia}
 #     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.
@@ -724,6 +884,10 @@ wiki = ${wikipedia}
 #     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
@@ -782,7 +946,7 @@ wiki = ${wikipedia}
 #     Default: black
 #
 # tabs.bg.bar (qcolor):
-#     Background color of the tabbar.
+#     Background color of the tab bar.
 #     Default: #555555
 #
 # tabs.indicator.start (qcolor):
@@ -804,10 +968,6 @@ wiki = ${wikipedia}
 #         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
@@ -849,7 +1009,7 @@ wiki = ${wikipedia}
 #     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
@@ -862,6 +1022,7 @@ completion.match.fg = #ff4444
 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
@@ -881,7 +1042,6 @@ tabs.indicator.start = #0000aa
 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))
@@ -909,7 +1069,7 @@ downloads.bg.error = red
 #     Default: 8pt ${_monospace}
 #
 # tabbar (font):
-#     Font used in the tabbar.
+#     Font used in the tab bar.
 #     Default: 8pt ${_monospace}
 #
 # statusbar (font):
@@ -928,27 +1088,27 @@ downloads.bg.error = red
 #     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:
 #