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   options
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
53       {auto,tab,tab-bg,tab-silent,tab-bg-silent,window,private-window}
54           How URLs should be opened if there is already a qutebrowser
55           instance running.
56
57       --backend {webkit,webengine}
58           Which backend to use.
59
60       --desktop-file-name DESKTOP_FILE_NAME
61           Set the base name of the desktop entry for this application. Used
62           to set the app_id under Wayland. See
63           https://doc.qt.io/qt-5/qguiapplication.html#desktopFileName-prop
64
65       --untrusted-args
66           Mark all following arguments as untrusted, which enforces that they
67           are URLs/search terms (and not flags or commands)
68
69   debug arguments
70       -l {critical,error,warning,info,debug,vdebug}, --loglevel
71       {critical,error,warning,info,debug,vdebug}
72           Override the configured console loglevel
73
74       --logfilter LOGFILTER
75           Comma-separated list of things to be logged to the debug log on
76           stdout.
77
78       --loglines LOGLINES
79           How many lines of the debug log to keep in RAM (-1: unlimited).
80
81       -d, --debug
82           Turn on debugging options.
83
84       --json-logging
85           Output log lines in JSON format (one object per line).
86
87       --nocolor
88           Turn off colored logging.
89
90       --force-color
91           Force colored logging
92
93       --nowindow
94           Don’t show the main window.
95
96       -T, --temp-basedir
97           Use a temporary basedir.
98
99       --no-err-windows
100           Don’t show any error windows (used for tests/smoke.py).
101
102       --qt-arg NAME VALUE
103           Pass an argument with a value to Qt. For example, you can do
104           --qt-arg geometry 650x555+200+300 to set the window geometry.
105
106       --qt-flag QT_FLAG
107           Pass an argument to Qt as flag.
108
109       -D DEBUG_FLAGS, --debug-flag DEBUG_FLAGS
110           Pass name of debugging feature to be turned on.
111

FILES

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

BUGS

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

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

RESOURCES

157       •   Website: https://www.qutebrowser.org/
158
159       •   Mailinglist: qutebrowser@lists.qutebrowser.org /
160           https://listi.jpberlin.de/mailman/listinfo/qutebrowser
161
162       •   Announce-only mailinglist:
163           qutebrowser-announce@lists.qutebrowser.org /
164           https://listi.jpberlin.de/mailman/listinfo/qutebrowser-announce
165
166       •   IRC: #qutebrowser on Libera Chat (webchat, via Matrix)
167
168       •   Github: https://github.com/qutebrowser/qutebrowser
169

AUTHOR

171       qutebrowser was written by Florian Bruhin. All contributors can be
172       found in the README file distributed with qutebrowser.
173
174
175
176qutebrowser                       08/29/2022                    QUTEBROWSER(1)
Impressum