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
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   debug arguments
66       -l {critical,error,warning,info,debug,vdebug}, --loglevel
67       {critical,error,warning,info,debug,vdebug}
68           Override the configured console loglevel
69
70       --logfilter LOGFILTER
71           Comma-separated list of things to be logged to the debug log on
72           stdout.
73
74       --loglines LOGLINES
75           How many lines of the debug log to keep in RAM (-1: unlimited).
76
77       -d, --debug
78           Turn on debugging options.
79
80       --json-logging
81           Output log lines in JSON format (one object per line).
82
83       --nocolor
84           Turn off colored logging.
85
86       --force-color
87           Force colored logging
88
89       --nowindow
90           Don’t show the main window.
91
92       -T, --temp-basedir
93           Use a temporary basedir.
94
95       --no-err-windows
96           Don’t show any error windows (used for tests/smoke.py).
97
98       --qt-arg NAME VALUE
99           Pass an argument with a value to Qt. For example, you can do
100           --qt-arg geometry 650x555+200+300 to set the window geometry.
101
102       --qt-flag QT_FLAG
103           Pass an argument to Qt as flag.
104
105       -D DEBUG_FLAGS, --debug-flag DEBUG_FLAGS
106           Pass name of debugging feature to be turned on.
107

FILES

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

BUGS

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

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

RESOURCES

153       •   Website: https://www.qutebrowser.org/
154
155       •   Mailinglist: qutebrowser@lists.qutebrowser.org /
156           https://lists.schokokeks.org/mailman/listinfo.cgi/qutebrowser
157
158       •   Announce-only mailinglist:
159           qutebrowser-announce@lists.qutebrowser.org /
160           https://lists.schokokeks.org/mailman/listinfo.cgi/qutebrowser-announce
161
162       •   IRC: #qutebrowser on Libera Chat (webchat, via Matrix)
163
164       •   Github: https://github.com/qutebrowser/qutebrowser
165

AUTHOR

167       qutebrowser was written by Florian Bruhin. All contributors can be
168       found in the README file distributed with qutebrowser.
169
170
171
172qutebrowser                       07/30/2021                    QUTEBROWSER(1)
Impressum