Cornelius Schumacher
Kandy is an application for synchronizing data on a mobile phone with the data on the desktop.
Table of Contents
Using Kandy
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 shows the direct response of the mobile phone. In the right side of the main window the processed output is shown.
On the left side you have the list of available commands. You can execute them by double-clicking or 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 pops up, which lets you select name and parameters for the command.
The command list is saved to an XML™ file by selecting Save from the menu or 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 two list of phonebook data, one representing the KDE address book and 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-seperated 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 combines 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 per default when starting Kandy.
Menu Reference
Show Menu
- Show->Terminal
Open the terminal window, where you can interact with your phone via AT commands.
Modem menu
Settings menu
- Settings->Show Toolbar
Toggle on or off the display of the toolbar
- Settings+Show Statusbar
Toggle on or off the display of the statusbar.
- 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 the section called “Configuring Kandy”.
Help menu
- Help->Contents... (F1)
Invokes the KDE Help system starting at the Kandy help pages. (this document).
- Help->What's This? (Shift+F1)
Changes the mouse cursor to a combination arrow and question mark. Clicking on items within Kandy will open a help window (if one exists for the particular item) explaining the item's function.
- Help->Report Bug...
Opens the Bug report dialog where you can report a bug or request a ‘wishlist’ feature.
- Help->About Kandy
This will display version and author information.
- Help->About KDE
This displays the KDE version and other basic information.
Credits and Licences
Kandy copyright 2001 Cornelius Schumacher <schumacher@kde.org>.
Documentation by Cornelius Schumacher, with additions by Lauri Watts <lauri@kde.org>.
This program is licensed under the terms of the GNU General Public License.
This documentation is licensed under the terms of the GNU Free Documentation License.
Installation
Kandy is part of the KDE project http://www.kde.org/.
Kandy can be found in the kdepim package on ftp://ftp.kde.org/pub/kde/, the main FTP site of the KDE project.
Requirements
You will need to have the kdelibs package installed in order to successfully compile the kdepim package that contains Kandy. The kdepim 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
In order to compile and install Kandy on your system, type the following in the base directory of the Kandy distribution:
% ./configure % make % make install
Since Kandy uses autoconf and automake you should have no trouble compiling it. Should you run into problems please report them to the KDE mailing lists.
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