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

FILES

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

BUGS

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

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

RESOURCES

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

AUTHOR

166       qutebrowser was written by Florian Bruhin. All contributors can be
167       found in the README file distributed with qutebrowser.
168
169
170
171qutebrowser                       05/14/2019                    QUTEBROWSER(1)
Impressum