Table of Contents

1. System Requirements
2. Installation
3. Registration
4. Getting Started
5. Backing Up
6. Syncing Calendars
7. Syncing Contacts
8. Tips and Tricks
9. Known Issues
10. Troubleshooting
11. Uninstalling
12. Restoring to Pre-Install State

• Spanning Sync 3 requires Mac OS X 10.5.3 or later and is compatible with Mac OS X 10.6 "Snow Leopard"
• Universal Binary runs natively on both Intel and PowerPC

  

• Compatible with all software and devices that sync with Apple Sync Services

Installing Spanning Sync is easy:

1. Quit System Preferences if it is open.
2. Download the latest version of Spanning Sync from spanningsync.com/download.
3. Open the downloaded .dmg file.
4. Read and agree to the licensing agreement
5. Double-click the Spanning Sync pref pane.
6. Select "Install for current user" or "Install for all users on the system", as appropriate.

You can try Spanning Sync free for up to 15 days. After the trial period, the software will stop synchronizing your data and prompt you to either register or uninstall.

To register, open the Spanning Sync preference pane, wait for the prompt, and click the "Buy" link. You must login to Spanning Sync using a valid Google Account and password in order for the prompt to appear. 

Once you've downloaded and installed Spanning Sync, you're ready to start synchronizing your calendars and contacts.

Click the Sign In button, then enter your Gmail or Google Apps email address and password.

Click the Sign In button to activate your account.

Spanning Sync syncs immediately whenever the calendars and contacts on your Mac change, but the schedule you select here guarantees a minimum interval for changes to be pulled down from Google.

If you'd like to begin a sync immediately, click the Sync Now button.

That's it! Your calendars and contacts are now automatically synchronized in both directions. If you are syncing any other devices or applications with calendars or contacts on your Mac, they will reflect new and updated events in Google Calendar.

Use the menu bar icon to manually start a sync, to check the time of the last sync, or as a shortcut to the preference pane. To turn the menu bar icon off, uncheck the "Show status in menu bar" checkbox in the preference pane.

Calendars and contacts can be among the most important things on your computer. While we've rigorously tested Spanning Sync, it's difficult to predict what will happen when several applications and devices are syncing the same data at the same time. For this reason, we highly recommend backing up your data.

To back up your iCal calendars, select "Back up iCal" from the File menu.

To restore your iCal calendars, select "Restore iCal" from the File menu.

To manually back up your Google calendars:

1. Login to Google Calendar and select Settings > Calendars > Export calendars.
2. A zip file containing ICS versions of all of your calendars will be downloaded to your computer.

To manually restore your Google calendars:

1. Login to Google Calendar and select Settings > Calendars > Import calendar.
2. Choose an ICS file on your Mac and a Google calendar to which they'll be added, then click Import. (Note that events will be added to the calendar you select, so you need to create a new calendar first to wind up with a calendar with only the events from your backup.)

To backup your Address Book, select "Export > Address Book Archive" from the File menu.

To restore your Address Book, select "Import > Address Book Archive" from the File menu.

To manually back up your Google contacts:

1. Sign in to Gmail.
2. Click Contacts along the left side of any Gmail page.
3. Click Export in the lower-left corner of your Contacts.
4. Choose whether to export all contacts or only one group.
5. Select the CSV format.
6. Click Export.
7. Choose Save to Disk then click OK.
8. Select a location to save your file, and click 'OK.'

To manually restore your Google Contacts:

1. Log in to Gmail.
2. Click Contacts on the left side of any Gmail page.
3. Click Import in the bottom-left corner.
4. Click Browse... and locate the CSV file you'd like to upload.
5. Select the file and click Import.

Syncing calendars from Apple's iCal to Google Calendar is easy. Before starting, you should already have created the iCal calendars and Google calendars that you wish to sync with each other.

In the Calendars tab of the Spanning Sync preference pane, you'll see a list of iCal calendars on the left and Google calendars on the right. To begin syncing a pair of calendars, select the checkbox next to the iCal calendar you want to sync and then choose the corresponding Google calendar from the pop-up menu.

Calendar pairs are always one-to-one. That is, each iCal calendar syncs with at most one Google calendar. Synchronization occurs in both directions unless one of the calendars is read-only (like a calendar of holidays or a shared calendar to which you have read-only access).

When you sync a calendar for the first time, all events from iCal are sent to Google and all events from Google are sent to iCal (assuming the sync method is set to "Sync both directions"; more about this later). Naturally, this kind of sync will take much longer than normal. 5-10 minutes is typical but a very large calendar with many thousands of events can take up to 30 minutes. Subsequent syncs will only take a few seconds.

Spanning Sync allows you to sync two calendars in a single direction, protecting one calendar from ever being modified by the syncing process. To do so, double-click the calendar pair to bring up the options panel and choose either "Sync to iCal" or "Sync to Google" from the "Sync method" popup menu. "Sync to iCal" means that data will only flow to iCal and the data on Google will never be modified. "Sync to Google" means that data will only flow to Google and the data in iCal will never be modified. Choosing "Sync both directions" enables traditional synchronization between both calendars. You can also change the sync method from the button bar at the bottom of the calendar list.

For large, older calendars you may be able to speed up the sync process by skipping over older events. To do so, double-click the calendar pair to bring up the options panel, check the "Do not sync events older than" checkbox and choose a number of days. Events older than that will not be synced, with one exception: recurring events are always synced.

iCal and Google Calendar both offer a variety of alarm options. If alarm syncing is enabled in the calendar options panel, then Spanning Sync will map existing iCal alarms to your choice of popup alarms, email messages, or SMS messages on Google Calendar. Existing Google Calendar popup alarms will sync to iCal as a message+sound alarm. Existing Google Calendar email message and SMS alarms will not sync since it's unlikely that you'd want to receive those alarms twice.

You can replace all existing events in a Google calendar with the contents of an iCal calendar by selecting "Replace Data on Google" from the Advanced tab of the Spanning Sync preference pane. However, care should be used when doing this as Google does not completely delete the calendar events for up to a week. Doing this more than once during that period can lead to a situation where the calendar account has gone "over-quota" with Google and further syncs will fail until Google purges the old data.

You cannot replace an iCal calendar with the contents of a Google calendar during a sync since Apple doesn't allow it. Instead, you can delete the existing iCal calendar, create a new one with the same name, pair it in the Spanning Sync preference pane, and sync.

Duplication can be a serious concern when synchronizing data across servers and devices. Spanning Sync uses specialized technology to prevent duplicate calendar events from appearing in iCal or Google. If duplicates do appear, there may be an issue with time zones or other devices and services that you sync with. Please see the troubleshooting section at the end of this document.

Spanning Sync keeps contacts in your Mac OS X Address Book synchronized with your Gmail contacts. Contact names, street addresses, phone numbers, email addresses, IM addresses, job titles, notes, and pictures are synchronized.

If you only want a subset of your Address Book contacts to sync, use the contact group feature of Spanning Sync.

In the above example, only contacts in the Address Book group "Businesses" will sync to Google and all new contacts from Google will be placed in the "Businesses" group. In this mode, contacts are deleted from Google only when they are completely deleted from Address Book, not when they are deleted from the Address Book group.

Syncing One-Way

Spanning Sync allows you to sync contacts in a single direction, protecting either your Mac or your Google contacts from ever being modified by the syncing process. To do so, choose either "Sync to Address Book" or "Sync to Google" from the popup menu in the upper-right corner of the Contacts pane. "Sync to Address Book" means that data will only flow to Address Book and the data on Google will never be modified. "Sync to Google" means that data will only flow to Google and the data in Address Book will never be modified. Choosing "Sync both directions" enables traditional synchronization between both sets of contacts.

Duplication can be a serious concern when synchronizing data across servers and devices. Spanning Sync uses specialized technology to prevent duplicate contacts from appearing in Address Book or Google. If duplicates do appear, it's probably because a contact with an unusual name (e.g. no last name) existed in both Address Book and Google that couldn't be matched up with one another.

Spanning Sync can do much more than just sync your calendars and contacts with Google. By using Google as a "hub," you can sync data on multiple Macs to each other.

Syncing multiple Macs is easy.

1. Create new Google calendars for each of the iCal calendars you wish to sync.
2. If you haven't done so already, create matching iCal calendars on all of the Macs that you want to sync.
3. Install Spanning Sync on each of the Macs.
4. On each Mac, enter the same Google account name and password and pair the same iCal calendars to the same Google calendars. The Spanning Sync preference pane should look nearly identical on each computer.
5. Begin syncing each Mac with Spanning Sync.

You may have multiple Google accounts for which you use Google Calendar, and yet want to sync these to a single Mac. This is made possible by Google's calendar sharing feature.

1. Let's call whichever Google account has the most calendars that you're interested in your "primary" account.
2. Login to Google Calendar for the other accounts and share your calendars with the primary account. Be sure to enable full read/write permissions ("Make changes to events") for the primary account.
3. Login to Spanning Sync using your primary Google account. You should see calendars from all of your shared accounts and can now sync all of them with iCal.

The log window can help provide detailed information about status of the syncing process and which calendar events and contacts are changing. You can open the log window from the Advanced tab of the Spanning Sync preference pane.

A little-known feature of iCal and Address Book lets you create a virtual Birthdays calendar and sync it to Google.

1. Open iCal, go to preferences, and select "Show Birthdays calendar."

   

2. If you haven't done so already, add a Birthday field to the Address Book template and start adding birthdays for your contacts.
3. A "Birthdays" calendar will now show up in Spanning Sync which you can sync to Google Calendar.

While Spanning Sync is not currently AppleScriptable, you can initiate a sync via AppleScript, Automator action, Mac OS X service, or shell script by invoking this shell command:

The Account & Schedule tab offers some basic scheduling options, however advanced users might want to customize the sync schedule. To do so, copy and paste these lines into Terminal (located in the Utilities folder), replacing seconds with the number of seconds you want between each sync:

Spanning Sync will notify you if five or more contacts or calendar events are to be deleted from your Mac or from Google and give you a chance to skip them so the data isn't deleted. If you'd like to be notified when Spanning Sync is about to delete any data, then set the threshold to one by copy and pasting this line into Terminal (located in the Utilities folder):

By option-clicking the "Start Over" button in the Advanced tab of the pref pane, you can cause the next sync to merge all of the selected data between your Mac and Google. This is like starting over without losing your preferences.

Currently, Apple does not allow sync software to modify CalDAV calendars so these calendars will only sync one-way to Google.

Copying an event and then pasting it into the same calendar creates a duplicate event. Even if you plan to change the pasted event, iCal will probably sync the pasted event to other sync clients on the computer (including Spanning Sync) before you've changed it. When this happens, the pasted event can become incorrectly linked to the existing event in Google Calendar. If you want to use one event as a template for another, paste it into a new "scratch" calendar, make the modifications, then move it back to the desired calendar.

In iCal, if you move an event from one calendar to another, the change may not sync to Google. To work around this issue:

1. Select the event in iCal and press Command-X ("Cut").
2. Select the calendar to which you would like to move the event.
3. Press Command-V ("Paste").

Deleting an iCal calendar that you sync is fine, however if you then create a new iCal calendar and pair it with the same Google Calendar that was paired with the deleted calendar, there could be unexpected side effects such as deleted events. If you really need to do this, you should do a "Start Over" from the Advanced tab of the Spanning Sync pref pane before syncing with the new calendar.

Spotlight may try to index some of Spanning Sync's data files, causing unnecessary CPU usage after each sync. To prevent this, open the Spotlight pref pane and drag this folder to the list in the Privacy tab:

~/Library/Application Support/Spanning Sync (where "~" is your home folder)

Some users find that Entourage causes Spanning Sync to sync every 10 seconds. This occurs because Entourage is "trickle syncing" every 10 seconds and, since Spanning Sync trickle syncs too, Apple Sync Services asks Spanning Sync to sync each time. To prevent the problem, you can turn off trickle syncing in Spanning Sync by copy and pasting the below lines into Terminal (located in the Utilities folder):

Some users have reported issues between Spanning Sync and Little Snitch, while others have reported that the two work fine together. The trick seems to be that you need to allow port 80 and port 443 access to the following:

/Library/PreferencePanes/Spanning Sync.prefPane
/Library/PreferencePanes/Spanning Sync.prefPane/Contents/Resources/Spanning Sync.app
/Library/PreferencePanes/Spanning Sync.prefPane/Contents/Resources/Spanning Sync Notifier.app

Spanning Tools for Mac is a suite of utilities that analyzes, reports, and fixes dozens of problems with iCal, Address Book, and Apple Sync Services—problems ranging from the obvious, such as duplicated calendar events, to the subtle, such as invalid calendar dates and poorly formatted contact names. A discount is available for Spanning Sync customers.

Before contacting Spanning Sync, please review the topics and suggestions below. If you can't resolve the problem, please send us a troubleshooting report:

1. Open the Spanning Sync preference pane.
2. Click the "Advanced" tab.
3. Click the "Create Report" button.
4. Email the file the appears on your desktop to support@spanningsync.com along with a detailed description of the problem.

Some of the topics below suggest "starting over" with Spanning Sync. "Starting over" with Spanning Sync will never cause data to be lost; it will only cause the next sync to take a long time. Here's how:

1. Open the Spanning Sync preference pane.
2. Click the "Advanced" tab.
3. Check "Start Over".
4. Click "OK".

Some of the topics below suggest resetting Apple's Sync Services, which is one of the functions provided by Spanning Tools for Mac. You can also do so manually:

1. Open iSync (in /Applications).
2. Go to preferences.
3. Click "Reset Sync History".
4. Read the fine print.

If information in iCal is correct but information in Google Calendar is wrong, you can replace calendar data on Google with calendar data in iCal:

1. Open the Spanning Sync preference pane.
2. Click the "Reset…" button.
3. Check "Replace info on Google Calendar with info from this computer".
4. Click "OK".
5. Sync.

Try one or more of the following:

• Make sure your account name and password are entered correctly in the preference pane. When entered correctly, you should see a "Welcome" message below the password field.
• Reset Spanning Sync (see above).
• Mac OS X or one of the sync apps may be confused or crashed. Try restarting your computer.
• Reset Apple Sync Services (see above).

The Unix permissions on your Preference Panes folder are probably incorrect. To solve the problem:

1. Open Disk Utility, located in /Applications/Utilities.
2. Select your boot drive in the Disk Utility window.
3. Click the Repair Permissions button.
4. Install Spanning Sync.

Duplicates can occur due to time zone mismatch issues where two or more of your calendar sources have different time zone settings. For example, the calendar on an iPhone can have time zone support turned on while iCal on the computer has time zone support turned off. If you create an event in a different time zone and then do a "refresh" sync, you could end up with duplicates or time shifts. It's also a good idea to check each of your Google calendars to make sure their time zones are set the same as your iCal calendars, and the same for any other device or server that you sync with.

We recommend that you verify that all four of these time zone settings are the same:

• Your Mac (System Preferences > Date & Time > Time Zone)
• Each iCal Calendar (If iCal > Preferences > Advanced > Time zone support is turned on, then in the calendar view check the setting above the search box in the upper-right corner of the window)
• Your Google Calendar settings (Google Calendar > Settings > Your current time zone)
• Each Google calendar (Google Calendar > Settings > Calendars > (calendar name) > Calendar Time Zone)
• Each device that you sync with (phones/iPods)

Non-Apple phone-syncing software is also known to duplicate calendar events. In this case, you should use Spanning Tools for Mac to remove the duplicates and then contact the developer of the software.

It's also possible that iCal is syncing new events before you're done editing them, which can cause a duplicate. To prevent this from happening, you can turn off trickle syncing in Spanning Sync by copy and pasting the below lines into Terminal (located in the Utilities folder):

If no Google calendars show up in the Spanning Sync preference pane, try one or more of the following:

• Quit and relaunch the Spanning Sync preference pane. (New Google calendars only show up when the preference pane is launched.)
• Open Google Calendar in your web browser and reset the time zone of the affected calendar by changing it, saving your changes, changing it back, and saving your changes again.
• Open Google Calendar in your web browser and reset the name of the affected calendar by changing it, saving your changes, changing it back, and saving your changes again.

Google can occasionally get confused about a calendar and stop sending us its name, so it shows up as "Unknown" in the Spanning Sync preference pane. To fix the problem, just log into Google Calendar, change the name of the affected calendar, save it, then change it back, and save again. Then refresh Spanning Sync by quitting System Preferences, reopening it, and reopening Spanning Sync. The correct calendar name should be listed.

Various networking problems can cause the preference pane to show an error "An unknown error occurred. Please check your network settings." Here are some things to check for:

• Verify Internet connectivity by connecting to http://www.spanningsync.com with your web browser.
• Google or Spanning Sync may be experiencing temporary downtime. Try again in an hour or so.
• A customized Mac OS X certificate policy can make our service unreachable. To reset the certificate policy:
  1. Open Keychain Access (located in /Applications/Utilities).
  2. Go to Preferences.
  3. Click the Certificates tab.
  4. Set the OCSP and CRL popup menus to Off.

If you're still running Mac OS X 10.4 "Tiger", you can't update to Spanning Sync 3 (which requires Leopard or better). But each time you launch the Spanning Sync pref pane it will prompt you to upgrade. You can prevent the Spanning Sync pref pane from prompting you to upgrade by copy this line and pasting it into a Terminal window:

The download package comes with an Uninstaller which will completely remove Spanning Sync.

You can also manually remove Spanning Sync by entering the following into a Terminal window:

and if installed for "this user":

or if installed for "all users on the system":

1. Quit iCal, Address Book, and System Preferences if they're open
2. Extract your backups:
   • In the Finder, navigate to ~/Library/Application Support/Spanning Sync (where "~" is your home directory)
   • Double-click the file called AddressBook-backup-date.zip to unzip it
   • Double-click the file called Calendars-backup-date.zip to unzip it
3. Delete your existing data:
   • Move the folder ~/Library/Calendars into the Trash
   • Move the folder ~/Library/Application Support/AddressBook into the Trash
4. Replace it with your backed-up data:
   • Move the ~/Application Support/Spanning Sync/Calendars folder into ~/Library
   • Move the ~/Application Support/Spanning Sync/AddressBook folder into ~/Library/Application Support
5. Log out of OS X and then log back in

Copyright ©2006-2010 Spanning Sync, Inc. All rights reserved. Spanning, Spanning Sync, Spanning Tools, the Spanning Sync and Spanning Tools logos, and "Save 5+Make 5" are trademarks of Spanning Sync, Inc.

Mac and the Mac logo are trademarks of Apple, Inc., registered in the U.S. and other countries.