[[PageOutline(2-5, Table of Contents, floated)]]

= Installation guide =

''This installation guide refers to the stable release of Papywizard.''

== Dependencies ==

Papywizard is entirely written in python, and uses some third-party modules:

 * [http://www.pygtk.org PyGTK] -- GTK+ for Python (for branch 1.x)
 * [http://www.riverbankcomputing.com PyQt] -- Qt for Python (for branch 2.x)
 * [http://pyserial.sourceforge.net pySerial] -- serial bus access for python
 * [http://code.google.com/p/pybluez pybluez] -- bluetooth python wrapper (linux and Windows)
 * [http://lightblue.sourceforge.net lightblue] -- bluetooth python wrapper (MacOS)
 * [http://www.vpython.org Visual Python] -- 3D Python project (optional, not used anymore in versions >= 2.1.7)

== Core ==

=== !Gnu/Linux ===

From sources:

{{{
$ python setup.py install --prefix=/usr/local
}}}

Debian/ubuntu packages are also available; just use '''{{{dpkg}}}''' to install them.

=== Maemo ===

You first need to read this [http://www.autopano.net/wiki/action/view/Install_Papywizard_on_Nokia_770_N800_N810 APP wiki page], and setup your Nokia device so the python 2.5 runtime is correclty installed.

For Papywizard v2, you need to install !PyQt for maemo, instead of PyGTK. See [http://pyqt.garage.maemo.org/installation.html here].

As maemo is based on gnu/linux, it is possible to install Papywizard through distutils tools (see previous section). However, it is easier to install the debian package. For that, just click on the package file name you want to install (from the [wiki:WikiStart#Download download page]).

''Note: the gbiloba.org catalogue has been removed.''

=== Windows ===

No major problem, here. Just click on the installer, and follow the instructions.

=== MacOS ===

''Need some explanations.''

== Configuration ==

No external configuration is needed; all parameters can be modified from the Papywizard Configuration dialog.