| Setting | Description |
|---|---|
Aliases for commands. |
|
Time interval (in milliseconds) between auto-saves of config/cookies/etc. |
|
Always restore open sites when qutebrowser is reopened. |
|
Backend to use to display websites. |
|
Keybindings mapping keys to commands in different modes. |
|
Default keybindings. If you want to add bindings, modify |
|
This setting can be used to map keys to other keys. |
|
Background color of the completion widget category headers. |
|
Bottom border color of the completion widget category headers. |
|
Top border color of the completion widget category headers. |
|
Foreground color of completion widget category headers. |
|
Background color of the completion widget for even rows. |
|
Text color of the completion widget. |
|
Background color of the selected completion item. |
|
Bottom border color of the selected completion item. |
|
Top border color of the selected completion item. |
|
Foreground color of the selected completion item. |
|
Foreground color of the matched text in the selected completion item. |
|
Foreground color of the matched text in the completion. |
|
Background color of the completion widget for odd rows. |
|
Color of the scrollbar in the completion view. |
|
Color of the scrollbar handle in the completion view. |
|
Background color of disabled items in the context menu. |
|
Foreground color of disabled items in the context menu. |
|
Background color of the context menu. |
|
Foreground color of the context menu. |
|
Background color of the context menu’s selected item. |
|
Foreground color of the context menu’s selected item. |
|
Background color for the download bar. |
|
Background color for downloads with errors. |
|
Foreground color for downloads with errors. |
|
Color gradient start for download backgrounds. |
|
Color gradient start for download text. |
|
Color gradient stop for download backgrounds. |
|
Color gradient end for download text. |
|
Color gradient interpolation system for download backgrounds. |
|
Color gradient interpolation system for download text. |
|
Background color for hints. |
|
Font color for hints. |
|
Font color for the matched part of hints. |
|
Background color of the keyhint widget. |
|
Text color for the keyhint widget. |
|
Highlight color for keys to complete the current keychain. |
|
Background color of an error message. |
|
Border color of an error message. |
|
Foreground color of an error message. |
|
Background color of an info message. |
|
Border color of an info message. |
|
Foreground color of an info message. |
|
Background color of a warning message. |
|
Border color of a warning message. |
|
Foreground color of a warning message. |
|
Background color for prompts. |
|
Border used around UI elements in prompts. |
|
Foreground color for prompts. |
|
Background color for the selected item in filename prompts. |
|
Background color of the statusbar in caret mode. |
|
Foreground color of the statusbar in caret mode. |
|
Background color of the statusbar in caret mode with a selection. |
|
Foreground color of the statusbar in caret mode with a selection. |
|
Background color of the statusbar in command mode. |
|
Foreground color of the statusbar in command mode. |
|
Background color of the statusbar in private browsing + command mode. |
|
Foreground color of the statusbar in private browsing + command mode. |
|
Background color of the statusbar in insert mode. |
|
Foreground color of the statusbar in insert mode. |
|
Background color of the statusbar. |
|
Foreground color of the statusbar. |
|
Background color of the statusbar in passthrough mode. |
|
Foreground color of the statusbar in passthrough mode. |
|
Background color of the statusbar in private browsing mode. |
|
Foreground color of the statusbar in private browsing mode. |
|
Background color of the progress bar. |
|
Foreground color of the URL in the statusbar on error. |
|
Default foreground color of the URL in the statusbar. |
|
Foreground color of the URL in the statusbar for hovered links. |
|
Foreground color of the URL in the statusbar on successful load (http). |
|
Foreground color of the URL in the statusbar on successful load (https). |
|
Foreground color of the URL in the statusbar when there’s a warning. |
|
Background color of the tab bar. |
|
Background color of unselected even tabs. |
|
Foreground color of unselected even tabs. |
|
Color for the tab indicator on errors. |
|
Color gradient start for the tab indicator. |
|
Color gradient end for the tab indicator. |
|
Color gradient interpolation system for the tab indicator. |
|
Background color of unselected odd tabs. |
|
Foreground color of unselected odd tabs. |
|
Background color of pinned unselected even tabs. |
|
Foreground color of pinned unselected even tabs. |
|
Background color of pinned unselected odd tabs. |
|
Foreground color of pinned unselected odd tabs. |
|
Background color of pinned selected even tabs. |
|
Foreground color of pinned selected even tabs. |
|
Background color of pinned selected odd tabs. |
|
Foreground color of pinned selected odd tabs. |
|
Background color of selected even tabs. |
|
Foreground color of selected even tabs. |
|
Background color of selected odd tabs. |
|
Foreground color of selected odd tabs. |
|
Background color for webpages if unset (or empty to use the theme’s color). |
|
Which algorithm to use for modifying how colors are rendered with darkmode. |
|
Contrast for dark mode. |
|
Render all web contents using a dark theme. |
|
Render all colors as grayscale. |
|
Desaturation factor for images in dark mode. |
|
Which images to apply dark mode to. |
|
Which pages to apply dark mode to. |
|
Threshold for inverting background elements with dark mode. |
|
Threshold for inverting text with dark mode. |
|
Force |
|
Number of commands to save in the command history. |
|
Delay (in milliseconds) before updating completions after typing a character. |
|
Height (in pixels or as percentage of the window) of the completion. |
|
Minimum amount of characters needed to update completions. |
|
Which categories to show (in which order) in the :open completion. |
|
Move on to the next part when there’s only one possible completion left. |
|
Padding (in pixels) of the scrollbar handle in the completion window. |
|
Width (in pixels) of the scrollbar in the completion window. |
|
When to show the autocompletion window. |
|
Shrink the completion to be smaller than the configured size if there are no scrollbars. |
|
Format of timestamps (e.g. for the history completion). |
|
Execute the best-matching command on a partial match. |
|
A list of patterns which should not be shown in the history. |
|
Number of URLs to show in the web history. |
|
Require a confirmation before quitting the application. |
|
Automatically start playing |
|
Enable support for the HTML 5 web application cache feature. |
|
Maximum number of pages to hold in the global memory page cache. |
|
Size (in bytes) of the HTTP network cache. Null to use the default value. |
|
Allow websites to read canvas elements. |
|
Which cookies to accept. |
|
Store cookies. |
|
Default encoding to use for websites. |
|
Allow websites to share screen content. |
|
Try to pre-fetch DNS entries to speed up browsing. |
|
Expand each subframe to its contents. |
|
Set fullscreen notification overlay timeout in milliseconds. |
|
Limit fullscreen to the browser window (does not expand to fill the screen). |
|
Allow websites to request geolocations. |
|
Value to send in the |
|
Custom headers for qutebrowser HTTP requests. |
|
Value to send in the |
|
When to send the Referer header. |
|
User agent to send. |
|
Enable host blocking. |
|
List of URLs of lists which contain hosts to block. |
|
A list of patterns that should always be loaded, despite being ad-blocked. |
|
Enable hyperlink auditing ( |
|
Load images automatically in web pages. |
|
Show javascript alerts. |
|
Allow JavaScript to read from or write to the clipboard. |
|
Allow JavaScript to close tabs. |
|
Allow JavaScript to open new tabs without user interaction. |
|
Enable JavaScript. |
|
Log levels to use for JavaScript console logging messages. |
|
Use the standard JavaScript modal dialog for |
|
Show javascript prompts. |
|
Allow locally loaded documents to access other local URLs. |
|
Allow locally loaded documents to access remote URLs. |
|
Enable support for HTML 5 local storage and Web SQL. |
|
Allow websites to record audio/video. |
|
Allow websites to lock your mouse pointer. |
|
Automatically mute tabs. |
|
Netrc-file for HTTP authentication. |
|
Allow websites to show notifications. |
|
Allow pdf.js to view PDF files in the browser. |
|
Allow websites to request persistent storage quota via |
|
Enable plugins in Web pages. |
|
Draw the background color and images also when the page is printed. |
|
Open new windows in private browsing mode which does not record visited pages. |
|
Proxy to use. |
|
Send DNS requests over the configured proxy. |
|
Allow websites to register protocol handlers via |
|
Enable quirks (such as faked user agent headers) needed to get specific sites to work properly. |
|
Validate SSL handshakes. |
|
How navigation requests to URLs with unknown schemes are handled. |
|
List of user stylesheet filenames to use. |
|
Enable WebGL. |
|
Which interfaces to expose via WebRTC. |
|
Monitor load requests for cross-site scripting attempts. |
|
Directory to save downloads to. |
|
Prompt the user for the download location. |
|
Remember the last used download directory. |
|
What to display in the download filename input. |
|
Default program used to open downloads. |
|
Where to show the downloaded files. |
|
Duration (in milliseconds) to wait before removing finished downloads. |
|
Editor (and arguments) to use for the |
|
Encoding to use for the editor. |
|
Font used in the completion categories. |
|
Font used in the completion widget. |
|
Font used for the context menu. |
|
Font used for the debugging console. |
|
Default font families to use. |
|
Default font size to use. |
|
Font used for the downloadbar. |
|
Font used for the hints. |
|
Font used in the keyhint widget. |
|
Font used for error messages. |
|
Font used for info messages. |
|
Font used for warning messages. |
|
Font used for prompts. |
|
Font used in the statusbar. |
|
Font used for selected tabs. |
|
Font used for unselected tabs. |
|
Font family for cursive fonts. |
|
Font family for fantasy fonts. |
|
Font family for fixed fonts. |
|
Font family for sans-serif fonts. |
|
Font family for serif fonts. |
|
Font family for standard fonts. |
|
Default font size (in pixels) for regular text. |
|
Default font size (in pixels) for fixed-pitch text. |
|
Hard minimum font size (in pixels). |
|
Minimum logical font size (in pixels) that is applied when zooming out. |
|
When a hint can be automatically followed without pressing Enter. |
|
Duration (in milliseconds) to ignore normal-mode key bindings after a successful auto-follow. |
|
CSS border value for hints. |
|
Characters used for hint strings. |
|
Dictionary file to be used by the word hints. |
|
Which implementation to use to find elements to hint. |
|
Hide unmatched hints in rapid mode. |
|
Leave hint mode when starting a new page load. |
|
Minimum number of characters used for hint strings. |
|
Mode to use for hints. |
|
Comma-separated list of regular expressions to use for 'next' links. |
|
Padding (in pixels) for hints. |
|
Comma-separated list of regular expressions to use for 'prev' links. |
|
Rounding radius (in pixels) for the edges of hints. |
|
Scatter hint key chains (like Vimium) or not (like dwb). |
|
CSS selectors used to determine which elements on a page should have hints. |
|
Make characters in hint strings uppercase. |
|
Maximum time (in minutes) between two history items for them to be considered being from the same browsing session. |
|
Allow Escape to quit the crash reporter. |
|
Which unbound keys to forward to the webview in normal mode. |
|
Enter insert mode if an editable element is clicked. |
|
Leave insert mode if a non-editable element is clicked. |
|
Automatically enter insert mode if an editable element is focused after loading the page. |
|
Leave insert mode when starting a new page load. |
|
Switch to insert mode when clicking flash and other plugins. |
|
Include hyperlinks in the keyboard focus chain when tabbing. |
|
Enable back and forward buttons on the mouse. |
|
Enable Opera-like mouse rocker gestures. |
|
Timeout (in milliseconds) for partially typed key bindings. |
|
Enable spatial navigation. |
|
Keychains that shouldn’t be shown in the keyhint dialog. |
|
Time (in milliseconds) from pressing a key to seeing the keyhint dialog. |
|
Rounding radius (in pixels) for the edges of the keyhint dialog. |
|
Level for console (stdout/stderr) logs. Ignored if the |
|
Level for in-memory logs. |
|
Duration (in milliseconds) to show messages in the statusbar for. |
|
How to open links in an existing instance if a new one is launched. |
|
Which window to choose when opening links as new tabs. |
|
Show a filebrowser in download prompts. |
|
Rounding radius (in pixels) for the edges of prompts. |
|
Additional arguments to pass to Qt, without leading |
|
Force a Qt platform to use. |
|
Force a Qt platformtheme to use. |
|
Force software rendering for QtWebEngine. |
|
Turn on Qt HighDPI scaling. |
|
When to use Chromium’s low-end device mode. |
|
Which Chromium process model to use. |
|
When/how to show the scrollbar. |
|
Enable smooth scrolling for web pages. |
|
When to find text on a page case-insensitively. |
|
Find text on a page incrementally, renewing the search for each typed character. |
|
Wrap around at the top and bottom of the page when advancing through text matches using |
|
Name of the session to save by default. |
|
Load a restored tab as soon as it takes focus. |
|
Languages to use for spell checking. |
|
Padding (in pixels) for the statusbar. |
|
Position of the status bar. |
|
When to show the statusbar. |
|
List of widgets displayed in the statusbar. |
|
Open new tabs (middleclick/ctrl+click) in the background. |
|
Mouse button with which to close tabs. |
|
How to behave when the close mouse button is pressed on the tab bar. |
|
Scaling factor for favicons in the tab bar. |
|
When to show favicons in the tab bar. |
|
Maximum stack size to remember for tab switches (-1 for no maximum). |
|
Padding (in pixels) for tab indicators. |
|
Width (in pixels) of the progress indicator (0 to disable). |
|
How to behave when the last tab is closed. |
|
Maximum width (in pixels) of tabs (-1 for no maximum). |
|
Minimum width (in pixels) of tabs (-1 for the default minimum size behavior). |
|
When switching tabs, what input mode is applied. |
|
Switch between tabs using the mouse wheel. |
|
Position of new tabs opened from another tab. |
|
Stack related tabs on top of each other when opened consecutively. |
|
Position of new tabs which are not opened from another tab. |
|
Padding (in pixels) around text for tabs. |
|
Force pinned tabs to stay at fixed URL. |
|
Shrink pinned tabs down to their contents. |
|
Position of the tab bar. |
|
Which tab to select when the focused tab is removed. |
|
When to show the tab bar. |
|
Duration (in milliseconds) to show the tab bar before hiding it when tabs.show is set to 'switching'. |
|
Open a new window for every tab. |
|
Alignment of the text inside of tabs. |
|
Format to use for the tab title. |
|
Format to use for the tab title for pinned tabs. The same placeholders like for |
|
Show tooltips on tabs. |
|
Number of close tab actions to remember, per window (-1 for no maximum). |
|
Width (in pixels or as percentage of the window) of the tab bar if it’s vertical. |
|
Wrap when changing tabs. |
|
What search to start when something else than a URL is entered. |
|
Page to open if :open -t/-b/-w is used without URL. |
|
URL segments where |
|
Open base URL of the searchengine if a searchengine shortcut is invoked without parameters. |
|
Search engines which can be used via the address bar. |
|
Page(s) to open at the start. |
|
URL parameters to strip with |
|
Hide the window decoration. |
|
Format to use for the window title. The same placeholders like for |
|
Default zoom level. |
|
Available zoom levels. |
|
Number of zoom increments to divide the mouse wheel movements to. |
|
Apply the zoom factor on a frame only to the text or to all content. |
Aliases for commands. The keys of the given dictionary are the aliases, while the values are the commands they map to.
Type: Dict
Default:
-
q: close
-
qa: quit
-
w: session-save
-
wq: quit --save
-
wqa: quit --save
Backend to use to display websites. qutebrowser supports two different web rendering engines / backends, QtWebKit and QtWebEngine. QtWebKit was discontinued by the Qt project with Qt 5.6, but picked up as a well maintained fork: https://github.com/annulen/webkit/wiki - qutebrowser only supports the fork. QtWebEngine is Qt’s official successor to QtWebKit. It’s slightly more resource hungry than QtWebKit and has a couple of missing features in qutebrowser, but is generally the preferred choice. This setting requires a restart.
Type: String
Valid values:
-
webengine: Use QtWebEngine (based on Chromium).
-
webkit: Use QtWebKit (based on WebKit, similar to Safari).
Default: webengine
Keybindings mapping keys to commands in different modes.
While it’s possible to add bindings with this setting, it’s recommended to use config.bind() in config.py or the :bind command, and leave this setting alone.
This setting is a dictionary containing mode names and dictionaries mapping keys to commands:
{mode: {key: command}}
If you want to map a key to another key, check the bindings.key_mappings setting instead.
For modifiers, you can use either - or + as delimiters, and these names:
-
Control:
Control,Ctrl -
Meta:
Meta,Windows,Mod4 -
Alt:
Alt,Mod1 -
Shift:
Shift
For simple keys (no <>-signs), a capital letter means the key is pressed with Shift. For special keys (with <>-signs), you need to explicitly add Shift- to match a key pressed with shift.
If you want a binding to do nothing, bind it to the nop command. If you want a default binding to be passed through to the website, bind it to null.
Note that some commands which are only useful for bindings (but not used interactively) are hidden from the command completion. See :help for a full list of available commands.
The following modes are available:
-
normal: Default mode, where most commands are invoked.
-
insert: Entered when an input field is focused on a website, or by pressing
iin normal mode. Passes through almost all keypresses to the website, but has some bindings like<Ctrl-e>to open an external editor. Note that single keys can’t be bound in this mode. -
hint: Entered when
fis pressed to select links with the keyboard. Note that single keys can’t be bound in this mode. -
passthrough: Similar to insert mode, but passes through all keypresses except
<Escape>to leave the mode. It might be useful to bind<Escape>to some other key in this mode if you want to be able to send an Escape key to the website as well. Note that single keys can’t be bound in this mode. -
command: Entered when pressing the
:key in order to enter a command. Note that single keys can’t be bound in this mode. -
prompt: Entered when there’s a prompt to display, like for download locations or when invoked from JavaScript.
-
yesno: Entered when there’s a yes/no prompt displayed.
-
caret: Entered when pressing the
vmode, used to select text using the keyboard. -
register: Entered when qutebrowser is waiting for a register name/key for commands like
:set-mark.
Type: Dict
Default: empty
Default keybindings. If you want to add bindings, modify bindings.commands instead.
The main purpose of this setting is that you can set it to an empty dictionary if you want to load no default keybindings at all.
If you want to preserve default bindings (and get new bindings when there is an update), use config.bind() in config.py or the :bind command, and leave this setting alone.
This setting can only be set in config.py.
Type: Dict
Default:
-
caret:
-
$: move-to-end-of-line
-
0: move-to-start-of-line
-
<Ctrl-Space>: drop-selection
-
<Escape>: leave-mode
-
<Return>: yank selection
-
<Space>: toggle-selection
-
G: move-to-end-of-document
-
H: scroll left
-
J: scroll down
-
K: scroll up
-
L: scroll right
-
V: toggle-selection --line
-
Y: yank selection -s
-
[: move-to-start-of-prev-block
-
]: move-to-start-of-next-block
-
b: move-to-prev-word
-
c: enter-mode normal
-
e: move-to-end-of-word
-
gg: move-to-start-of-document
-
h: move-to-prev-char
-
j: move-to-next-line
-
k: move-to-prev-line
-
l: move-to-next-char
-
o: reverse-selection
-
v: toggle-selection
-
w: move-to-next-word
-
y: yank selection
-
{: move-to-end-of-prev-block
-
}: move-to-end-of-next-block
-
-
command:
-
<Alt-B>: rl-backward-word
-
<Alt-Backspace>: rl-backward-kill-word
-
<Alt-D>: rl-kill-word
-
<Alt-F>: rl-forward-word
-
<Ctrl-?>: rl-delete-char
-
<Ctrl-A>: rl-beginning-of-line
-
<Ctrl-B>: rl-backward-char
-
<Ctrl-C>: completion-item-yank
-
<Ctrl-D>: completion-item-del
-
<Ctrl-E>: rl-end-of-line
-
<Ctrl-F>: rl-forward-char
-
<Ctrl-H>: rl-backward-delete-char
-
<Ctrl-K>: rl-kill-line
-
<Ctrl-N>: command-history-next
-
<Ctrl-P>: command-history-prev
-
<Ctrl-Return>: command-accept --rapid
-
<Ctrl-Shift-C>: completion-item-yank --sel
-
<Ctrl-Shift-Tab>: completion-item-focus prev-category
-
<Ctrl-Tab>: completion-item-focus next-category
-
<Ctrl-U>: rl-unix-line-discard
-
<Ctrl-W>: rl-unix-word-rubout
-
<Ctrl-Y>: rl-yank
-
<Down>: completion-item-focus --history next
-
<Escape>: leave-mode
-
<Return>: command-accept
-
<Shift-Delete>: completion-item-del
-
<Shift-Tab>: completion-item-focus prev
-
<Tab>: completion-item-focus next
-
<Up>: completion-item-focus --history prev
-
-
hint:
-
<Ctrl-B>: hint all tab-bg
-
<Ctrl-F>: hint links
-
<Ctrl-R>: hint --rapid links tab-bg
-
<Escape>: leave-mode
-
<Return>: follow-hint
-
-
insert:
-
<Ctrl-E>: open-editor
-
<Escape>: leave-mode
-
<Shift-Ins>: insert-text -- {primary}
-
-
normal:
-
': enter-mode jump_mark
-
+: zoom-in
-
-: zoom-out
-
.: repeat-command
-
/: set-cmd-text /
-
:: set-cmd-text :
-
;I: hint images tab
-
;O: hint links fill :open -t -r {hint-url}
-
;R: hint --rapid links window
-
;Y: hint links yank-primary
-
;b: hint all tab-bg
-
;d: hint links download
-
;f: hint all tab-fg
-
;h: hint all hover
-
;i: hint images
-
;o: hint links fill :open {hint-url}
-
;r: hint --rapid links tab-bg
-
;t: hint inputs
-
;y: hint links yank
-
<Alt-1>: tab-focus 1
-
<Alt-2>: tab-focus 2
-
<Alt-3>: tab-focus 3
-
<Alt-4>: tab-focus 4
-
<Alt-5>: tab-focus 5
-
<Alt-6>: tab-focus 6
-
<Alt-7>: tab-focus 7
-
<Alt-8>: tab-focus 8
-
<Alt-9>: tab-focus -1
-
<Alt-m>: tab-mute
-
<Ctrl-A>: navigate increment
-
<Ctrl-Alt-p>: print
-
<Ctrl-B>: scroll-page 0 -1
-
<Ctrl-D>: scroll-page 0 0.5
-
<Ctrl-F5>: reload -f
-
<Ctrl-F>: scroll-page 0 1
-
<Ctrl-N>: open -w
-
<Ctrl-PgDown>: tab-next
-
<Ctrl-PgUp>: tab-prev
-
<Ctrl-Q>: quit
-
<Ctrl-Return>: follow-selected -t
-
<Ctrl-Shift-N>: open -p
-
<Ctrl-Shift-T>: undo
-
<Ctrl-Shift-Tab>: nop
-
<Ctrl-Shift-W>: close
-
<Ctrl-T>: open -t
-
<Ctrl-Tab>: tab-focus last
-
<Ctrl-U>: scroll-page 0 -0.5
-
<Ctrl-V>: enter-mode passthrough
-
<Ctrl-W>: tab-close
-
<Ctrl-X>: navigate decrement
-
<Ctrl-^>: tab-focus last
-
<Ctrl-h>: home
-
<Ctrl-p>: tab-pin
-
<Ctrl-s>: stop
-
<Escape>: clear-keychain ;; search ;; fullscreen --leave
-
<F11>: fullscreen
-
<F5>: reload
-
<Return>: follow-selected
-
<back>: back
-
<forward>: forward
-
=: zoom
-
?: set-cmd-text ?
-
@: run-macro
-
B: set-cmd-text -s :quickmark-load -t
-
D: tab-close -o
-
F: hint all tab
-
G: scroll-to-perc
-
H: back
-
J: tab-next
-
K: tab-prev
-
L: forward
-
M: bookmark-add
-
N: search-prev
-
O: set-cmd-text -s :open -t
-
PP: open -t -- {primary}
-
Pp: open -t -- {clipboard}
-
R: reload -f
-
Sb: open qute://bookmarks#bookmarks
-
Sh: open qute://history
-
Sq: open qute://bookmarks
-
Ss: open qute://settings
-
T: tab-focus
-
V: enter-mode caret ;; toggle-selection --line
-
ZQ: quit
-
ZZ: quit --save
-
[[: navigate prev
-
]]: navigate next
-
`: enter-mode set_mark
-
ad: download-cancel
-
b: set-cmd-text -s :quickmark-load
-
cd: download-clear
-
co: tab-only
-
d: tab-close
-
f: hint
-
g$: tab-focus -1
-
g0: tab-focus 1
-
gB: set-cmd-text -s :bookmark-load -t
-
gC: tab-clone
-
gD: tab-give
-
gO: set-cmd-text :open -t -r {url:pretty}
-
gU: navigate up -t
-
g^: tab-focus 1
-
ga: open -t
-
gb: set-cmd-text -s :bookmark-load
-
gd: download
-
gf: view-source
-
gg: scroll-to-perc 0
-
gi: hint inputs --first
-
gl: tab-move -
-
gm: tab-move
-
go: set-cmd-text :open {url:pretty}
-
gr: tab-move +
-
gt: set-cmd-text -s :buffer
-
gu: navigate up
-
h: scroll left
-
i: enter-mode insert
-
j: scroll down
-
k: scroll up
-
l: scroll right
-
m: quickmark-save
-
n: search-next
-
o: set-cmd-text -s :open
-
pP: open -- {primary}
-
pp: open -- {clipboard}
-
q: record-macro
-
r: reload
-
sf: save
-
sk: set-cmd-text -s :bind
-
sl: set-cmd-text -s :set -t
-
ss: set-cmd-text -s :set
-
tCH: config-cycle -p -u *://*.{url:host}/* content.cookies.accept all no-3rdparty never ;; reload
-
tCh: config-cycle -p -u *://{url:host}/* content.cookies.accept all no-3rdparty never ;; reload
-
tCu: config-cycle -p -u {url} content.cookies.accept all no-3rdparty never ;; reload
-
tIH: config-cycle -p -u *://*.{url:host}/* content.images ;; reload
-
tIh: config-cycle -p -u *://{url:host}/* content.images ;; reload
-
tIu: config-cycle -p -u {url} content.images ;; reload
-
tPH: config-cycle -p -u *://*.{url:host}/* content.plugins ;; reload
-
tPh: config-cycle -p -u *://{url:host}/* content.plugins ;; reload
-
tPu: config-cycle -p -u {url} content.plugins ;; reload
-
tSH: config-cycle -p -u *://*.{url:host}/* content.javascript.enabled ;; reload
-
tSh: config-cycle -p -u *://{url:host}/* content.javascript.enabled ;; reload
-
tSu: config-cycle -p -u {url} content.javascript.enabled ;; reload
-
tcH: config-cycle -p -t -u *://*.{url:host}/* content.cookies.accept all no-3rdparty never ;; reload
-
tch: config-cycle -p -t -u *://{url:host}/* content.cookies.accept all no-3rdparty never ;; reload
-
tcu: config-cycle -p -t -u {url} content.cookies.accept all no-3rdparty never ;; reload
-
th: back -t
-
tiH: config-cycle -p -t -u *://*.{url:host}/* content.images ;; reload
-
tih: config-cycle -p -t -u *://{url:host}/* content.images ;; reload
-
tiu: config-cycle -p -t -u {url} content.images ;; reload
-
tl: forward -t
-
tpH: config-cycle -p -t -u *://*.{url:host}/* content.plugins ;; reload
-
tph: config-cycle -p -t -u *://{url:host}/* content.plugins ;; reload
-
tpu: config-cycle -p -t -u {url} content.plugins ;; reload
-
tsH: config-cycle -p -t -u *://*.{url:host}/* content.javascript.enabled ;; reload
-
tsh: config-cycle -p -t -u *://{url:host}/* content.javascript.enabled ;; reload
-
tsu: config-cycle -p -t -u {url} content.javascript.enabled ;; reload
-
u: undo
-
v: enter-mode caret
-
wB: set-cmd-text -s :bookmark-load -w
-
wIh: devtools left
-
wIj: devtools bottom
-
wIk: devtools top
-
wIl: devtools right
-
wIw: devtools window
-
wO: set-cmd-text :open -w {url:pretty}
-
wP: open -w -- {primary}
-
wb: set-cmd-text -s :quickmark-load -w
-
wf: hint all window
-
wh: back -w
-
wi: devtools
-
wl: forward -w
-
wo: set-cmd-text -s :open -w
-
wp: open -w -- {clipboard}
-
xO: set-cmd-text :open -b -r {url:pretty}
-
xo: set-cmd-text -s :open -b
-
yD: yank domain -s
-
yM: yank inline [{title}({url}) -s]
-
yP: yank pretty-url -s
-
yT: yank title -s
-
yY: yank -s
-
yd: yank domain
-
ym: yank inline [{title}({url})]
-
yp: yank pretty-url
-
yt: yank title
-
yy: yank
-
{{: navigate prev -t
-
}}: navigate next -t
-
-
passthrough:
-
<Shift-Escape>: leave-mode
-
-
prompt:
-
<Alt-B>: rl-backward-word
-
<Alt-Backspace>: rl-backward-kill-word
-
<Alt-D>: rl-kill-word
-
<Alt-F>: rl-forward-word
-
<Alt-Shift-Y>: prompt-yank --sel
-
<Alt-Y>: prompt-yank
-
<Ctrl-?>: rl-delete-char
-
<Ctrl-A>: rl-beginning-of-line
-
<Ctrl-B>: rl-backward-char
-
<Ctrl-E>: rl-end-of-line
-
<Ctrl-F>: rl-forward-char
-
<Ctrl-H>: rl-backward-delete-char
-
<Ctrl-K>: rl-kill-line
-
<Ctrl-P>: prompt-open-download --pdfjs
-
<Ctrl-U>: rl-unix-line-discard
-
<Ctrl-W>: rl-unix-word-rubout
-
<Ctrl-X>: prompt-open-download
-
<Ctrl-Y>: rl-yank
-
<Down>: prompt-item-focus next
-
<Escape>: leave-mode
-
<Return>: prompt-accept
-
<Shift-Tab>: prompt-item-focus prev
-
<Tab>: prompt-item-focus next
-
<Up>: prompt-item-focus prev
-
-
register:
-
<Escape>: leave-mode
-
-
yesno:
-
<Alt-Shift-Y>: prompt-yank --sel
-
<Alt-Y>: prompt-yank
-
<Escape>: leave-mode
-
<Return>: prompt-accept
-
N: prompt-accept --save no
-
Y: prompt-accept --save yes
-
n: prompt-accept no
-
y: prompt-accept yes
-
This setting can be used to map keys to other keys.
When the key used as dictionary-key is pressed, the binding for the key used as dictionary-value is invoked instead.
This is useful for global remappings of keys, for example to map Ctrl-[ to Escape.
Note that when a key is bound (via bindings.default or bindings.commands), the mapping is ignored.
Type: Dict
Default:
-
<Ctrl-6>: <Ctrl-^>
-
<Ctrl-Enter>: <Ctrl-Return>
-
<Ctrl-I>: <Tab>
-
<Ctrl-J>: <Return>
-
<Ctrl-M>: <Return>
-
<Ctrl-[>: <Escape>
-
<Enter>: <Return>
-
<Shift-Enter>: <Return>
-
<Shift-Return>: <Return>
Background color of the completion widget category headers.
Type: QssColor
Default: qlineargradient(x1:0, y1:0, x2:0, y2:1, stop:0 #888888, stop:1 #505050)
Text color of the completion widget. May be a single color to use for all columns or a list of three colors, one for each column.
Default:
-
white
-
white
-
white
Foreground color of the matched text in the selected completion item.
Type: QtColor
Default: #ff4444
Background color of disabled items in the context menu. If set to null, the Qt default is used.
Type: QssColor
Default: empty
Foreground color of disabled items in the context menu. If set to null, the Qt default is used.
Type: QssColor
Default: empty
Background color of the context menu. If set to null, the Qt default is used.
Type: QssColor
Default: empty
Foreground color of the context menu. If set to null, the Qt default is used.
Type: QssColor
Default: empty
Background color of the context menu’s selected item. If set to null, the Qt default is used.
Type: QssColor
Default: empty
Foreground color of the context menu’s selected item. If set to null, the Qt default is used.
Type: QssColor
Default: empty
Color gradient interpolation system for download backgrounds.
Type: ColorSystem
Valid values:
-
rgb: Interpolate in the RGB color system.
-
hsv: Interpolate in the HSV color system.
-
hsl: Interpolate in the HSL color system.
-
none: Don’t show a gradient.
Default: rgb
Color gradient interpolation system for download text.
Type: ColorSystem
Valid values:
-
rgb: Interpolate in the RGB color system.
-
hsv: Interpolate in the HSV color system.
-
hsl: Interpolate in the HSL color system.
-
none: Don’t show a gradient.
Default: rgb
Background color for hints.
Note that you can use a rgba(…) value for transparency.
Type: QssColor
Default: qlineargradient(x1:0, y1:0, x2:0, y2:1, stop:0 rgba(255, 247, 133, 0.8), stop:1 rgba(255, 197, 66, 0.8))
Background color of the statusbar in private browsing + command mode.
Type: QssColor
Default: darkslategray
Foreground color of the URL in the statusbar on successful load (http).
Type: QssColor
Default: white
Foreground color of the URL in the statusbar on successful load (https).
Type: QssColor
Default: lime
Color gradient interpolation system for the tab indicator.
Type: ColorSystem
Valid values:
-
rgb: Interpolate in the RGB color system.
-
hsv: Interpolate in the HSV color system.
-
hsl: Interpolate in the HSL color system.
-
none: Don’t show a gradient.
Default: rgb
Background color for webpages if unset (or empty to use the theme’s color).
Type: QtColor
Default: white
Which algorithm to use for modifying how colors are rendered with darkmode. This setting requires a restart.
Type: String
Valid values:
-
lightness-cielab: Modify colors by converting them to CIELAB color space and inverting the L value.
-
lightness-hsl: Modify colors by converting them to the HSL color space and inverting the lightness (i.e. the "L" in HSL).
-
brightness-rgb: Modify colors by subtracting each of r, g, and b from their maximum value.
Default: lightness-cielab
On QtWebEngine, this setting requires Qt 5.14 or newer.
On QtWebKit, this setting is unavailable.
Contrast for dark mode.
This only has an effect when colors.webpage.darkmode.algorithm is set to lightness-hsl or brightness-rgb.
This setting requires a restart.
Type: Float
Default: 0.0
On QtWebEngine, this setting requires Qt 5.14 or newer.
On QtWebKit, this setting is unavailable.
Render all web contents using a dark theme.
Example configurations from Chromium’s chrome://flags:
-
"With simple HSL/CIELAB/RGB-based inversion": Set
colors.webpage.darkmode.algorithmaccordingly. -
"With selective image inversion": Set
colors.webpage.darkmode.policy.imagestosmart. -
"With selective inversion of non-image elements": Set
colors.webpage.darkmode.threshold.textto 150 andcolors.webpage.darkmode.threshold.backgroundto 205. -
"With selective inversion of everything": Combines the two variants above. This setting requires a restart.
Type: Bool
Default: false
On QtWebEngine, this setting requires Qt 5.14 or newer.
On QtWebKit, this setting is unavailable.
Render all colors as grayscale.
This only has an effect when colors.webpage.darkmode.algorithm is set to lightness-hsl or brightness-rgb.
This setting requires a restart.
Type: Bool
Default: false
On QtWebEngine, this setting requires Qt 5.14 or newer.
On QtWebKit, this setting is unavailable.
Desaturation factor for images in dark mode. If set to 0, images are left as-is. If set to 1, images are completely grayscale. Values between 0 and 1 desaturate the colors accordingly. This setting requires a restart.
Type: Float
Default: 0.0
On QtWebEngine, this setting requires Qt 5.14 or newer.
On QtWebKit, this setting is unavailable.
Which images to apply dark mode to. WARNING: On Qt 5.15.0, this setting can cause frequent renderer process crashes due to a bug in Qt. This setting requires a restart.
Type: String
Valid values:
-
always: Apply dark mode filter to all images.
-
never: Never apply dark mode filter to any images.
-
smart: Apply dark mode based on image content.
Default: never
On QtWebEngine, this setting requires Qt 5.14 or newer.
On QtWebKit, this setting is unavailable.
Which pages to apply dark mode to. This setting requires a restart.
Type: String
Valid values:
-
always: Apply dark mode filter to all frames, regardless of content.
-
smart: Apply dark mode filter to frames based on background color.
Default: smart
On QtWebEngine, this setting requires Qt 5.14 or newer.
On QtWebKit, this setting is unavailable.
Threshold for inverting background elements with dark mode.
Background elements with brightness above this threshold will be inverted, and below it will be left as in the original, non-dark-mode page. Set to 256 to never invert the color or to 0 to always invert it.
Note: This behavior is the opposite of colors.webpage.darkmode.threshold.text!
This setting requires a restart.
Type: Int
Default: 0
On QtWebEngine, this setting requires Qt 5.14 or newer.
On QtWebKit, this setting is unavailable.
Threshold for inverting text with dark mode. Text colors with brightness below this threshold will be inverted, and above it will be left as in the original, non-dark-mode page. Set to 256 to always invert text color or to 0 to never invert text color. This setting requires a restart.
Type: Int
Default: 256
On QtWebEngine, this setting requires Qt 5.14 or newer.
On QtWebKit, this setting is unavailable.
Force prefers-color-scheme: dark colors for websites.
Type: Bool
Default: false
On QtWebEngine, this setting requires Qt 5.14 or newer.
On QtWebKit, this setting is unavailable.
Number of commands to save in the command history. 0: no history / -1: unlimited
Type: Int
Default: 100
Which categories to show (in which order) in the :open completion.
Type: FlagList
Valid values:
-
searchengines
-
quickmarks
-
bookmarks
-
history
Default:
-
searchengines
-
quickmarks
-
bookmarks
-
history
When to show the autocompletion window.
Type: String
Valid values:
-
always: Whenever a completion is available.
-
auto: Whenever a completion is requested.
-
never: Never.
Default: always
Shrink the completion to be smaller than the configured size if there are no scrollbars.
Type: Bool
Default: false
Format of timestamps (e.g. for the history completion). See https://sqlite.org/lang_datefunc.html for allowed substitutions.
Type: String
Default: %Y-%m-%d
A list of patterns which should not be shown in the history. This only affects the completion. Matching URLs are still saved in the history (and visible on the qute://history page), but hidden in the completion. Changing this setting will cause the completion history to be regenerated on the next start, which will take a short while. This setting requires a restart.
Type: List of UrlPattern
Default: empty
Require a confirmation before quitting the application.
Type: ConfirmQuit
Valid values:
-
always: Always show a confirmation.
-
multiple-tabs: Show a confirmation if multiple tabs are opened.
-
downloads: Show a confirmation if downloads are running
-
never: Never show a confirmation.
Default:
-
never
Automatically start playing <video> elements.
Note: On Qt < 5.11, this option needs a restart and does not support URL patterns.
This setting supports URL patterns.
Type: Bool
Default: true
On QtWebEngine, this setting requires Qt 5.10 or newer.
On QtWebKit, this setting is unavailable.
Enable support for the HTML 5 web application cache feature. An application cache acts like an HTTP cache in some sense. For documents that use the application cache via JavaScript, the loader engine will first ask the application cache for the contents, before hitting the network.
This setting supports URL patterns.
Type: Bool
Default: true
This setting is only available with the QtWebKit backend.
Maximum number of pages to hold in the global memory page cache. The page cache allows for a nicer user experience when navigating forth or back to pages in the forward/back history, by pausing and resuming up to n pages. For more information about the feature, please refer to: http://webkit.org/blog/427/webkit-page-cache-i-the-basics/
Type: Int
Default: 0
This setting is only available with the QtWebKit backend.
Size (in bytes) of the HTTP network cache. Null to use the default value. With QtWebEngine, the maximum supported value is 2147483647 (~2 GB).
Type: Int
Default: empty
Allow websites to read canvas elements. Note this is needed for some websites to work properly. This setting requires a restart.
Type: Bool
Default: true
This setting is only available with the QtWebEngine backend.
Which cookies to accept.
With QtWebEngine, this setting also controls other features with tracking capabilities similar to those of cookies; including IndexedDB, DOM storage, filesystem API, service workers, and AppCache.
Note that with QtWebKit, only all and never are supported as per-domain values. Setting no-3rdparty or no-unknown-3rdparty per-domain on QtWebKit will have the same effect as all.
This setting supports URL patterns.
Type: String
Valid values:
-
all: Accept all cookies.
-
no-3rdparty: Accept cookies from the same origin only. This is known to break some sites, such as GMail.
-
no-unknown-3rdparty: Accept cookies from the same origin only, unless a cookie is already set for the domain. On QtWebEngine, this is the same as no-3rdparty.
-
never: Don’t accept cookies at all.
Default: all
On QtWebEngine, this setting requires Qt 5.11 or newer.
Store cookies. Note this option needs a restart with QtWebEngine on Qt < 5.9.
Type: Bool
Default: true
Default encoding to use for websites. The encoding must be a string describing an encoding such as utf-8, iso-8859-1, etc.
Type: String
Default: iso-8859-1
Allow websites to share screen content. On Qt < 5.10, a dialog box is always displayed, even if this is set to "true".
This setting supports URL patterns.
Type: BoolAsk
Valid values:
-
true
-
false
-
ask
Default: ask
Try to pre-fetch DNS entries to speed up browsing.
This setting supports URL patterns.
Type: Bool
Default: true
On QtWebEngine, this setting requires Qt 5.12 or newer.
Expand each subframe to its contents. This will flatten all the frames to become one scrollable page.
This setting supports URL patterns.
Type: Bool
Default: false
This setting is only available with the QtWebKit backend.
Set fullscreen notification overlay timeout in milliseconds. If set to 0, no overlay will be displayed.
Type: Int
Default: 3000
Limit fullscreen to the browser window (does not expand to fill the screen).
Type: Bool
Default: false
Allow websites to request geolocations.
This setting supports URL patterns.
Type: BoolAsk
Valid values:
-
true
-
false
-
ask
Default: ask
Value to send in the Accept-Language header.
Note that the value read from JavaScript is always the global value.
This setting supports URL patterns.
Type: String
Default: en-US,en;q=0.9
Custom headers for qutebrowser HTTP requests.
This setting supports URL patterns.
Type: Dict
Default: empty
Value to send in the DNT header.
When this is set to true, qutebrowser asks websites to not track your identity. If set to null, the DNT header is not sent at all.
This setting supports URL patterns.
Type: Bool
Default: true
When to send the Referer header. The Referer header tells websites from which website you were coming from when visiting them. No restart is needed with QtWebKit. This setting requires a restart.
Type: String
Valid values:
-
always: Always send the Referer.
-
never: Never send the Referer. This is not recommended, as some sites may break.
-
same-domain: Only send the Referer for the same domain. This will still protect your privacy, but shouldn’t break any sites. With QtWebEngine, the referer will still be sent for other domains, but with stripped path information.
Default: same-domain
User agent to send.
The following placeholders are defined:
-
{os_info}: Something like "X11; Linux x86_64". -
{webkit_version}: The underlying WebKit version (set to a fixed value with QtWebEngine). -
{qt_key}: "Qt" for QtWebKit, "QtWebEngine" for QtWebEngine. -
{qt_version}: The underlying Qt version. -
{upstream_browser_key}: "Version" for QtWebKit, "Chrome" for QtWebEngine. -
{upstream_browser_version}: The corresponding Safari/Chrome version. -
{qutebrowser_version}: The currently running qutebrowser version.
The default value is equal to the unchanged user agent of QtWebKit/QtWebEngine.
Note that the value read from JavaScript is always the global value. With QtWebEngine between 5.12 and 5.14 (inclusive), changing the value exposed to JavaScript requires a restart.
This setting supports URL patterns.
Type: FormatString
Default: Mozilla/5.0 ({os_info}) AppleWebKit/{webkit_version} (KHTML, like Gecko) {qt_key}/{qt_version} {upstream_browser_key}/{upstream_browser_version} Safari/{webkit_version}
List of URLs of lists which contain hosts to block.
The file can be in one of the following formats:
-
An
/etc/hosts-like file -
One host per line
-
A zip-file of any of the above, with either only one file, or a file named
hosts(with any extension).
It’s also possible to add a local file or directory via a file:// URL. In
case of a directory, all files in the directory are read as adblock lists.
The file ~/.config/qutebrowser/blocked-hosts is always read if it exists.
Type: List of Url
Default:
A list of patterns that should always be loaded, despite being ad-blocked.
Note this whitelists blocked hosts, not first-party URLs. As an example, if example.org loads an ad from ads.example.org, the whitelisted host should be ads.example.org. If you want to disable the adblocker on a given page, use the content.host_blocking.enabled setting with a URL pattern instead.
Local domains are always exempt from hostblocking.
Type: List of UrlPattern
Default: empty
Load images automatically in web pages.
This setting supports URL patterns.
Type: Bool
Default: true
Allow JavaScript to read from or write to the clipboard. With QtWebEngine, writing the clipboard as response to a user interaction is always allowed.
This setting supports URL patterns.
Type: Bool
Default: false
Allow JavaScript to close tabs.
This setting supports URL patterns.
Type: Bool
Default: false
This setting is only available with the QtWebKit backend.
Allow JavaScript to open new tabs without user interaction.
This setting supports URL patterns.
Type: Bool
Default: false
Log levels to use for JavaScript console logging messages.
When a JavaScript message with the level given in the dictionary key is logged, the corresponding dictionary value selects the qutebrowser logger to use.
On QtWebKit, the "unknown" setting is always used.
The following levels are valid: none, debug, info, warning, error.
Type: Dict
Default:
-
error: debug
-
info: debug
-
unknown: debug
-
warning: debug
Allow locally loaded documents to access other local URLs.
This setting supports URL patterns.
Type: Bool
Default: true
Allow locally loaded documents to access remote URLs.
This setting supports URL patterns.
Type: Bool
Default: false
Enable support for HTML 5 local storage and Web SQL.
This setting supports URL patterns.
Type: Bool
Default: true
Allow websites to record audio/video.
This setting supports URL patterns.
Type: BoolAsk
Valid values:
-
true
-
false
-
ask
Default: ask
This setting is only available with the QtWebEngine backend.
Allow websites to lock your mouse pointer.
This setting supports URL patterns.
Type: BoolAsk
Valid values:
-
true
-
false
-
ask
Default: ask
On QtWebEngine, this setting requires Qt 5.8 or newer.
On QtWebKit, this setting is unavailable.
Automatically mute tabs.
Note that if the :tab-mute command is used, the mute status for the affected tab is now controlled manually, and this setting doesn’t have any effect.
This setting supports URL patterns.
Type: Bool
Default: false
Allow websites to show notifications.
This setting supports URL patterns.
Type: BoolAsk
Valid values:
-
true
-
false
-
ask
Default: ask
On QtWebEngine, this setting requires Qt 5.13 or newer.
Allow pdf.js to view PDF files in the browser. Note that the files can still be downloaded by clicking the download button in the pdf.js viewer.
This setting supports URL patterns.
Type: Bool
Default: false
Allow websites to request persistent storage quota via navigator.webkitPersistentStorage.requestQuota.
This setting supports URL patterns.
Type: BoolAsk
Valid values:
-
true
-
false
-
ask
Default: ask
On QtWebEngine, this setting requires Qt 5.11 or newer.
On QtWebKit, this setting is unavailable.
Draw the background color and images also when the page is printed.
This setting supports URL patterns.
Type: Bool
Default: true
On QtWebEngine, this setting requires Qt 5.8 or newer.
Open new windows in private browsing mode which does not record visited pages.
Type: Bool
Default: false
Proxy to use.
In addition to the listed values, you can use a socks://… or http://…; URL.
Type: Proxy
Valid values:
-
system: Use the system wide proxy.
-
none: Don’t use any proxy
Default: system
Send DNS requests over the configured proxy.
Type: Bool
Default: true
This setting is only available with the QtWebKit backend.
Allow websites to register protocol handlers via navigator.registerProtocolHandler.
This setting supports URL patterns.
Type: BoolAsk
Valid values:
-
true
-
false
-
ask
Default: ask
On QtWebEngine, this setting requires Qt 5.11 or newer.
On QtWebKit, this setting is unavailable.
Enable quirks (such as faked user agent headers) needed to get specific sites to work properly. This setting requires a restart.
Type: Bool
Default: true
Validate SSL handshakes.
This setting supports URL patterns.
Type: BoolAsk
Valid values:
-
true
-
false
-
ask
Default: ask
How navigation requests to URLs with unknown schemes are handled.
This setting supports URL patterns.
Type: String
Valid values:
-
disallow: Disallows all navigation requests to URLs with unknown schemes.
-
allow-from-user-interaction: Allows navigation requests to URLs with unknown schemes that are issued from user-interaction (like a mouse-click), whereas other navigation requests (for example from JavaScript) are suppressed.
-
allow-all: Allows all navigation requests to URLs with unknown schemes.
Default: allow-from-user-interaction
On QtWebEngine, this setting requires Qt 5.11 or newer.
On QtWebKit, this setting is unavailable.
Which interfaces to expose via WebRTC. On Qt 5.10, this option doesn’t work because of a Qt bug. This setting requires a restart.
Type: String
Valid values:
-
all-interfaces: WebRTC has the right to enumerate all interfaces and bind them to discover public interfaces.
-
default-public-and-private-interfaces: WebRTC should only use the default route used by http. This also exposes the associated default private address. Default route is the route chosen by the OS on a multi-homed endpoint.
-
default-public-interface-only: WebRTC should only use the default route used by http. This doesn’t expose any local addresses.
-
disable-non-proxied-udp: WebRTC should only use TCP to contact peers or servers unless the proxy server supports UDP. This doesn’t expose any local addresses either.
Default: all-interfaces
On QtWebEngine, this setting requires Qt 5.9.2 or newer.
On QtWebKit, this setting is unavailable.
Monitor load requests for cross-site scripting attempts. Suspicious scripts will be blocked and reported in the devtools JavaScript console. Note that bypasses for the XSS auditor are widely known and it can be abused for cross-site info leaks in some scenarios, see: https://www.chromium.org/developers/design-documents/xss-auditor
This setting supports URL patterns.
Type: Bool
Default: false
Directory to save downloads to. If unset, a sensible OS-specific default is used.
Type: Directory
Default: empty
Prompt the user for the download location.
If set to false, downloads.location.directory will be used.
Type: Bool
Default: true
What to display in the download filename input.
Type: String
Valid values:
-
path: Show only the download path.
-
filename: Show only download filename.
-
both: Show download path and filename.
Default: path
Default program used to open downloads.
If null, the default internal handler is used.
Any {} in the string will be expanded to the filename, else the filename will be appended.
Type: String
Default: empty
Duration (in milliseconds) to wait before removing finished downloads. If set to -1, downloads are never removed.
Type: Int
Default: -1
Editor (and arguments) to use for the open-editor command.
The following placeholders are defined:
-
{file}: Filename of the file to be edited. -
{line}: Line in which the caret is found in the text. -
{column}: Column in which the caret is found in the text. -
{line0}: Same as{line}, but starting from index 0. -
{column0}: Same as{column}, but starting from index 0.
Type: ShellCommand
Default:
-
gvim
-
-f
-
{file}
-
-c
-
normal {line}G{column0}l
Default font families to use. Whenever "default_family" is used in a font setting, it’s replaced with the fonts listed here. If set to an empty value, a system-specific monospace default is used.
Type: List of Font, or Font
Default: empty
Default font size to use. Whenever "default_size" is used in a font setting, it’s replaced with the size listed here. Valid values are either a float value with a "pt" suffix, or an integer value with a "px" suffix.
Type: String
Default: 10pt
When a hint can be automatically followed without pressing Enter.
Type: String
Valid values:
-
always: Auto-follow whenever there is only a single hint on a page.
-
unique-match: Auto-follow whenever there is a unique non-empty match in either the hint string (word mode) or filter (number mode).
-
full-match: Follow the hint when the user typed the whole hint (letter, word or number mode) or the element’s text (only in number mode).
-
never: The user will always need to press Enter to follow a hint.
Default: unique-match
Duration (in milliseconds) to ignore normal-mode key bindings after a successful auto-follow.
Type: Int
Default: 0
Which implementation to use to find elements to hint.
Type: String
Valid values:
-
javascript: Better but slower
-
python: Slightly worse but faster
Default: python
This setting is only available with the QtWebKit backend.
Mode to use for hints.
Type: String
Valid values:
-
number: Use numeric hints. (In this mode you can also type letters from the hinted element to filter and reduce the number of elements that are hinted.)
-
letter: Use the characters in the
hints.charssetting. -
word: Use hints words based on the html elements and the extra words.
Default: letter
Comma-separated list of regular expressions to use for 'next' links.
Type: List of Regex
Default:
-
\bnext\b
-
\bmore\b
-
\bnewer\b
-
\b[>→≫\b]
-
\b(>>|»)\b
-
\bcontinue\b
Comma-separated list of regular expressions to use for 'prev' links.
Type: List of Regex
Default:
-
\bprev(ious)?\b
-
\bback\b
-
\bolder\b
-
\b[<←≪\b]
-
\b(<<|«)\b
Scatter hint key chains (like Vimium) or not (like dwb). Ignored for number hints.
Type: Bool
Default: true
CSS selectors used to determine which elements on a page should have hints.
This setting supports URL patterns.
This setting can only be set in config.py.
Type: Dict
Default:
-
all:
-
a
-
area
-
textarea
-
select
-
input:not([type="hidden")]
-
button
-
frame
-
iframe
-
img
-
link
-
summary
-
[onclick]
-
[onmousedown]
-
[role="link"]
-
[role="option"]
-
[role="button"]
-
[ng-click]
-
[ngClick]
-
[data-ng-click]
-
[x-ng-click]
-
[tabindex]
-
-
images:
-
img
-
-
inputs:
-
input[type="text"]
-
input[type="date"]
-
input[type="datetime-local"]
-
input[type="email"]
-
input[type="month"]
-
input[type="number"]
-
input[type="password"]
-
input[type="search"]
-
input[type="tel"]
-
input[type="time"]
-
input[type="url"]
-
input[type="week"]
-
input:not([type)]
-
textarea
-
-
links:
-
a[href]
-
area[href]
-
link[href]
-
[role="link"[href]]
-
-
media:
-
audio
-
img
-
video
-
-
url:
-
[src]
-
[href]
-
Maximum time (in minutes) between two history items for them to be considered being from the same browsing session.
Items with less time between them are grouped when being displayed in :history. Use -1 to disable separation.
Type: Int
Default: 30
Which unbound keys to forward to the webview in normal mode.
Type: String
Valid values:
-
all: Forward all unbound keys.
-
auto: Forward unbound non-alphanumeric keys.
-
none: Don’t forward any keys.
Default: auto
Automatically enter insert mode if an editable element is focused after loading the page.
Type: Bool
Default: false
Leave insert mode when starting a new page load. Patterns may be unreliable on this setting, and they may match the url you are navigating to, or the URL you are navigating from.
This setting supports URL patterns.
Type: Bool
Default: true
Include hyperlinks in the keyboard focus chain when tabbing.
This setting supports URL patterns.
Type: Bool
Default: true
Timeout (in milliseconds) for partially typed key bindings. If the current input forms only partial matches, the keystring will be cleared after this time.
Type: Int
Default: 5000
Enable spatial navigation. Spatial navigation consists in the ability to navigate between focusable elements in a Web page, such as hyperlinks and form controls, by using Left, Right, Up and Down arrow keys. For example, if the user presses the Right key, heuristics determine whether there is an element he might be trying to reach towards the right and which element he probably wants.
This setting supports URL patterns.
Type: Bool
Default: false
Keychains that shouldn’t be shown in the keyhint dialog.
Globs are supported, so ;* will blacklist all keychains starting with ;. Use * to disable keyhints.
Type: List of String
Default: empty
Level for console (stdout/stderr) logs. Ignored if the --loglevel or --debug CLI flags are used.
Type: LogLevel
Valid values:
-
vdebug
-
debug
-
info
-
warning
-
error
-
critical
Default: info
Level for in-memory logs.
Type: LogLevel
Valid values:
-
vdebug
-
debug
-
info
-
warning
-
error
-
critical
Default: debug
Duration (in milliseconds) to show messages in the statusbar for. Set to 0 to never clear messages.
Type: Int
Default: 2000
How to open links in an existing instance if a new one is launched.
This happens when e.g. opening a link from a terminal.
See new_instance_open_target_window to customize in which window the link is opened in.
Type: String
Valid values:
-
tab: Open a new tab in the existing window and activate the window.
-
tab-bg: Open a new background tab in the existing window and activate the window.
-
tab-silent: Open a new tab in the existing window without activating the window.
-
tab-bg-silent: Open a new background tab in the existing window without activating the window.
-
window: Open in a new window.
Default: tab
Which window to choose when opening links as new tabs.
When new_instance_open_target is set to window, this is ignored.
Type: String
Valid values:
-
first-opened: Open new tabs in the first (oldest) opened window.
-
last-opened: Open new tabs in the last (newest) opened window.
-
last-focused: Open new tabs in the most recently focused window.
-
last-visible: Open new tabs in the most recently visible window.
Default: last-focused
Additional arguments to pass to Qt, without leading --.
With QtWebEngine, some Chromium arguments (see https://peter.sh/experiments/chromium-command-line-switches/ for a list) will work.
This setting requires a restart.
Type: List of String
Default: empty
Force a Qt platform to use.
This sets the QT_QPA_PLATFORM environment variable and is useful to force using the XCB plugin when running QtWebEngine on Wayland.
This setting requires a restart.
Type: String
Default: empty
Force a Qt platformtheme to use.
This sets the QT_QPA_PLATFORMTHEME environment variable which controls dialogs like the filepicker. By default, Qt determines the platform theme based on the desktop environment.
This setting requires a restart.
Type: String
Default: empty
Force software rendering for QtWebEngine. This is needed for QtWebEngine to work with Nouveau drivers and can be useful in other scenarios related to graphic issues. This setting requires a restart.
Type: String
Valid values:
-
software-opengl: Tell LibGL to use a software implementation of GL (
LIBGL_ALWAYS_SOFTWARE/QT_XCB_FORCE_SOFTWARE_OPENGL) -
qt-quick: Tell Qt Quick to use a software renderer instead of OpenGL. (
QT_QUICK_BACKEND=software) -
chromium: Tell Chromium to disable GPU support and use Skia software rendering instead. (
--disable-gpu) -
none: Don’t force software rendering.
Default: none
This setting is only available with the QtWebEngine backend.
Turn on Qt HighDPI scaling.
This is equivalent to setting QT_AUTO_SCREEN_SCALE_FACTOR=1 or QT_ENABLE_HIGHDPI_SCALING=1 (Qt >= 5.14) in the environment.
It’s off by default as it can cause issues with some bitmap fonts. As an alternative to this, it’s possible to set font sizes and the zoom.default setting.
This setting requires a restart.
Type: Bool
Default: false
When to use Chromium’s low-end device mode. This improves the RAM usage of renderer processes, at the expense of performance. This setting requires a restart.
Type: String
Valid values:
-
always: Always use low-end device mode.
-
auto: Decide automatically (uses low-end mode with < 1 GB available RAM).
-
never: Never use low-end device mode.
Default: auto
This setting is only available with the QtWebEngine backend.
Which Chromium process model to use. Alternative process models use less resources, but decrease security and robustness. See the following pages for more details:
-
https://www.chromium.org/developers/design-documents/process-models
-
https://doc.qt.io/qt-5/qtwebengine-features.html#process-models This setting requires a restart.
Type: String
Valid values:
-
process-per-site-instance: Pages from separate sites are put into separate processes and separate visits to the same site are also isolated.
-
process-per-site: Pages from separate sites are put into separate processes. Unlike Process per Site Instance, all visits to the same site will share an OS process. The benefit of this model is reduced memory consumption, because more web pages will share processes. The drawbacks include reduced security, robustness, and responsiveness.
-
single-process: Run all tabs in a single process. This should be used for debugging purposes only, and it disables
:open --private.
Default: process-per-site-instance
This setting is only available with the QtWebEngine backend.
When/how to show the scrollbar.
Type: String
Valid values:
-
always: Always show the scrollbar.
-
never: Never show the scrollbar.
-
when-searching: Show the scrollbar when searching for text in the webpage. With the QtWebKit backend, this is equal to
never. -
overlay: Show an overlay scrollbar. With Qt < 5.11 or on macOS, this is unavailable and equal to
when-searching; with the QtWebKit backend, this is equal tonever. Enabling/disabling overlay scrollbars requires a restart.
Default: overlay
Enable smooth scrolling for web pages.
Note smooth scrolling does not work with the :scroll-px command.
This setting supports URL patterns.
Type: Bool
Default: false
When to find text on a page case-insensitively.
Type: IgnoreCase
Valid values:
-
always: Search case-insensitively.
-
never: Search case-sensitively.
-
smart: Search case-sensitively if there are capital characters.
Default: smart
Find text on a page incrementally, renewing the search for each typed character.
Type: Bool
Default: true
Wrap around at the top and bottom of the page when advancing through text matches using :search-next and :search-prev.
Type: Bool
Default: true
On QtWebEngine, this setting requires Qt 5.14 or newer.
Name of the session to save by default. If this is set to null, the session which was last loaded is saved.
Type: SessionName
Default: empty
Languages to use for spell checking. You can check for available languages and install dictionaries using scripts/dictcli.py. Run the script with -h/--help for instructions.
Type: List of String
Valid values:
-
af-ZA: Afrikaans (South Africa)
-
bg-BG: Bulgarian (Bulgaria)
-
ca-ES: Catalan (Spain)
-
cs-CZ: Czech (Czech Republic)
-
da-DK: Danish (Denmark)
-
de-DE: German (Germany)
-
el-GR: Greek (Greece)
-
en-AU: English (Australia)
-
en-CA: English (Canada)
-
en-GB: English (United Kingdom)
-
en-US: English (United States)
-
es-ES: Spanish (Spain)
-
et-EE: Estonian (Estonia)
-
fa-IR: Farsi (Iran)
-
fo-FO: Faroese (Faroe Islands)
-
fr-FR: French (France)
-
he-IL: Hebrew (Israel)
-
hi-IN: Hindi (India)
-
hr-HR: Croatian (Croatia)
-
hu-HU: Hungarian (Hungary)
-
id-ID: Indonesian (Indonesia)
-
it-IT: Italian (Italy)
-
ko: Korean
-
lt-LT: Lithuanian (Lithuania)
-
lv-LV: Latvian (Latvia)
-
nb-NO: Norwegian (Norway)
-
nl-NL: Dutch (Netherlands)
-
pl-PL: Polish (Poland)
-
pt-BR: Portuguese (Brazil)
-
pt-PT: Portuguese (Portugal)
-
ro-RO: Romanian (Romania)
-
ru-RU: Russian (Russia)
-
sh: Serbo-Croatian
-
sk-SK: Slovak (Slovakia)
-
sl-SI: Slovenian (Slovenia)
-
sq: Albanian
-
sr: Serbian
-
sv-SE: Swedish (Sweden)
-
ta-IN: Tamil (India)
-
tg-TG: Tajik (Tajikistan)
-
tr-TR: Turkish (Turkey)
-
uk-UA: Ukrainian (Ukraine)
-
vi-VN: Vietnamese (Viet Nam)
Default: empty
On QtWebEngine, this setting requires Qt 5.8 or newer.
On QtWebKit, this setting is unavailable.
When to show the statusbar.
Type: String
Valid values:
-
always: Always show the statusbar.
-
never: Always hide the statusbar.
-
in-mode: Show the statusbar when in modes other than normal mode.
Default: always
List of widgets displayed in the statusbar.
Type: List of String
Valid values:
-
url: Current page URL.
-
scroll: Percentage of the current page position like
10%. -
scroll_raw: Raw percentage of the current page position like
10. -
history: Display an arrow when possible to go back/forward in history.
-
tabs: Current active tab, e.g.
2. -
keypress: Display pressed keys when composing a vi command.
-
progress: Progress bar for the current page loading.
Default:
-
keypress
-
url
-
scroll
-
history
-
tabs
-
progress
Mouse button with which to close tabs.
Type: String
Valid values:
-
right: Close tabs on right-click.
-
middle: Close tabs on middle-click.
-
none: Don’t close tabs using the mouse.
Default: middle
How to behave when the close mouse button is pressed on the tab bar.
Type: String
Valid values:
-
new-tab: Open a new tab.
-
close-current: Close the current tab.
-
close-last: Close the last tab.
-
ignore: Don’t do anything.
Default: new-tab
Scaling factor for favicons in the tab bar.
The tab size is unchanged, so big favicons also require extra tabs.padding.
Type: Float
Default: 1.0
When to show favicons in the tab bar.
Type: String
Valid values:
-
always: Always show favicons.
-
never: Always hide favicons.
-
pinned: Show favicons only on pinned tabs.
Default: always
How to behave when the last tab is closed.
Type: String
Valid values:
-
ignore: Don’t do anything.
-
blank: Load a blank page.
-
startpage: Load the start page.
-
default-page: Load the default page.
-
close: Close the window.
Default: ignore
Maximum width (in pixels) of tabs (-1 for no maximum).
This setting only applies when tabs are horizontal.
This setting does not apply to pinned tabs, unless tabs.pinned.shrink is False.
This setting may not apply properly if max_width is smaller than the minimum size of tab contents, or smaller than tabs.min_width.
Type: Int
Default: -1
Minimum width (in pixels) of tabs (-1 for the default minimum size behavior).
This setting only applies when tabs are horizontal.
This setting does not apply to pinned tabs, unless tabs.pinned.shrink is False.
Type: Int
Default: -1
When switching tabs, what input mode is applied.
Type: String
Valid values:
-
persist: Retain the current mode.
-
restore: Restore previously saved mode.
-
normal: Always revert to normal mode.
Default: normal
Position of new tabs opened from another tab.
See tabs.new_position.stacking for controlling stacking behavior.
Type: NewTabPosition
Valid values:
-
prev: Before the current tab.
-
next: After the current tab.
-
first: At the beginning.
-
last: At the end.
Default: next
Stack related tabs on top of each other when opened consecutively.
Only applies for next and prev values of tabs.new_position.related and tabs.new_position.unrelated.
Type: Bool
Default: true
Position of new tabs which are not opened from another tab.
See tabs.new_position.stacking for controlling stacking behavior.
Type: NewTabPosition
Valid values:
-
prev: Before the current tab.
-
next: After the current tab.
-
first: At the beginning.
-
last: At the end.
Default: last
Which tab to select when the focused tab is removed.
Type: SelectOnRemove
Valid values:
-
prev: Select the tab which came before the closed one (left in horizontal, above in vertical).
-
next: Select the tab which came after the closed one (right in horizontal, below in vertical).
-
last-used: Select the previously selected tab.
Default: next
When to show the tab bar.
Type: String
Valid values:
-
always: Always show the tab bar.
-
never: Always hide the tab bar.
-
multiple: Hide the tab bar if only one tab is open.
-
switching: Show the tab bar when switching tabs.
Default: always
Duration (in milliseconds) to show the tab bar before hiding it when tabs.show is set to 'switching'.
Type: Int
Default: 800
Alignment of the text inside of tabs.
Type: TextAlignment
Valid values:
-
left
-
right
-
center
Default: left
Format to use for the tab title. The following placeholders are defined:
-
{perc}: Percentage as a string like[10%]. -
{perc_raw}: Raw percentage, e.g.10. -
{current_title}: Title of the current web page. -
{title_sep}: The string ` - ` if a title is set, empty otherwise. -
{index}: Index of this tab. -
{id}: Internal tab ID of this tab. -
{scroll_pos}: Page scroll position. -
{host}: Host of the current web page. -
html5: Either ''webkit'' or ''webengine'' -
{private}: Indicates when private mode is enabled. -
{current_url}: URL of the current web page. -
{protocol}: Protocol (http/https/…) of the current web page. -
{audio}: Indicator for audio/mute status.
Type: FormatString
Default: {audio}{index}: {current_title}
Format to use for the tab title for pinned tabs. The same placeholders like for tabs.title.format are defined.
Type: FormatString
Default: {index}
Show tooltips on tabs. Note this setting only affects windows opened after it has been set.
Type: Bool
Default: true
Width (in pixels or as percentage of the window) of the tab bar if it’s vertical.
Type: PercOrInt
Default: 20%
What search to start when something else than a URL is entered.
Type: String
Valid values:
-
naive: Use simple/naive check.
-
dns: Use DNS requests (might be slow!).
-
never: Never search automatically.
-
schemeless: Always search automatically unless URL explicitly contains a scheme.
Default: naive
Page to open if :open -t/-b/-w is used without URL.
Use about:blank for a blank page.
Type: FuzzyUrl
Default: https://start.duckduckgo.com/
URL segments where :navigate increment/decrement will search for a number.
Type: FlagList
Valid values:
-
host
-
port
-
path
-
query
-
anchor
Default:
-
path
-
query
Open base URL of the searchengine if a searchengine shortcut is invoked without parameters.
Type: Bool
Default: false
Search engines which can be used via the address bar.
Maps a search engine name (such as DEFAULT, or ddg) to a URL with a
{} placeholder. The placeholder will be replaced by the search term, use
{{ and }} for literal {/} braces.
The following further placeholds are defined to configure how special characters in the search terms are replaced by safe characters (called 'quoting'):
-
{}and{semiquoted}quote everything except slashes; this is the most sensible choice for almost all search engines (for the search termslash/and&this placeholder expands toslash/and%26amp). -
{quoted}quotes all characters (forslash/and&this placeholder expands toslash%2Fand%26amp). -
{unquoted}quotes nothing (forslash/and&this placeholder expands toslash/and&).
The search engine named DEFAULT is used when url.auto_search is turned
on and something else than a URL was entered to be opened. Other search
engines can be used by prepending the search engine name to the search
term, e.g. :open google qutebrowser.
Type: Dict
Default:
-
DEFAULT: https://duckduckgo.com/?q={}
Page(s) to open at the start.
Default: https://start.duckduckgo.com
URL parameters to strip with :yank url.
Type: List of String
Default:
-
ref
-
utm_source
-
utm_medium
-
utm_campaign
-
utm_term
-
utm_content
Format to use for the window title. The same placeholders like for
tabs.title.format are defined.
Type: FormatString
Default: {perc}{current_title}{title_sep}qutebrowser
Available zoom levels.
Type: List of Perc
Default:
-
25%
-
33%
-
50%
-
67%
-
75%
-
90%
-
100%
-
110%
-
125%
-
150%
-
175%
-
200%
-
250%
-
300%
-
400%
-
500%
Apply the zoom factor on a frame only to the text or to all content.
This setting supports URL patterns.
Type: Bool
Default: false
This setting is only available with the QtWebKit backend.
| Type | Description |
|---|---|
Bool |
A boolean setting, either When setting from a string, |
BoolAsk |
Like |
ColorSystem |
The color system to use for color interpolation. |
Command |
A qutebrowser command with arguments. |
ConfirmQuit |
Whether to display a confirmation when the window is closed. |
Dict |
A dictionary of values. When setting from a string, pass a json-like dict, e.g. |
Directory |
A directory on the local filesystem. |
Encoding |
Setting for a python encoding. |
File |
A file on the local filesystem. |
FlagList |
A list of flags. Lists with duplicate flags are invalid. Each item is checked against the valid values of the setting. |
Float |
Base class for a float setting. |
Font |
A font family, with optional style/weight/size. * Style: |
FontFamily |
A Qt font family. |
FormatString |
A string with placeholders. |
FuzzyUrl |
A URL which gets interpreted as search if needed. |
IgnoreCase |
Whether to search case insensitively. |
Int |
Base class for an integer setting. |
Key |
A name of a key. |
List |
A list of values. When setting from a string, pass a json-like list, e.g. |
ListOrValue |
A list of values, or a single value. |
LogLevel |
A logging level. |
NewTabPosition |
How new tabs are positioned. |
Padding |
Setting for paddings around elements. |
Perc |
A percentage. |
PercOrInt |
Percentage or integer. |
Position |
The position of the tab bar. |
Proxy |
A proxy URL, or |
QssColor |
A color value supporting gradients. A value can be in one of the following formats: * |
QtColor |
A color value. A value can be in one of the following formats: * |
Regex |
A regular expression. When setting from |
SearchEngineUrl |
A search engine URL. |
SelectOnRemove |
Which tab to select when the focused tab is removed. |
SessionName |
The name of a session. |
ShellCommand |
A shell command as a list. See the documentation for |
String |
A string value. See the setting’s valid values for more information on allowed values. |
TextAlignment |
Alignment of text. |
UniqueCharString |
A string which may not contain duplicate chars. |
Url |
A URL as a string. |
UrlPattern |
A match pattern for a URL. See https://developer.chrome.com/apps/match_patterns for the allowed syntax. |
VerticalPosition |
The position of the download bar. |