3 # Configfile for qutebrowser.
5 # This configfile is parsed by python's configparser in extended
6 # interpolation mode. The format is very INI-like, so there are
7 # categories like [general] with "key = value"-pairs.
9 # Note that you shouldn't add your own comments, as this file is
10 # regenerated every time the config is saved.
12 # Interpolation looks like ${value} or ${section:value} and will be
13 # replaced by the respective value.
15 # Some settings will expand environment variables. Note that, since
16 # interpolation is run first, you will need to escape the $ char as
19 # This is the default config, so if you want to remove anything from
20 # here (as opposed to change/add), for example a key binding, set it to
23 # You will need to escape the following values:
24 # - # at the start of the line (at the first position of the key) (\#)
28 # General/miscellaneous options.
30 # ignore-case (IgnoreCase):
31 # Whether to find text on a page case-insensitively.
32 # true: Search case-insensitively
33 # false: Search case-sensitively
34 # smart: Search case-sensitively if there are capital chars
37 # startpage (List of String):
38 # The default page(s) to open at the start, separated by commas.
39 # Default: https://start.duckduckgo.com
41 # yank-ignored-url-parameters (List of String):
42 # The URL parameters to strip with :yank url, separated by commas.
44 # ref,utm_source,utm_medium,utm_campaign,utm_term,utm_content
46 # default-page (FuzzyUrl):
47 # The page to open if :open -t/-b/-w is used without URL. Use
48 # `about:blank` for a blank page.
49 # Default: ${startpage}
51 # auto-search (AutoSearch):
52 # Whether to start a search when something else than a URL is
54 # naive: Use simple/naive check.
55 # dns: Use DNS requests (might be slow!).
56 # false: Never search automatically.
59 # auto-save-config (Bool):
60 # Whether to save the config automatically on quit.
61 # Valid values: true, false
64 # auto-save-interval (Int):
65 # How often (in milliseconds) to auto-save config/cookies/etc.
68 # editor (ShellCommand):
69 # The editor (and arguments) to use for the `open-editor` command.
70 # The arguments get split like in a shell, so you can use `"` or `'`
72 # `{}` gets replaced by the filename of the file to be edited.
73 # Default: gvim -f "{}"
75 # editor-encoding (Encoding):
76 # Encoding to use for editor.
79 # private-browsing (Bool):
80 # Do not record visited pages in the history or store web page
82 # Valid values: true, false
85 # developer-extras (Bool):
86 # Enable extra tools for Web developers.
87 # This needs to be enabled for `:inspector` to work and also adds an
88 # _Inspect_ entry to the context menu.
89 # Valid values: true, false
92 # print-element-backgrounds (Bool):
93 # Whether the background color and images are also drawn when the
95 # Valid values: true, false
98 # xss-auditing (Bool):
99 # Whether load requests should be monitored for cross-site scripting
101 # Suspicious scripts will be blocked and reported in the inspector's
102 # JavaScript console. Enabling this feature might have an impact on
104 # Valid values: true, false
107 # site-specific-quirks (Bool):
108 # Enable workarounds for broken sites.
109 # Valid values: true, false
112 # default-encoding (String):
113 # Default encoding to use for websites.
114 # The encoding must be a string describing an encoding such as
115 # _utf-8_, _iso-8859-1_, etc. If left empty a default value will be
119 # new-instance-open-target (String):
120 # How to open links in an existing instance if a new one is
122 # tab: Open a new tab in the existing window and activate the
124 # tab-bg: Open a new background tab in the existing window and
125 # activate the window.
126 # tab-silent: Open a new tab in the existing window without
127 # activating the window.
128 # tab-bg-silent: Open a new background tab in the existing
129 # window without activating the window.
130 # window: Open in a new window.
133 # new-instance-open-target.window (String):
134 # Which window to choose when opening links as new tabs.
135 # first-opened: Open new tabs in the first (oldest) opened
137 # last-opened: Open new tabs in the last (newest) opened window.
138 # last-focused: Open new tabs in the most recently focused
140 # last-visible: Open new tabs in the most recently visible
142 # Default: last-focused
144 # log-javascript-console (String):
145 # How to log javascript console messages.
146 # none: Don't log messages.
147 # debug: Log messages with debug level.
148 # info: Log messages with info level.
151 # save-session (Bool):
152 # Whether to always save the open pages.
153 # Valid values: true, false
156 # session-default-name (SessionName):
157 # The name of the session to save by default, or empty for the last
161 # url-incdec-segments (FlagList):
162 # The URL segments where `:navigate increment/decrement` will search
164 # Valid values: host, path, query, anchor
165 # Default: path,query
167 startpage = https://duckduckgo.com/?t=chakra
168 yank-ignored-url-parameters = ref,utm_source,utm_medium,utm_campaign,utm_term,utm_content
169 default-page = ${startpage}
171 auto-save-config = true
172 auto-save-interval = 15000
173 editor = urxvt -e vim "{}"
174 editor-encoding = utf-8
175 private-browsing = false
176 developer-extras = true
177 print-element-backgrounds = true
179 site-specific-quirks = true
181 new-instance-open-target = tab
182 new-instance-open-target.window = last-focused
183 log-javascript-console = none
185 session-default-name =
186 url-incdec-segments = path,query
189 # General options related to the user interface.
191 # zoom-levels (List of Perc):
192 # The available zoom levels, separated by commas.
194 # 25%,33%,50%,67%,75%,90%,100%,110%,125%,150%,175%,200%,250%,300%,400%,500%
196 # default-zoom (Perc):
197 # The default zoom level.
200 # downloads-position (VerticalPosition):
201 # Where to show the downloaded files.
202 # Valid values: top, bottom
205 # status-position (VerticalPosition):
206 # The position of the status bar.
207 # Valid values: top, bottom
210 # message-timeout (Int):
211 # Time (in ms) to show messages in the statusbar for.
214 # message-unfocused (Bool):
215 # Whether to show messages in unfocused windows.
216 # Valid values: true, false
219 # confirm-quit (ConfirmQuit):
220 # Whether to confirm quitting the application.
221 # always: Always show a confirmation.
222 # multiple-tabs: Show a confirmation if multiple tabs are
224 # downloads: Show a confirmation if downloads are running
225 # never: Never show a confirmation.
228 # zoom-text-only (Bool):
229 # Whether the zoom factor on a frame applies only to the text or to
231 # Valid values: true, false
234 # frame-flattening (Bool):
235 # Whether to expand each subframe to its contents.
236 # This will flatten all the frames to become one scrollable page.
237 # Valid values: true, false
240 # user-stylesheet (UserStyleSheet):
241 # User stylesheet to use (absolute filename, filename relative to
242 # the config directory or CSS string). Will expand environment
244 # Default: html > ::-webkit-scrollbar { width: 0px; height: 0px; }
246 # css-media-type (String):
247 # Set the CSS media type.
250 # smooth-scrolling (Bool):
251 # Whether to enable smooth scrolling for webpages.
252 # Valid values: true, false
255 # remove-finished-downloads (Int):
256 # Number of milliseconds to wait before removing finished downloads.
257 # Will not be removed if value is -1.
260 # hide-statusbar (Bool):
261 # Whether to hide the statusbar unless a message is shown.
262 # Valid values: true, false
265 # statusbar-padding (Padding):
266 # Padding for statusbar (top, bottom, left, right).
269 # window-title-format (FormatString):
270 # The format to use for the window title. The following placeholders
272 # * `{perc}`: The percentage as a string like `[10%]`.
273 # * `{perc_raw}`: The raw percentage, e.g. `10`
274 # * `{title}`: The title of the current web page
275 # * `{title_sep}`: The string ` - ` if a title is set, empty
277 # * `{id}`: The internal window ID of this window.
278 # * `{scroll_pos}`: The page scroll position.
279 # * `{host}`: The host of the current web page.
280 # Default: {perc}{title}{title_sep}qutebrowser
282 # modal-js-dialog (Bool):
283 # Use standard JavaScript modal dialog for alert() and confirm()
284 # Valid values: true, false
287 # hide-wayland-decoration (Bool):
288 # Hide the window decoration when using wayland (requires restart)
289 # Valid values: true, false
292 # keyhint-blacklist (List of String):
293 # Keychains that shouldn't be shown in the keyhint dialog
294 # Globs are supported, so ';*' will blacklist all keychainsstarting
295 # with ';'. Use '*' to disable keyhints
298 # prompt-radius (Int):
299 # The rounding radius for the edges of prompts.
301 zoom-levels = 25%,33%,50%,67%,75%,90%,100%,110%,125%,150%,175%,200%,250%,300%,400%,500%
303 downloads-position = top
304 status-position = bottom
305 message-timeout = 2000
306 message-unfocused = false
307 confirm-quit = downloads
308 zoom-text-only = false
309 frame-flattening = false
310 user-stylesheet = html > ::-webkit-scrollbar { width: 0px; height: 0px; }
312 smooth-scrolling = false
313 remove-finished-downloads = -1
314 hide-statusbar = false
315 statusbar-padding = 1,1,0,0
316 window-title-format = {perc}{title}{title_sep}qutebrowser
317 modal-js-dialog = false
318 hide-wayland-decoration = false
323 # Settings related to the network.
325 # do-not-track (Bool):
326 # Value to send in the `DNT` header.
327 # Valid values: true, false
330 # accept-language (String):
331 # Value to send in the `accept-language` header.
334 # referer-header (String):
335 # Send the Referer header
336 # always: Always send.
337 # never: Never send; this is not recommended, as some sites may
339 # same-domain: Only send for the same domain. This will still
340 # protect your privacy, but shouldn't break any sites.
341 # Default: same-domain
343 # user-agent (UserAgent):
344 # User agent to send. Empty to send the default.
349 # In addition to the listed values, you can use a `socks://...` or
351 # system: Use the system wide proxy.
352 # none: Don't use any proxy
355 # proxy-dns-requests (Bool):
356 # Whether to send DNS requests over the configured proxy.
357 # Valid values: true, false
360 # ssl-strict (BoolAsk):
361 # Whether to validate SSL handshakes.
362 # Valid values: true, false, ask
365 # dns-prefetch (Bool):
366 # Whether to try to pre-fetch DNS entries to speed up browsing.
367 # Valid values: true, false
370 # custom-headers (HeaderDict):
371 # Set custom headers for qutebrowser HTTP requests.
375 # Set location of a netrc-file for HTTP authentication. If empty,
379 accept-language = en-US,en,de,fr
380 referer-header = same-domain
383 proxy-dns-requests = true
390 # Options related to completion and command history.
393 # When to show the autocompletion window.
394 # always: Whenever a completion is available.
395 # auto: Whenever a completion is requested.
399 # download-path-suggestion (String):
400 # What to display in the download filename input.
401 # path: Show only the download path.
402 # filename: Show only download filename.
403 # both: Show download path and filename.
406 # timestamp-format (TimestampTemplate):
407 # How to format timestamps (e.g. for history)
410 # height (PercOrInt):
411 # The height of the completion, in px or as percentage of the
415 # cmd-history-max-items (Int):
416 # How many commands to save in the command history.
417 # 0: no history / -1: unlimited
420 # web-history-max-items (Int):
421 # How many URLs to show in the web history.
422 # 0: no history / -1: unlimited
425 # quick-complete (Bool):
426 # Whether to move on to the next part when there's only one possible
428 # Valid values: true, false
432 # Whether to shrink the completion to be smaller than the configured
433 # size if there are no scrollbars.
434 # Valid values: true, false
437 # scrollbar-width (Int):
438 # Width of the scrollbar in the completion window (in px).
441 # scrollbar-padding (Int):
442 # Padding of scrollbar handle in completion window (in px).
445 download-path-suggestion = path
446 timestamp-format = %Y-%m-%d
448 cmd-history-max-items = 100
449 web-history-max-items = 1000
450 quick-complete = false
453 scrollbar-padding = 2
456 # Options related to input modes.
459 # Timeout (in milliseconds) for ambiguous key bindings.
460 # If the current input forms both a complete match and a partial
461 # match, the complete match will be executed after this time.
464 # partial-timeout (Int):
465 # Timeout (in milliseconds) for partially typed key bindings.
466 # If the current input forms only partial matches, the keystring
467 # will be cleared after this time.
470 # insert-mode-on-plugins (Bool):
471 # Whether to switch to insert mode when clicking flash and other
473 # Valid values: true, false
476 # auto-leave-insert-mode (Bool):
477 # Whether to leave insert mode if a non-editable element is clicked.
478 # Valid values: true, false
481 # auto-insert-mode (Bool):
482 # Whether to automatically enter insert mode if an editable element
483 # is focused after page load.
484 # Valid values: true, false
487 # forward-unbound-keys (String):
488 # Whether to forward unbound keys to the webview in normal mode.
489 # all: Forward all unbound keys.
490 # auto: Forward unbound non-alphanumeric keys.
491 # none: Don't forward any keys.
494 # spatial-navigation (Bool):
495 # Enables or disables the Spatial Navigation feature.
496 # Spatial navigation consists in the ability to navigate between
497 # focusable elements in a Web page, such as hyperlinks and form
498 # controls, by using Left, Right, Up and Down arrow keys. For
499 # example, if a user presses the Right key, heuristics determine
500 # whether there is an element he might be trying to reach towards
501 # the right and which element he probably wants.
502 # Valid values: true, false
505 # links-included-in-focus-chain (Bool):
506 # Whether hyperlinks should be included in the keyboard focus chain.
507 # Valid values: true, false
510 # rocker-gestures (Bool):
511 # Whether to enable Opera-like mouse rocker gestures. This disables
513 # Valid values: true, false
516 # mouse-zoom-divider (Int):
517 # How much to divide the mouse wheel movements to translate them
518 # into zoom increments.
521 partial-timeout = 1000
522 insert-mode-on-plugins = false
523 auto-leave-insert-mode = true
524 auto-insert-mode = false
525 forward-unbound-keys = auto
526 spatial-navigation = false
527 links-included-in-focus-chain = true
528 rocker-gestures = false
529 mouse-zoom-divider = 512
532 # Configuration of the tab bar.
534 # background-tabs (Bool):
535 # Whether to open new tabs (middleclick/ctrl+click) in background.
536 # Valid values: true, false
539 # select-on-remove (SelectOnRemove):
540 # Which tab to select when the focused tab is removed.
541 # prev: Select the tab which came before the closed one (left in
542 # horizontal, above in vertical).
543 # next: Select the tab which came after the closed one (right in
544 # horizontal, below in vertical).
545 # last-used: Select the previously selected tab.
548 # new-tab-position (NewTabPosition):
549 # How new tabs are positioned.
550 # prev: Before the current tab.
551 # next: After the current tab.
552 # first: At the beginning.
556 # new-tab-position-explicit (NewTabPosition):
557 # How new tabs opened explicitly are positioned.
558 # prev: Before the current tab.
559 # next: After the current tab.
560 # first: At the beginning.
564 # last-close (String):
565 # Behavior when the last tab is closed.
566 # ignore: Don't do anything.
567 # blank: Load a blank page.
568 # startpage: Load the start page.
569 # default-page: Load the default page.
570 # close: Close the window.
574 # When to show the tab bar
575 # always: Always show the tab bar.
576 # never: Always hide the tab bar.
577 # multiple: Hide the tab bar if only one tab is open.
578 # switching: Show the tab bar when switching tabs.
581 # show-switching-delay (Int):
582 # Time to show the tab bar before hiding it when tabs->show is set
587 # Whether to wrap when changing tabs.
588 # Valid values: true, false
592 # Whether tabs should be movable.
593 # Valid values: true, false
596 # close-mouse-button (String):
597 # On which mouse button to close tabs.
598 # right: Close tabs on right-click.
599 # middle: Close tabs on middle-click.
600 # none: Don't close tabs using the mouse.
603 # position (Position):
604 # The position of the tab bar.
605 # Valid values: top, bottom, left, right
608 # show-favicons (Bool):
609 # Whether to show favicons in the tab bar.
610 # Valid values: true, false
614 # The width of the tab bar if it's vertical, in px or as percentage
618 # indicator-width (Int):
619 # Width of the progress indicator (0 to disable).
622 # tabs-are-windows (Bool):
623 # Whether to open windows instead of tabs.
624 # Valid values: true, false
627 # title-format (FormatString):
628 # The format to use for the tab title. The following placeholders
630 # * `{perc}`: The percentage as a string like `[10%]`.
631 # * `{perc_raw}`: The raw percentage, e.g. `10`
632 # * `{title}`: The title of the current web page
633 # * `{title_sep}`: The string ` - ` if a title is set, empty
635 # * `{index}`: The index of this tab.
636 # * `{id}`: The internal tab ID of this tab.
637 # * `{scroll_pos}`: The page scroll position.
638 # * `{host}`: The host of the current web page.
639 # Default: {index}: {title}
641 # title-alignment (TextAlignment):
642 # Alignment of the text inside of tabs
643 # Valid values: left, right, center
646 # mousewheel-tab-switching (Bool):
647 # Switch between tabs using the mouse wheel.
648 # Valid values: true, false
652 # Padding for tabs (top, bottom, left, right).
655 # indicator-padding (Padding):
656 # Padding for indicators (top, bottom, left, right).
658 background-tabs = false
659 select-on-remove = prev
660 new-tab-position = next
661 new-tab-position-explicit = next
664 show-switching-delay = 800
667 close-mouse-button = middle
672 tabs-are-windows = false
673 title-format = {index}: {title}
674 title-alignment = left
675 mousewheel-tab-switching = true
677 indicator-padding = 2,2,0,4
680 # Settings related to cache and storage.
682 # download-directory (Directory):
683 # The directory to save downloads to. An empty value selects a
684 # sensible os-specific default. Will expand environment variables.
687 # prompt-download-directory (Bool):
688 # Whether to prompt the user for the download location.
689 # If set to false, 'download-directory' will be used.
690 # Valid values: true, false
693 # remember-download-directory (Bool):
694 # Whether to remember the last used download directory.
695 # Valid values: true, false
698 # maximum-pages-in-cache (Int):
699 # The maximum number of pages to hold in the global memory page
701 # The Page Cache allows for a nicer user experience when navigating
702 # forth or back to pages in the forward/back history, by pausing and
703 # resuming up to _n_ pages.
704 # For more information about the feature, please refer to:
705 # http://webkit.org/blog/427/webkit-page-cache-i-the-basics/
708 # object-cache-capacities (List of WebKitBytes):
709 # The capacities for the global memory cache for dead objects such
710 # as stylesheets or scripts. Syntax: cacheMinDeadCapacity,
711 # cacheMaxDead, totalCapacity.
712 # The _cacheMinDeadCapacity_ specifies the minimum number of bytes
713 # that dead objects should consume when the cache is under pressure.
714 # _cacheMaxDead_ is the maximum number of bytes that dead objects
715 # should consume when the cache is *not* under pressure.
716 # _totalCapacity_ specifies the maximum number of bytes that the
717 # cache should consume *overall*.
720 # offline-storage-default-quota (WebKitBytes):
721 # Default quota for new offline storage databases.
724 # offline-web-application-cache-quota (WebKitBytes):
725 # Quota for the offline web application cache.
728 # offline-storage-database (Bool):
729 # Whether support for the HTML 5 offline storage feature is enabled.
730 # Valid values: true, false
733 # offline-web-application-storage (Bool):
734 # Whether support for the HTML 5 web application cache feature is
736 # An application cache acts like an HTTP cache in some sense. For
737 # documents that use the application cache via JavaScript, the
738 # loader engine will first ask the application cache for the
739 # contents, before hitting the network.
740 # The feature is described in details at:
741 # http://dev.w3.org/html5/spec/Overview.html#appcache
742 # Valid values: true, false
745 # local-storage (Bool):
746 # Whether support for the HTML 5 local storage feature is enabled.
747 # Valid values: true, false
751 # Size of the HTTP network cache.
753 download-directory = ~/downloads
754 prompt-download-directory = true
755 remember-download-directory = true
756 maximum-pages-in-cache =
757 object-cache-capacities =
758 offline-storage-default-quota =
759 offline-web-application-cache-quota =
760 offline-storage-database = true
761 offline-web-application-storage = true
763 cache-size = 52428800
766 # Loaded plugins/scripts and allowed actions.
768 # allow-images (Bool):
769 # Whether images are automatically loaded in web pages.
770 # Valid values: true, false
773 # allow-javascript (Bool):
774 # Enables or disables the running of JavaScript programs.
775 # Valid values: true, false
778 # allow-plugins (Bool):
779 # Enables or disables plugins in Web pages.
780 # Qt plugins with a mimetype such as "application/x-qt-plugin" are
781 # not affected by this setting.
782 # Valid values: true, false
786 # Enables or disables WebGL. For QtWebEngine, Qt/PyQt >= 5.7 is
787 # required for this setting.
788 # Valid values: true, false
791 # css-regions (Bool):
792 # Enable or disable support for CSS regions.
793 # Valid values: true, false
796 # hyperlink-auditing (Bool):
797 # Enable or disable hyperlink auditing (<a ping>).
798 # Valid values: true, false
801 # geolocation (BoolAsk):
802 # Allow websites to request geolocations.
803 # Valid values: true, false, ask
806 # notifications (BoolAsk):
807 # Allow websites to show notifications.
808 # Valid values: true, false, ask
811 # javascript-can-open-windows-automatically (Bool):
812 # Whether JavaScript programs can open new windows without user
814 # Valid values: true, false
817 # javascript-can-close-windows (Bool):
818 # Whether JavaScript programs can close windows.
819 # Valid values: true, false
822 # javascript-can-access-clipboard (Bool):
823 # Whether JavaScript programs can read or write to the clipboard.
824 # Valid values: true, false
827 # ignore-javascript-prompt (Bool):
828 # Whether all javascript prompts should be ignored.
829 # Valid values: true, false
832 # ignore-javascript-alert (Bool):
833 # Whether all javascript alerts should be ignored.
834 # Valid values: true, false
837 # local-content-can-access-remote-urls (Bool):
838 # Whether locally loaded documents are allowed to access remote
840 # Valid values: true, false
843 # local-content-can-access-file-urls (Bool):
844 # Whether locally loaded documents are allowed to access other local
846 # Valid values: true, false
849 # cookies-accept (String):
850 # Control which cookies to accept.
851 # all: Accept all cookies.
852 # no-3rdparty: Accept cookies from the same origin only.
853 # no-unknown-3rdparty: Accept cookies from the same origin only,
854 # unless a cookie is already set for the domain.
855 # never: Don't accept cookies at all.
856 # Default: no-3rdparty
858 # cookies-store (Bool):
859 # Whether to store cookies.
860 # Valid values: true, false
863 # host-block-lists (List of Url):
864 # List of URLs of lists which contain hosts to block.
865 # The file can be in one of the following formats:
866 # - An '/etc/hosts'-like file
867 # - One host per line
868 # - A zip-file of any of the above, with either only one file, or a
869 # file named 'hosts' (with any extension).
871 # 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
873 # host-blocking-enabled (Bool):
874 # Whether host blocking is enabled.
875 # Valid values: true, false
878 # host-blocking-whitelist (List of String):
879 # List of domains that should always be loaded, despite being
881 # Domains may contain * and ? wildcards and are otherwise required
882 # to exactly match the requested domain.
883 # Local domains are always exempt from hostblocking.
886 # enable-pdfjs (Bool):
887 # Enable pdf.js to view PDF files in the browser.
888 # Note that the files can still be downloaded by clicking the
889 # download button in the pdf.js viewer.
890 # Valid values: true, false
893 allow-javascript = true
894 allow-plugins = false
897 hyperlink-auditing = false
900 javascript-can-open-windows-automatically = false
901 javascript-can-close-windows = false
902 javascript-can-access-clipboard = false
903 ignore-javascript-prompt = false
904 ignore-javascript-alert = false
905 local-content-can-access-remote-urls = false
906 local-content-can-access-file-urls = true
907 cookies-accept = no-3rdparty
909 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
910 host-blocking-enabled = true
911 host-blocking-whitelist = piwik.org
918 # CSS border value for hints.
919 # Default: 1px solid #E3BE23
922 # Mode to use for hints.
923 # number: Use numeric hints.
924 # letter: Use the chars in the hints -> chars setting.
925 # word: Use hints words based on the html elements and the extra
929 # chars (UniqueCharString):
930 # Chars used for hint strings.
934 # Minimum number of chars used for hint strings.
938 # Whether to scatter hint key chains (like Vimium) or not (like
939 # dwb). Ignored for number hints.
940 # Valid values: true, false
944 # Make chars in hint strings uppercase.
945 # Valid values: true, false
949 # The dictionary file to be used by the word hints.
950 # Default: /usr/share/dict/words
952 # auto-follow (String):
953 # Controls when a hint can be automatically followed without the
954 # user pressing Enter.
955 # always: Auto-follow whenever there is only a single hint on a
957 # unique-match: Auto-follow whenever there is a unique non-empty
958 # match in either the hint string (word mode) or filter (number
960 # full-match: Follow the hint when the user typed the whole hint
961 # (letter, word or number mode) or the element's text (only in
963 # never: The user will always need to press Enter to follow a
965 # Default: unique-match
967 # auto-follow-timeout (Int):
968 # A timeout (in milliseconds) to inhibit normal-mode key bindings
969 # after a successful auto-follow.
972 # next-regexes (List of Regex):
973 # A comma-separated list of regexes to use for 'next' links.
975 # \bnext\b,\bmore\b,\bnewer\b,\b[>→≫]\b,\b(>>|»)\b,\bcontinue\b
977 # prev-regexes (List of Regex):
978 # A comma-separated list of regexes to use for 'prev' links.
979 # Default: \bprev(ious)?\b,\bback\b,\bolder\b,\b[<←≪]\b,\b(<<|«)\b
981 # find-implementation (String):
982 # Which implementation to use to find elements to hint.
983 # javascript: Better but slower
984 # python: Slightly worse but faster
987 # hide-unmatched-rapid-hints (Bool):
988 # Controls hiding unmatched hints in rapid mode.
989 # Valid values: true, false
991 border = 1px solid #E3BE23
997 dictionary = /usr/share/dict/words
998 auto-follow = unique-match
999 auto-follow-timeout = 0
1000 next-regexes = \bnext\b,\bmore\b,\bnewer\b,\b[>→≫]\b,\b(>>|»)\b,\bcontinue\b
1001 prev-regexes = \bprev(ious)?\b,\bback\b,\bolder\b,\b[<←≪]\b,\b(<<|«)\b
1002 find-implementation = javascript
1003 hide-unmatched-rapid-hints = true
1006 # Definitions of search engines which can be used via the address bar.
1007 # The searchengine named `DEFAULT` is used when `general -> auto-search`
1008 # is true and something else than a URL was entered to be opened. Other
1009 # search engines can be used by prepending the search engine name to the
1010 # search term, e.g. `:open google qutebrowser`. The string `{}` will be
1011 # replaced by the search term, use `{{` and `}}` for literal `{`/`}`
1013 DEFAULT = ${duckduckgo}
1014 duckduckgo = https://duckduckgo.com/?t=chakra&q={}
1016 google = https://encrypted.google.com/search?q={}
1018 wikipedia = http://en.wikipedia.org/w/index.php?title=Special:Search&search={}
1020 pcl = http://docs.pointclouds.org/trunk/search.php?query={}
1021 std = http://en.cppreference.com/mwiki/index.php?title=Special%3ASearch&search={}
1022 cv = http://docs.opencv.org/3.1.0/index.html#gsc.tab=0&gsc.ref=more%3A3.1&gsc.q={}
1025 # Aliases for commands.
1026 # By default, no aliases are defined. Example which adds a new command
1027 # `:qtb` to open qutebrowsers website:
1028 # `qtb = open https://www.qutebrowser.org/`
1034 # Colors used in the UI.
1035 # A value can be in one of the following format:
1036 # * `#RGB`/`#RRGGBB`/`#RRRGGGBBB`/`#RRRRGGGGBBBB`
1037 # * An SVG color name as specified in http://www.w3.org/TR/SVG/types.html#ColorKeywords[the W3C specification].
1038 # * transparent (no color)
1039 # * `rgb(r, g, b)` / `rgba(r, g, b, a)` (values 0-255 or percentages)
1040 # * `hsv(h, s, v)` / `hsva(h, s, v, a)` (values 0-255, hue 0-359)
1041 # * A gradient as explained in http://doc.qt.io/qt-5/stylesheet-reference.html#list-of-property-types[the Qt documentation] under ``Gradient''.
1042 # A *.system value determines the color system to use for color
1043 # interpolation between similarly-named *.start and *.stop entries,
1044 # regardless of how they are defined in the options. Valid values are
1045 # 'rgb', 'hsv', and 'hsl'.
1046 # The `hints.*` values are a special case as they're real CSS colors, not Qt-CSS colors. There, for a gradient, you need to use `-webkit-gradient`, see https://www.webkit.org/blog/175/introducing-css-gradients/[the WebKit documentation].
1048 # completion.fg (QtColor):
1049 # Text color of the completion widget.
1052 # completion.bg (QssColor):
1053 # Background color of the completion widget.
1056 # completion.alternate-bg (QssColor):
1057 # Alternating background color of the completion widget.
1060 # completion.category.fg (QtColor):
1061 # Foreground color of completion widget category headers.
1064 # completion.category.bg (QssColor):
1065 # Background color of the completion widget category headers.
1066 # Default: qlineargradient(x1:0, y1:0, x2:0, y2:1, stop:0 #888888,
1069 # completion.category.border.top (QssColor):
1070 # Top border color of the completion widget category headers.
1073 # completion.category.border.bottom (QssColor):
1074 # Bottom border color of the completion widget category headers.
1075 # Default: ${completion.category.border.top}
1077 # completion.item.selected.fg (QtColor):
1078 # Foreground color of the selected completion item.
1081 # completion.item.selected.bg (QssColor):
1082 # Background color of the selected completion item.
1085 # completion.item.selected.border.top (QssColor):
1086 # Top border color of the completion widget category headers.
1089 # completion.item.selected.border.bottom (QssColor):
1090 # Bottom border color of the selected completion item.
1091 # Default: ${completion.item.selected.border.top}
1093 # completion.match.fg (QssColor):
1094 # Foreground color of the matched text in the completion.
1097 # completion.scrollbar.fg (QssColor):
1098 # Color of the scrollbar handle in completion view.
1099 # Default: ${completion.fg}
1101 # completion.scrollbar.bg (QssColor):
1102 # Color of the scrollbar in completion view
1103 # Default: ${completion.bg}
1105 # statusbar.fg (QssColor):
1106 # Foreground color of the statusbar.
1109 # statusbar.bg (QssColor):
1110 # Background color of the statusbar.
1113 # statusbar.fg.insert (QssColor):
1114 # Foreground color of the statusbar in insert mode.
1115 # Default: ${statusbar.fg}
1117 # statusbar.bg.insert (QssColor):
1118 # Background color of the statusbar in insert mode.
1119 # Default: darkgreen
1121 # statusbar.fg.command (QssColor):
1122 # Foreground color of the statusbar in command mode.
1123 # Default: ${statusbar.fg}
1125 # statusbar.bg.command (QssColor):
1126 # Background color of the statusbar in command mode.
1127 # Default: ${statusbar.bg}
1129 # statusbar.fg.caret (QssColor):
1130 # Foreground color of the statusbar in caret mode.
1131 # Default: ${statusbar.fg}
1133 # statusbar.bg.caret (QssColor):
1134 # Background color of the statusbar in caret mode.
1137 # statusbar.fg.caret-selection (QssColor):
1138 # Foreground color of the statusbar in caret mode with a selection
1139 # Default: ${statusbar.fg}
1141 # statusbar.bg.caret-selection (QssColor):
1142 # Background color of the statusbar in caret mode with a selection
1145 # statusbar.progress.bg (QssColor):
1146 # Background color of the progress bar.
1149 # statusbar.url.fg (QssColor):
1150 # Default foreground color of the URL in the statusbar.
1151 # Default: ${statusbar.fg}
1153 # statusbar.url.fg.success (QssColor):
1154 # Foreground color of the URL in the statusbar on successful load
1158 # statusbar.url.fg.success.https (QssColor):
1159 # Foreground color of the URL in the statusbar on successful load
1163 # statusbar.url.fg.error (QssColor):
1164 # Foreground color of the URL in the statusbar on error.
1167 # statusbar.url.fg.warn (QssColor):
1168 # Foreground color of the URL in the statusbar when there's a
1172 # statusbar.url.fg.hover (QssColor):
1173 # Foreground color of the URL in the statusbar for hovered links.
1176 # tabs.fg.odd (QtColor):
1177 # Foreground color of unselected odd tabs.
1180 # tabs.bg.odd (QtColor):
1181 # Background color of unselected odd tabs.
1184 # tabs.fg.even (QtColor):
1185 # Foreground color of unselected even tabs.
1188 # tabs.bg.even (QtColor):
1189 # Background color of unselected even tabs.
1192 # tabs.fg.selected.odd (QtColor):
1193 # Foreground color of selected odd tabs.
1196 # tabs.bg.selected.odd (QtColor):
1197 # Background color of selected odd tabs.
1200 # tabs.fg.selected.even (QtColor):
1201 # Foreground color of selected even tabs.
1202 # Default: ${tabs.fg.selected.odd}
1204 # tabs.bg.selected.even (QtColor):
1205 # Background color of selected even tabs.
1206 # Default: ${tabs.bg.selected.odd}
1208 # tabs.bg.bar (QtColor):
1209 # Background color of the tab bar.
1212 # tabs.indicator.start (QtColor):
1213 # Color gradient start for the tab indicator.
1216 # tabs.indicator.stop (QtColor):
1217 # Color gradient end for the tab indicator.
1220 # tabs.indicator.error (QtColor):
1221 # Color for the tab indicator on errors..
1224 # tabs.indicator.system (ColorSystem):
1225 # Color gradient interpolation system for the tab indicator.
1226 # rgb: Interpolate in the RGB color system.
1227 # hsv: Interpolate in the HSV color system.
1228 # hsl: Interpolate in the HSL color system.
1229 # none: Don't show a gradient.
1232 # hints.fg (QssColor):
1233 # Font color for hints.
1236 # hints.bg (QssColor):
1237 # Background color for hints. Note that you can use a `rgba(...)`
1238 # value for transparency.
1239 # Default: qlineargradient(x1:0, y1:0, x2:0, y2:1, stop:0 rgba(255,
1240 # 247, 133, 0.8), stop:1 rgba(255, 197, 66, 0.8))
1242 # hints.fg.match (QssColor):
1243 # Font color for the matched part of hints.
1246 # downloads.bg.bar (QssColor):
1247 # Background color for the download bar.
1250 # downloads.fg.start (QtColor):
1251 # Color gradient start for download text.
1254 # downloads.bg.start (QtColor):
1255 # Color gradient start for download backgrounds.
1258 # downloads.fg.stop (QtColor):
1259 # Color gradient end for download text.
1260 # Default: ${downloads.fg.start}
1262 # downloads.bg.stop (QtColor):
1263 # Color gradient stop for download backgrounds.
1266 # downloads.fg.system (ColorSystem):
1267 # Color gradient interpolation system for download text.
1268 # rgb: Interpolate in the RGB color system.
1269 # hsv: Interpolate in the HSV color system.
1270 # hsl: Interpolate in the HSL color system.
1271 # none: Don't show a gradient.
1274 # downloads.bg.system (ColorSystem):
1275 # Color gradient interpolation system for download backgrounds.
1276 # rgb: Interpolate in the RGB color system.
1277 # hsv: Interpolate in the HSV color system.
1278 # hsl: Interpolate in the HSL color system.
1279 # none: Don't show a gradient.
1282 # downloads.fg.error (QtColor):
1283 # Foreground color for downloads with errors.
1286 # downloads.bg.error (QtColor):
1287 # Background color for downloads with errors.
1290 # webpage.bg (QtColor):
1291 # Background color for webpages if unset (or empty to use the
1295 # keyhint.fg (QssColor):
1296 # Text color for the keyhint widget.
1299 # keyhint.fg.suffix (CssColor):
1300 # Highlight color for keys to complete the current keychain
1303 # keyhint.bg (QssColor):
1304 # Background color of the keyhint widget.
1305 # Default: rgba(0, 0, 0, 80%)
1307 # messages.fg.error (QssColor):
1308 # Foreground color of an error message.
1311 # messages.bg.error (QssColor):
1312 # Background color of an error message.
1315 # messages.border.error (QssColor):
1316 # Border color of an error message.
1319 # messages.fg.warning (QssColor):
1320 # Foreground color a warning message.
1323 # messages.bg.warning (QssColor):
1324 # Background color of a warning message.
1325 # Default: darkorange
1327 # messages.border.warning (QssColor):
1328 # Border color of an error message.
1331 # messages.fg.info (QssColor):
1332 # Foreground color an info message.
1335 # messages.bg.info (QssColor):
1336 # Background color of an info message.
1339 # messages.border.info (QssColor):
1340 # Border color of an info message.
1343 # prompts.fg (QssColor):
1344 # Foreground color for prompts.
1347 # prompts.bg (QssColor):
1348 # Background color for prompts.
1351 # prompts.selected.bg (QssColor):
1352 # Background color for the selected item in filename prompts.
1354 completion.fg = white
1355 completion.bg = #333333
1356 completion.alternate-bg = #444444
1357 completion.category.fg = white
1358 completion.category.bg = qlineargradient(x1:0, y1:0, x2:0, y2:1, stop:0 #888888, stop:1 #505050)
1359 completion.category.border.top = black
1360 completion.category.border.bottom = ${completion.category.border.top}
1361 completion.item.selected.fg = black
1362 completion.item.selected.bg = #e8c000
1363 completion.item.selected.border.top = #bbbb00
1364 completion.item.selected.border.bottom = ${completion.item.selected.border.top}
1365 completion.match.fg = #ff4444
1366 completion.scrollbar.fg = ${completion.fg}
1367 completion.scrollbar.bg = ${completion.bg}
1368 statusbar.fg = white
1369 statusbar.bg = black
1370 statusbar.fg.insert = ${statusbar.fg}
1371 statusbar.bg.insert = darkgreen
1372 statusbar.fg.command = ${statusbar.fg}
1373 statusbar.bg.command = ${statusbar.bg}
1374 statusbar.fg.caret = ${statusbar.fg}
1375 statusbar.bg.caret = purple
1376 statusbar.fg.caret-selection = ${statusbar.fg}
1377 statusbar.bg.caret-selection = #a12dff
1378 statusbar.progress.bg = white
1379 statusbar.url.fg = ${statusbar.fg}
1380 statusbar.url.fg.success = white
1381 statusbar.url.fg.success.https = lime
1382 statusbar.url.fg.error = orange
1383 statusbar.url.fg.warn = yellow
1384 statusbar.url.fg.hover = aqua
1387 tabs.fg.even = white
1388 tabs.bg.even = darkgrey
1389 tabs.fg.selected.odd = white
1390 tabs.bg.selected.odd = black
1391 tabs.fg.selected.even = ${tabs.fg.selected.odd}
1392 tabs.bg.selected.even = ${tabs.bg.selected.odd}
1393 tabs.bg.bar = #555555
1394 tabs.indicator.start = #0000aa
1395 tabs.indicator.stop = #00aa00
1396 tabs.indicator.error = #ff0000
1397 tabs.indicator.system = rgb
1399 hints.bg = 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))
1400 hints.fg.match = green
1401 downloads.bg.bar = black
1402 downloads.fg.start = white
1403 downloads.bg.start = #0000aa
1404 downloads.fg.stop = ${downloads.fg.start}
1405 downloads.bg.stop = #00aa00
1406 downloads.fg.system = rgb
1407 downloads.bg.system = rgb
1408 downloads.fg.error = white
1409 downloads.bg.error = red
1411 keyhint.fg = #FFFFFF
1412 keyhint.fg.suffix = #FFFF00
1413 keyhint.bg = rgba(0, 0, 0, 80%)
1414 messages.fg.error = ${statusbar.fg}
1415 messages.bg.error = red
1416 messages.border.error = #bb0000
1417 messages.fg.warning = ${statusbar.fg}
1418 messages.bg.warning = darkorange
1419 messages.border.warning = #d47300
1420 messages.fg.info = white
1421 messages.bg.info = black
1422 messages.border.info = #333333
1423 prompts.fg = ${statusbar.fg}
1424 prompts.bg = darkblue
1425 prompts.selected.bg = #308cc6
1428 # Fonts used for the UI, with optional style/weight/size.
1429 # * Style: `normal`/`italic`/`oblique`
1430 # * Weight: `normal`, `bold`, `100`..`900`
1431 # * Size: _number_ `px`/`pt`
1433 # _monospace (Font):
1434 # Default monospace fonts.
1435 # Default: Terminus, Monospace, "DejaVu Sans Mono", Monaco,
1436 # "Bitstream Vera Sans Mono", "Andale Mono", "Courier New", Courier,
1437 # "Liberation Mono", monospace, Fixed, Consolas, Terminal
1439 # completion (Font):
1440 # Font used in the completion widget.
1441 # Default: 8pt ${_monospace}
1443 # completion.category (Font):
1444 # Font used in the completion categories.
1445 # Default: bold ${completion}
1448 # Font used in the tab bar.
1449 # Default: 8pt ${_monospace}
1452 # Font used in the statusbar.
1453 # Default: 8pt ${_monospace}
1456 # Font used for the downloadbar.
1457 # Default: 8pt ${_monospace}
1460 # Font used for the hints.
1461 # Default: bold 13px ${_monospace}
1463 # debug-console (QtFont):
1464 # Font used for the debugging console.
1465 # Default: 8pt ${_monospace}
1467 # web-family-standard (FontFamily):
1468 # Font family for standard fonts.
1471 # web-family-fixed (FontFamily):
1472 # Font family for fixed fonts.
1475 # web-family-serif (FontFamily):
1476 # Font family for serif fonts.
1479 # web-family-sans-serif (FontFamily):
1480 # Font family for sans-serif fonts.
1483 # web-family-cursive (FontFamily):
1484 # Font family for cursive fonts.
1487 # web-family-fantasy (FontFamily):
1488 # Font family for fantasy fonts.
1491 # web-size-minimum (Int):
1492 # The hard minimum font size.
1495 # web-size-minimum-logical (Int):
1496 # The minimum logical font size that is applied when zooming out.
1499 # web-size-default (Int):
1500 # The default font size for regular text.
1503 # web-size-default-fixed (Int):
1504 # The default font size for fixed-pitch text.
1508 # Font used in the keyhint widget.
1509 # Default: 8pt ${_monospace}
1511 # messages.error (Font):
1512 # Font used for error messages.
1513 # Default: 8pt ${_monospace}
1515 # messages.warning (Font):
1516 # Font used for warning messages.
1517 # Default: 8pt ${_monospace}
1519 # messages.info (Font):
1520 # Font used for info messages.
1521 # Default: 8pt ${_monospace}
1524 # Font used for prompts.
1525 # Default: 8pt sans-serif
1526 _monospace = Terminus, Monospace, "DejaVu Sans Mono", Monaco, "Bitstream Vera Sans Mono", "Andale Mono", "Liberation Mono", "Courier New", Courier, monospace, Fixed, Consolas, Terminal
1527 completion = 8pt ${_monospace}
1528 completion.category = bold ${completion}
1529 tabbar = 8pt ${_monospace}
1530 statusbar = 8pt ${_monospace}
1531 downloads = 8pt ${_monospace}
1532 hints = bold 12px ${_monospace}
1533 debug-console = 8pt ${_monospace}
1534 web-family-standard =
1537 web-family-sans-serif =
1538 web-family-cursive =
1539 web-family-fantasy =
1541 web-size-minimum-logical =
1543 web-size-default-fixed =
1544 keyhint = 8pt ${_monospace}
1545 messages.error = 8pt ${_monospace}
1546 messages.warning = 8pt ${_monospace}
1547 messages.info = 8pt ${_monospace}
1548 prompts = 8pt sans-serif