All settings
Setting | Description |
---|---|
Aliases for commands. |
|
How often (in milliseconds) to auto-save config/cookies/etc. |
|
Always restore open sites when qutebrowser is reopened. |
|
The 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 completion widget category headers. |
|
Foreground color of 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 completion view |
|
Color of the scrollbar handle in completion view. |
|
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 an info message. |
|
Background color of a warning message. |
|
Border color of an error message. |
|
Foreground color 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 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 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) |
|
How many commands to save in the command history. |
|
The height of the completion, in px or as percentage of the window. |
|
Move on to the next part when there’s only one possible completion left. |
|
Padding of scrollbar handle in the completion window (in px). |
|
Width of the scrollbar in the completion window (in px). |
|
When to show the autocompletion window. |
|
Shrink the completion to be smaller than the configured size if there are no scrollbars. |
|
How to format timestamps (e.g. for the history completion). |
|
How many URLs to show in the web history. |
|
Whether quitting the application requires a confirmation. |
|
Whether support for the HTML 5 web application cache feature is enabled. |
|
The maximum number of pages to hold in the global memory page cache. |
|
Size of the HTTP network cache. Null to use the default value. |
|
Control which cookies to accept. |
|
Store cookies. |
|
Default encoding to use for websites. |
|
Enable extra tools for Web developers. |
|
Try to pre-fetch DNS entries to speed up browsing. |
|
Expand each subframe to its contents. |
|
Allow websites to request geolocations. |
|
Value to send in the |
|
Set custom headers for qutebrowser HTTP requests. |
|
Value to send in the |
|
Send the Referer header. |
|
User agent to send. Unset to send the default. |
|
Whether host blocking is enabled. |
|
List of URLs of lists which contain hosts to block. |
|
List of domains that should always be loaded, despite being ad-blocked. |
|
Enable or disable hyperlink auditing ( |
|
Whether images are automatically loaded in web pages. |
|
Show javascript alerts. |
|
Whether JavaScript can read from or write to the clipboard. |
|
Whether JavaScript can close tabs. |
|
Whether JavaScript can open new tabs without user interaction. |
|
Enables or disables JavaScript. |
|
Log levels to use for JavaScript console logging messages. |
|
Use the standard JavaScript modal dialog for |
|
Show javascript prompts. |
|
Whether locally loaded documents are allowed to access other local urls. |
|
Whether locally loaded documents are allowed to access remote urls. |
|
Whether support for HTML 5 local storage and Web SQL is enabled. |
|
Allow websites to record audio/video. |
|
Location of a netrc-file for HTTP authentication. |
|
Allow websites to show notifications. |
|
Enable pdf.js to view PDF files in the browser. |
|
Enables or disables plugins in Web pages. |
|
Whether the background color and images are also drawn when the page is printed. |
|
Open new windows in private browsing mode which does not record visited pages. |
|
The proxy to use. |
|
Send DNS requests over the configured proxy. |
|
Validate SSL handshakes. |
|
A list of user stylesheet filenames to use. |
|
Enables or disables WebGL. |
|
Whether load requests should be monitored for cross-site scripting attempts. |
|
The 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. |
|
The default program used to open downloads. |
|
Where to show the downloaded files. |
|
Number of milliseconds to wait before removing finished downloads. |
|
The 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 debugging console. |
|
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. |
|
Default monospace fonts. |
|
Font used for prompts. |
|
Font used in the statusbar. |
|
Font used in the tab bar. |
|
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. |
|
The default font size for regular text. |
|
The default font size for fixed-pitch text. |
|
The hard minimum font size. |
|
The minimum logical font size that is applied when zooming out. |
|
Force software rendering for QtWebEngine. |
|
Controls when a hint can be automatically followed without pressing Enter. |
|
A timeout (in milliseconds) to ignore normal-mode key bindings after a successful auto-follow. |
|
CSS border value for hints. |
|
Chars used for hint strings. |
|
The dictionary file to be used by the word hints. |
|
Which implementation to use to find elements to hint. |
|
Hide unmatched hints in rapid mode. |
|
Minimum number of chars used for hint strings. |
|
Mode to use for hints. |
|
A comma-separated list of regexes to use for next links. |
|
A comma-separated list of regexes to use for prev links. |
|
Scatter hint key chains (like Vimium) or not (like dwb). |
|
Make chars in hint strings uppercase. |
|
The maximum time in minutes between two history items for them to be considered being from the same browsing session. |
|
Find text on a page case-insensitively. |
|
Forward unbound keys to the webview in normal mode. |
|
Leave insert mode if a non-editable element is clicked. |
|
Automatically enter insert mode if an editable element is focused after loading the page. |
|
Switch to insert mode when clicking flash and other plugins. |
|
Include hyperlinks in the keyboard focus chain when tabbing. |
|
Timeout (in milliseconds) for partially typed key bindings. |
|
Enable Opera-like mouse rocker gestures. |
|
Enable Spatial Navigation. |
|
Keychains that shouldn’t be shown in the keyhint dialog. |
|
Time from pressing a key to seeing the keyhint dialog (ms). |
|
Time (in ms) to show messages in the statusbar for. |
|
Show messages in unfocused windows. |
|
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 upload/download prompts. |
|
The rounding radius for the edges of prompts. |
|
Additional arguments to pass to Qt, without leading |
|
Show a scrollbar. |
|
Enable smooth scrolling for web pages. |
|
The name of the session to save by default. |
|
Hide the statusbar unless a message is shown. |
|
Padding for the statusbar. |
|
The position of the status bar. |
|
Open new tabs (middleclick/ctrl+click) in the background. |
|
On which mouse button to close tabs. |
|
Scaling for favicons in the tab bar. |
|
Show favicons in the tab bar. |
|
Padding for tab indicators |
|
Behavior when the last tab is closed. |
|
Switch between tabs using the mouse wheel. |
|
How new tabs opened from another tab are positioned. |
|
How new tabs which aren’t opened from another tab are positioned. |
|
Padding around text for tabs |
|
The position of the tab bar. |
|
Which tab to select when the focused tab is removed. |
|
When to show the tab bar. |
|
Time 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. |
|
The format to use for the tab title. |
|
The format to use for the tab title for pinned tabs. The same placeholders like for |
|
The width of the tab bar if it’s vertical, in px or as percentage of the window. |
|
Width of the progress indicator (0 to disable). |
|
Whether to wrap when changing tabs. |
|
Whether to start a search when something else than a URL is entered. |
|
The page to open if :open -t/-b/-w is used without URL. |
|
The URL segments where |
|
Definitions of search engines which can be used via the address bar. |
|
The page(s) to open at the start. |
|
The URL parameters to strip with |
|
Hide the window decoration when using wayland (requires restart) |
|
The format to use for the window title. |
|
The default zoom level. |
|
The available zoom levels. |
|
How much to divide the mouse wheel movements to translate them into zoom increments. |
|
Whether the zoom factor on a frame applies only to the text or to all content. |
aliases
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
:quit
-
w
:session-save
-
wq
:quit --save
auto_save.interval
How often (in milliseconds) to auto-save config/cookies/etc.
Type: Int
Default: 15000
backend
The 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 that 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
bindings.commands
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 special keys (can’t be part of a keychain), enclose them in <
…>
. 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: The default mode, where most commands are invoked.
-
insert: Entered when an input field is focused on a website, or by pressing
i
in 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
f
is 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.
You can bind normal keys in this mode, but they will be only active when a yes/no-prompt is asked. For other prompt modes, you can only bind special keys. -
caret: Entered when pressing the
v
mode, 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
bindings.default
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.
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
-
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
-
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-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-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>
:command-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>
:command-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
-
<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-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
-
Ss
:open qute://settings
-
T
:tab-focus
-
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
-
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
-
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
-
th
:back -t
-
tl
:forward -t
-
u
:undo
-
v
:enter-mode caret
-
wB
:set-cmd-text -s :bookmark-load -w
-
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
:inspector
-
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
-
yP
:yank pretty-url -s
-
yT
:yank title -s
-
yY
:yank -s
-
yd
:yank domain
-
yp
:yank pretty-url
-
yt
:yank title
-
yy
:yank
-
{{
:navigate prev -t
-
}}
:navigate next -t
-
-
passthrough
:-
<Ctrl-V>
:leave-mode
-
-
prompt
:-
<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-E>
:rl-end-of-line
-
<Ctrl-F>
:rl-forward-char
-
<Ctrl-H>
:rl-backward-delete-char
-
<Ctrl-K>
:rl-kill-line
-
<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
-
n
:prompt-accept no
-
y
:prompt-accept yes
-
-
register
:-
<Escape>
:leave-mode
-
bindings.key_mappings
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-J>
:<Return>
-
<Ctrl-M>
:<Return>
-
<Ctrl-[>
:<Escape>
-
<Enter>
:<Return>
-
<Shift-Enter>
:<Return>
-
<Shift-Return>
:<Return>
colors.completion.category.bg
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)
colors.completion.category.border.bottom
Bottom border color of the completion widget category headers.
Type: QssColor
Default: black
colors.completion.category.border.top
Top border color of the completion widget category headers.
Type: QssColor
Default: black
colors.completion.category.fg
Foreground color of completion widget category headers.
Type: QtColor
Default: white
colors.completion.even.bg
Background color of the completion widget for even rows.
Type: QssColor
Default: #333333
colors.completion.item.selected.bg
Background color of the selected completion item.
Type: QssColor
Default: #e8c000
colors.completion.item.selected.border.bottom
Bottom border color of the selected completion item.
Type: QssColor
Default: #bbbb00
colors.completion.item.selected.border.top
Top border color of the completion widget category headers.
Type: QssColor
Default: #bbbb00
colors.completion.item.selected.fg
Foreground color of the selected completion item.
Type: QtColor
Default: black
colors.completion.match.fg
Foreground color of the matched text in the completion.
Type: QssColor
Default: #ff4444
colors.completion.odd.bg
Background color of the completion widget for odd rows.
Type: QssColor
Default: #444444
colors.completion.scrollbar.bg
Color of the scrollbar in completion view
Type: QssColor
Default: #333333
colors.completion.scrollbar.fg
Color of the scrollbar handle in completion view.
Type: QssColor
Default: white
colors.downloads.start.bg
Color gradient start for download backgrounds.
Type: QtColor
Default: #0000aa
colors.downloads.stop.bg
Color gradient stop for download backgrounds.
Type: QtColor
Default: #00aa00
colors.downloads.system.bg
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
colors.downloads.system.fg
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
colors.hints.bg
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))
colors.keyhint.bg
Background color of the keyhint widget.
Type: QssColor
Default: rgba(0, 0, 0, 80%)
colors.keyhint.suffix.fg
Highlight color for keys to complete the current keychain.
Type: QssColor
Default: #FFFF00
colors.messages.warning.bg
Background color of a warning message.
Type: QssColor
Default: darkorange
colors.prompts.border
Border used around UI elements in prompts.
Type: String
Default: 1px solid gray
colors.prompts.selected.bg
Background color for the selected item in filename prompts.
Type: QssColor
Default: grey
colors.statusbar.caret.bg
Background color of the statusbar in caret mode.
Type: QssColor
Default: purple
colors.statusbar.caret.fg
Foreground color of the statusbar in caret mode.
Type: QssColor
Default: white
colors.statusbar.caret.selection.bg
Background color of the statusbar in caret mode with a selection.
Type: QssColor
Default: #a12dff
colors.statusbar.caret.selection.fg
Foreground color of the statusbar in caret mode with a selection.
Type: QssColor
Default: white
colors.statusbar.command.bg
Background color of the statusbar in command mode.
Type: QssColor
Default: black
colors.statusbar.command.fg
Foreground color of the statusbar in command mode.
Type: QssColor
Default: white
colors.statusbar.command.private.bg
Background color of the statusbar in private browsing + command mode.
Type: QssColor
Default: grey
colors.statusbar.command.private.fg
Foreground color of the statusbar in private browsing + command mode.
Type: QssColor
Default: white
colors.statusbar.insert.bg
Background color of the statusbar in insert mode.
Type: QssColor
Default: darkgreen
colors.statusbar.insert.fg
Foreground color of the statusbar in insert mode.
Type: QssColor
Default: white
colors.statusbar.private.bg
Background color of the statusbar in private browsing mode.
Type: QssColor
Default: #666666
colors.statusbar.private.fg
Foreground color of the statusbar in private browsing mode.
Type: QssColor
Default: white
colors.statusbar.url.error.fg
Foreground color of the URL in the statusbar on error.
Type: QssColor
Default: orange
colors.statusbar.url.fg
Default foreground color of the URL in the statusbar.
Type: QssColor
Default: white
colors.statusbar.url.hover.fg
Foreground color of the URL in the statusbar for hovered links.
Type: QssColor
Default: aqua
colors.statusbar.url.success.http.fg
Foreground color of the URL in the statusbar on successful load (http).
Type: QssColor
Default: white
colors.statusbar.url.success.https.fg
Foreground color of the URL in the statusbar on successful load (https).
Type: QssColor
Default: lime
colors.statusbar.url.warn.fg
Foreground color of the URL in the statusbar when there’s a warning.
Type: QssColor
Default: yellow
colors.tabs.indicator.start
Color gradient start for the tab indicator.
Type: QtColor
Default: #0000aa
colors.tabs.indicator.system
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
colors.webpage.bg
Background color for webpages if unset (or empty to use the theme’s color)
Type: QtColor
Default: white
completion.cmd_history_max_items
How many commands to save in the command history. 0: no history / -1: unlimited
Type: Int
Default: 100
completion.height
The height of the completion, in px or as percentage of the window.
Type: PercOrInt
Default: 50%
completion.quick
Move on to the next part when there’s only one possible completion left.
Type: Bool
Default: true
completion.scrollbar.padding
Padding of scrollbar handle in the completion window (in px).
Type: Int
Default: 2
completion.scrollbar.width
Width of the scrollbar in the completion window (in px).
Type: Int
Default: 12
completion.show
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
completion.shrink
Shrink the completion to be smaller than the configured size if there are no scrollbars.
Type: Bool
Default: false
completion.timestamp_format
How to format timestamps (e.g. for the history completion).
Type: TimestampTemplate
Default: %Y-%m-%d
completion.web_history_max_items
How many URLs to show in the web history. 0: no history / -1: unlimited
Type: Int
Default: -1
confirm_quit
Whether quitting the application requires a confirmation.
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
content.cache.appcache
Whether support for the HTML 5 web application cache feature is enabled. 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.
Type: Bool
Default: true
This setting is only available with the QtWebKit backend.
content.cache.maximum_pages
The maximum number of pages to hold in the global memory page cache. The Page Cache allows for a nicer user experience when navigating forth or back to pages in the forward/back history, by pausing and resuming up to n pages. 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.
content.cache.size
Size of the HTTP network cache. Null to use the default value.
Type: Int
Default: empty
content.cookies.accept
Control which cookies to accept.
Type: String
Valid values:
-
all
: Accept all cookies. -
no-3rdparty
: Accept cookies from the same origin only. -
no-unknown-3rdparty
: Accept cookies from the same origin only, unless a cookie is already set for the domain. -
never
: Don’t accept cookies at all.
Default: no-3rdparty
This setting is only available with the QtWebKit backend.
content.cookies.store
Store cookies. Note this option needs a restart with QtWebEngine on Qt < 5.9.
Type: Bool
Default: true
content.default_encoding
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
content.developer_extras
Enable extra tools for Web developers.
This needs to be enabled for :inspector
to work and also adds an Inspect entry to the context menu. For QtWebEngine, see --enable-webengine-inspector
in qutebrowser --help
instead.
Type: Bool
Default: false
This setting is only available with the QtWebKit backend.
content.dns_prefetch
Try to pre-fetch DNS entries to speed up browsing.
Type: Bool
Default: true
This setting is only available with the QtWebKit backend.
content.frame_flattening
Expand each subframe to its contents. This will flatten all the frames to become one scrollable page.
Type: Bool
Default: false
This setting is only available with the QtWebKit backend.
content.geolocation
Allow websites to request geolocations.
Type: BoolAsk
Valid values:
-
true
-
false
-
ask
Default: ask
content.headers.accept_language
Value to send in the Accept-Language
header.
Type: String
Default: en-US,en
content.headers.do_not_track
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.
Type: Bool
Default: true
content.headers.referer
Send the Referer header. The Referer header tells websites from which website you were coming from when visting them.
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.
Default: same-domain
This setting is only available with the QtWebKit backend.
content.headers.user_agent
User agent to send. Unset to send the default.
Type: String
Default: empty
content.host_blocking.lists
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).
Type: List of Url
Default:
-
https://www.malwaredomainlist.com/hostslist/hosts.txt
-
http://someonewhocares.org/hosts/hosts
-
http://winhelp2002.mvps.org/hosts.zip
-
http://malwaredomains.lehigh.edu/files/justdomains.zip
-
https://pgl.yoyo.org/adservers/serverlist.php?hostformat=hosts&mimetype=plaintext
content.host_blocking.whitelist
List of domains that should always be loaded, despite being ad-blocked. Domains may contain * and ? wildcards and are otherwise required to exactly match the requested domain. Local domains are always exempt from hostblocking.
Type: List of String
Default:
-
piwik.org
content.hyperlink_auditing
Enable or disable hyperlink auditing (<a ping>
).
Type: Bool
Default: false
content.javascript.can_access_clipboard
Whether JavaScript can read from or write to the clipboard. With QtWebEngine, writing the clipboard as response to a user interaction is always allowed.
Type: Bool
Default: false
content.javascript.can_close_tabs
Whether JavaScript can close tabs.
Type: Bool
Default: false
This setting is only available with the QtWebKit backend.
content.javascript.can_open_tabs_automatically
Whether JavaScript can open new tabs without user interaction.
Type: Bool
Default: false
content.javascript.log
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.
Type: Dict
Default:
-
error
:debug
-
info
:debug
-
unknown
:debug
-
warning
:debug
content.javascript.modal_dialog
Use the standard JavaScript modal dialog for alert()
and confirm()
Type: Bool
Default: false
content.local_content_can_access_file_urls
Whether locally loaded documents are allowed to access other local urls.
Type: Bool
Default: true
content.local_content_can_access_remote_urls
Whether locally loaded documents are allowed to access remote urls.
Type: Bool
Default: false
content.local_storage
Whether support for HTML 5 local storage and Web SQL is enabled.
Type: Bool
Default: true
content.media_capture
Allow websites to record audio/video.
Type: BoolAsk
Valid values:
-
true
-
false
-
ask
Default: ask
This setting is only available with the QtWebEngine backend.
content.netrc_file
Location of a netrc-file for HTTP authentication.
If unset, ~/.netrc
is used.
Type: File
Default: empty
content.notifications
Allow websites to show notifications.
Type: BoolAsk
Valid values:
-
true
-
false
-
ask
Default: ask
content.pdfjs
Enable 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.
Type: Bool
Default: false
This setting is only available with the QtWebKit backend.
content.print_element_backgrounds
Whether the background color and images are also drawn when the page is printed.
Type: Bool
Default: true
On QtWebEngine, this setting requires Qt 5.8 or newer.
content.private_browsing
Open new windows in private browsing mode which does not record visited pages.
Type: Bool
Default: false
content.proxy
The 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
content.proxy_dns_requests
Send DNS requests over the configured proxy.
Type: Bool
Default: true
This setting is only available with the QtWebKit backend.
content.user_stylesheets
A list of user stylesheet filenames to use.
Type: List of File, or File
Default: empty
content.xss_auditing
Whether load requests should be monitored for cross-site scripting attempts. Suspicious scripts will be blocked and reported in the inspector’s JavaScript console. Enabling this feature might have an impact on performance.
Type: Bool
Default: false
downloads.location.directory
The directory to save downloads to. If unset, a sensible os-specific default is used.
Type: Directory
Default: empty
downloads.location.prompt
Prompt the user for the download location.
If set to false, downloads.location.directory
will be used.
Type: Bool
Default: true
downloads.location.suggestion
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
downloads.open_dispatcher
The 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
downloads.position
Where to show the downloaded files.
Type: VerticalPosition
Valid values:
-
top
-
bottom
Default: top
downloads.remove_finished
Number of milliseconds to wait before removing finished downloads. If set to -1, downloads are never removed.
Type: Int
Default: -1
editor.command
The editor (and arguments) to use for the open-editor
command.
{}
gets replaced by the filename of the file to be edited.
Type: ShellCommand
Default:
-
gvim
-
-f
-
{}
fonts.completion.category
Font used in the completion categories.
Type: Font
Default: bold 8pt monospace
fonts.monospace
Default monospace fonts. Whenever "monospace" is used in a font setting, it’s replaced with the fonts listed here.
Type: Font
Default: "xos4 Terminus", Terminus, Monospace, "DejaVu Sans Mono", Monaco, "Bitstream Vera Sans Mono", "Andale Mono", "Courier New", Courier, "Liberation Mono", monospace, Fixed, Consolas, Terminal
fonts.web.size.minimum_logical
The minimum logical font size that is applied when zooming out.
Type: Int
Default: 6
force_software_rendering
Force software rendering for QtWebEngine. This is needed for QtWebEngine to work with Nouveau drivers. This setting requires a restart.
Type: Bool
Default: false
This setting is only available with the QtWebEngine backend.
hints.auto_follow
Controls 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
hints.auto_follow_timeout
A timeout (in milliseconds) to ignore normal-mode key bindings after a successful auto-follow.
Type: Int
Default: 0
hints.dictionary
The dictionary file to be used by the word hints.
Type: File
Default: /usr/share/dict/words
hints.find_implementation
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.
hints.mode
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 chars in thehints.chars
setting. -
word
: Use hints words based on the html elements and the extra words.
Default: letter
hints.next_regexes
A comma-separated list of regexes to use for next links.
Type: List of Regex
Default:
-
\bnext\b
-
\bmore\b
-
\bnewer\b
-
\b[>→≫\b]
-
\b(>>|»)\b
-
\bcontinue\b
hints.prev_regexes
A comma-separated list of regexes to use for prev links.
Type: List of Regex
Default:
-
\bprev(ious)?\b
-
\bback\b
-
\bolder\b
-
\b[<←≪\b]
-
\b(<<|«)\b
hints.scatter
Scatter hint key chains (like Vimium) or not (like dwb). Ignored for number hints.
Type: Bool
Default: true
history_gap_interval
The 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
ignore_case
Find text on a page case-insensitively.
Type: String
Valid values:
-
always
: Search case-insensitively -
never
: Search case-sensitively -
smart
: Search case-sensitively if there are capital chars
Default: smart
input.forward_unbound_keys
Forward unbound keys 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
input.insert_mode.auto_leave
Leave insert mode if a non-editable element is clicked.
Type: Bool
Default: true
input.insert_mode.auto_load
Automatically enter insert mode if an editable element is focused after loading the page.
Type: Bool
Default: false
input.insert_mode.plugins
Switch to insert mode when clicking flash and other plugins.
Type: Bool
Default: false
input.links_included_in_focus_chain
Include hyperlinks in the keyboard focus chain when tabbing.
Type: Bool
Default: true
input.partial_timeout
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
input.rocker_gestures
Enable Opera-like mouse rocker gestures. This disables the context menu.
Type: Bool
Default: false
input.spatial_navigation
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 a 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.
Type: Bool
Default: false
keyhint.blacklist
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
messages.timeout
Time (in ms) to show messages in the statusbar for. Set to 0 to never clear messages.
Type: Int
Default: 2000
new_instance_open_target
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
new_instance_open_target_window
Which window to choose when opening links as new tabs.
When new_instance_open_target
is not 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
qt_args
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
scrolling.smooth
Enable smooth scrolling for web pages.
Note smooth scrolling does not work with the :scroll-px
command.
Type: Bool
Default: false
session_default_name
The 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
statusbar.padding
Padding for the statusbar.
Type: Padding
Default:
-
bottom
:1
-
left
:0
-
right
:0
-
top
:1
statusbar.position
The position of the status bar.
Type: VerticalPosition
Valid values:
-
top
-
bottom
Default: bottom
tabs.close_mouse_button
On which mouse button 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
tabs.favicons.scale
Scaling for favicons in the tab bar.
The tab size is unchanged, so big favicons also require extra tabs.padding
.
Type: Float
Default: 1.0
tabs.indicator_padding
Padding for tab indicators
Type: Padding
Default:
-
bottom
:2
-
left
:0
-
right
:4
-
top
:2
tabs.last_close
Behavior 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
tabs.new_position.related
How new tabs opened from another tab are positioned.
Type: NewTabPosition
Valid values:
-
prev
: Before the current tab. -
next
: After the current tab. -
first
: At the beginning. -
last
: At the end.
Default: next
tabs.new_position.unrelated
How new tabs which aren’t opened from another tab are positioned.
Type: NewTabPosition
Valid values:
-
prev
: Before the current tab. -
next
: After the current tab. -
first
: At the beginning. -
last
: At the end.
Default: last
tabs.position
The position of the tab bar.
Type: Position
Valid values:
-
top
-
bottom
-
left
-
right
Default: top
tabs.select_on_remove
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
tabs.show
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
tabs.show_switching_delay
Time to show the tab bar before hiding it when tabs.show is set to switching.
Type: Int
Default: 800
tabs.title.alignment
Alignment of the text inside of tabs.
Type: TextAlignment
Valid values:
-
left
-
right
-
center
Default: left
tabs.title.format
The format to use for the tab title. The following placeholders are defined:
-
{perc}
: The percentage as a string like[10%]
. -
{perc_raw}
: The raw percentage, e.g.10
-
{title}
: The title of the current web page -
{title_sep}
: The string ` - ` if a title is set, empty otherwise. -
{index}
: The index of this tab. -
{id}
: The internal tab ID of this tab. -
{scroll_pos}
: The page scroll position. -
{host}
: The host of the current web page. -
‘{backend}`: Either 'webkit’ or 'webengine'
-
{private}
: Indicates when private mode is enabled.
Type: FormatString
Default: {index}: {title}
tabs.title.format_pinned
The format to use for the tab title for pinned tabs. The same placeholders like for tabs.title.format
are defined.
Type: FormatString
Default: {index}
tabs.width.bar
The width of the tab bar if it’s vertical, in px or as percentage of the window.
Type: PercOrInt
Default: 20%
url.auto_search
Whether to start a search 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.
Default: naive
url.default_page
The 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.incdec_segments
The URL segments where :navigate increment/decrement
will search for a number.
Type: FlagList
Valid values:
-
host
-
path
-
query
-
anchor
Default:
-
path
-
query
url.searchengines
Definitions of search engines which can be used via the address bar.
Maps a searchengine 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 {
/}
signs.
The searchengine 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={}
url.start_pages
The page(s) to open at the start.
Default: https://start.duckduckgo.com
url.yank_ignored_parameters
The URL parameters to strip with :yank url
.
Type: List of String
Default:
-
ref
-
utm_source
-
utm_medium
-
utm_campaign
-
utm_term
-
utm_content
window.hide_wayland_decoration
Hide the window decoration when using wayland (requires restart)
Type: Bool
Default: false
window.title_format
The format to use for the window title. The following placeholders are defined:
-
{perc}
: The percentage as a string like[10%]
. -
{perc_raw}
: The raw percentage, e.g.10
-
{title}
: The title of the current web page -
{title_sep}
: The string ` - ` if a title is set, empty otherwise. -
{id}
: The internal window ID of this window. -
{scroll_pos}
: The page scroll position. -
{host}
: The host of the current web page. -
‘{backend}`: Either 'webkit’ or 'webengine'
-
{private}
: Indicates when private mode is enabled.
Type: FormatString
Default: {perc}{title}{title_sep}qutebrowser
zoom.levels
The available zoom levels.
Type: List of Perc
Default:
-
25%
-
33%
-
50%
-
67%
-
75%
-
90%
-
100%
-
110%
-
125%
-
150%
-
175%
-
200%
-
250%
-
300%
-
400%
-
500%
zoom.mouse_divider
How much to divide the mouse wheel movements to translate them into zoom increments.
Type: Int
Default: 512
zoom.text_only
Whether the zoom factor on a frame applies only to the text or to all content.
Type: Bool
Default: false
This setting is only available with the QtWebKit backend.
Setting types
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. |
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. |
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: * |
QtFont |
A font family, with optional style/weight/size. * Style: |
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. |
TimestampTemplate |
An strftime-like template for timestamps. See https://docs.python.org/3/library/datetime.html#strftime-strptime-behavior for reference. |
UniqueCharString |
A string which may not contain duplicate chars. |
Url |
A URL as a string. |
VerticalPosition |
The position of the download bar. |