The GPE multisync Plugin [V 0.2 Florian Boor, 30.06.2004]

* What it provides

The GPE Multisync plugin is used to syncronize GPE PIM data 
with other devices and software.
It currently supports syncing tasks (ToDo/gpe-todo), events 
(Calendar/gpe-calendar) and contacts (Contacts/gpe-contacts). 
Apart from GPE, Multisync provides syncronisation against Ximian Evolution, 
devices that use SyncML (over TCP/IP), Palm PDAs, Opie based PDA
software and IrMc ddevices. 
Additionally it is possible to create backups using multisync.

* Requirements
 - TCP/IP connection between PC and PDA.
 - SSH client on PC (e.g. ssh/openssh)
 - SSH server on PDA (e.g. openssh, dropbear - installed on all Familiar
images) 
 - Multisync and GPE Multisync plugin.
 - libglade

* Installation on PC
At the moment writing this no common Linux distribution ships the GPE
multisync plugin. Usully you want to install Multisync and its plugins using
the usual installation method of your distribution. e.g. on a debian system
you would use apt and type "apt-get install multisync
libmultisync-plugin-all". 

If you use a x86 based linux PC, this may help:
I'll try to provide an up to date package containing all necessary binaries
here:
http://handhelds.org/~florian/multisync/gpe-multisync.tar.gz

If this doesn not work four you, you'll need to build yourself.
After installation of Multisync grab latest source files from GPE FTP
server (ftp://ftp.handhelds.org/pub/projects/gpe/source), compile and install 
them. You will need to install in this order:
 - libgpevtype
 - libnsqlc
 - gpe-multisync

At the moment these files are latest versions:
ftp://ftp.handhelds.org/pub/projects/gpe/source/libgpevtype-0.4.tar.gz
ftp://ftp.handhelds.org/pub/projects/gpe/source/libnsqlc-0.2.tar.gz
ftp://ftp.handhelds.org/pub/projects/gpe/source/gpe-multisync-0.1.tar.gz

To build these sources cd to the source directory and use "make PREFIX=/usr"
to build the libraries. Install them with "make install".
This assumes you have all necessary development stuff (compiler, libraries)
installed.


Last step ist to check if you have a ssh client installed. Most common
distributions install one per default. If you have a command "ssh"
everything is fine.


* Setup on PDA

If you have an up to date Familiar linux installed, the setup is easy. 
Fist step should be to set up an IP connection to your PDA, how to do this
is described in other documents.
Second step is to install latest nsqld package from unstable feed. 
To do this make sure you have unstable familiar feed in your ipkg.conf
(which is default if you flashed an unstable image).
Set up an internet connection and run "ipkg update" and "ipkg install nsqld"
an your PDA. If you are not able to set up an internet connection, download
latest nsqld package from http://handhelds.org/feeds/unstable, transfer it
to your PDA and install it. 
Because gpe-multisqnc only supports public key authentication you will need
to copy your public key from PC to your PDA and add it to the file
~/.ssh/authorized_keys. The public key is usually located in
~/.ssh/id_dsa.pub. If you don't have this file generate a key using
"ssh-keygen". If you previously established the IP
connection you may copy the key in this way:
scp ~/.ssh/id_dsa.pub <username>@<ip of PDA>:/tmp
ssh <username>@<ip of PDA>
(then, on PDA)
cat id_dsa.pub >> ~/.ssh/authorized_keys

After this press <Ctrl>+D to log out from your PDA.
Installation is finished now.

* Setup Multisync
Start Multisync and add a syncronisation pair ("New").
Select GPE as first sync plugin and a second plugin to use. The GPE plugin
takes two configuration options: 
 - Hostname: IP address or hostname of your PDA
 - Username: Username to use on your PDA

After you set up the second plugin you are finished. Make sure your IP
connection is up, start syncronisation and hopefully become happy.

I wrote this from memory, it definitely contains bugs, feedback is very
welcome!

