]> git.rmz.io Git - dotfiles.git/blob - qutebrowser/qutebrowser.conf
8244eae4b706d478d2f781b99707f92c413ec03b
[dotfiles.git] / qutebrowser / qutebrowser.conf
1 # vim: ft=dosini
2
3 # Configfile for qutebrowser.
4 #
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.
8 #
9 # Note that you shouldn't add your own comments, as this file is
10 # regenerated every time the config is saved.
11 #
12 # Interpolation looks like ${value} or ${section:value} and will be
13 # replaced by the respective value.
14 #
15 # Some settings will expand environment variables. Note that, since
16 # interpolation is run first, you will need to escape the $ char as
17 # described below.
18 #
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
21 # an empty value.
22 #
23 # You will need to escape the following values:
24 # - # at the start of the line (at the first position of the key) (\#)
25 # - $ in a value ($$)
26
27 [general]
28 # General/miscellaneous options.
29 #
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
35 # Default: smart
36 #
37 # wrap-search (Bool):
38 # Whether to wrap finding text to the top when arriving at the end.
39 # Valid values: true, false
40 # Default: true
41 #
42 # startpage (List):
43 # The default page(s) to open at the start, separated by commas.
44 # Default: https://duckduckgo.com
45 #
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}
50 #
51 # auto-search (AutoSearch):
52 # Whether to start a search when something else than a URL is
53 # entered.
54 # naive: Use simple/naive check.
55 # dns: Use DNS requests (might be slow!).
56 # false: Never search automatically.
57 # Default: naive
58 #
59 # auto-save-config (Bool):
60 # Whether to save the config automatically on quit.
61 # Valid values: true, false
62 # Default: true
63 #
64 # auto-save-interval (Int):
65 # How often (in milliseconds) to auto-save config/cookies/etc.
66 # Default: 15000
67 #
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 `'`
71 # to quote them.
72 # `{}` gets replaced by the filename of the file to be edited.
73 # Default: gvim -f "{}"
74 #
75 # editor-encoding (Encoding):
76 # Encoding to use for editor.
77 # Default: utf-8
78 #
79 # private-browsing (Bool):
80 # Do not record visited pages in the history or store web page
81 # icons.
82 # Valid values: true, false
83 # Default: false
84 #
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
90 # Default: false
91 #
92 # print-element-backgrounds (Bool):
93 # Whether the background color and images are also drawn when the
94 # page is printed.
95 # Valid values: true, false
96 # Default: true
97 #
98 # xss-auditing (Bool):
99 # Whether load requests should be monitored for cross-site scripting
100 # attempts.
101 # Suspicious scripts will be blocked and reported in the inspector's
102 # JavaScript console. Enabling this feature might have an impact on
103 # performance.
104 # Valid values: true, false
105 # Default: false
106 #
107 # site-specific-quirks (Bool):
108 # Enable workarounds for broken sites.
109 # Valid values: true, false
110 # Default: true
111 #
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
116 # used.
117 # Default:
118 #
119 # new-instance-open-target (String):
120 # How to open links in an existing instance if a new one is
121 # launched.
122 # tab: Open a new tab in the existing window and activate the
123 # window.
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.
131 # Default: tab
132 #
133 # log-javascript-console (String):
134 # How to log javascript console messages.
135 # none: Don't log messages.
136 # debug: Log messages with debug level.
137 # info: Log messages with info level.
138 # Default: debug
139 #
140 # save-session (Bool):
141 # Whether to always save the open pages.
142 # Valid values: true, false
143 # Default: false
144 #
145 # session-default-name (SessionName):
146 # The name of the session to save by default, or empty for the last
147 # loaded session.
148 # Default:
149 #
150 # url-incdec-segments (FlagList):
151 # The URL segments where `:navigate increment/decrement` will search
152 # for a number.
153 # Valid values: host, path, query, anchor
154 # Default: path,query
155 ignore-case = smart
156 wrap-search = true
157 startpage = https://duckduckgo.com/?t=chakra
158 default-page = ${startpage}
159 auto-search = naive
160 auto-save-config = true
161 auto-save-interval = 15000
162 editor = urxvt -e vim "{}"
163 editor-encoding = utf-8
164 private-browsing = false
165 developer-extras = true
166 print-element-backgrounds = true
167 xss-auditing = false
168 site-specific-quirks = true
169 default-encoding =
170 new-instance-open-target = tab
171 log-javascript-console = none
172 save-session = true
173 session-default-name =
174 url-incdec-segments = path,query
175
176 [ui]
177 # General options related to the user interface.
178 #
179 # zoom-levels (PercList):
180 # The available zoom levels, separated by commas.
181 # Default:
182 # 25%,33%,50%,67%,75%,90%,100%,110%,125%,150%,175%,200%,250%,300%,400%,500%
183 #
184 # default-zoom (Perc):
185 # The default zoom level.
186 # Default: 100%
187 #
188 # downloads-position (VerticalPosition):
189 # Where to show the downloaded files.
190 # Valid values: top, bottom
191 # Default: top
192 #
193 # message-timeout (Int):
194 # Time (in ms) to show messages in the statusbar for.
195 # Default: 2000
196 #
197 # message-unfocused (Bool):
198 # Whether to show messages in unfocused windows.
199 # Valid values: true, false
200 # Default: false
201 #
202 # confirm-quit (ConfirmQuit):
203 # Whether to confirm quitting the application.
204 # always: Always show a confirmation.
205 # multiple-tabs: Show a confirmation if multiple tabs are
206 # opened.
207 # downloads: Show a confirmation if downloads are running
208 # never: Never show a confirmation.
209 # Default: never
210 #
211 # display-statusbar-messages (Bool):
212 # Whether to display javascript statusbar messages.
213 # Valid values: true, false
214 # Default: false
215 #
216 # zoom-text-only (Bool):
217 # Whether the zoom factor on a frame applies only to the text or to
218 # all content.
219 # Valid values: true, false
220 # Default: false
221 #
222 # frame-flattening (Bool):
223 # Whether to expand each subframe to its contents.
224 # This will flatten all the frames to become one scrollable page.
225 # Valid values: true, false
226 # Default: false
227 #
228 # user-stylesheet (UserStyleSheet):
229 # User stylesheet to use (absolute filename, filename relative to
230 # the config directory or CSS string). Will expand environment
231 # variables.
232 # Default: ::-webkit-scrollbar { width: 0px; height: 0px; }
233 #
234 # css-media-type (String):
235 # Set the CSS media type.
236 # Default:
237 #
238 # smooth-scrolling (Bool):
239 # Whether to enable smooth scrolling for webpages.
240 # Valid values: true, false
241 # Default: false
242 #
243 # remove-finished-downloads (Int):
244 # Number of milliseconds to wait before removing finished downloads.
245 # Will not be removed if value is -1.
246 # Default: -1
247 #
248 # hide-statusbar (Bool):
249 # Whether to hide the statusbar unless a message is shown.
250 # Valid values: true, false
251 # Default: false
252 #
253 # statusbar-padding (Padding):
254 # Padding for statusbar (top, bottom, left, right).
255 # Default: 1,1,0,0
256 #
257 # window-title-format (FormatString):
258 # The format to use for the window title. The following placeholders
259 # are defined:
260 # * `{perc}`: The percentage as a string like `[10%]`.
261 # * `{perc_raw}`: The raw percentage, e.g. `10`
262 # * `{title}`: The title of the current web page
263 # * `{title_sep}`: The string ` - ` if a title is set, empty
264 # otherwise.
265 # * `{id}`: The internal window ID of this window.
266 # * `{scroll_pos}`: The page scroll position.
267 # Default: {perc}{title}{title_sep}qutebrowser
268 #
269 # hide-mouse-cursor (Bool):
270 # Whether to hide the mouse cursor.
271 # Valid values: true, false
272 # Default: false
273 #
274 # modal-js-dialog (Bool):
275 # Use standard JavaScript modal dialog for alert() and confirm()
276 # Valid values: true, false
277 # Default: false
278 #
279 # hide-wayland-decoration (Bool):
280 # Hide the window decoration when using wayland (requires restart)
281 # Valid values: true, false
282 # Default: false
283 zoom-levels = 25%,33%,50%,67%,75%,90%,100%,110%,125%,150%,175%,200%,250%,300%,400%,500%
284 default-zoom = 100%
285 downloads-position = top
286 message-timeout = 2000
287 message-unfocused = false
288 confirm-quit = downloads
289 display-statusbar-messages = false
290 zoom-text-only = false
291 frame-flattening = false
292 user-stylesheet = $$XDG_CONFIG_HOME/qutebrowser/css/default.css
293 css-media-type =
294 smooth-scrolling = false
295 remove-finished-downloads = -1
296 hide-statusbar = false
297 statusbar-padding = 1,1,0,0
298 window-title-format = {perc}{title}{title_sep}qutebrowser
299 hide-mouse-cursor = false
300 modal-js-dialog = false
301 hide-wayland-decoration = false
302
303 [network]
304 # Settings related to the network.
305 #
306 # do-not-track (Bool):
307 # Value to send in the `DNT` header.
308 # Valid values: true, false
309 # Default: true
310 #
311 # accept-language (String):
312 # Value to send in the `accept-language` header.
313 # Default: en-US,en
314 #
315 # referer-header (String):
316 # Send the Referer header
317 # always: Always send.
318 # never: Never send; this is not recommended, as some sites may
319 # break.
320 # same-domain: Only send for the same domain. This will still
321 # protect your privacy, but shouldn't break any sites.
322 # Default: same-domain
323 #
324 # user-agent (UserAgent):
325 # User agent to send. Empty to send the default.
326 # Default:
327 #
328 # proxy (Proxy):
329 # The proxy to use.
330 # In addition to the listed values, you can use a `socks://...` or
331 # `http://...` URL.
332 # system: Use the system wide proxy.
333 # none: Don't use any proxy
334 # Default: system
335 #
336 # proxy-dns-requests (Bool):
337 # Whether to send DNS requests over the configured proxy.
338 # Valid values: true, false
339 # Default: true
340 #
341 # ssl-strict (BoolAsk):
342 # Whether to validate SSL handshakes.
343 # Valid values: true, false, ask
344 # Default: ask
345 #
346 # dns-prefetch (Bool):
347 # Whether to try to pre-fetch DNS entries to speed up browsing.
348 # Valid values: true, false
349 # Default: true
350 do-not-track = true
351 accept-language = en-US,en,de,fr
352 referer-header = same-domain
353 user-agent =
354 proxy = system
355 proxy-dns-requests = true
356 ssl-strict = ask
357 dns-prefetch = true
358
359 [completion]
360 # Options related to completion and command history.
361 #
362 # auto-open (Bool):
363 # Automatically open completion when typing.
364 # Valid values: true, false
365 # Default: true
366 #
367 # download-path-suggestion (String):
368 # What to display in the download filename input.
369 # path: Show only the download path.
370 # filename: Show only download filename.
371 # both: Show download path and filename.
372 # Default: path
373 #
374 # timestamp-format (TimestampTemplate):
375 # How to format timestamps (e.g. for history)
376 # Default: %Y-%m-%d
377 #
378 # show (Bool):
379 # Whether to show the autocompletion window.
380 # Valid values: true, false
381 # Default: true
382 #
383 # height (PercOrInt):
384 # The height of the completion, in px or as percentage of the
385 # window.
386 # Default: 50%
387 #
388 # cmd-history-max-items (Int):
389 # How many commands to save in the command history.
390 # 0: no history / -1: unlimited
391 # Default: 100
392 #
393 # web-history-max-items (Int):
394 # How many URLs to show in the web history.
395 # 0: no history / -1: unlimited
396 # Default: 1000
397 #
398 # quick-complete (Bool):
399 # Whether to move on to the next part when there's only one possible
400 # completion left.
401 # Valid values: true, false
402 # Default: true
403 #
404 # shrink (Bool):
405 # Whether to shrink the completion to be smaller than the configured
406 # size if there are no scrollbars.
407 # Valid values: true, false
408 # Default: false
409 #
410 # scrollbar-width (Int):
411 # Width of the scrollbar in the completion window (in px).
412 # Default: 12
413 #
414 # scrollbar-padding (Int):
415 # Padding of scrollbar handle in completion window (in px).
416 # Default: 2
417 auto-open = true
418 download-path-suggestion = path
419 timestamp-format = %Y-%m-%d
420 show = true
421 height = 150
422 cmd-history-max-items = 100
423 web-history-max-items = 1000
424 quick-complete = false
425 shrink = true
426 scrollbar-width = 12
427 scrollbar-padding = 2
428
429 [input]
430 # Options related to input modes.
431 #
432 # timeout (Int):
433 # Timeout for ambiguous key bindings.
434 # Default: 500
435 #
436 # partial-timeout (Int):
437 # Timeout for partially typed key bindings.
438 # Default: 1000
439 #
440 # insert-mode-on-plugins (Bool):
441 # Whether to switch to insert mode when clicking flash and other
442 # plugins.
443 # Valid values: true, false
444 # Default: false
445 #
446 # auto-leave-insert-mode (Bool):
447 # Whether to leave insert mode if a non-editable element is clicked.
448 # Valid values: true, false
449 # Default: true
450 #
451 # auto-insert-mode (Bool):
452 # Whether to automatically enter insert mode if an editable element
453 # is focused after page load.
454 # Valid values: true, false
455 # Default: false
456 #
457 # forward-unbound-keys (String):
458 # Whether to forward unbound keys to the webview in normal mode.
459 # all: Forward all unbound keys.
460 # auto: Forward unbound non-alphanumeric keys.
461 # none: Don't forward any keys.
462 # Default: auto
463 #
464 # spatial-navigation (Bool):
465 # Enables or disables the Spatial Navigation feature.
466 # Spatial navigation consists in the ability to navigate between
467 # focusable elements in a Web page, such as hyperlinks and form
468 # controls, by using Left, Right, Up and Down arrow keys. For
469 # example, if a user presses the Right key, heuristics determine
470 # whether there is an element he might be trying to reach towards
471 # the right and which element he probably wants.
472 # Valid values: true, false
473 # Default: false
474 #
475 # links-included-in-focus-chain (Bool):
476 # Whether hyperlinks should be included in the keyboard focus chain.
477 # Valid values: true, false
478 # Default: true
479 #
480 # rocker-gestures (Bool):
481 # Whether to enable Opera-like mouse rocker gestures. This disables
482 # the context menu.
483 # Valid values: true, false
484 # Default: false
485 #
486 # mouse-zoom-divider (Int):
487 # How much to divide the mouse wheel movements to translate them
488 # into zoom increments.
489 # Default: 512
490 timeout = 500
491 partial-timeout = 1000
492 insert-mode-on-plugins = false
493 auto-leave-insert-mode = true
494 auto-insert-mode = false
495 forward-unbound-keys = auto
496 spatial-navigation = false
497 links-included-in-focus-chain = true
498 rocker-gestures = false
499 mouse-zoom-divider = 512
500
501 [tabs]
502 # Configuration of the tab bar.
503 #
504 # background-tabs (Bool):
505 # Whether to open new tabs (middleclick/ctrl+click) in background.
506 # Valid values: true, false
507 # Default: false
508 #
509 # select-on-remove (SelectOnRemove):
510 # Which tab to select when the focused tab is removed.
511 # left: Select the tab on the left.
512 # right: Select the tab on the right.
513 # previous: Select the previously selected tab.
514 # Default: right
515 #
516 # new-tab-position (NewTabPosition):
517 # How new tabs are positioned.
518 # left: On the left of the current tab.
519 # right: On the right of the current tab.
520 # first: At the left end.
521 # last: At the right end.
522 # Default: right
523 #
524 # new-tab-position-explicit (NewTabPosition):
525 # How new tabs opened explicitly are positioned.
526 # left: On the left of the current tab.
527 # right: On the right of the current tab.
528 # first: At the left end.
529 # last: At the right end.
530 # Default: last
531 #
532 # last-close (String):
533 # Behavior when the last tab is closed.
534 # ignore: Don't do anything.
535 # blank: Load a blank page.
536 # startpage: Load the start page.
537 # default-page: Load the default page.
538 # close: Close the window.
539 # Default: ignore
540 #
541 # show (String):
542 # When to show the tab bar
543 # always: Always show the tab bar.
544 # never: Always hide the tab bar.
545 # multiple: Hide the tab bar if only one tab is open.
546 # switching: Show the tab bar when switching tabs.
547 # Default: always
548 #
549 # show-switching-delay (Int):
550 # Time to show the tab bar before hiding it when tabs->show is set
551 # to 'switching'.
552 # Default: 800
553 #
554 # wrap (Bool):
555 # Whether to wrap when changing tabs.
556 # Valid values: true, false
557 # Default: true
558 #
559 # movable (Bool):
560 # Whether tabs should be movable.
561 # Valid values: true, false
562 # Default: true
563 #
564 # close-mouse-button (String):
565 # On which mouse button to close tabs.
566 # right: Close tabs on right-click.
567 # middle: Close tabs on middle-click.
568 # none: Don't close tabs using the mouse.
569 # Default: middle
570 #
571 # position (Position):
572 # The position of the tab bar.
573 # Valid values: top, bottom, left, right
574 # Default: top
575 #
576 # show-favicons (Bool):
577 # Whether to show favicons in the tab bar.
578 # Valid values: true, false
579 # Default: true
580 #
581 # width (PercOrInt):
582 # The width of the tab bar if it's vertical, in px or as percentage
583 # of the window.
584 # Default: 20%
585 #
586 # indicator-width (Int):
587 # Width of the progress indicator (0 to disable).
588 # Default: 3
589 #
590 # tabs-are-windows (Bool):
591 # Whether to open windows instead of tabs.
592 # Valid values: true, false
593 # Default: false
594 #
595 # title-format (FormatString):
596 # The format to use for the tab title. The following placeholders
597 # are defined:
598 # * `{perc}`: The percentage as a string like `[10%]`.
599 # * `{perc_raw}`: The raw percentage, e.g. `10`
600 # * `{title}`: The title of the current web page
601 # * `{title_sep}`: The string ` - ` if a title is set, empty
602 # otherwise.
603 # * `{index}`: The index of this tab.
604 # * `{id}`: The internal tab ID of this tab.
605 # * `{scroll_pos}`: The page scroll position.
606 # Default: {index}: {title}
607 #
608 # title-alignment (TextAlignment):
609 # Alignment of the text inside of tabs
610 # Valid values: left, right, center
611 # Default: left
612 #
613 # mousewheel-tab-switching (Bool):
614 # Switch between tabs using the mouse wheel.
615 # Valid values: true, false
616 # Default: true
617 #
618 # padding (Padding):
619 # Padding for tabs (top, bottom, left, right).
620 # Default: 0,0,5,5
621 #
622 # indicator-padding (Padding):
623 # Padding for indicators (top, bottom, left, right).
624 # Default: 2,2,0,4
625 background-tabs = false
626 select-on-remove = left
627 new-tab-position = right
628 new-tab-position-explicit = right
629 last-close = ignore
630 show = always
631 show-switching-delay = 800
632 wrap = true
633 movable = true
634 close-mouse-button = middle
635 position = top
636 show-favicons = true
637 width = 20%
638 indicator-width = 3
639 tabs-are-windows = false
640 title-format = {index}: {title}
641 title-alignment = left
642 mousewheel-tab-switching = true
643 padding = 0,0,5,5
644 indicator-padding = 2,2,0,4
645
646 [storage]
647 # Settings related to cache and storage.
648 #
649 # download-directory (Directory):
650 # The directory to save downloads to. An empty value selects a
651 # sensible os-specific default. Will expand environment variables.
652 # Default:
653 #
654 # prompt-download-directory (Bool):
655 # Whether to prompt the user for the download location.
656 # If set to false, 'download-directory' will be used.
657 # Valid values: true, false
658 # Default: true
659 #
660 # remember-download-directory (Bool):
661 # Whether to remember the last used download directory.
662 # Valid values: true, false
663 # Default: true
664 #
665 # maximum-pages-in-cache (Int):
666 # The maximum number of pages to hold in the global memory page
667 # cache.
668 # The Page Cache allows for a nicer user experience when navigating
669 # forth or back to pages in the forward/back history, by pausing and
670 # resuming up to _n_ pages.
671 # For more information about the feature, please refer to:
672 # http://webkit.org/blog/427/webkit-page-cache-i-the-basics/
673 # Default:
674 #
675 # object-cache-capacities (WebKitBytesList):
676 # The capacities for the global memory cache for dead objects such
677 # as stylesheets or scripts. Syntax: cacheMinDeadCapacity,
678 # cacheMaxDead, totalCapacity.
679 # The _cacheMinDeadCapacity_ specifies the minimum number of bytes
680 # that dead objects should consume when the cache is under pressure.
681 # _cacheMaxDead_ is the maximum number of bytes that dead objects
682 # should consume when the cache is *not* under pressure.
683 # _totalCapacity_ specifies the maximum number of bytes that the
684 # cache should consume *overall*.
685 # Default:
686 #
687 # offline-storage-default-quota (WebKitBytes):
688 # Default quota for new offline storage databases.
689 # Default:
690 #
691 # offline-web-application-cache-quota (WebKitBytes):
692 # Quota for the offline web application cache.
693 # Default:
694 #
695 # offline-storage-database (Bool):
696 # Whether support for the HTML 5 offline storage feature is enabled.
697 # Valid values: true, false
698 # Default: true
699 #
700 # offline-web-application-storage (Bool):
701 # Whether support for the HTML 5 web application cache feature is
702 # enabled.
703 # An application cache acts like an HTTP cache in some sense. For
704 # documents that use the application cache via JavaScript, the
705 # loader engine will first ask the application cache for the
706 # contents, before hitting the network.
707 # The feature is described in details at:
708 # http://dev.w3.org/html5/spec/Overview.html#appcache
709 # Valid values: true, false
710 # Default: true
711 #
712 # local-storage (Bool):
713 # Whether support for the HTML 5 local storage feature is enabled.
714 # Valid values: true, false
715 # Default: true
716 #
717 # cache-size (Int):
718 # Size of the HTTP network cache.
719 # Default: 52428800
720 download-directory = ~/downloads
721 prompt-download-directory = true
722 remember-download-directory = true
723 maximum-pages-in-cache =
724 object-cache-capacities =
725 offline-storage-default-quota =
726 offline-web-application-cache-quota =
727 offline-storage-database = true
728 offline-web-application-storage = true
729 local-storage = true
730 cache-size = 52428800
731
732 [content]
733 # Loaded plugins/scripts and allowed actions.
734 #
735 # allow-images (Bool):
736 # Whether images are automatically loaded in web pages.
737 # Valid values: true, false
738 # Default: true
739 #
740 # allow-javascript (Bool):
741 # Enables or disables the running of JavaScript programs.
742 # Valid values: true, false
743 # Default: true
744 #
745 # allow-plugins (Bool):
746 # Enables or disables plugins in Web pages.
747 # Qt plugins with a mimetype such as "application/x-qt-plugin" are
748 # not affected by this setting.
749 # Valid values: true, false
750 # Default: false
751 #
752 # webgl (Bool):
753 # Enables or disables WebGL.
754 # Valid values: true, false
755 # Default: true
756 #
757 # css-regions (Bool):
758 # Enable or disable support for CSS regions.
759 # Valid values: true, false
760 # Default: true
761 #
762 # hyperlink-auditing (Bool):
763 # Enable or disable hyperlink auditing (<a ping>).
764 # Valid values: true, false
765 # Default: false
766 #
767 # geolocation (BoolAsk):
768 # Allow websites to request geolocations.
769 # Valid values: true, false, ask
770 # Default: ask
771 #
772 # notifications (BoolAsk):
773 # Allow websites to show notifications.
774 # Valid values: true, false, ask
775 # Default: ask
776 #
777 # javascript-can-open-windows (Bool):
778 # Whether JavaScript programs can open new windows.
779 # Valid values: true, false
780 # Default: false
781 #
782 # javascript-can-close-windows (Bool):
783 # Whether JavaScript programs can close windows.
784 # Valid values: true, false
785 # Default: false
786 #
787 # javascript-can-access-clipboard (Bool):
788 # Whether JavaScript programs can read or write to the clipboard.
789 # Valid values: true, false
790 # Default: false
791 #
792 # ignore-javascript-prompt (Bool):
793 # Whether all javascript prompts should be ignored.
794 # Valid values: true, false
795 # Default: false
796 #
797 # ignore-javascript-alert (Bool):
798 # Whether all javascript alerts should be ignored.
799 # Valid values: true, false
800 # Default: false
801 #
802 # local-content-can-access-remote-urls (Bool):
803 # Whether locally loaded documents are allowed to access remote
804 # urls.
805 # Valid values: true, false
806 # Default: false
807 #
808 # local-content-can-access-file-urls (Bool):
809 # Whether locally loaded documents are allowed to access other local
810 # urls.
811 # Valid values: true, false
812 # Default: true
813 #
814 # cookies-accept (String):
815 # Control which cookies to accept.
816 # all: Accept all cookies.
817 # no-3rdparty: Accept cookies from the same origin only.
818 # no-unknown-3rdparty: Accept cookies from the same origin only,
819 # unless a cookie is already set for the domain.
820 # never: Don't accept cookies at all.
821 # Default: no-3rdparty
822 #
823 # cookies-store (Bool):
824 # Whether to store cookies.
825 # Valid values: true, false
826 # Default: true
827 #
828 # host-block-lists (UrlList):
829 # List of URLs of lists which contain hosts to block.
830 # The file can be in one of the following formats:
831 # - An '/etc/hosts'-like file
832 # - One host per line
833 # - A zip-file of any of the above, with either only one file, or a
834 # file named 'hosts' (with any extension).
835 # Default:
836 # 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
837 #
838 # host-blocking-enabled (Bool):
839 # Whether host blocking is enabled.
840 # Valid values: true, false
841 # Default: true
842 #
843 # host-blocking-whitelist (List):
844 # List of domains that should always be loaded, despite being
845 # ad-blocked.
846 # Domains may contain * and ? wildcards and are otherwise required
847 # to exactly match the requested domain.
848 # Local domains are always exempt from hostblocking.
849 # Default: piwik.org
850 #
851 # enable-pdfjs (Bool):
852 # Enable pdf.js to view PDF files in the browser.
853 # Note that the files can still be downloaded by clicking the
854 # download button in the pdf.js viewer.
855 # Valid values: true, false
856 # Default: false
857 allow-images = true
858 allow-javascript = true
859 allow-plugins = false
860 webgl = true
861 css-regions = true
862 hyperlink-auditing = false
863 geolocation = ask
864 notifications = ask
865 javascript-can-open-windows = false
866 javascript-can-close-windows = false
867 javascript-can-access-clipboard = false
868 ignore-javascript-prompt = false
869 ignore-javascript-alert = false
870 local-content-can-access-remote-urls = false
871 local-content-can-access-file-urls = true
872 cookies-accept = no-3rdparty
873 cookies-store = true
874 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
875 host-blocking-enabled = true
876 host-blocking-whitelist = piwik.org
877 enable-pdfjs = false
878
879 [hints]
880 # Hinting settings.
881 #
882 # border (String):
883 # CSS border value for hints.
884 # Default: 1px solid #E3BE23
885 #
886 # opacity (Float):
887 # Opacity for hints.
888 # Default: 0.7
889 #
890 # mode (String):
891 # Mode to use for hints.
892 # number: Use numeric hints.
893 # letter: Use the chars in the hints -> chars setting.
894 # Default: letter
895 #
896 # chars (String):
897 # Chars used for hint strings.
898 # Default: asdfghjkl
899 #
900 # min-chars (Int):
901 # Minimum number of chars used for hint strings.
902 # Default: 1
903 #
904 # scatter (Bool):
905 # Whether to scatter hint key chains (like Vimium) or not (like
906 # dwb).
907 # Valid values: true, false
908 # Default: true
909 #
910 # uppercase (Bool):
911 # Make chars in hint strings uppercase.
912 # Valid values: true, false
913 # Default: false
914 #
915 # auto-follow (Bool):
916 # Whether to auto-follow a hint if there's only one left.
917 # Valid values: true, false
918 # Default: true
919 #
920 # next-regexes (RegexList):
921 # A comma-separated list of regexes to use for 'next' links.
922 # Default:
923 # \bnext\b,\bmore\b,\bnewer\b,\b[>→≫]\b,\b(>>|»)\b,\bcontinue\b
924 #
925 # prev-regexes (RegexList):
926 # A comma-separated list of regexes to use for 'prev' links.
927 # Default: \bprev(ious)?\b,\bback\b,\bolder\b,\b[<←≪]\b,\b(<<|«)\b
928 border = 1px solid #E3BE23
929 opacity = 0.7
930 mode = letter
931 chars = aoeuidhtns
932 min-chars = 1
933 scatter = true
934 uppercase = true
935 auto-follow = true
936 next-regexes = \bnext\b,\bmore\b,\bnewer\b,\b[>→≫]\b,\b(>>|»)\b,\bcontinue\b
937 prev-regexes = \bprev(ious)?\b,\bback\b,\bolder\b,\b[<←≪]\b,\b(<<|«)\b
938
939 [searchengines]
940 # Definitions of search engines which can be used via the address bar.
941 # The searchengine named `DEFAULT` is used when `general -> auto-search`
942 # is true and something else than a URL was entered to be opened. Other
943 # search engines can be used by prepending the search engine name to the
944 # search term, e.g. `:open google qutebrowser`. The string `{}` will be
945 # replaced by the search term, use `{{` and `}}` for literal `{`/`}`
946 # signs.
947 DEFAULT = ${duckduckgo}
948 duckduckgo = https://duckduckgo.com/?t=chakra&q={}
949 ddg = ${duckduckgo}
950 google = https://encrypted.google.com/search?q={}
951 g = ${google}
952 wikipedia = http://en.wikipedia.org/w/index.php?title=Special:Search&search={}
953 wiki = ${wikipedia}
954 pcl = http://docs.pointclouds.org/trunk/search.php?query={}
955
956 [aliases]
957 # Aliases for commands.
958 # By default, no aliases are defined. Example which adds a new command
959 # `:qtb` to open qutebrowsers website:
960 # `qtb = open http://www.qutebrowser.org/`
961 quit = close
962 q = close
963 exit = quit
964
965 [colors]
966 # Colors used in the UI.
967 # A value can be in one of the following format:
968 # * `#RGB`/`#RRGGBB`/`#RRRGGGBBB`/`#RRRRGGGGBBBB`
969 # * A SVG color name as specified in http://www.w3.org/TR/SVG/types.html#ColorKeywords[the W3C specification].
970 # * transparent (no color)
971 # * `rgb(r, g, b)` / `rgba(r, g, b, a)` (values 0-255 or percentages)
972 # * `hsv(h, s, v)` / `hsva(h, s, v, a)` (values 0-255, hue 0-359)
973 # * A gradient as explained in http://doc.qt.io/qt-5/stylesheet-reference.html#list-of-property-types[the Qt documentation] under ``Gradient''.
974 # A *.system value determines the color system to use for color
975 # interpolation between similarly-named *.start and *.stop entries,
976 # regardless of how they are defined in the options. Valid values are
977 # 'rgb', 'hsv', and 'hsl'.
978 # 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].
979 #
980 # completion.fg (QtColor):
981 # Text color of the completion widget.
982 # Default: white
983 #
984 # completion.bg (QssColor):
985 # Background color of the completion widget.
986 # Default: #333333
987 #
988 # completion.alternate-bg (QssColor):
989 # Alternating background color of the completion widget.
990 # Default: #444444
991 #
992 # completion.category.fg (QtColor):
993 # Foreground color of completion widget category headers.
994 # Default: white
995 #
996 # completion.category.bg (QssColor):
997 # Background color of the completion widget category headers.
998 # Default: qlineargradient(x1:0, y1:0, x2:0, y2:1, stop:0 #888888,
999 # stop:1 #505050)
1000 #
1001 # completion.category.border.top (QssColor):
1002 # Top border color of the completion widget category headers.
1003 # Default: black
1004 #
1005 # completion.category.border.bottom (QssColor):
1006 # Bottom border color of the completion widget category headers.
1007 # Default: ${completion.category.border.top}
1008 #
1009 # completion.item.selected.fg (QtColor):
1010 # Foreground color of the selected completion item.
1011 # Default: black
1012 #
1013 # completion.item.selected.bg (QssColor):
1014 # Background color of the selected completion item.
1015 # Default: #e8c000
1016 #
1017 # completion.item.selected.border.top (QssColor):
1018 # Top border color of the completion widget category headers.
1019 # Default: #bbbb00
1020 #
1021 # completion.item.selected.border.bottom (QssColor):
1022 # Bottom border color of the selected completion item.
1023 # Default: ${completion.item.selected.border.top}
1024 #
1025 # completion.match.fg (QssColor):
1026 # Foreground color of the matched text in the completion.
1027 # Default: #ff4444
1028 #
1029 # completion.scrollbar.fg (QssColor):
1030 # Color of the scrollbar handle in completion view.
1031 # Default: ${completion.fg}
1032 #
1033 # completion.scrollbar.bg (QssColor):
1034 # Color of the scrollbar in completion view
1035 # Default: ${completion.bg}
1036 #
1037 # statusbar.fg (QssColor):
1038 # Foreground color of the statusbar.
1039 # Default: white
1040 #
1041 # statusbar.bg (QssColor):
1042 # Background color of the statusbar.
1043 # Default: black
1044 #
1045 # statusbar.fg.error (QssColor):
1046 # Foreground color of the statusbar if there was an error.
1047 # Default: ${statusbar.fg}
1048 #
1049 # statusbar.bg.error (QssColor):
1050 # Background color of the statusbar if there was an error.
1051 # Default: red
1052 #
1053 # statusbar.fg.warning (QssColor):
1054 # Foreground color of the statusbar if there is a warning.
1055 # Default: ${statusbar.fg}
1056 #
1057 # statusbar.bg.warning (QssColor):
1058 # Background color of the statusbar if there is a warning.
1059 # Default: darkorange
1060 #
1061 # statusbar.fg.prompt (QssColor):
1062 # Foreground color of the statusbar if there is a prompt.
1063 # Default: ${statusbar.fg}
1064 #
1065 # statusbar.bg.prompt (QssColor):
1066 # Background color of the statusbar if there is a prompt.
1067 # Default: darkblue
1068 #
1069 # statusbar.fg.insert (QssColor):
1070 # Foreground color of the statusbar in insert mode.
1071 # Default: ${statusbar.fg}
1072 #
1073 # statusbar.bg.insert (QssColor):
1074 # Background color of the statusbar in insert mode.
1075 # Default: darkgreen
1076 #
1077 # statusbar.fg.command (QssColor):
1078 # Foreground color of the statusbar in command mode.
1079 # Default: ${statusbar.fg}
1080 #
1081 # statusbar.bg.command (QssColor):
1082 # Background color of the statusbar in command mode.
1083 # Default: ${statusbar.bg}
1084 #
1085 # statusbar.fg.caret (QssColor):
1086 # Foreground color of the statusbar in caret mode.
1087 # Default: ${statusbar.fg}
1088 #
1089 # statusbar.bg.caret (QssColor):
1090 # Background color of the statusbar in caret mode.
1091 # Default: purple
1092 #
1093 # statusbar.fg.caret-selection (QssColor):
1094 # Foreground color of the statusbar in caret mode with a selection
1095 # Default: ${statusbar.fg}
1096 #
1097 # statusbar.bg.caret-selection (QssColor):
1098 # Background color of the statusbar in caret mode with a selection
1099 # Default: #a12dff
1100 #
1101 # statusbar.progress.bg (QssColor):
1102 # Background color of the progress bar.
1103 # Default: white
1104 #
1105 # statusbar.url.fg (QssColor):
1106 # Default foreground color of the URL in the statusbar.
1107 # Default: ${statusbar.fg}
1108 #
1109 # statusbar.url.fg.success (QssColor):
1110 # Foreground color of the URL in the statusbar on successful load
1111 # (http).
1112 # Default: white
1113 #
1114 # statusbar.url.fg.success.https (QssColor):
1115 # Foreground color of the URL in the statusbar on successful load
1116 # (https).
1117 # Default: lime
1118 #
1119 # statusbar.url.fg.error (QssColor):
1120 # Foreground color of the URL in the statusbar on error.
1121 # Default: orange
1122 #
1123 # statusbar.url.fg.warn (QssColor):
1124 # Foreground color of the URL in the statusbar when there's a
1125 # warning.
1126 # Default: yellow
1127 #
1128 # statusbar.url.fg.hover (QssColor):
1129 # Foreground color of the URL in the statusbar for hovered links.
1130 # Default: aqua
1131 #
1132 # tabs.fg.odd (QtColor):
1133 # Foreground color of unselected odd tabs.
1134 # Default: white
1135 #
1136 # tabs.bg.odd (QtColor):
1137 # Background color of unselected odd tabs.
1138 # Default: grey
1139 #
1140 # tabs.fg.even (QtColor):
1141 # Foreground color of unselected even tabs.
1142 # Default: white
1143 #
1144 # tabs.bg.even (QtColor):
1145 # Background color of unselected even tabs.
1146 # Default: darkgrey
1147 #
1148 # tabs.fg.selected.odd (QtColor):
1149 # Foreground color of selected odd tabs.
1150 # Default: white
1151 #
1152 # tabs.bg.selected.odd (QtColor):
1153 # Background color of selected odd tabs.
1154 # Default: black
1155 #
1156 # tabs.fg.selected.even (QtColor):
1157 # Foreground color of selected even tabs.
1158 # Default: ${tabs.fg.selected.odd}
1159 #
1160 # tabs.bg.selected.even (QtColor):
1161 # Background color of selected even tabs.
1162 # Default: ${tabs.bg.selected.odd}
1163 #
1164 # tabs.bg.bar (QtColor):
1165 # Background color of the tab bar.
1166 # Default: #555555
1167 #
1168 # tabs.indicator.start (QtColor):
1169 # Color gradient start for the tab indicator.
1170 # Default: #0000aa
1171 #
1172 # tabs.indicator.stop (QtColor):
1173 # Color gradient end for the tab indicator.
1174 # Default: #00aa00
1175 #
1176 # tabs.indicator.error (QtColor):
1177 # Color for the tab indicator on errors..
1178 # Default: #ff0000
1179 #
1180 # tabs.indicator.system (ColorSystem):
1181 # Color gradient interpolation system for the tab indicator.
1182 # rgb: Interpolate in the RGB color system.
1183 # hsv: Interpolate in the HSV color system.
1184 # hsl: Interpolate in the HSL color system.
1185 # none: Don't show a gradient.
1186 # Default: rgb
1187 #
1188 # hints.fg (CssColor):
1189 # Font color for hints.
1190 # Default: black
1191 #
1192 # hints.bg (CssColor):
1193 # Background color for hints.
1194 # Default: -webkit-gradient(linear, left top, left bottom,
1195 # color-stop(0%,#FFF785), color-stop(100%,#FFC542))
1196 #
1197 # hints.fg.match (CssColor):
1198 # Font color for the matched part of hints.
1199 # Default: green
1200 #
1201 # downloads.bg.bar (QssColor):
1202 # Background color for the download bar.
1203 # Default: black
1204 #
1205 # downloads.fg.start (QtColor):
1206 # Color gradient start for download text.
1207 # Default: white
1208 #
1209 # downloads.bg.start (QtColor):
1210 # Color gradient start for download backgrounds.
1211 # Default: #0000aa
1212 #
1213 # downloads.fg.stop (QtColor):
1214 # Color gradient end for download text.
1215 # Default: ${downloads.fg.start}
1216 #
1217 # downloads.bg.stop (QtColor):
1218 # Color gradient stop for download backgrounds.
1219 # Default: #00aa00
1220 #
1221 # downloads.fg.system (ColorSystem):
1222 # Color gradient interpolation system for download text.
1223 # rgb: Interpolate in the RGB color system.
1224 # hsv: Interpolate in the HSV color system.
1225 # hsl: Interpolate in the HSL color system.
1226 # none: Don't show a gradient.
1227 # Default: rgb
1228 #
1229 # downloads.bg.system (ColorSystem):
1230 # Color gradient interpolation system for download backgrounds.
1231 # rgb: Interpolate in the RGB color system.
1232 # hsv: Interpolate in the HSV color system.
1233 # hsl: Interpolate in the HSL color system.
1234 # none: Don't show a gradient.
1235 # Default: rgb
1236 #
1237 # downloads.fg.error (QtColor):
1238 # Foreground color for downloads with errors.
1239 # Default: white
1240 #
1241 # downloads.bg.error (QtColor):
1242 # Background color for downloads with errors.
1243 # Default: red
1244 #
1245 # webpage.bg (QtColor):
1246 # Background color for webpages if unset (or empty to use the
1247 # theme's color)
1248 # Default: white
1249 completion.fg = white
1250 completion.bg = #333333
1251 completion.alternate-bg = #444444
1252 completion.category.fg = white
1253 completion.category.bg = qlineargradient(x1:0, y1:0, x2:0, y2:1, stop:0 #888888, stop:1 #505050)
1254 completion.category.border.top = black
1255 completion.category.border.bottom = ${completion.category.border.top}
1256 completion.item.selected.fg = black
1257 completion.item.selected.bg = #e8c000
1258 completion.item.selected.border.top = #bbbb00
1259 completion.item.selected.border.bottom = ${completion.item.selected.border.top}
1260 completion.match.fg = #ff4444
1261 completion.scrollbar.fg = ${completion.fg}
1262 completion.scrollbar.bg = ${completion.bg}
1263 statusbar.fg = white
1264 statusbar.bg = black
1265 statusbar.fg.error = ${statusbar.fg}
1266 statusbar.bg.error = red
1267 statusbar.fg.warning = ${statusbar.fg}
1268 statusbar.bg.warning = darkorange
1269 statusbar.fg.prompt = ${statusbar.fg}
1270 statusbar.bg.prompt = darkblue
1271 statusbar.fg.insert = ${statusbar.fg}
1272 statusbar.bg.insert = darkgreen
1273 statusbar.fg.command = ${statusbar.fg}
1274 statusbar.bg.command = ${statusbar.bg}
1275 statusbar.fg.caret = ${statusbar.fg}
1276 statusbar.bg.caret = purple
1277 statusbar.fg.caret-selection = ${statusbar.fg}
1278 statusbar.bg.caret-selection = #a12dff
1279 statusbar.progress.bg = white
1280 statusbar.url.fg = ${statusbar.fg}
1281 statusbar.url.fg.success = white
1282 statusbar.url.fg.success.https = lime
1283 statusbar.url.fg.error = orange
1284 statusbar.url.fg.warn = yellow
1285 statusbar.url.fg.hover = aqua
1286 tabs.fg.odd = white
1287 tabs.bg.odd = grey
1288 tabs.fg.even = white
1289 tabs.bg.even = darkgrey
1290 tabs.fg.selected.odd = white
1291 tabs.bg.selected.odd = black
1292 tabs.fg.selected.even = ${tabs.fg.selected.odd}
1293 tabs.bg.selected.even = ${tabs.bg.selected.odd}
1294 tabs.bg.bar = #555555
1295 tabs.indicator.start = #0000aa
1296 tabs.indicator.stop = #00aa00
1297 tabs.indicator.error = #ff0000
1298 tabs.indicator.system = rgb
1299 hints.fg = black
1300 hints.bg = -webkit-gradient(linear, left top, left bottom, color-stop(0%,#FFF785), color-stop(100%,#FFC542))
1301 hints.fg.match = green
1302 downloads.bg.bar = black
1303 downloads.fg.start = white
1304 downloads.bg.start = #0000aa
1305 downloads.fg.stop = ${downloads.fg.start}
1306 downloads.bg.stop = #00aa00
1307 downloads.fg.system = rgb
1308 downloads.bg.system = rgb
1309 downloads.fg.error = white
1310 downloads.bg.error = red
1311 webpage.bg = white
1312
1313 [fonts]
1314 # Fonts used for the UI, with optional style/weight/size.
1315 # * Style: `normal`/`italic`/`oblique`
1316 # * Weight: `normal`, `bold`, `100`..`900`
1317 # * Size: _number_ `px`/`pt`
1318 #
1319 # _monospace (Font):
1320 # Default monospace fonts.
1321 # Default: Terminus, Monospace, "DejaVu Sans Mono", Monaco,
1322 # "Bitstream Vera Sans Mono", "Andale Mono", "Liberation Mono",
1323 # "Courier New", Courier, monospace, Fixed, Consolas, Terminal
1324 #
1325 # completion (Font):
1326 # Font used in the completion widget.
1327 # Default: 8pt ${_monospace}
1328 #
1329 # tabbar (QtFont):
1330 # Font used in the tab bar.
1331 # Default: 8pt ${_monospace}
1332 #
1333 # statusbar (Font):
1334 # Font used in the statusbar.
1335 # Default: 8pt ${_monospace}
1336 #
1337 # downloads (Font):
1338 # Font used for the downloadbar.
1339 # Default: 8pt ${_monospace}
1340 #
1341 # hints (Font):
1342 # Font used for the hints.
1343 # Default: bold 13px Monospace
1344 #
1345 # debug-console (QtFont):
1346 # Font used for the debugging console.
1347 # Default: 8pt ${_monospace}
1348 #
1349 # web-family-standard (FontFamily):
1350 # Font family for standard fonts.
1351 # Default:
1352 #
1353 # web-family-fixed (FontFamily):
1354 # Font family for fixed fonts.
1355 # Default:
1356 #
1357 # web-family-serif (FontFamily):
1358 # Font family for serif fonts.
1359 # Default:
1360 #
1361 # web-family-sans-serif (FontFamily):
1362 # Font family for sans-serif fonts.
1363 # Default:
1364 #
1365 # web-family-cursive (FontFamily):
1366 # Font family for cursive fonts.
1367 # Default:
1368 #
1369 # web-family-fantasy (FontFamily):
1370 # Font family for fantasy fonts.
1371 # Default:
1372 #
1373 # web-size-minimum (Int):
1374 # The hard minimum font size.
1375 # Default:
1376 #
1377 # web-size-minimum-logical (Int):
1378 # The minimum logical font size that is applied when zooming out.
1379 # Default:
1380 #
1381 # web-size-default (Int):
1382 # The default font size for regular text.
1383 # Default:
1384 #
1385 # web-size-default-fixed (Int):
1386 # The default font size for fixed-pitch text.
1387 # Default:
1388 _monospace = Terminus, Monospace, "DejaVu Sans Mono", Monaco, "Bitstream Vera Sans Mono", "Andale Mono", "Liberation Mono", "Courier New", Courier, monospace, Fixed, Consolas, Terminal
1389 completion = 8pt ${_monospace}
1390 tabbar = 8pt ${_monospace}
1391 statusbar = 8pt ${_monospace}
1392 downloads = 8pt ${_monospace}
1393 hints = bold 12px Monospace
1394 debug-console = 8pt ${_monospace}
1395 web-family-standard =
1396 web-family-fixed =
1397 web-family-serif =
1398 web-family-sans-serif =
1399 web-family-cursive =
1400 web-family-fantasy =
1401 web-size-minimum =
1402 web-size-minimum-logical =
1403 web-size-default =
1404 web-size-default-fixed =