# The &kandy; Handbook

Cornelius
Schumacher

    schumacher@kde.org

2002-02-05
0.03.00

&kandy; is an application for synchronizing the data on a mobile phone with the data on the desktop.

KDE
kdepim
kandy
synchronizing
phone

## Using &kandy;

### The Terminal Window

The terminal window provides a low-level interface for controlling the mobile phone via `AT` modem commands. You can type in commands in the upper middle field: the lower-middle fields show the direct response of the mobile phone; the right side of the main window shows the processed output.

On the left side you have the list of available commands; you can execute them by double-clicking on them or by pressing the Execute button. The modem response output fields show what happens. If you have typed in a new command you can add it to the list of available commands by pressing the Add button; a dialog will pop up to allow you select a name and parameters for the command.

The command list is saved to an &XML; file by selecting Save from the menu or by pressing the corresponding toolbar button. You can load an existing file by selecting Open from the menu.

### Mobile Interface Window

By choosing Mobile GUI from the Show menu of the terminal window you open the Interface Window for your mobile phone. This shows a comprehensive view of the status and data present on the phone including the phonebook. There are twos list of phonebook data: one representing the &kde; address book; the other representing the data on the phone.

You can read the phone books by pressing the Read button right under the corresponding list. By pressing the Write button you write back the data shown in the list to the corresponding phonebook. By pressing Save to File you can store the mobile phonebook as list of comma-separated values to disk. After loading the phonebook data using the Read buttons you can merge the phonebooks by pressing the Merge button: this will put data only present in one of the phonebooks into the other and vice versa; if conflicts occur during this process, a dialog pops up.

The Sync button performs all the actions needed for syncing the phonebooks. It reads the data from the &kde; addressbook and the mobile phone, does the merge and writes it back.

### Configuring &kandy;

By selecting the entry Configure Kandy from the menu you get the preferences dialog of &kandy;. You can set the name of the serial device where your mobile is connected in this dialog; examples for the name of the serial device under &Linux; are `/dev/ttyS0` for the first and `/dev/ttyS1` for the second serial interface of your computer. You can also set which windows are opened by default when starting &kandy;.

## Menu Reference

### File menu

&Ctrl;Q File Quit

  Exit &kandy;.

### Show Menu

Show Terminal

  Open the terminal window, where you can interact with your phone via `AT` commands.

### Modem menu

Modem Connect

  Connect to your phone.

Modem Disconnect

  Disconnect from your phone.

### Settings menu

Settings Show Toolbar

  Toggle whether the toolbar should be displayed.

Settings Show Statusbar

  Toggle whether the statusbar should be displayed.

Settings Configure Shortcuts...

  Open a standard dialog to modify shortcut keybindings.

Settings Configure Toolbars...

  Open a standard dialog to modify the icons on the toolbar.

Settings Configure Kandy...

  Opens a dialog where you can customize the application.; this is described further in the section.

### Help menu

&help.menu.documentation;

## Credits and Licenses

&kandy; copyright 2001 Cornelius Schumacher schumacher@kde.org.

Documentation by Cornelius Schumacher, with additions by Lauri Watts lauri@kde.org.

&underGPL; &underFDL;

## Installation

### How to obtain &kandy;

&install.intro.documentation;

### Requirements

You will need to have the kdelibs package installed in order to successfully compile the kdepim package that contains &kandy;. The kdelibs package may be found at the same location as the kdepim package.

The &kaddressbook; is part of the kdebase package. This can also be found at the same location as the kdepim package.

### Compilation and Installation

&install.compile.documentation;

Compiling and installing the required kdelibs package follows the same process. If you encounter any problems compiling or installing &kandy;, help may be obtained from the &kde; mailing lists or from the Usenet newsgroup: comp.windows.x.kde.

## Developer Information

### DCOP Interface

&kandy; provides a DCOP interface KandyIface with the following functions: `syncPhonebook()` syncs the mobile phone book book with the &kde; address book. This is equivalent to pressing the Sync button in the Mobile Interface Window. `exit()` closes &kandy;.