Installation Instructions for Pybik 2.1
=======================================

Currently Pybik is available in the official archive for Ubuntu and Debian.

For Ubuntu the latest release is available in the Pybik Personal Package Archive (PPA)
<https://launchpad.net/~barcc/+archive/pybik>. Add `ppa:barcc/pybik` to your system's
software sources (with the Ubuntu Software-Center).
You can also do this in a terminal:
        sudo add-apt-repository ppa:barcc/pybik
        sudo apt-get update
        sudo apt-get install pybik


If Pybik is not available for your distribution, see the following installation instructions.


Run from source archive
=======================

Please use the latest source from the official download site
<https://launchpad.net/pybik/+download>.

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

Please make sure you satisfy Pybik's dependencies:
 * Python 3.4
 * Qt5 and Python 3 bindings for Qt5 (PyQt5)
 * Python 3 bindings for ICU (PyICU) (optional)
For building the rendering engine:
 * C-compiler (gcc)
 * development files for Python 3
 * Mesa development files
 * gettext, intltool (for translations)

Build + Run
-----------

Extract the archive, switch to the created directory in a terminal and enter:
        ./build_local.sh

To run Pybik you can use the command in the same directory
        ./pybik


System-wide installation
========================

This installation method is intended primarily for packagers. Pybik comes
with a full featured `setup.py` installation script. To find out more, run:
        ./setup.py --help
You may need additional software
 * Cython (for Python3, >= 0.17.4, to recreate files in `./csrc/`)
 * help2man to create a manpage


VCS and Daily Builds
====================

Development happens with the Bazaar version control system.
Location: <https://code.launchpad.net/~barcc/pybik/trunk>
You can get the latest revision with:
        bzr branch lp:pybik

Daily build for Ubuntu are provided in the PPA `ppa:barcc/daily-build`
<https://code.launchpad.net/~barcc/+archive/daily-build>


