151 lines
4.5 KiB
Plaintext
151 lines
4.5 KiB
Plaintext
// 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: 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 (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).
|
|
|
|
*-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.
|
|
|
|
=== 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.
|
|
|
|
*--relaxed-config*::
|
|
Silently remove unknown config options.
|
|
|
|
*--nowindow*::
|
|
Don't show the main window.
|
|
|
|
*--debug-exit*::
|
|
Turn on debugging of late exit.
|
|
|
|
*--no-crash-dialog*::
|
|
Don't show a crash dialog.
|
|
|
|
*--pdb-postmortem*::
|
|
Drop into pdb on exceptions.
|
|
|
|
*--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.
|
|
|
|
*--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
|
|
|
|
== FILES
|
|
|
|
- '~/.config/qutebrowser/qutebrowser.conf': Main config file.
|
|
- '~/.config/qutebrowser/quickmarks': Saved quickmarks.
|
|
- '~/.config/qutebrowser/keys.conf': Defined keybindings.
|
|
- '~/.local/share/qutebrowser/': Various state information.
|
|
- '~/.cache/qutebrowser/': Temporary data.
|
|
|
|
== 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
|
|
http://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: 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`] 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.
|