qutebrowser readme
==================

About qutebrowser
-----------------

qutebrowser is a browser based on PyQt5 which aims to be keyboard-focused with
an input similar to vim.

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


Requirements
------------

The following software and libraries are required to run qutebrowser:

* http://www.python.org/[Python] 3.3 or newer (3.4 recommended)
* http://qt-project.org/[Qt] 5.2 or newer (5.3 recommended)
* QtWebKit
* http://www.riverbankcomputing.com/software/pyqt/intro[PyQt] 5.2 or newer (5.3
  recommended) for Python 3
* https://pypi.python.org/pypi/setuptools/[pkg_resources/setuptools]

The following libraries are optional and provide better debugging:

* https://pypi.python.org/pypi/colorlog/[colorlog]
* On Windows: https://pypi.python.org/pypi/colorama/[colorama]

.On Debian:

    apt-get install python3-pyqt5 python3-pyqt5.qtwebkit python3-pkg-resources

.On Archlinux:

    pacman -S python-pyqt5 qt5-webkit python-setuptools

Note an Archlinux AUR package is available.

.On Windows:

Use the installer from http://www.python.org/downloads[python.org] to get
Python 3 and the installer from
http://www.riverbankcomputing.com/software/pyqt/download5[Riverbank computing]
to get Qt and PyQt5. Run `scripts/ez_setup.py` to get setuptools.

Note a standalone .EXE is available.