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

= qutebrowser(1)
:doctype: manpage
:man source: qutebrowser
:man manual: qutebrowser manpage
:toc:
:homepage: http://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 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.

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

*'URL'*::
    URLs to open on startup.

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

*-c* 'CONFDIR', *--confdir* 'CONFDIR'::
    Set config directory (empty for no config storage)

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

=== debug arguments
*-l* 'LOGLEVEL', *--loglevel* 'LOGLEVEL'::
    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.

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

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

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

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

*--qt-style* 'STYLE'::
    Set the Qt GUI style to use.

*--qt-stylesheet* 'STYLESHEET'::
    Override the Qt application stylesheet.

*--qt-widgetcount*::
    Print debug message at the end about number of widgets left undestroyed and maximum number of widgets existed at the same time.

*--qt-reverse*::
    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.
// QUTE_OPTIONS_END

== BUGS
Bugs are tracked at two locations:

* The link:BUGS[doc/BUGS] and link:TODO[doc/TODO] files shipped with
qutebrowser.
* The Github issue tracker at
https://github.com/The-Compiler/qutebrowser/issues.

If you found a bug or have a suggestion, either open a ticket in the github
issue tracker, or write a mail to the
https://lists.schokokeks.org/mailman/listinfo.cgi/qutebrowser[mailinglist] at
mailto:qutebrowser@lists.qutebrowser.org[].

== 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: http://www.qutebrowser.org/
* Mailinglist: mailto:qutebrowser@lists.qutebrowser.org[] /
https://lists.schokokeks.org/mailman/listinfo.cgi/qutebrowser
* IRC: irc://irc.freenode.org/#qutebrowser[`#qutebrowser`]
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.