= Papywizard Installation Guide =

 * [#Installation Installation]
  * [#Linux Linux]
  * [#Nokia Nokia]
 * [#Configuration Configuration] 

''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
}}}

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

You also need the python catalogue:

||''Name''||Maemo extra||
||''Address''||!http://repository.maemo.org/extras||
||''Distribution''||bora (770/N800) or chinook (N810)||
||''Component''||free non-free||

or from :

 * [http://www.gronmayer.com/it/index.php?lang=en&system=maemo3 for OS2007] -- 770 (with HE) and N800 (original firmware)
 * [http://www.gronmayer.com/it/index.php?lang=en&system=maemo4 for OS2008] -- N800 (upgraded firmware) and N810

''Note 1: on the 770, you need to install '''OS-2007 HE''' firmeware, in order to run python2.5. Then, you have to manually install '''python2.5-runtime''' package with apt-get (from xosso-xterm) before installing Papywizard.''

''Note 2: on N800 and N810, you first need to install '''maemo-python-device-env''' package, from the application manager, before installing Papywizard.''

Then install Papywizard. For more informations about Nokia setup, see this [http://www.autopano.net/wiki/action/view/Install_Papywizard_on_Nokia_770_N800_N810 App wiki page].

== Configuration ==

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