KitchenSync

From OESF

Taken from http://www.handhelds.org/~zecke/kitchensync.html

What is needed

In order to compile kitchensync currently you need to have KDE 3.1 (or any later Version) running. At least kdelibs and kdepim including kaddressbook and korganizer should be included. On the device side a current version of OPIE is needed too ;).

Compiling

For compiling KDE and Qt please look at KDE. To compile KitchenSync you need to untar the tarball and do:

cd kitchensync

Configure it like this:

./configure --prefix='kde-config --prefix' --enable-debug

Note: Set --prefix to the root of your KDE distribution, usually it's /usr ie, kde libs are in /usr/lib, apps in /usr/bin, etc...

run 'make'

wait... wait some more... when it's done, run 'make install' as root then run 'kitchensync' as your normal user

Setting it up

KitchenSync is a complete framework. It's goal is to sync anything with anything. This is why KitchenSync is not limited to one device.

On the Opie device:

Make sure to use the Security Settings Application to allow a Connection from the host to the device.

On the host side:

The first screen you see will be blank with a red background. This means that it has never been set up before. First, you need to set up your device. Click on the 'Settings' menu, then on 'Configure Devices' 'Add' a new device Chose the 'Qtopia' Connector Click 'Next' For 'User' enter "root", for 'Password' enter "rootme" NOTE: Yes... the password is always "rootme", no matter what the root users password is. Enter the Zaurus' or iPaq's IP address/ hostname in 'Destination Address' Pick your 'Distribution' (Sharp Rom or OZ/Opie) Click 'Next' Give it a name, ie. "My Zaurus" Click 'Finish' Click on the 'Loaded' check box next to the device you just configured and click on 'Ok' Now we can add your profile In the main window Click on 'Settings' menu Then 'Configure Profiles' Click 'Add' Give it a name, ie. "My Profile" Select the 'Parts', for now just select all three Click on 'Finish' Click on 'Ok' Now we configure your profile Click on 'Settings' menu Then 'Configure Current Profile' Enter the path to your saved kOrg calendar file ie. /.kde/share/apps/korganizer/MyCalandar.ics Click on ok Select your Connection in the first dropdown box, and your profile in the 2nd one. Click on the plug icon in the lower right hand corner of the window to try to connect. you should see a message like "Successfully authenticated." in the log window, and the plug should show as connected. Hit the sync button, you should be up and running.

Known Issues Addressbook: No known issues. Events: I simply ignore Alarms currently. Todos: No known issues... Test and it might change

Common errors

   * You do not have a compiler installed
   * You're missing one of the development packages of your distribution.
   * When events and todos do not get synced check if you told the OrganizerPart where to find the organizer.
   * If KS is not able to connect to the device check if you're device allows connections. Opie Security App
   * If you can not create any parts make sure you installed KS into $KDEDIR
   * If KS fails to download Categories.xml make sure that your KDE proxy settings are disabled for the Zaurus!
   * If uploading and downloading takes too long check if the Categories attribute inside the XML files is filled with duplicates. KitchenSync-0.0.6 fixes this problem