1QUTEBROWSER(1)                qutebrowser manpage               QUTEBROWSER(1)
2
3
4

NAME

6       qutebrowser - a keyboard-driven, vim-like browser based on Python and
7       Qt.
8

SYNOPSIS

10       qutebrowser [-OPTION [...]] [:COMMAND [...]] [URL [...]]
11

DESCRIPTION

13       qutebrowser is a keyboard-focused browser with a minimal GUI. It’s
14       based on Python and Qt and is free software, licensed under the GPL.
15
16       It was inspired by other browsers/addons like dwb and
17       Vimperator/Pentadactyl.
18
19       Note the commands and settings of qutebrowser are not described in this
20       manpage, but in the help integrated in qutebrowser - use the ":help"
21       command to show it.
22

OPTIONS

24   positional arguments
25       :command
26           Commands to execute on startup.
27
28       URL
29           URLs to open on startup (empty as a window separator).
30
31   options
32       -h, --help
33           show this help message and exit
34
35       -B BASEDIR, --basedir BASEDIR
36           Base directory for all storage.
37
38       -C CONFIG, --config-py CONFIG
39           Path to config.py.
40
41       -V, --version
42           Show version and quit.
43
44       -s OPTION VALUE, --set OPTION VALUE
45           Set a temporary setting for this session.
46
47       -r SESSION, --restore SESSION
48           Restore a named session.
49
50       -R, --override-restore
51           Don’t restore a session even if one would be restored.
52
53       --target
54       {auto,tab,tab-bg,tab-silent,tab-bg-silent,window,private-window}
55           How URLs should be opened if there is already a qutebrowser
56           instance running.
57
58       --backend {webkit,webengine}
59           Which backend to use.
60
61       --qt-wrapper {PyQt6,PyQt5}
62           Which Qt wrapper to use. This can also be set via the
63           QUTE_QT_WRAPPER environment variable. If both are set, the command
64           line argument takes precedence.
65
66       --desktop-file-name DESKTOP_FILE_NAME
67           Set the base name of the desktop entry for this application. Used
68           to set the app_id under Wayland. See
69           https://doc.qt.io/qt-6/qguiapplication.html#desktopFileName-prop
70
71       --untrusted-args
72           Mark all following arguments as untrusted, which enforces that they
73           are URLs/search terms (and not flags or commands)
74
75   debug arguments
76       -l {critical,error,warning,info,debug,vdebug}, --loglevel
77       {critical,error,warning,info,debug,vdebug}
78           Override the configured console loglevel
79
80       --logfilter LOGFILTER
81           Comma-separated list of things to be logged to the debug log on
82           stdout.
83
84       --loglines LOGLINES
85           How many lines of the debug log to keep in RAM (-1: unlimited).
86
87       -d, --debug
88           Turn on debugging options.
89
90       --json-logging
91           Output log lines in JSON format (one object per line).
92
93       --nocolor
94           Turn off colored logging.
95
96       --force-color
97           Force colored logging
98
99       --nowindow
100           Don’t show the main window.
101
102       -T, --temp-basedir
103           Use a temporary basedir.
104
105       --no-err-windows
106           Don’t show any error windows (used for tests/smoke.py).
107
108       --qt-arg NAME VALUE
109           Pass an argument with a value to Qt. For example, you can do
110           --qt-arg geometry 650x555+200+300 to set the window geometry.
111
112       --qt-flag QT_FLAG
113           Pass an argument to Qt as flag.
114
115       -D DEBUG_FLAGS, --debug-flag DEBUG_FLAGS
116           Pass name of debugging feature to be turned on.
117

FILES

119~/.config/qutebrowser/config.py: Configuration file.
120
121~/.config/qutebrowser/autoconfig.yml: Configuration done via the
122           GUI.
123
124~/.config/qutebrowser/quickmarks: Saved quickmarks.
125
126~/.local/share/qutebrowser/: Various state information.
127
128~/.cache/qutebrowser/: Temporary data.
129
130       Note qutebrowser conforms to the XDG basedir specification - if
131       XDG_CONFIG_HOME, XDG_DATA_HOME or XDG_CACHE_HOME are set in the
132       environment, the directories configured there are used instead of the
133       above defaults.
134

BUGS

136       Bugs are tracked in the Github issue tracker at
137       https://github.com/qutebrowser/qutebrowser/issues.
138
139       If you found a bug, use the built-in :report command to create a bug
140       report with all information needed.
141
142       If you prefer, you can also write to the mailinglist at
143       qutebrowser@lists.qutebrowser.org instead.
144
145       For security bugs, please contact security@qutebrowser.org (or if GPG
146       encryption is desired, contact me@the-compiler.org with GPG ID
147       0x916EB0C8FD55A072).
148
149       Alternatively, report a vulnerability via GitHub’s private reporting
150       feature.
151
153       This program is free software: you can redistribute it and/or modify it
154       under the terms of the GNU General Public License as published by the
155       Free Software Foundation, either version 3 of the License, or (at your
156       option) any later version.
157
158       This program is distributed in the hope that it will be useful, but
159       WITHOUT ANY WARRANTY; without even the implied warranty of
160       MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
161       General Public License for more details.
162
163       You should have received a copy of the GNU General Public License along
164       with this program. If not, see https://www.gnu.org/licenses/.
165

RESOURCES

167       •   Website: https://www.qutebrowser.org/
168
169       •   Mailinglist: qutebrowser@lists.qutebrowser.org /
170           https://listi.jpberlin.de/mailman/listinfo/qutebrowser
171
172       •   Announce-only mailinglist:
173           qutebrowser-announce@lists.qutebrowser.org /
174           https://listi.jpberlin.de/mailman/listinfo/qutebrowser-announce
175
176       •   IRC: #qutebrowser on Libera Chat (webchat, via Matrix)
177
178       •   Github: https://github.com/qutebrowser/qutebrowser
179

AUTHOR

181       qutebrowser was written by Florian Bruhin. All contributors can be
182       found in the README file distributed with qutebrowser.
183
184
185
186qutebrowser                       09/21/2023                    QUTEBROWSER(1)
Impressum