Autogenerated config.py

NOTE: config.py is intended for advanced users who are comfortable

with manually migrating the config file on qutebrowser upgrades. If

you prefer, you can also configure qutebrowser using the

:set/:bind/:config-* commands without having to write a config.py

file.

Documentation:

qute://help/configuring.html

qute://help/settings.html

Change the argument to True to still load settings configured via autoconfig.yml

config.load_autoconfig(False)

Always restore open sites when qutebrowser is reopened. Without this

option set, `:wq` (`:quit --save`) needs to be used to save open tabs

(and restore them), while quitting qutebrowser in any other way will

not save/restore the session. By default, this will save to the

session which was last loaded. This behavior can be customized via the

`session.default_name` setting.

Type: Bool

c.auto_save.session = True

Automatically start playing `<video>` elements.

Type: Bool

c.content.autoplay = False

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`. If this setting is used with URL patterns, the pattern gets

applied to the origin/first party URL of the page making the request,

not the request URL. With QtWebEngine 5.15.0+, paths will be stripped

from URLs, so URL patterns using paths will not match. With

QtWebEngine 5.15.2+, subdomains are additionally stripped as well, so

you will typically need to set this setting for `example.com` when the

cookie is set on `somesubdomain.example.com` for it to work properly.

To debug issues with this setting, start qutebrowser with `--debug

--logfilter network --debug-flag log-cookies` which will show all

cookies being set.

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.

config.set('content.cookies.accept', 'all', 'chrome-devtools://*')

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`. If this setting is used with URL patterns, the pattern gets

applied to the origin/first party URL of the page making the request,

not the request URL. With QtWebEngine 5.15.0+, paths will be stripped

from URLs, so URL patterns using paths will not match. With

QtWebEngine 5.15.2+, subdomains are additionally stripped as well, so

you will typically need to set this setting for `example.com` when the

cookie is set on `somesubdomain.example.com` for it to work properly.

To debug issues with this setting, start qutebrowser with `--debug

--logfilter network --debug-flag log-cookies` which will show all

cookies being set.

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.

config.set('content.cookies.accept', 'all', 'devtools://*')

Allow websites to lock your mouse pointer.

Type: BoolAsk

Valid values:

- true

- false

- ask

c.content.mouse_lock = 'ask'

Value to send in the `Accept-Language` header. Note that the value

read from JavaScript is always the global value.

Type: String

config.set('content.headers.accept_language', '', 'https://matchmaker.krunker.io/*')

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.

Type: FormatString

config.set('content.headers.user_agent', 'Mozilla/5.0 ({os_info}) AppleWebKit/{webkit_version} (KHTML, like Gecko) {upstream_browser_key}/{upstream_browser_version} Safari/{webkit_version}', 'https://web.whatsapp.com/')

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.

Type: FormatString

config.set('content.headers.user_agent', 'Mozilla/5.0 ({os_info}) AppleWebKit/{webkit_version} (KHTML, like Gecko) {upstream_browser_key}/{upstream_browser_version} Safari/{webkit_version} Edg/{upstream_browser_version}', 'https://accounts.google.com/*')

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.

Type: FormatString

config.set('content.headers.user_agent', 'Mozilla/5.0 ({os_info}) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/99 Safari/537.36', 'https://*.slack.com/*')

Load images automatically in web pages.

Type: Bool

config.set('content.images', True, 'chrome-devtools://*')

Load images automatically in web pages.

Type: Bool

config.set('content.images', True, 'devtools://*')

Enable JavaScript.

Type: Bool

config.set('content.javascript.enabled', True, 'chrome-devtools://*')

Enable JavaScript.

Type: Bool

config.set('content.javascript.enabled', True, 'devtools://*')

Enable JavaScript.

Type: Bool

config.set('content.javascript.enabled', True, 'chrome://*/*')

Enable JavaScript.

Type: Bool

config.set('content.javascript.enabled', True, 'qute://*/*')

Allow websites to record audio.

Type: BoolAsk

Valid values:

- true

- false

- ask

c.content.media.audio_capture = 'ask'

Allow websites to record audio and video.

Type: BoolAsk

Valid values:

- true

- false

- ask

c.content.media.audio_video_capture = 'ask'

Allow websites to record video.

Type: BoolAsk

Valid values:

- true

- false

- ask

c.content.media.video_capture = 'ask'

List of user stylesheet filenames to use.

Type: List of File, or File

c.content.user_stylesheets = '~/.config/qutebrowser/greasemonkey/all.css'

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.

Type: Bool

c.content.mute = True

Duration (in milliseconds) to wait before removing finished downloads.

If set to -1, downloads are never removed.

Type: Int

c.downloads.remove_finished = 1

CSS border value for hints.

Type: String

c.hints.border = '1px solid #282a36'

Padding (in pixels) for the statusbar.

Type: Padding

c.statusbar.padding = {'top': 3, 'right': 8, 'bottom': 3, 'left': 8}

Scaling factor for favicons in the tab bar. The tab size is unchanged,

so big favicons also require extra `tabs.padding`.

Type: Float

c.tabs.favicons.scale = 1

Padding (in pixels) around text for tabs.

Type: Padding

c.tabs.padding = {'top': 3, 'right': 6, 'bottom': 3, 'left': 6}

Width (in pixels) of the progress indicator (0 to disable).

Type: Int

c.tabs.indicator.width = 1

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

term `slash/and&amp` this placeholder expands to `slash/and%26amp`).

* `{quoted}` quotes all characters (for `slash/and&amp` this

placeholder expands to `slash%2Fand%26amp`). * `{unquoted}` quotes

nothing (for `slash/and&amp` this placeholder expands to

`slash/and&amp`). * `{0}` means the same as `{}`, but can be used

multiple times. 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

c.url.searchengines = {'DEFAULT': 'https://www.google.com.ar/search?q={}'}

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.

Type: List of QtColor, or QtColor

c.colors.completion.fg = '#f8f8f2'

Background color of the completion widget for odd rows.

Type: QssColor

c.colors.completion.odd.bg = '#282a36'

Background color of the completion widget for even rows.

Type: QssColor

c.colors.completion.even.bg = '#282a36'

Foreground color of completion widget category headers.

Type: QtColor

c.colors.completion.category.fg = '#f8f8f2'

Background color of the completion widget category headers.

Type: QssColor

c.colors.completion.category.bg = '#282a36'

Top border color of the completion widget category headers.

Type: QssColor

c.colors.completion.category.border.top = '#282a36'

Bottom border color of the completion widget category headers.

Type: QssColor

c.colors.completion.category.border.bottom = '#282a36'

Foreground color of the selected completion item.

Type: QtColor

c.colors.completion.item.selected.fg = '#f8f8f2'

Background color of the selected completion item.

Type: QssColor

c.colors.completion.item.selected.bg = '#44475a'

Top border color of the selected completion item.

Type: QssColor

c.colors.completion.item.selected.border.top = '#44475a'

Bottom border color of the selected completion item.

Type: QssColor

c.colors.completion.item.selected.border.bottom = '#44475a'

Foreground color of the matched text in the completion.

Type: QtColor

c.colors.completion.match.fg = '#ffb86c'

Color of the scrollbar handle in the completion view.

Type: QssColor

c.colors.completion.scrollbar.fg = '#f8f8f2'

Color of the scrollbar in the completion view.

Type: QssColor

c.colors.completion.scrollbar.bg = '#282a36'

Background color for the download bar.

Type: QssColor

c.colors.downloads.bar.bg = '#282a36'

Color gradient stop for download backgrounds.

Type: QtColor

c.colors.downloads.stop.bg = '#282a36'

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.

c.colors.downloads.system.bg = 'none'

Foreground color for downloads with errors.

Type: QtColor

c.colors.downloads.error.fg = '#ff5555'

Background color for downloads with errors.

Type: QtColor

c.colors.downloads.error.bg = '#282a36'

Font color for hints.

Type: QssColor

c.colors.hints.fg = '#bd93f9'

Background color for hints. Note that you can use a `rgba(...)` value

for transparency.

Type: QssColor

c.colors.hints.bg = '#282a36'

Font color for the matched part of hints.

Type: QtColor

c.colors.hints.match.fg = '#e0e0e0'

Text color for the keyhint widget.

Type: QssColor

c.colors.keyhint.fg = '#bd93f9'

Highlight color for keys to complete the current keychain.

Type: QssColor

c.colors.keyhint.suffix.fg = '#44475a'

Background color of the keyhint widget.

Type: QssColor

c.colors.keyhint.bg = '#282a36'

Foreground color of an error message.

Type: QssColor

c.colors.messages.error.fg = '#ff5555'

Background color of an error message.

Type: QssColor

c.colors.messages.error.bg = '#282a36'

Border color of an error message.

Type: QssColor

c.colors.messages.error.border = '#282a36'

Foreground color of a warning message.

Type: QssColor

c.colors.messages.warning.fg = '#ff5555'

Background color of a warning message.

Type: QssColor

c.colors.messages.warning.bg = '#282a36'

Border color of a warning message.

Type: QssColor

c.colors.messages.warning.border = '#282a36'

Foreground color of an info message.

Type: QssColor

c.colors.messages.info.fg = '#6272a4'

Background color of an info message.

Type: QssColor

c.colors.messages.info.bg = '#282a36'

Border color of an info message.

Type: QssColor

c.colors.messages.info.border = '#282a36'

Foreground color for prompts.

Type: QssColor

c.colors.prompts.fg = '#8be9fd'

Border used around UI elements in prompts.

Type: String

c.colors.prompts.border = '1px solid #282a36'

Background color for prompts.

Type: QssColor

c.colors.prompts.bg = '#282a36'

Background color for the selected item in filename prompts.

Type: QssColor

c.colors.prompts.selected.bg = '#44475a'

Foreground color of the statusbar.

Type: QssColor

c.colors.statusbar.normal.fg = '#f8f8f2'

Background color of the statusbar.

Type: QssColor

c.colors.statusbar.normal.bg = '#282a36'

Foreground color of the statusbar in insert mode.

Type: QssColor

c.colors.statusbar.insert.fg = '#ffffff'

Background color of the statusbar in insert mode.

Type: QssColor

c.colors.statusbar.insert.bg = '#177a32'

Foreground color of the statusbar in passthrough mode.

Type: QssColor

c.colors.statusbar.passthrough.fg = '#ffb86c'

Background color of the statusbar in passthrough mode.

Type: QssColor

c.colors.statusbar.passthrough.bg = '#282a36'

Foreground color of the statusbar in private browsing mode.

Type: QssColor

c.colors.statusbar.private.fg = '#e0e0e0'

Background color of the statusbar in private browsing mode.

Type: QssColor

c.colors.statusbar.private.bg = '#282a36'

Foreground color of the statusbar in command mode.

Type: QssColor

c.colors.statusbar.command.fg = '#ff79c6'

Background color of the statusbar in command mode.

Type: QssColor

c.colors.statusbar.command.bg = '#282a36'

Foreground color of the statusbar in private browsing + command mode.

Type: QssColor

c.colors.statusbar.command.private.fg = '#e0e0e0'

Background color of the statusbar in private browsing + command mode.

Type: QssColor

c.colors.statusbar.command.private.bg = '#282a36'

Foreground color of the statusbar in caret mode.

Type: QssColor

c.colors.statusbar.caret.fg = '#ffb86c'

Background color of the statusbar in caret mode.

Type: QssColor

c.colors.statusbar.caret.bg = '#282a36'

Foreground color of the statusbar in caret mode with a selection.

Type: QssColor

c.colors.statusbar.caret.selection.fg = '#ffb86c'

Background color of the statusbar in caret mode with a selection.

Type: QssColor

c.colors.statusbar.caret.selection.bg = '#282a36'

Background color of the progress bar.

Type: QssColor

c.colors.statusbar.progress.bg = '#282a36'

Default foreground color of the URL in the statusbar.

Type: QssColor

c.colors.statusbar.url.fg = '#f8f8f2'

Foreground color of the URL in the statusbar on error.

Type: QssColor

c.colors.statusbar.url.error.fg = '#ff5555'

Foreground color of the URL in the statusbar for hovered links.

Type: QssColor

c.colors.statusbar.url.hover.fg = '#8be9fd'

Foreground color of the URL in the statusbar on successful load

(http).

Type: QssColor

c.colors.statusbar.url.success.http.fg = '#50fa7b'

Foreground color of the URL in the statusbar on successful load

(https).

Type: QssColor

c.colors.statusbar.url.success.https.fg = '#50fa7b'

Foreground color of the URL in the statusbar when there's a warning.

Type: QssColor

c.colors.statusbar.url.warn.fg = '#f1fa8c'

Background color of the tab bar.

Type: QssColor

c.colors.tabs.bar.bg = '#44475a'

Color gradient start for the tab indicator.

Type: QtColor

c.colors.tabs.indicator.start = '#ffb86c'

Color gradient end for the tab indicator.

Type: QtColor

c.colors.tabs.indicator.stop = '#50fa7b'

Color for the tab indicator on errors.

Type: QtColor

c.colors.tabs.indicator.error = '#ff5555'

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.

c.colors.tabs.indicator.system = 'none'

Foreground color of unselected odd tabs.

Type: QtColor

c.colors.tabs.odd.fg = '#f8f8f2'

Background color of unselected odd tabs.

Type: QtColor

c.colors.tabs.odd.bg = '#44475a'

Foreground color of unselected even tabs.

Type: QtColor

c.colors.tabs.even.fg = '#f8f8f2'

Background color of unselected even tabs.

Type: QtColor

c.colors.tabs.even.bg = '#44475a'

Foreground color of selected odd tabs.

Type: QtColor

c.colors.tabs.selected.odd.fg = '#f8f8f2'

Background color of selected odd tabs.

Type: QtColor

c.colors.tabs.selected.odd.bg = '#282a36'

Foreground color of selected even tabs.

Type: QtColor

c.colors.tabs.selected.even.fg = '#f8f8f2'

Background color of selected even tabs.

Type: QtColor

c.colors.tabs.selected.even.bg = '#282a36'

Bindings for normal mode

config.bind(',a', 'config-cycle content.user_stylesheets ~/.config/qutebrowser/greasemonkey/all.css ""')

config.bind(',d', 'config-cycle content.user_stylesheets ~/.config/qutebrowser/greasemonkey/messenger.css ""')

config.bind(',l', 'hint links spawn mpv --ytdl-format=133+140 {hint-url}')

config.bind(',m', 'hint links spawn alacritty -e mpv --ytdl-format=140 {hint-url}')

config.bind(',v', 'hint links spawn mpv {hint-url}')