Using
Once is installed it needs to be configured to match your hardware. The conduits need to be configured as well. After that you can use to synchronise your with your desktop or view data from your with the builtin applications.

Configuring
Once is installed it is easy to set up. Run from either the panel menu or from the command prompt and it will prompt you with a dialog box asking you to configure it for the first time. This configuration dialog can be requested later from the Settings Configure menu or by starting from the shell as follows:

$  kpilot --setup

In addition, if you upgrade and some new configuration options require your attention, this setup dialog will reappear.
A full description of the setup dialog can be found below.
Once is properly set up, pressing OK will bring up the main window. The first thing you should do is make a full backup of the . Do this by selecting File Backup or the toolbar icon Full Backup . When you do, the status bar will ask you to press the button on the cradle. Assuming everything is set up properly you should see the begin to sync and a message box telling you what databases are being backed up. This will back up your entire into your local directory. Note that this may take a little while, however a normal operation is significantly faster.

General page
This is a setup page that contains options describing the hardware, you, the user and how you want the various parts of to be started.
General page
The General setup page
The General setup page
Pilot Device 	 This is the serial port that the cradle is connected to. By default it is set to /dev/pilot which should be a symbolic link to the proper serial port. Make sure the serial port has the correct permissions. It must be read/write by all if is intended to be used by a normal user! This is done by doing a chmod 666 device where device is the correct serial port. See also the FAQ for more information about setting up the device. / USB cradle users see the FAQ as well!
Speed 	 This indicates the speed of the serial connection to the . For an older model , choose 9600. Newer models may be able to handle speeds up to the maximum listed, 115200. You can experiment with the connection speed: the manual suggests starting at a speed of 19200 and trying faster speeds to see if they work.
Pilot User 	 This is the user name of the . By default this name is the same as your log on name. When you first sync with the will check to see if this name matches the one on the . If they do not, you are asked to pick which you will use. If you pick the local name, the will be changed to match. This is also used to store the information synced from the . For example, if I were to HotSync my on your machine, it would store the data into a subdirectory named pilone.
Start HotSync Daemon at login 	 By enabling this a link to the daemon is placed in your autostart folder and will be started automatically. Note that this is not normally needed if the daemon is docked in the panel.
Start KPilot at HotSync 	 When the button is pressed on the cradle (assuming the daemon is running) can sync without actually starting up the . However, by enabling this option the daemon will start up the when the operation begins.
Show Daemon in 	 This option lets the daemon place a little HotSync icon HotSync icon . in the system tray. This icon has a menu that can be brought up with the right mouse button, for performing a and the like. Without this option, the daemon is not visible to the user at all.
Stop Daemon on exit 	 Setting this option will cause the daemon to exit when you quit , leaving the serial port free for other -syncing tools such as malsync
For a fully visible installation, enable Start KPilot at HotSync and Show Daemon in while disabling Stop Daemon on exit. To make all but invisible, disable all the options except Stop Daemon on exit.

Address page
The address page contains settings specific to the built in address book viewer. Note that this address book has nothing directly to do with the address book, your email address book, or anything else. Connections with those address books could be provided by conduits. The kaddressbook conduit can sync your with the address book.
Address page
The Address setup page
The Address setup page
Import Format 	Export Format 	 can import and export the address database to or from a text file. These two fields determine the format the file is written in (for export) or must have (for import). You can list the fields of the address book, separated by commas. The names of fields are described below.
Noone really uses the CSV import and export for the address book, so leave it alone.
Address display 	 This set of radio buttons determines how addresses are displayed and sorted in the address book. This is similar to the setting in the itself where addresses can be sorted based on company or on last name.
Both the import and the export format are lists of field specifiers separated by some delimiter (usually a comma). Note that all fields must be separated by the same delimiter. For import formats: Field specifiers are three-character strings that begin with a %. Field specifiers %CC are used to indicate that in the imported data the data for the corresponding field is to be found there (as a string that does not contain the delimiter character). The following field specifiers are supported:

Address Format Specifiers
Specifier	Field
%LN	Last name
%FN	First name
%CO	Company
%P1,%P2,%P3,%P4,%P5	Phone numbers 1 through 5
%AD	Address
%CI	City
%ST	State
%ZI	Zip (Postal code)
%CT	Country
%TI	Title
%C1,%C2,%C3,%C4	Custom fields

DB Specials page
This page contains settings specific to the databases works with.
DB Specials page
The DB Setup page
The DB Setup page
Show Secrets 	 In your you can mark some records as private. By default, does not display these records on the screen. If you want to see them, turn this option on.
Backup only: 	 This text field can be used to list databases that should not be synced, only backed up. Note that you have to fill in the database creator, not the name of the product, so for Handbase databases you fill in PmDB. Multiple databases should be separated by commas. See the FAQ for a list of databases that should be listed here (the default should be OK though).
Skip 	 This text field lists databases that should not be backed up nor synced, in the same format as the backup only field.
Changing the contents of the Backup Only: or Skip fields, in particular removing the databases already listed there, can damage those databases when you perform a .

Sync page
The sync page contains preferences relevant to the operation on your .
Sync page
The Sync page
The Sync page
Sync Files 	 When this is enabled any files dropped into the file install (either the icon docked on the panel or into the file installer in ) will be installed on the during the next HotSync.
Local overrides Pilot 	 When a record has been modified on both the and the local side, only one can be kept. By default assumes the has the most recent information and will keep that. By enabling this option assumes it has the most recent information and will overwrite the 's copy.
Force first-time sync every time 	 Under some circumstances — you have many PCs and many s — you may want to perform a "cleaner" HotSync every time instead of the "quick-and-dirty" HotSync that does if you just have one and one PC. Just when you want to enable this option is a matter of personal preference.
Do full backup when changing PCs 	 If you have more than one PC and synchronise your with each of them you may want to disable this option. When you change PCs it is a good idea to perform a full backup, since otherwise your KDE desktop will not reflect the state of your accurately. (This is a limitation of the itself.) On the other hand, performing a full backup can be time-consuming and annoying, which is why you can disable such a backup here.
Prefer FastSync to HotSync 	 While a HotSync is faster than a full backup, a FastSync is faster still than a HotSync and synchronises only those databases that have conduits. This means that any database without a conduit is not backed up and not synchronised. This also means that if something goes wrong with your , you may not be able to recover databases with no conduit. This is a classic trade-off between speed and safety.

Main Window
The main window in just contains the logo. You can switch to one of the builtin applications by using the View menu.
Main Window
The Main Window
The Main Window
The main window contains the application menu, which we will deal with here.
File HotSync 	 Starts a . You should press the HotSync button on your 's cradle.
It is not possible to cancel a once the request has been made.
File FastSync 	 (not available with all installations) Starts a FastSync in the same way that a is started.
File Backup 	 Performs a full backup of your . This is like a , but can take several minutes.
The first thing you should do after starting for the first time is make a full backup.
File Restore 	 This copies all the data on your PC to your , replacing whatever data was there. Use this if your suffers some catastrophe (or is replaced by a new one).
Doing a restore will erase all data on the before restoring the information from your PC!
File Quit 	 Quits , closing the main window and stopping the daemon if that configuration option is enabled.
The View menu allows you to choose a database viewer or 's main page.
View 	 Displays the logo page. This puts in the state shown in the picture above.
View Memo Viewer 	 Displays the internal memo viewer. See below for more information on the memo viewer.
View Address Viewer 	 Displays the internal address book viewer. You can view and edit addresses with the address book viewer. See below for more information.
View File Installer 	 Displays the file installer. You can drag files onto the file installer to install them on your . See below for more information.

Builtin Applications
The builtin applications can be selected : by selecting the application from the Conduits menu, for example Conduits Memo .
Selecting one of the builtin applications will cause that application to appear in 's main window. Any changes you make to the databases with the builtin applications (such as deleting a memo) do not take effect on the until the next HotSync.

The Memo Application
The memo application allows you to view the memos on your , export them to text files, import new ones to be installed the next time you , or edit existing ones.
Memo Application
The Memo Application
The Memo Application
The memo application has a drop-down box for the memo categories defined in the . Here category "All" is selected. Underneath the drop-down box is a list of memo titles. These are the first lines of the memos, just like in the memo application. Clicking on one of the memo titles in the list box will display it in the text box labelled Memo Text: to the right.
When a memo is selected you can use the buttons Export Memo and Delete Memo to export the selected memo to a file or to delete the selected memo. Exporting a memo requires you to give a filename; the memo is written to that file. Take care not to overwrite existing files with this action. Deleting a memo does not affect the until the next .
The Import Memo button allows you to read a text file and add it — as a memo — to the . Importing a memo does not take effect until the next . Note that if you import a memo and decide that you do not want to have it on the you must perform a (copying the memo to the ) and then delete the memo from the . It is not possible to delete newly-added memos from the builtin memo application.

The Address Utility
The address viewer lets you view, import, export and edit addresses to and from the . The import and export format is configurable via the settings dialog. Note that the first field in the import format is used as the Key Field. That is, if Use Key Field is turned on in the settings dialog, when importing if sees another record with a matching Key Field the existing record is updated to reflect the new data being read in. If no such record exists, a new record is created. The default is not to use the Key Field, so every record read in from the import file is created and added to the database.
The Address Application
The Address Application
The Address Application
The address application resembles the memo application; the drop-down box, list and text area function exactly the same, allowing you to select and view an address as on the .
You can use the buttons to enter new records into the address book, delete addresses or changes addresses. The button Import List lets you read a text file containing records in comma-separated-value format (with the fields in the particular order described by the Address Import setting) and add those records to the address book. The Export List writes all the addresses in the address book to a file in the format given by the Address Export setting.

The File Installer
The file installer supports dragging and dropping of files into the file list area or just hit the Add File button to add a file if you are not. These files will be installed on your during the next if Sync Files is checked in the settings dialog. If you choose not to install the files on the , just hit Clear List to remove any pending files.
An internal copy of the file is kept, so you can even drag and drop s from !
Also, if you are using the Daemon you may drag and drop files or s onto the docked icon on the tool bar. Provided Sync Files is checked in the settings dialog they will be installed the next time you HotSync.
The File Installer
The File Installer
The File Installer

Conduits
Conduits can be external programs, written by third parties, to interface your to any application imaginable.
Conduits can be set up by selecting Settings Configure Conduits . This allows you to select which conduits to run during a and to configure those conduits. A window similar to the following will be displayed:
The Conduit Setup Dialog
The Conduit Setup Dialog
The Conduit Setup Dialog
You can drag-and-drop conduits between the two branches of the tree (from Available to Active and back again). Only those conduits listed under Active will actually run during a HotSync. Click on a conduit to configure it.

Mail Conduit
This conduit allows you to send and receive email. The configuration of the Mail Conduit is fairly complex.
Setting up the Mail Conduit
The Mail Conduit Setup Dialog
The Mail Conduit Conduit Setup Dialog
There are two tabs in the setup dialog for the Mail Conduit, one for Sending mail and one for Receiving mail.

Sending Mail
Setting up the Mail Conduit
Choosing the Send Method
Choosing the Send Method
Depending on which send method you choose, different fields will be activated in the remainder of the tab, allowing you to enter the necessary information.
Setting up the Mail Conduit
General mail configuration: who are you?
General mail configuration: who are you?
Your email address can be entered in the Email Address field. This is the email address that goes in the From: line in outgoing mail. If you enter a file name in the Signature File field then that file will be appended to each outgoing mail as a signature.
Setting up the Mail Conduit
configuration
configuration
The configuration of the method of sending is fairly straightforward. Check the path to your installation of , for example by typing which sendmail in a window. The options to should not need to be changed, but you can if you like.
is not provided with destination addresses on the command line, so you must specify the -t. If you are using a non- MTA like Postfix then the equivalent extract recipients from message headers option must be given.
Setting up the Mail Conduit
SMTP setup
SMTP setup
To use SMTP sending you need to specify the name of the machine which runs your SMTP server, and the port number to connect to. The default port number of 25 is almost always correct.
does not use the SMTP configuration of the SMTP IOSlave. This may change in a future version of .
Setting up the Mail Conduit
sending
sending
When sending mail through , automatically places it in your outbox. saves mail in the outbox until you request that those pieces of mail are really sent. Check the Send mail through immediately to let the Mail Conduit tell to send all mail from the outbox as soon as it it done HotSyncing. This has the side effect of also sending any other pieces of mail that may be in your outbox.

Receiving Mail
Setting up the Mail Conduit
Choosing the Receive Method
Choosing the Receive Method
Depending on which send method you choose, different fields will be activated in the remainder of the tab, allowing you to enter the necessary information.

Calendar Conduit
This conduit will synchronize your with . The conduit needs two pieces of information: the filename of the calendar file (this will usually be a file that ends in .vcs under .kde/share/apps/korganizer/ under your home directory) and whether or not to ask before changing data in that calendar file.
The Calendar Conduit Setup Dialog
Calendar Conduit Setup
Calendar Conduit Setup
You can usually leave Prompt before changing data off.

To-do Conduit
This conduit synchronizes with 's todo list. The configuration dialog looks exactly the same as the configuration dialog for the Calendar Conduit.

Conduit
The Conduit is a partial replacement for the builtin memo application. It keeps the notes you write with synchronized with the memos you write on your .
Setting up the conduit is very simple, since there is only one configuration option.
Conduit Setup
Conduit Setup
Conduit Setup

Conduit
The conduit allows you to synchronize the address book with your address book.

NULL conduit
The NULL conduit is included as a programming example and has no practical function whatsoever.