
= Installation Instructions =

Please make sure you satisfy Pybik's dependencies:

 * Python 2.7
 * Python bindings for GTK+: pygtk >= 2.16
 * pyopengl
 * python-numpy
 For building extension module (optional [2]):
 * cython or pyrex [1] 
 * development files for python, mesa
 For building translation files (optional):
 * gettext
 * intltool

[1] The project is currently moving from pyrex to cython,
    the support for pyrex may be removed sometime.
[2] Without the extension module Pybik runs with poor performance


== Ubuntu ==

For Ubuntu Pybik is also available in a PPA.

You can use the Ubuntu Software-Center and add ppa:barcc/pybik to your
system's Software Sources. Just install the package pybik and do not care
about the dependencies, it will be resolved automatically.

You can also do this in a Terminal:
  sudo add-apt-repository ppa:barcc/pybik
  sudo apt-get install pybik


== Source directory ==

Pybik should run fine directly from source directory.

To build the extension module, manpage and translation files, run:
    ./build_local.sh


== System-wide installation ==

To install properly, run:

    ./setup.py install

See --help for an overview of the available options; e.g. --prefix to
install to a custom base directory, and --without-gettext to avoid
installing natural language support files.


