// Note some sections in this file (everything between QUTE_*_START and
// QUTE_*_END) are autogenerated by scripts/src2asciidoc.sh. DO NOT edit them
// by hand.

= qutebrowser(1)
:doctype: manpage
:man source: qutebrowser
:man manual: qutebrowser manpage
:toc:
:homepage: https://www.qutebrowser.org/

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

== SYNOPSIS
*qutebrowser* ['-OPTION' ['...']] [':COMMAND' ['...']] ['URL' ['...']]

== DESCRIPTION
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.

== OPTIONS
// QUTE_OPTIONS_START
=== positional arguments
*':command'*::
    Commands to execute on startup.

*'URL'*::
    URLs to open on startup (empty as a window separator).

=== optional arguments
*-h*, *--help*::
    show this help message and exit

*--basedir* 'BASEDIR'::
    Base directory for all storage.

*-V*, *--version*::
    Show version and quit.

*-s* 'SECTION' 'OPTION' 'VALUE', *--set* 'SECTION' 'OPTION' 'VALUE'::
    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).

*--debug*::
    Turn on debugging options.

*--json-logging*::
    Output log lines in JSON format (one object per line).

*--nocolor*::
    Turn off colored logging.

*--force-color*::
    Force colored logging

*--harfbuzz* '{old,new,system,auto}'::
    HarfBuzz engine version to use. Default: auto.

*--relaxed-config*::
    Silently remove unknown config options.

*--nowindow*::
    Don't show the main window.

*--debug-exit*::
    Turn on debugging of late exit.

*--pdb-postmortem*::
    Drop into pdb on exceptions.

*--temp-basedir*::
    Use a temporary basedir.

*--no-err-windows*::
    Don't show any error windows (used for tests/smoke.py).

*--qt-arg* 'QT_ARG'::
    Pass an argument with a value to Qt.

*--qt-flag* 'QT_FLAG'::
    Pass an argument to Qt as flag.
// QUTE_OPTIONS_END

== FILES

- '~/.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
Bugs are tracked in the Github issue tracker at 
https://github.com/The-Compiler/qutebrowser/issues.

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
https://lists.schokokeks.org/mailman/listinfo.cgi/qutebrowser[mailinglist] at
mailto:qutebrowser@lists.qutebrowser.org[] instead.

For security bugs, please contact me directly at me@the-compiler.org, GPG ID
https://www.the-compiler.org/pubkey.asc[0xFD55A072].

== COPYRIGHT
This program is free software: you can redistribute it and/or modify it under
the terms of the GNU General Public License as published by the Free Software
Foundation, either version 3 of the License, or (at your option) any later
version.

This program is distributed in the hope that it will be useful, but WITHOUT
ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
FOR A PARTICULAR PURPOSE.  See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with
this program.  If not, see <http://www.gnu.org/licenses/>.

== RESOURCES
* Website: https://www.qutebrowser.org/
* Mailinglist: mailto:qutebrowser@lists.qutebrowser.org[] /
https://lists.schokokeks.org/mailman/listinfo.cgi/qutebrowser
* Announce-only mailinglist: mailto:qutebrowser-announce@lists.qutebrowser.org[] /
https://lists.schokokeks.org/mailman/listinfo.cgi/qutebrowser-announce
* IRC: irc://irc.freenode.org/#qutebrowser[`#qutebrowser`] on
http://freenode.net/[Freenode]
* Github: https://github.com/The-Compiler/qutebrowser

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