# The &multisynk; Handbook

Tobias
Koenig

    tokoe@kde.org

2004-11-02
1.0
&FDLNotice;

&multisynk; is the &kde; synchronization application.

KDE
synchronization
handheld
OPIE
Qtopia

## Introduction

&multisynk; is a frontend for &kde;'s synchronization framework kitchensync. This framework let you synchronize a lot of mobile devices like handhelds and mobile phones with your KDE desktop, but also offers the possibility to synchronize two or more KDE desktops directly.

The graphical user interface is similar to multisync, so everybody who have ever worked with it should be familiar with multisynk as well.

## Using &multisynk;

### General Information

&multisynk; is based on the kitchensync framework. The purpose of this framework is to synchronize a couple of data records (events, todos, contacts), where the synchronization algorithm knows nothing about the data. The actual synchronization is done between a so called konnector pair. A konnector pair consists of two data providers (konnectors) which load the data from a source (a file, a mobile device or the network), hand it over to the synchronization engine and write back the synchronized data to the source.

Additionally every konnector pair can give the synchronization engine hints how conflict resolution shall be handled. Either it's done automatically (e.g. when a contact is changed on the PC and the handheld, always overwrite the contact on the handheld) or manually, then a dialog will appear where the user can choose which data record she wants to keep.

### Getting Started

After you have started &multisynk; (either using the panel menu or by typing `multisynk` at the command prompt) the &multisynk; main window will be displayed:

Starting &multisynk; The &multisynk; main window.

The &multisynk; main window.

From the menubar or the toolbar you can execute the following commands:

New

  Create new konnector pair.

Edit

  Edit the selected konnector pair.

Delete

  Delete the selected konnector pair.

Log

  Show the dialog which displays the log information of current synchronization process.

Sync

  Synchronize the selected konnector pair.

#### Add Konnector Pair

To add a new konnector pair just click on the first icon in the toolbar or select New from the File menu.

The following dialog will appear:

New Konnector Pair Dialog The new konnector pair dialog.

The new konnector pair dialog.

In this dialog you can select the konnectors which shall be part of the konnector pair, they can be configured by clicking on Configure... after selected the type. Additionally you can give the pair a name for better distinction in the konnector pair overview.

On the second tab of the konnector pair edit dialog you can choose how conflict resolution shall be handled.

New Konnector Pair Dialog The new konnector pair dialog.

The new konnector pair dialog.

The following behaviours are possible:

Resolve it manually

  A dialog will appear where you can choose which entry you want to keep.

Always use the entry from the first plugin

  Always the entry from the first konnector is used.

Always use the entry from the second plugin

  Always the entry from the second konnector is used.

Always put both entries on both sides

  The changed entries are duplicated on both sides.

#### Edit Konnector Pair

To change the settings of a konnector pair, just select it in the konnector pair overview and choose Edit... from the toolbar or menubar. The appearing dialog is the same like the one you get when adding a new konnector pair.

#### Delete Konnector Pair

To delete a konnector pair, just select it in the konnector pair overview and choose Delete from the toolbar or menubar. An confirmation dialog will show up and ask you whether you really want to remove the konnector pair.

#### Start Synchronization Process

After you have added a konnector pair, you can select it in the konnector pair overview and press the Sync button in the toolbar or choose the action from the menubar. The progress of the synchronization is shown by the status column in the konnector pair overview and the log dialog.

#### The Log Dialog

The log dialog collects all information of the synchronization progress and displays them with a timestamp in a separated window.

The Log Dialog The log dialog.

The log dialog.

&konnectors-chapter;

## Command Line Options

&multisynk; supports all command-line options common to &kde; and &Qt; programs; you can get a list of these options with ``--help``, ``--help-kde``, and ``--help-qt``.

## Credits and License

&multisynk; - The &kde; Synchronization Application

Copyright (c) 2004, Tobias Koenig

Currently it is maintained by Tobias Koenig tokoe@kde.org.

&underFDL;