= Papywizard Installation Guide =

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

''This installation guide refers to the stable release of Papywizard; installation of the developpement branch can be found [InstallationGuideSvn here]''.

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

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

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

== Configuration ==

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