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

NAME

6       qutebrowser - a keyboard-driven, vim-like browser based on PyQt5.
7

SYNOPSIS

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

DESCRIPTION

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

OPTIONS

23   positional arguments
24       :command
25           Commands to execute on startup.
26
27       URL
28           URLs to open on startup (empty as a window separator).
29
30   optional arguments
31       -h, --help
32           show this help message and exit
33
34       -B BASEDIR, --basedir BASEDIR
35           Base directory for all storage.
36
37       -C CONFIG, --config-py CONFIG
38           Path to config.py.
39
40       -V, --version
41           Show version and quit.
42
43       -s OPTION VALUE, --set OPTION VALUE
44           Set a temporary setting for this session.
45
46       -r SESSION, --restore SESSION
47           Restore a named session.
48
49       -R, --override-restore
50           Don’t restore a session even if one would be restored.
51
52       --target {auto,tab,tab-bg,tab-silent,tab-bg-silent,window}
53           How URLs should be opened if there is already a qutebrowser
54           instance running.
55
56       --backend {webkit,webengine}
57           Which backend to use.
58
59       --enable-webengine-inspector
60           Enable the web inspector for QtWebEngine. Note that this is a
61           SECURITY RISK and you should not visit untrusted websites with the
62           inspector turned on. See
63           https://bugreports.qt.io/browse/QTBUG-50725 for more details. This
64           is not needed anymore since Qt 5.11 where the inspector is always
65           enabled and secure.
66
67   debug arguments
68       -l {critical,error,warning,info,debug,vdebug}, --loglevel
69       {critical,error,warning,info,debug,vdebug}
70           Set loglevel
71
72       --logfilter LOGFILTER
73           Comma-separated list of things to be logged to the debug log on
74           stdout.
75
76       --loglines LOGLINES
77           How many lines of the debug log to keep in RAM (-1: unlimited).
78
79       -d, --debug
80           Turn on debugging options.
81
82       --json-logging
83           Output log lines in JSON format (one object per line).
84
85       --nocolor
86           Turn off colored logging.
87
88       --force-color
89           Force colored logging
90
91       --nowindow
92           Don’t show the main window.
93
94       -T, --temp-basedir
95           Use a temporary basedir.
96
97       --no-err-windows
98           Don’t show any error windows (used for tests/smoke.py).
99
100       --qt-arg NAME VALUE
101           Pass an argument with a value to Qt. For example, you can do
102           --qt-arg geometry 650x555+200+300 to set the window geometry.
103
104       --qt-flag QT_FLAG
105           Pass an argument to Qt as flag.
106
107       -D DEBUG_FLAGS, --debug-flag DEBUG_FLAGS
108           Pass name of debugging feature to be turned on.
109

FILES

111       ·   ~/.config/qutebrowser/config.py: Configuration file.
112
113       ·   ~/.config/qutebrowser/autoconfig.yml: Configuration done via the
114           GUI.
115
116       ·   ~/.config/qutebrowser/quickmarks: Saved quickmarks.
117
118       ·   ~/.local/share/qutebrowser/: Various state information.
119
120       ·   ~/.cache/qutebrowser/: Temporary data.
121
122       Note qutebrowser conforms to the XDG basedir specification - if
123       XDG_CONFIG_HOME, XDG_DATA_HOME or XDG_CACHE_HOME are set in the
124       environment, the directories configured there are used instead of the
125       above defaults.
126

BUGS

128       Bugs are tracked in the Github issue tracker at
129       https://github.com/qutebrowser/qutebrowser/issues.
130
131       If you found a bug, use the built-in :report command to create a bug
132       report with all information needed.
133
134       If you prefer, you can also write to the mailinglist at
135       qutebrowser@lists.qutebrowser.org instead.
136
137       For security bugs, please contact me directly at me@the-compiler.org,
138       GPG ID 0xFD55A072.
139

141       This program is free software: you can redistribute it and/or modify it
142       under the terms of the GNU General Public License as published by the
143       Free Software Foundation, either version 3 of the License, or (at your
144       option) any later version.
145
146       This program is distributed in the hope that it will be useful, but
147       WITHOUT ANY WARRANTY; without even the implied warranty of
148       MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
149       General Public License for more details.
150
151       You should have received a copy of the GNU General Public License along
152       with this program. If not, see http://www.gnu.org/licenses/.
153

RESOURCES

155       ·   Website: https://www.qutebrowser.org/
156
157       ·   Mailinglist: qutebrowser@lists.qutebrowser.org /
158           https://lists.schokokeks.org/mailman/listinfo.cgi/qutebrowser
159
160       ·   Announce-only mailinglist:
161           qutebrowser-announce@lists.qutebrowser.org /
162           https://lists.schokokeks.org/mailman/listinfo.cgi/qutebrowser-announce
163
164       ·   IRC: #qutebrowser on Freenode
165
166       ·   Github: https://github.com/qutebrowser/qutebrowser
167

AUTHOR

169       qutebrowser was written by Florian Bruhin. All contributors can be
170       found in the README file distributed with qutebrowser.
171
172
173
174qutebrowser                       02/17/2020                    QUTEBROWSER(1)
Impressum