Using BusyCal with iCloud
iCloud is Apple’s free online service, which includes calendar syncing among its many features. BusyCal can connect to iCloud for syncing calendars across your devices and sharing them with others.
For details on using BusyCal with iCloud, see the following:
- Syncing with iCloud
- Sharing Calendars with Others through iCloud
- Connecting to iCloud wth an App-Specific Password
- Hosting Calendars on iCloud
- iCloud Limitations
BusyCal can use iCloud to sync calendar data across your devices.
To sync BusyCal with iCloud, do the following:
- Choose BusyCal > Preferences > Accounts.
- Click the + (plus) icon to add a new account.
- Choose iCloud from the Server Type pop-up menu, enter your Apple ID and password, and click OK.
Note: If you have enabled two-step verification or two-factor authentication for your Apple ID, you will need to set an app-specific password for BusyCal.
BusyCal enables you to share calendars with other iCloud users. Once each user has configured BusyCal to sync with their personal iCloud account, you can share calendars with each other through iCloud. When a calendar is shared through iCloud, events can be edited by any user and changes sync between them.
To share a calendar with other iCloud users:
Control-click the calendar in the left sidebar and choose Get Info from the contextual menu.
Select the Share calendar checkbox, and then enter the iCloud email address of the person you want to share the calendar with. Select “Allow Write” if you want them to have read-write access to your calendar; otherwise, deselect it to give them read-only access.
Click OK. BusyCal begins syncing with iCloud and an icon appears next to the calendar name indicating that it is shared.
The person you shared the calendar with will receive an email invitation from iCloud. If they are running BusyCal or OS X Calendar and are syncing with iCloud, the shared calendar appears automatically when they accept the invitation.
You can also share an iCloud calendar as read-only public calendar, available to anyone who uses an app or web service that accepts webcal URLs. To do so, follow the instructions just above, but in step 2, select “Share read-only with everyone.”After you click OK, reopen the Calendar Info dialog; the public URL appears in the URL field. To copy it to your clipboard, Control-click it and choose Copy from the contextual menu.
When sharing calendars with others, there are two options you may want to enable, for keeping track of changes to events on shared calendars:
First, in BusyCal > Preferences > Advanced, select “Confirm changes to events on shared calendars” if you want to display a warning when you edit or delete an event on a shared calendar.
Second, in the Calendar Info dialog for any given calendar (which you can display by double-clicking the calendar name in the Calendar List), select “Show change notifications in Inbox” to display a badge on the app icon and a message in the Inbox when events are added or changed by others, or deselect it to avoid seeing badges and Inbox notifications for that calendar.
Apple offers optional security enhancements for your iCloud account called two-step verification and two-factor authentication. Both methods require you to verify your identity using one of your devices before you can connect to iCloud with a new device or app.
Apple’s implementation of two-step verification and two-factor authentication is proprietary and only available to Apple apps. If you’re using one of these security measures, you’ll have to create an app-specific password for BusyCal that lets you sync securely with iCloud.
App-specific passwords are required for all third-party apps that sync with iCloud.
Note: This affects only iCloud users who have enabled two-step verification or two-factor authentication. If you are not using either, you can ignore this.
These are the steps for creating an app-specific password for BusyCal to sync with iCloud:
- Sign in to your Apple ID account page.
- In the Security section, click Edit.
- Click Generate Password and follow the steps on your screen. The app-specific password is displayed on screen. Write down this password and/or copy it to your clipboard.
- Enter the password in BusyCal.
In BusyCal, choose BusyCal > Preferences > Accounts, select your iCloud account in the left sidebar, and enter the new app-specific password in the Password field.
iCloud functions as a CalDAV server that syncs with client apps.
BusyCal (for both OS X and iOS) and the built-in Calendar app on OS X and iOS are CalDAV clients that sync with iCloud.
This means any data you enter into the built-in Calendar app on OS X or iOS will sync to BusyCal through iCloud, and vice versa. As long as you have all client apps configured to sync with the same iCloud account, all your calendar data remain in sync.
All calendars you want to sync between your Macs, iOS devices, and other users must be hosted on iCloud. You cannot sync calendars from other sources (On My Mac, Google, Exchange, etc.) to iCloud.
If you have any existing calendars hosted elsewhere that you want to host on iCloud, you can move them to iCloud or merge them with an existing calendar in iCloud, as follows.
For this example, let’s say you have a local calendar called “Work” that you want to host on iCloud. Here’s how you can move it to iCloud:
- Make sure you are syncing with iCloud and that your iCloud Account appears in the left sidebar.
Control-click the calendar that you want to move to iCloud and choose Move to iCloud from the contextual menu.
iCloud requires you to store events and to dos on separate calendars. If the Work calendar contains both events and to dos, it will be transformed into two calendars on iCloud—one for events and one for to dos. The to do calendar will be indicated with a checkmark next to its name.
For this example, let’s say you have a local calendar called “Work” that you want to merge with an existing calendar on iCloud called “Fred.” Here’s how to do it:
Export the Work calendar by selecting it in the left sidebar and choosing File > Export, and save it to your desktop. Then delete the Work calendar from BusyCal by Control-clicking on it and choosing Delete from the contextual menu.
Choose File > Import and select the file you exported in step 1. If the “Import events into” section does not appear at the bottom of the dialog, click Options to display it. Select Existing Calendar, and choose the Fred calendar (which is hosted on iCloud). BusyCal adds the events from the Work calendar to the Fred calendar on iCloud.
Note: iCloud stores events and to dos on separate calendars. Therefore, if you attempt to import a calendar that contains both events and to dos into a calendar on iCloud that only supports events, the to dos will be rejected. To import the to dos, you must repeat this step and import into an existing calendar on iCloud that supports to dos.
Tip: After merging the calendars, you can remove duplicate events by choosing Help > Find Duplicates.
iCloud places certain limits on calendar data.
iCloud limits the amount of data you can sync with BusyCal, as follows:
- Total number of calendars, events, and reminders: 25,000
- Maximum combined number of calendars and reminder lists you can have: 100
- Maximum size of all calendar and reminder data (not including attachments): 24 MB
- Maximum size of all event attachments: 300 MB
- Maximum size of a calendar event including attachments: 20 MB
- Maximum number of attachments per event: 20
- Maximum number of attendees you can invite to an event: 300
- Maximum number of people with whom you can share a private calendar: 100
- Maximum number of characters in a reminder title: 100
For more information, see iCloud: Limits for Contacts, Calendars and Reminders.
BusyCal syncs all its data types (events, to dos, journals, graphics, stickies, attachments, tags, etc.) with iCloud.
If you are syncing multiple Macs running BusyCal with the same iCloud account, all these data types should sync seamlessly. However, there are some limitations to be aware of when syncing these data types with other apps (such as Calendar for OS X or iOS) through iCloud:
- Stickies, Journals, and Graphics in BusyCal sync between BusyCal clients through iCloud, but appear as all-day events in Calendar and other clients.
- Tags applied to events in BusyCal sync with other copies of BusyCal through iCloud, but do not appear in Calendar or other clients.
- To dos in BusyCal sync with the Reminders app on OS X and iOS through iCloud. They do not appear in Calendar for OS X or iOS.