## 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 ## This is here so configs done via the GUI are still loaded. ## Remove it to not load settings done via the GUI. config.load_autoconfig(False) ## Aliases for commands. The keys of the given dictionary are the ## aliases, while the values are the commands they map to. ## Type: Dict # c.aliases = {'w': 'session-save', 'q': 'close', 'qa': 'quit', 'wq': 'quit --save', 'wqa': 'quit --save'} ## Time interval (in milliseconds) between auto-saves of ## config/cookies/etc. ## Type: Int # c.auto_save.interval = 15000 ## 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 = False ## Backend to use to display websites. qutebrowser supports two different ## web rendering engines / backends, QtWebEngine and QtWebKit (not ## recommended). QtWebEngine is Qt's official successor to QtWebKit, and ## both the default/recommended backend. It's based on a stripped-down ## Chromium and regularly updated with security fixes and new features by ## the Qt project: https://wiki.qt.io/QtWebEngine QtWebKit was ## qutebrowser's original backend when the project was started. However, ## support for QtWebKit was discontinued by the Qt project with Qt 5.6 in ## 2016. The development of QtWebKit was picked up in an official fork: ## https://github.com/qtwebkit/qtwebkit - however, the project seems to ## have stalled again. The latest release (5.212.0 Alpha 4) from March ## 2020 is based on a WebKit version from 2016, with many known security ## vulnerabilities. Additionally, there is no process isolation and ## sandboxing. Due to all those issues, while support for QtWebKit is ## still available in qutebrowser for now, using it is strongly ## discouraged. ## Type: String ## Valid values: ## - webengine: Use QtWebEngine (based on Chromium - recommended). ## - webkit: Use QtWebKit (based on WebKit, similar to Safari - many known security issues!). # c.backend = 'webengine' ## Map keys to other keys, so that they are equivalent in all modes. 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 to . NOTE: ## This should only be used if two keys should always be equivalent, i.e. ## for things like (keypad) and (non-keypad). For normal ## command bindings, qutebrowser works differently to vim: You always ## bind keys to commands, usually via `:bind` or `config.bind()`. Instead ## of using this setting, consider finding the command a key is bound to ## (e.g. via `:bind gg`) and then binding the same command to the desired ## key. Note that when a key is bound (via `bindings.default` or ## `bindings.commands`), the mapping is ignored. ## Type: Dict # c.bindings.key_mappings = {'': '', '': '', '': '', '': '', '': '', '': '', '': '', '': '', '': ''} ## When to show a changelog after qutebrowser was upgraded. ## Type: String ## Valid values: ## - major: Show changelog for major upgrades (e.g. v2.0.0 -> v3.0.0). ## - minor: Show changelog for major and minor upgrades (e.g. v2.0.0 -> v2.1.0). ## - patch: Show changelog for major, minor and patch upgrades (e.g. v2.0.0 -> v2.0.1). ## - never: Never show changelog after upgrades. # c.changelog_after_upgrade = 'minor' ## Background color of the completion widget category headers. ## Type: QssColor # c.colors.completion.category.bg = 'qlineargradient(x1:0, y1:0, x2:0, y2:1, stop:0 #888888, stop:1 #505050)' ## Bottom border color of the completion widget category headers. ## Type: QssColor # c.colors.completion.category.border.bottom = 'black' ## Top border color of the completion widget category headers. ## Type: QssColor # c.colors.completion.category.border.top = 'black' ## Foreground color of completion widget category headers. ## Type: QtColor # c.colors.completion.category.fg = 'white' ## Background color of the completion widget for even rows. ## Type: QssColor # c.colors.completion.even.bg = '#333333' ## 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 = ['white', 'white', 'white'] ## Background color of the selected completion item. ## Type: QssColor # c.colors.completion.item.selected.bg = '#e8c000' ## Bottom border color of the selected completion item. ## Type: QssColor # c.colors.completion.item.selected.border.bottom = '#bbbb00' ## Top border color of the selected completion item. ## Type: QssColor # c.colors.completion.item.selected.border.top = '#bbbb00' ## Foreground color of the selected completion item. ## Type: QtColor # c.colors.completion.item.selected.fg = 'black' ## Foreground color of the matched text in the selected completion item. ## Type: QtColor # c.colors.completion.item.selected.match.fg = '#ff4444' ## Foreground color of the matched text in the completion. ## Type: QtColor # c.colors.completion.match.fg = '#ff4444' ## Background color of the completion widget for odd rows. ## Type: QssColor # c.colors.completion.odd.bg = '#444444' ## Color of the scrollbar in the completion view. ## Type: QssColor # c.colors.completion.scrollbar.bg = '#333333' ## Color of the scrollbar handle in the completion view. ## Type: QssColor # c.colors.completion.scrollbar.fg = 'white' ## Background color of disabled items in the context menu. If set to ## null, the Qt default is used. ## Type: QssColor # c.colors.contextmenu.disabled.bg = None ## Foreground color of disabled items in the context menu. If set to ## null, the Qt default is used. ## Type: QssColor # c.colors.contextmenu.disabled.fg = None ## Background color of the context menu. If set to null, the Qt default ## is used. ## Type: QssColor # c.colors.contextmenu.menu.bg = None ## Foreground color of the context menu. If set to null, the Qt default ## is used. ## Type: QssColor # c.colors.contextmenu.menu.fg = None ## Background color of the context menu's selected item. If set to null, ## the Qt default is used. ## Type: QssColor # c.colors.contextmenu.selected.bg = None ## Foreground color of the context menu's selected item. If set to null, ## the Qt default is used. ## Type: QssColor # c.colors.contextmenu.selected.fg = None ## Background color for the download bar. ## Type: QssColor # c.colors.downloads.bar.bg = 'black' ## Background color for downloads with errors. ## Type: QtColor # c.colors.downloads.error.bg = 'red' ## Foreground color for downloads with errors. ## Type: QtColor # c.colors.downloads.error.fg = 'white' ## Color gradient start for download backgrounds. ## Type: QtColor # c.colors.downloads.start.bg = '#0000aa' ## Color gradient start for download text. ## Type: QtColor # c.colors.downloads.start.fg = 'white' ## Color gradient stop for download backgrounds. ## Type: QtColor # c.colors.downloads.stop.bg = '#00aa00' ## Color gradient end for download text. ## Type: QtColor # c.colors.downloads.stop.fg = 'white' ## 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 = '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. # c.colors.downloads.system.fg = 'rgb' ## Background color for hints. Note that you can use a `rgba(...)` value ## for transparency. ## Type: QssColor # c.colors.hints.bg = 'qlineargradient(x1:0, y1:0, x2:0, y2:1, stop:0 rgba(255, 247, 133, 0.8), stop:1 rgba(255, 197, 66, 0.8))' ## Font color for hints. ## Type: QssColor # c.colors.hints.fg = 'black' ## Font color for the matched part of hints. ## Type: QtColor # c.colors.hints.match.fg = 'green' ## Background color of the keyhint widget. ## Type: QssColor # c.colors.keyhint.bg = 'rgba(0, 0, 0, 80%)' ## Text color for the keyhint widget. ## Type: QssColor # c.colors.keyhint.fg = '#FFFFFF' ## Highlight color for keys to complete the current keychain. ## Type: QssColor # c.colors.keyhint.suffix.fg = '#FFFF00' ## Background color of an error message. ## Type: QssColor # c.colors.messages.error.bg = 'red' ## Border color of an error message. ## Type: QssColor # c.colors.messages.error.border = '#bb0000' ## Foreground color of an error message. ## Type: QssColor # c.colors.messages.error.fg = 'white' ## Background color of an info message. ## Type: QssColor # c.colors.messages.info.bg = 'black' ## Border color of an info message. ## Type: QssColor # c.colors.messages.info.border = '#333333' ## Foreground color of an info message. ## Type: QssColor # c.colors.messages.info.fg = 'white' ## Background color of a warning message. ## Type: QssColor # c.colors.messages.warning.bg = 'darkorange' ## Border color of a warning message. ## Type: QssColor # c.colors.messages.warning.border = '#d47300' ## Foreground color of a warning message. ## Type: QssColor # c.colors.messages.warning.fg = 'black' ## Background color for prompts. ## Type: QssColor # c.colors.prompts.bg = '#444444' ## Border used around UI elements in prompts. ## Type: String # c.colors.prompts.border = '1px solid gray' ## Foreground color for prompts. ## Type: QssColor # c.colors.prompts.fg = 'white' ## Background color for the selected item in filename prompts. ## Type: QssColor # c.colors.prompts.selected.bg = 'grey' ## Foreground color for the selected item in filename prompts. ## Type: QssColor # c.colors.prompts.selected.fg = 'white' ## Background color of the statusbar in caret mode. ## Type: QssColor # c.colors.statusbar.caret.bg = 'purple' ## Foreground color of the statusbar in caret mode. ## Type: QssColor # c.colors.statusbar.caret.fg = 'white' ## Background color of the statusbar in caret mode with a selection. ## Type: QssColor # c.colors.statusbar.caret.selection.bg = '#a12dff' ## Foreground color of the statusbar in caret mode with a selection. ## Type: QssColor # c.colors.statusbar.caret.selection.fg = 'white' ## Background color of the statusbar in command mode. ## Type: QssColor # c.colors.statusbar.command.bg = 'black' ## Foreground color of the statusbar in command mode. ## Type: QssColor # c.colors.statusbar.command.fg = 'white' ## Background color of the statusbar in private browsing + command mode. ## Type: QssColor # c.colors.statusbar.command.private.bg = 'darkslategray' ## Foreground color of the statusbar in private browsing + command mode. ## Type: QssColor # c.colors.statusbar.command.private.fg = 'white' ## Background color of the statusbar in insert mode. ## Type: QssColor # c.colors.statusbar.insert.bg = 'darkgreen' ## Foreground color of the statusbar in insert mode. ## Type: QssColor # c.colors.statusbar.insert.fg = 'white' ## Background color of the statusbar. ## Type: QssColor # c.colors.statusbar.normal.bg = 'black' ## Foreground color of the statusbar. ## Type: QssColor # c.colors.statusbar.normal.fg = 'white' ## Background color of the statusbar in passthrough mode. ## Type: QssColor # c.colors.statusbar.passthrough.bg = 'darkblue' ## Foreground color of the statusbar in passthrough mode. ## Type: QssColor # c.colors.statusbar.passthrough.fg = 'white' ## Background color of the statusbar in private browsing mode. ## Type: QssColor # c.colors.statusbar.private.bg = '#666666' ## Foreground color of the statusbar in private browsing mode. ## Type: QssColor # c.colors.statusbar.private.fg = 'white' ## Background color of the progress bar. ## Type: QssColor # c.colors.statusbar.progress.bg = 'white' ## Foreground color of the URL in the statusbar on error. ## Type: QssColor # c.colors.statusbar.url.error.fg = 'orange' ## Default foreground color of the URL in the statusbar. ## Type: QssColor # c.colors.statusbar.url.fg = 'white' ## Foreground color of the URL in the statusbar for hovered links. ## Type: QssColor # c.colors.statusbar.url.hover.fg = 'aqua' ## Foreground color of the URL in the statusbar on successful load ## (http). ## Type: QssColor # c.colors.statusbar.url.success.http.fg = 'white' ## Foreground color of the URL in the statusbar on successful load ## (https). ## Type: QssColor # c.colors.statusbar.url.success.https.fg = 'lime' ## Foreground color of the URL in the statusbar when there's a warning. ## Type: QssColor # c.colors.statusbar.url.warn.fg = 'yellow' ## Background color of the tab bar. ## Type: QssColor # c.colors.tabs.bar.bg = '#555555' ## Background color of unselected even tabs. ## Type: QtColor # c.colors.tabs.even.bg = 'darkgrey' ## Foreground color of unselected even tabs. ## Type: QtColor # c.colors.tabs.even.fg = 'white' ## Color for the tab indicator on errors. ## Type: QtColor # c.colors.tabs.indicator.error = '#ff0000' ## Color gradient start for the tab indicator. ## Type: QtColor # c.colors.tabs.indicator.start = '#0000aa' ## Color gradient end for the tab indicator. ## Type: QtColor # c.colors.tabs.indicator.stop = '#00aa00' ## 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 = 'rgb' ## Background color of unselected odd tabs. ## Type: QtColor # c.colors.tabs.odd.bg = 'grey' ## Foreground color of unselected odd tabs. ## Type: QtColor # c.colors.tabs.odd.fg = 'white' ## Background color of pinned unselected even tabs. ## Type: QtColor # c.colors.tabs.pinned.even.bg = 'darkseagreen' ## Foreground color of pinned unselected even tabs. ## Type: QtColor # c.colors.tabs.pinned.even.fg = 'white' ## Background color of pinned unselected odd tabs. ## Type: QtColor # c.colors.tabs.pinned.odd.bg = 'seagreen' ## Foreground color of pinned unselected odd tabs. ## Type: QtColor # c.colors.tabs.pinned.odd.fg = 'white' ## Background color of pinned selected even tabs. ## Type: QtColor # c.colors.tabs.pinned.selected.even.bg = 'black' ## Foreground color of pinned selected even tabs. ## Type: QtColor # c.colors.tabs.pinned.selected.even.fg = 'white' ## Background color of pinned selected odd tabs. ## Type: QtColor # c.colors.tabs.pinned.selected.odd.bg = 'black' ## Foreground color of pinned selected odd tabs. ## Type: QtColor # c.colors.tabs.pinned.selected.odd.fg = 'white' ## Background color of selected even tabs. ## Type: QtColor # c.colors.tabs.selected.even.bg = 'black' ## Foreground color of selected even tabs. ## Type: QtColor # c.colors.tabs.selected.even.fg = 'white' ## Background color of selected odd tabs. ## Type: QtColor # c.colors.tabs.selected.odd.bg = 'black' ## Foreground color of selected odd tabs. ## Type: QtColor # c.colors.tabs.selected.odd.fg = 'white' ## Background color for webpages if unset (or empty to use the theme's ## color). ## Type: QtColor # c.colors.webpage.bg = 'white' ## Which algorithm to use for modifying how colors are rendered with ## darkmode. The `lightness-cielab` value was added with QtWebEngine 5.14 ## and is treated like `lightness-hsl` with older QtWebEngine versions. ## Type: String ## Valid values: ## - lightness-cielab: Modify colors by converting them to CIELAB color space and inverting the L value. Not available with Qt < 5.14. ## - 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. # c.colors.webpage.darkmode.algorithm = 'lightness-cielab' ## Contrast for dark mode. This only has an effect when ## `colors.webpage.darkmode.algorithm` is set to `lightness-hsl` or ## `brightness-rgb`. ## Type: Float # c.colors.webpage.darkmode.contrast = 0.0 ## 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.algorithm` accordingly. - ## "With selective image inversion": Set ## `colors.webpage.darkmode.policy.images` to `smart`. - "With selective ## inversion of non-image elements": Set ## `colors.webpage.darkmode.threshold.text` to 150 and ## `colors.webpage.darkmode.threshold.background` to 205. - "With ## selective inversion of everything": Combines the two variants above. ## Type: Bool # c.colors.webpage.darkmode.enabled = False ## Render all colors as grayscale. This only has an effect when ## `colors.webpage.darkmode.algorithm` is set to `lightness-hsl` or ## `brightness-rgb`. ## Type: Bool # c.colors.webpage.darkmode.grayscale.all = False ## 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. ## Type: Float # c.colors.webpage.darkmode.grayscale.images = 0.0 ## Which images to apply dark mode to. With QtWebEngine 5.15.0, this ## setting can cause frequent renderer process crashes due to a ## https://codereview.qt-project.org/c/qt/qtwebengine- ## chromium/+/304211[bug in Qt]. ## 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. Not available with Qt 5.15.0. # c.colors.webpage.darkmode.policy.images = 'smart' ## Which pages to apply dark mode to. The underlying Chromium setting has ## been removed in QtWebEngine 5.15.3, thus this setting is ignored ## there. Instead, every element is now classified individually. ## 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. # c.colors.webpage.darkmode.policy.page = 'smart' ## 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`! ## Type: Int # c.colors.webpage.darkmode.threshold.background = 0 ## 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. ## Type: Int # c.colors.webpage.darkmode.threshold.text = 256 ## Value to use for `prefers-color-scheme:` for websites. The "light" ## value is only available with QtWebEngine 5.15.2+. On older versions, ## it is the same as "auto". The "auto" value is broken on QtWebEngine ## 5.15.2 due to a Qt bug. There, it will fall back to "light" ## unconditionally. ## Type: String ## Valid values: ## - auto: Use the system-wide color scheme setting. ## - light: Force a light theme. ## - dark: Force a dark theme. # c.colors.webpage.preferred_color_scheme = 'auto' ## Number of commands to save in the command history. 0: no history / -1: ## unlimited ## Type: Int # c.completion.cmd_history_max_items = 100 ## Delay (in milliseconds) before updating completions after typing a ## character. ## Type: Int # c.completion.delay = 0 ## Default filesystem autocomplete suggestions for :open. The elements of ## this list show up in the completion window under the Filesystem ## category when the command line contains `:open` but no argument. ## Type: List of String # c.completion.favorite_paths = [] ## Height (in pixels or as percentage of the window) of the completion. ## Type: PercOrInt # c.completion.height = '50%' ## Minimum amount of characters needed to update completions. ## Type: Int # c.completion.min_chars = 1 ## Which categories to show (in which order) in the :open completion. ## Type: FlagList ## Valid values: ## - searchengines ## - quickmarks ## - bookmarks ## - history ## - filesystem # c.completion.open_categories = ['searchengines', 'quickmarks', 'bookmarks', 'history', 'filesystem'] ## Move on to the next part when there's only one possible completion ## left. ## Type: Bool # c.completion.quick = True ## Padding (in pixels) of the scrollbar handle in the completion window. ## Type: Int # c.completion.scrollbar.padding = 2 ## Width (in pixels) of the scrollbar in the completion window. ## Type: Int # c.completion.scrollbar.width = 12 ## When to show the autocompletion window. ## Type: String ## Valid values: ## - always: Whenever a completion is available. ## - auto: Whenever a completion is requested. ## - never: Never. # c.completion.show = 'always' ## Shrink the completion to be smaller than the configured size if there ## are no scrollbars. ## Type: Bool # c.completion.shrink = False ## Format of timestamps (e.g. for the history completion). See ## https://sqlite.org/lang_datefunc.html and ## https://docs.python.org/3/library/datetime.html#strftime-strptime- ## behavior for allowed substitutions, qutebrowser uses both sqlite and ## Python to format its timestamps. ## Type: String # c.completion.timestamp_format = '%Y-%m-%d %H:%M' ## Execute the best-matching command on a partial match. ## Type: Bool # c.completion.use_best_match = False ## 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 `: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. ## Type: List of UrlPattern # c.completion.web_history.exclude = [] ## Number of URLs to show in the web history. 0: no history / -1: ## unlimited ## Type: Int # c.completion.web_history.max_items = -1 ## 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. # c.confirm_quit = ['never'] ## Automatically start playing `