BusyCal Configuration Guide

To sync BusyCal with your iPhone via iTunes, do the following:

• Launch iTunes, dock your iPhone, and select your iPhone in the iTunes source list.
• Click the Info tab.
• Select the "Sync iCal calendars" checkbox
• Optionally, on your first sync, you may wish to overwrite the iPhone by selecting the "Calendars" checkbox under "Replace information on this iPhone".
• Click Apply

To sync BusyCal with the iPhone via MobileMe requires that you enable MobileMe syncing on both your Mac and iPhone.

Syncing your Mac with MobileMe

Open System Preferences, select MobileMe, click the Sync tab, and check the Calendars checkbox (as well as any other information you'd like to sync with your iPhone, like Bookmarks and Contacts).

Syncing your iPhone with MobileMe

• On your Home screen, tap Settings.
• Tap Mail, Contacts, Calendars.
• Make sure Fetch New Data is set to Push.
• Tap Add Account and choose MobileMe.
• Enter your MobileMe account information then tap Save.
• Turn on Mail, Contacts, Calendars, and Bookmarks.
• Important: If prompted, choose “Merge with MobileMe” to make sure the contacts and calendars already on your device sync with MobileMe.

You are now syncing BusyCal with your iPhone. Any events you create on your iPhone will sync to BusyCal and vice versa.

Note: The key thing to watch out for when syncing multiple Macs with a shared MobileMe account is a sync loop. A sync loop will occur if you are sharing calendars with multiple computers on your LAN using BusyCal's publish/subscribe, while also syncing calendars between those same computers with a shared MobileMe account. See MobileMe sync loop for more info.

After you've configured BusyCal to sync with Google Calendar, the next step is to get your iPhone syncing with Google Calendar using Google Sync, as follows:

• Open the Settings application on your device's home screen.
• Open Mail, Contacts, Calendars.
• Tap Add Account....
• Select Microsoft Exchange.

• In the Email field, enter the name of the account (anything you'd like).
• Leave the Domain field blank.
• Enter your full Google Account email address as the Username.
• Enter your Google Account password as the Password.
• Tap Next at the top of your screen.
• A new Server field will appear. Enter m.google.com.
• Press Next at the top of your screen again.
• Turn Calendars ON.

You've set up Google Sync for your iPhone. Synchronization will begin automatically if you have Push enabled on your phone. You can also open the Calendar app and wait a few seconds to start a sync.

By default, Google will only sync your primary Google Calendar with your iPhone. If you want to sync more than one calendar, there is an additional step:

Open the Safari browser on your iPhone and go to http://m.google.com/sync. Sign in with your account and select the calendars you want to sync with your iPhone. Once you've selected the calendars you want to sync, they will appear on the iPhone on your next sync.

You can now add and edit calendar events on your iPhone and they will sync to Google wirelessly, and from there they will sync to BusyCal!

Note: If you're using Google Apps, you will need to enable ActiveSync for your Google Apps account before you can use Google Mobile Sync.

To publish all calendars from a central host, you'll need to transfer the calendars you wish to share on each computer to the host computer, as follows:

1. On each computer, export the calendars you want to move to the Host by selecting the calendar and choosing Fie > Export. After successfully exporting each calendar, delete it by right-clicking on it and choosing Delete. Then transfer the exported calendar files to the Host computer (via email or file sharing).
2. On the Host, double-click the calendar files to import them. Then publish the calendars with BusyCal/BusySync.
3. On each client, subscribe to the calendars being published by the Host with BusyCal/BusySync.

Port forwarding

To configure BusyCal for remote access requires a static public IP address for your Cable/DSL Modem, a static private IP address for the Mac on your LAN that is Publishing calendars via BusyCal, and port-forwarding on your router (which may be your Cable/DSL Modem, an Airport Extreme Base Station, or some other device) configured to forward all incoming requests on a certain port (4990 is the default for BusyCal) to your Mac's private IP address.

Note: Port Forwarding is a complex topic and is recommended for advanced users only. As an alternative to port-forwarding, it is recommended that you sync BusyCal calendars between Home and Work or with remote users using Google Calendar as a conduit. This can be achieved without making any modifications to your router and enables you to sync from any location, even while traveling.

It is beyond the scope of this user's guide to explain how to configure port-forwarding on your router, but the following resources may prove helpful:

• Port Forwarding Tutorial
• Designing Airport Networks, Using Port Mapping section (page 59), describes how to configure port mapping on an Airport Base Station.

If you are comfortable with port-forwarding and wish to use this method, you may continue with the following instructions for configuring one Mac to publish calendars over the internet, and the other Mac(s) to subscribe to calendars over the internet.

Publishing calendars over the internet

To publish calendars for other BusyCal users to access over the internet, you will have to configure BusyCal to listen for incoming traffic on a static port and configure your router to forward incoming traffic on that port to your computer.

1. Select BusyCal > Preferences > Bonjour, select the Static radio button, and enter a port number between 1000 and 65535 (BusyCal will default to port 4990). Optionally, you may use SSL to encrypt the data (recommended). If you wish to use a different port number, see well known TCP ports used by Apple software products to choose a unique one.
2. Configure your router to forward all incoming traffic on the port specified above to your computer. See the documentation that came with your router for information on how to configure port forwarding.

Note: In an environment with multiple users and users in remote locations, it is recommended that you designate one Mac as the host where you publish all calendars. This will simplify your network administration and maintenance as you'll only have to configure your router to port-forward to one Mac.

Subscribing to calendars over the internet

BusyCal automatically displays all of the BusyCal users and the calendars they are publishing on your local area network in the source list. If you wish to subscribe to calendars being published by a BusyCal user at a remote location, however, you will have to configure BusyCal to connect to that user manually by selecting Connect to Remote BusyCal User from the Calendar menu.

1. Enter the remote user's public IP address or domain name followed by a colon and the port number (e.g. 62.188.79.140:4990 or my.example.com:4990). If no port is specified, the default port 4990 will be used. See publishing calendars over the internet for more info.
2. Select how often you would like BusyCal to check for changes (every 5 minutes is recommended). Note: any changes you make to a remote calendar that you are subscribed to will be sync'd immediately to the server. Otherwise, BusyCal will check with the server at the specified interval to see if any events have been changed by others.

The remote server will be added to the source list. You can change the server address, alter the frequency to check for changes, or disconnect from the server and remove it from the source list, by right-clicking the server name and selecting Server Settings.

Note: You can subscribe to a server in your office via Bonjour and then connect to it remotely while at home or traveling by following the steps above. When doing so, BusyCal will recognize that the server you are connecting to remotely is the same server that you have connected to via Bonjour, and will bind the two together so you don't end up with two identical servers in the list (one local and one remote). And BusyCal will automatically choose the best method for connecting to that server (it will connect via Bonjour when you're on the same LAN, otherwise it will connect over the internet).

To sync BusyCal with MobileMe, enable MobileMe syncing on both your Mac at work and at home.

Syncing your Mac with MobileMe

Open System Preferences, select MobileMe, click the Sync tab, and check the Calendars checkbox (as well as any other information you'd like to sync, like Bookmarks and Contacts).

You are now syncing BusyCal with MobileMe. Any events you create on your Mac at work will sync to MobileMe and from there the events will sync to your Mac at home, and vice versa.

Note: The key thing to watch out for when syncing multiple Macs with a shared MobileMe account is a sync loop. A sync loop will occur if you are sharing calendars with multiple computers on your LAN using BusyCal's publish/subscribe, while also syncing calendars between those same computers with a shared MobileMe account. See MobileMe sync loop for more info.

In this example, we start out with a Mac at Work hosting the Work calendar, Google hosting the Fred calendar, and a Mac at Home hosting the Home calendar.

To sync calendars between home and work using Google Calendar as a conduit, both the Mac at home and the Mac at work must be syncing with the same Google Calendar account. Once both Macs are configured to sync with Google, they can each subscribe to the Fred calendar that is hosted on Google.

Fred publishes his Work calendar to Google. Once published to Google, the calendar automatically shows up in BusyCal at home and can be subscribed to.

Likewise, Fred publishes his Home calendar to Google. Once published to Google, the calendar automatically shows up in BusyCal at work and can be subscribed to.

The end result shows all of the calendars being synchronized between Work, Google, and Home. Any changes made on a calendar at any location, will sync between all of them.

In this example, we start out with Fred and Mary each syncing BusyCal with their personal Google Calendar accounts, but they are not yet sharing calendars with each other.

Fred can share his calendar on Google Calendar with Mary by logging into Google Calendar on the web and clicking Settings > Calendars > Share this calendar.

In the next dialog, Fred enters Mary's Google Calendar account ID in the Person field, and sets the Permission Settings (Make changes to events, See all event details, or See only free/busy time) for the calendar. In effect, Fred is Publishing his calendar to Mary's Google Calendar account.

Once Fred has shared his calendar with Mary, it will show up on Mary's Google Calendar, and from there it will automatically sync to BusyCal on Mary's Mac where she can subscribe to it.

Now Fred and Mary can both make changes to the Fred calendar in BusyCal and the changes will sync back and forth through Google. This process can be repeated with other calendars that Fred or Mary wish to share with each other or with other Google Calendar users.

You can move a calendar that is hosted locally on your Mac to Google Calendar, or you can merge it with an existing calendar on Google. Following are instructions for each.

To move a local calendar to Google

For this example, let's say you have a calendar hosted on your Mac called Home that you want to host on Google. Here's how you can move it to Google:

1. Export the local Home calendar by selecting the calendar and choosing Fie > Export, and save it to your desktop. After successfully exporting the Home calendar, delete it by control-clicking it and selecting Delete.
2. Login to Google Calendar on the web, click the "Create" link below "My calendars" and create a new calendar called "Home".
3. In BusyCal, subscribe to the Home calendar you just created on Google Calendar. Then, double-click the file you exported in step 1 to import it. When prompted, choose to import the events into the Home calendar (which is now hosted on Google). This will add the events from the old Home calendar to the new Home calendar on Google.

To merge a local calendar with a calendar on Google

For this example, let's say you have a calendar hosted on your Mac called "Home", and you want to merge it with an existing calendar on Google called "Fred". Here's how to do it:

1. In BusyCal, subscribe to the Fred calendar hosted on Google.
2. Export the local Home calendar by selecting the calendar and choosing Fie > Export, and save it to your desktop. After successfully exporting the Home calendar, delete it by control-clicking it and selecting Delete.
3. Double-click the file you exported in step 1 to import it. When prompted, choose to import the events into the Fred calendar (which is hosted on Google). This will add the events from the old Home calendar to the Fred calendar on Google.

Your calendars are now hosted on Google.

Add Google Login

For each Google account you wish to sync with, select Calendar > Add Google Login, and enter your Google account login details.

Note: This method of syncing with multiple Google accounts requires that you enter the google login and password for each account. This is fine for an individual with multiple google accounts. However, if you want to sync with other Google Calendar users without sharing your personal Google Account password, you should follow the instructions for Syncing calendars with remote users using Google Calendar as a conduit.

Subscribe to Google

Once you've configured BusyCal to sync with multiple Google Account, each account will appear in the source list and you can subscribe to the calendars on those Google Accounts by checking them.

Publish to Google

In addition to being able to subscribe to calendars hosted on Google, you can also publish calendars hosted in BusyCal to Google. To publish a calendar to Google, right-click on the calendar and select Publish to <google account>. If you are syncing with multiple google accounts, you can publish to any/all of them by selecting the appropriate account name in the menu.