= 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, through the maemo application manager. Add this repository entry in the application manager:

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

You also need the python repository:

||''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 dpkg (from x-term) 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.''

== Configuration ==

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