[[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
 * [http://pyserial.sourceforge.net pySerial] -- serial bus access for python
 * [http://code.google.com/p/pybluez pybluez] -- bluetooth python wrapper
 * [http://www.vpython.org Visual Python] -- 3D Python project (optional)

=== 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 ===

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. Add this catalogue entry in the '''Application Manager''':

||''Name''||gbiloba.org||
||''Address''||!http://www.gbiloba.org/debs||
||''Distribution''||bora||
||''Component''||free||

or click [attachment:gbiloba.install?format=raw here].

Now, you 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. Once it is done, just open the Application Manager, and install Papywizard as any other application. For future updates of the stable release, you will just need to use the Application Manager.

''If you want to install the dev. release of Papywizard (branch 1.9.x), you need to install !PyQt for maemo. See [http://pyqt.garage.maemo.org/installation.html here].''

=== Windows ===

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

== Configuration ==

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