blueZync manual

This is the manual for blueZync 0.1.6. See also Manual for latest blueZync version.

blueZync manual

blueZync is still in it's very early days, and contains lots of bugs.
Please back up all your data before using blueZync

In this manual you will find:

• Install blueZync
• Using the blueZync 4 thunderbird extension
  • blueZync 4 thunderbird error messages
• Mozilla plugin for OpenSync

Questions and comments are most welcome.
Please use the blueZync Users Discussion Forum

Install blueZync

• First of all, you will need at least version 0.34 of OpenSync.

It is not likely to be available in your distro's package manager. You can download it here and install it with

cd /usr/local
tar xjf libopensync-0.34-Linux.tar.bz2

• Second, you will need the mozilla-sync plugin

It is not likely to be available in your distro's package manager. You can download it here and install it with

cd /usr/local
tar xjf libopensync-plugin-mozilla-0.1.6-Linux.tar.bz2

• Third, you must set up the path for the dynamic linker

Different distro's have different library paths
You must set LD_LIBRARY_PATH correctly!

Depending on your distro and where you downloaded and installed blueZync, set the correct linker path:

export LD_LIBRARY_PATH=/usr/local/lib:/usr/lib/thunderbird-2.0.0.6/:/usr/local/lib/opensync/formats

Obviously you must run Thunderbird from a commandline where the above are defined. (Thunderbird will find /usr/lib/thunderbird-2.0.0.6/ or whatever by itself, but not the others)

• Last, you will need the blueZync4thunderbird extension for Thunderbird

You can download it here. Then start Thunderbird, and install it using Tools -> Add-ons -> Install

Using the blueZync 4 thunderbird extension

If the installation went well, you should now have two new menu entries in Thunderbird under Tools:

• blueZync - Settings
• blueZync - Synchronize

blueZync 4 thunderbird settings

In Thunderbird, select Tools -> blueZync - Settings

You might get an error message here - please see blueZync 4 thunderbird error messages

The blueZync4thunderbird settings window has two parts:

• a list of synchronization groups on the left
• information on the selected synchronization group on the right

If this is your first time using blueZync4thunderbird, both will be empty. Click Add group

On the panel to the right, you can now set:

• the address book to synchronize
• the calendar to synchronize (if you have lightning)
• the plugin to use
• configuration for the plugin to use

blueZync 4 thunderbird error messages

Unable to load OpenSync library (Null)

This indicates a problem with dynamic loading of libraries.

• Please make sure that your LD_LIBRARY_PATH is set correctly, as described above: Install blueZync.

Depending on your thunderbird profile directory, please try

cd /home/someone/.thunderbird/ab1cde23.default/extensions/blueZync@KaarPoSoft.dk/components
ldd libBlueZync.so

Any not-found must be resolved.

Depending on your prefix, please try

cd /usr/lib/opensync/plugins
ldd mozilla-sync.so

Any not-found must be resolved.

If you encounter this error
You must uninstall and then re-install the extension!
Sorry about this, but that's how Thunderbird works

Getting more information about errors

export OSYNC_TRACE=/some/directory

Check out the logfiles generated. Look for something like <--- ERROR --- osync_module_load:

If you post the output of the ldd command and the (relevant parts of) the logfiles on the blueZync Users Discussion Forum we will see if we can help...

Mozilla plugin for OpenSync

First of all, please see Install blueZync

• you must have the Gecko Runtime Environment known to ldconfig or in your LD_LIBRARY_PATH

As root execute the command ldconfig -p | grep libxpcom.so If you see .../libxpcom.so listed, everything should be OK. Otherwise you will have to export LD_LIBRARY_PATH="xxx" where xxx is the directory of libxpcom.so

Different distro's have different library paths
You must set LD_LIBRARY_PATH correctly!

Depending on your distro and where you downloaded and installed blueZync, set the correct linker path:

export LD_LIBRARY_PATH=/usr/local/lib:/usr/lib/thunderbird-2.0.0.6/:/usr/local/lib/opensync/formats

The mozilla-sync configuration file

<?xml version="1.0"?>
<config>
	<!--	gre-directory is where the xpcom library lives.
		The directory should also have a subdirectory called "components" -->
	<gre-directory>/usr/lib/thunderbird-x.y.z.w</gre-directory>

	<!--	profile-directory is where the user's thunderbird profile lives.
		Use the full pathname. Tilde ~ is *not* recognized.  -->
	<profile-directory>/home/someone/.thunderbird/ab1cde23</profile-directory>

	<!--	Below you can give an addressbook-file, a calendar-id, or both -->

	<!--	addressbook-file is the name of the addressbook file.
		Should have .mab extension.
		Relative to profile-directory -->
	<addressbook-file>abook.mab</addressbook-file>

	<!--	Identifier of the Mozilla calendar.
		Under the profile directory there should be a file called storage.sdb
		This file contains the Mozilla calendars.
		Try the shell command sqlite3 /home/someone/.thunderbird/ab1cde23/storage.sdb
		And in this sqlite3 command window give the command 
		SELECT p.value, c.uri FROM cal_calendars AS c
			LEFT JOIN cal_calendars_prefs AS p ON c.id=p.calendar WHERE p.name='name';
		The identifier is given in the URL after moz-profile-calendar://?id=
		If the URL has no ?id= the identifier is zero -->
	<calendar-id>1234</calendar-id>
</config>