1QUTEBROWSER(1) qutebrowser manpage QUTEBROWSER(1)
2
6 qutebrowser - a keyboard-driven, vim-like browser based on Python and
7 Qt.
8
10 qutebrowser [-OPTION [...]] [:COMMAND [...]] [URL [...]]
11
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 It was inspired by other browsers/addons like dwb and
17 Vimperator/Pentadactyl.
18 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
24 positional arguments
25 :command
26 Commands to execute on startup.
27 URL
29 URLs to open on startup (empty as a window separator).
30 options
32 -h, --help
33 show this help message and exit
34 -B BASEDIR, --basedir BASEDIR
36 Base directory for all storage.
37 -C CONFIG, --config-py CONFIG
39 Path to config.py.
40 -V, --version
42 Show version and quit.
43 -s OPTION VALUE, --set OPTION VALUE
45 Set a temporary setting for this session.
46 -r SESSION, --restore SESSION
48 Restore a named session.
49 -R, --override-restore
51 Don’t restore a session even if one would be restored.
52 --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 --backend {webkit,webengine}
59 Which backend to use.
60 --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 --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 --untrusted-args
72 Mark all following arguments as untrusted, which enforces that they
73 are URLs/search terms (and not flags or commands)
74 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 --logfilter LOGFILTER
81 Comma-separated list of things to be logged to the debug log on
82 stdout.
83 --loglines LOGLINES
85 How many lines of the debug log to keep in RAM (-1: unlimited).
86 -d, --debug
88 Turn on debugging options.
89 --json-logging
91 Output log lines in JSON format (one object per line).
92 --nocolor
94 Turn off colored logging.
95 --force-color
97 Force colored logging
98 --nowindow
100 Don’t show the main window.
101 -T, --temp-basedir
103 Use a temporary basedir.
104 --no-err-windows
106 Don’t show any error windows (used for tests/smoke.py).
107 --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 --qt-flag QT_FLAG
113 Pass an argument to Qt as flag.
114 -D DEBUG_FLAGS, --debug-flag DEBUG_FLAGS
116 Pass name of debugging feature to be turned on.
117
119 • ~/.config/qutebrowser/config.py: Configuration file.
120 • ~/.config/qutebrowser/autoconfig.yml: Configuration done via the
122 GUI.
123 • ~/.config/qutebrowser/quickmarks: Saved quickmarks.
125 • ~/.local/share/qutebrowser/: Various state information.
127 • ~/.cache/qutebrowser/: Temporary data.
129 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
136 Bugs are tracked in the Github issue tracker at
137 https://github.com/qutebrowser/qutebrowser/issues.
138 If you found a bug, use the built-in :report command to create a bug
140 report with all information needed.
141 If you prefer, you can also write to the mailinglist at
143 qutebrowser@lists.qutebrowser.org instead.
144 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 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 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 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
167 • Website: https://www.qutebrowser.org/
168 • Mailinglist: qutebrowser@lists.qutebrowser.org /
170 https://listi.jpberlin.de/mailman/listinfo/qutebrowser
171 • Announce-only mailinglist:
173 qutebrowser-announce@lists.qutebrowser.org /
174 https://listi.jpberlin.de/mailman/listinfo/qutebrowser-announce
175 • IRC: #qutebrowser on Libera Chat (webchat, via Matrix)
177 • Github: https://github.com/qutebrowser/qutebrowser
179
181 qutebrowser was written by Florian Bruhin. All contributors can be
182 found in the README file distributed with qutebrowser.
183qutebrowser 08/28/2023 QUTEBROWSER(1)