qutebrowser man page

qutebrowser — a keyboard-driven, vim-like browser based on PyQt5 and QtWebKit.


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


qutebrowser is a keyboard-focused browser with a minimal GUI. It’s based on Python, PyQt5 and QtWebKit and free software, licensed under the GPL.

It was inspired by other browsers/addons like dwb and Vimperator/Pentadactyl.

Note the commands and settings of qutebrowser are not described in this manpage, but in the help integrated in qutebrowser - use the ":help" command to show it.


positional arguments


Commands to execute on startup.


URLs to open on startup (empty as a window separator).

optional arguments

-h, --help

show this help message and exit

-c CONFDIR, --confdir CONFDIR

Set config directory (empty for no config storage).

--datadir DATADIR

Set data directory (empty for no data storage).

--cachedir CACHEDIR

Set cache directory (empty for no cache storage).

--basedir BASEDIR

Base directory for all storage. Other --*dir arguments are ignored if this is given.

-V, --version

Show version and quit.


Set a temporary setting for this session.

-r SESSION, --restore SESSION

Restore a named session.

-R, --override-restore

Don’t restore a session even if one would be restored.

--target {auto,tab,tab-bg,tab-silent,tab-bg-silent,window}

How URLs should be opened if there is already a qutebrowser instance running.

--backend {webkit,webengine}

Which backend to use (webengine backend is EXPERIMENTAL!).

debug arguments

-l {critical,error,warning,info,debug,vdebug}, --loglevel {critical,error,warning,info,debug,vdebug}

Set loglevel

--logfilter LOGFILTER

Comma-separated list of things to be logged to the debug log on stdout.

--loglines LOGLINES

How many lines of the debug log to keep in RAM (-1: unlimited).


Turn on debugging options.


Output log lines in JSON format (one object per line).


Turn off colored logging.


Force colored logging

--harfbuzz {old,new,system,auto}

HarfBuzz engine version to use. Default: auto.


Silently remove unknown config options.


Don’t show the main window.


Turn on debugging of late exit.


Drop into pdb on exceptions.


Use a temporary basedir.


Don’t show any error windows (used for tests/smoke.py).

--qt-name NAME

Set the window name.

--qt-style STYLE

Set the Qt GUI style to use.

--qt-stylesheet STYLESHEET

Override the Qt application stylesheet.


Print debug message at the end about number of widgets left undestroyed and maximum number of widgets existed at the same time.


Set the application’s layout direction to right-to-left.

--qt-qmljsdebugger port:PORT[,block]

Activate the QML/JS debugger with a specified port. block is optional and will make the application wait until a debugger connects to it.


· ~/.config/qutebrowser/qutebrowser.conf: Main config file.

· ~/.config/qutebrowser/quickmarks: Saved quickmarks.

· ~/.config/qutebrowser/keys.conf: Defined key bindings.

· ~/.local/share/qutebrowser/: Various state information.

· ~/.cache/qutebrowser/: Temporary data.

Note qutebrowser conforms to the XDG basedir specification - if XDG_CONFIG_HOME, XDG_DATA_HOME or XDG_CACHE_HOME are set in the environment, the directories configured there are used instead of the above defaults.


Bugs are tracked in the Github issue tracker at https://github.com/The-Compiler/qutebro….

If you found a bug, use the built-in :report command to create a bug report with all information needed.

If you prefer, you can also write to the mailinglist at qutebrowser@lists.qutebrowser.org instead.

For security bugs, please contact me directly at me@the-compiler.org, GPG ID 0xFD55A072.


· Mailinglist: qutebrowser@lists.qutebrowser.org / https://lists.schokokeks.org/mailman/li…

· IRC: #qutebrowser on Freenode


qutebrowser was written by Florian Bruhin. All contributors can be found in the README file distributed with qutebrowser.


qutebrowser qutebrowser manpage 08/05/2016