[[TOC]]

= Papywizard Installation Guide =

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

== Installation ==

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)

=== Linux ===

As most distributions come with python and all needed modules (just install them through your application manager), there is no need to pre-build a package. Just install it with distutils tools:

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

''Note: a debian package should come soon.''

=== Nokia ===

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 Nokia is based on 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.