ADDSYNC

Updated: 2007-06-15
Index

NAME

addsync - synchronize your mobile's phone book with KABC using Gammu

SYNOPSIS

addsync

DESCRIPTION

addsync reads your mobile's address book and synchronizes it with a KABC address book. New entries can be added to both sides and existing but different entries can be merged or ovrerwritten.

Caution:: This software is (perhaps still ;-) quite experimental. Anyway, it has always been working as it should with my Nokia 6230i. I don't know if it works just as fine with other mobiles.
You're welcome to test it and contact me if there are problems. But use it with care ;-)

REQUIREMENTS

The Gammu engine (http://gammu.org/) is used to connect the mobile phone, so you need a working Gammu installation. Aditionally, the Gammu Python bindings (found at http://cihar.com/gammu/python/) and the KDE bindings for Python (http://riverbankcomputing.co.uk/pykde/) are needed. The cfgparse Python module (found at http://cfgparse.sourceforge.net/) is also used (and not a part of the standard Python installation).
And you need Python, of course :-)

CONFIGURATION

addsync does not take any command line parameters. The configuration is stored in ~/.addsync. This file will be created with a commented sample configuration the first time addsync is run. It's syntax is parameter = value.
The following values can be set:

resource: This is the name of the KABC address book that will be synced with the mobile's address book.

The following settings define custom fields that contain an optional custom name for an addressee to be used on the mobile and the ME memory location of each entry. If "KADDRESSBOOK" is used for the "_app" parameter, the field will be visible in kaddressbook (which makes sense for a mobile name). The "_id" parameter defines the field name.

mobname_app: The application identifier for a name to be used on the mobile instead of the name used in KABC.
mobname_id: The parameter name for the mobile name.
location_app: The application identifier for the entry containing the entry's ME memory location on the mobile.
location_id: The parameter name for the ME location entry.

USAGE

Be sure to have a working Gammu installation. Try to read some data from the mobile before using addsync. E. g. do something like

gammu --getmemory ME 1

or so to test if you can actually read the phone's address book. Then just run addsync. It will inform you about all differences between the phone's address book and the KABC address book and ask you what to do.

AUTHOR

Tobias Leupold <tobias . leupold at web . de>

This document was created by man2html, using the manual pages.
Time: 10:03:08 GMT, June 17, 2007