Adding accounts and subscriptions

Cheaha Calendar

Cheaha Calendar can show as many accounts as you like, side by side. Changes you make in Cheaha Calendar go back to the account, so they appear on your other devices too.

To add an account, click Add Account in the left column (on a Mac, also File > Add Account…). Choose the kind of account, fill in what it asks for, and click the button at the bottom. Cheaha Calendar checks the sign-in, finds your calendars and downloads them.

The Description field is optional. It's the name the account goes by in the calendar list, such as "Personal" or "Work". Left empty, the account is shown by your email address.

iCloud

For your Apple Account's calendars.

  • User name: your Apple Account email address.
  • Password: an app-specific password, not your usual Apple Account password. Make one at account.apple.com under Sign-In and Security > App-Specific Passwords. The Make an app-specific password… link in the window opens that page.

Google

For Gmail and Google Workspace calendars. Click Sign In with Google, and Google's sign-in page opens in your web browser. Sign in there and allow access to your calendars, then come back to Cheaha Calendar. There's nothing else to set up, and Cheaha Calendar never sees your Google password.

Cheaha Calendar shows the calendars in your list at calendar.google.com. A few things are done on Google's site rather than in the app:

  • Making, renaming and deleting Google calendars. (Get Info… can still rename a Google calendar or change its color, but only in Cheaha Calendar.)
  • Adding a calendar someone shared with you: add it to your list at calendar.google.com first, and Cheaha Calendar shows it at the next refresh.

Microsoft 365 and Outlook.com

For Outlook.com, Hotmail and Live accounts, and work or school Microsoft 365 accounts (Exchange Online). Click Sign In with Microsoft, and Microsoft's sign-in page opens in your web browser. Sign in there and allow access to your calendars. Cheaha Calendar never sees your Microsoft password.

Cheaha Calendar shows events from a year ago to two years ahead for these accounts. Calendars other people share with you in Outlook aren't shown yet.

Exchange Server

For an Exchange server your organization runs itself. (For Exchange Online, choose Microsoft 365 instead.)

  • User name: your email address, or DOMAIN\user.
  • Password: your network password.
  • Server: leave it empty and Cheaha Calendar finds the server from your email address, the way Outlook does. If that doesn't work, or you use DOMAIN\user, enter the server's address. Your IT department can tell you what it is, or look in Outlook's account settings.

Fastmail

  • User name: your Fastmail address.
  • Password: an app password with CalDAV access. Make one in Fastmail under Settings > Privacy & Security > App passwords.

Yahoo

For Yahoo and AOL calendars.

  • User name: your Yahoo address.
  • Password: an app password. Make one in your Yahoo account under Account security > Generate app password.

Other CalDAV

For Nextcloud, Radicale, Baïkal, Synology, Zoho, mailbox.org, Posteo and other CalDAV servers.

  • User name and Password: the ones you use for that server.
  • Server: the server's address, such as caldav.example.com or cloud.example.com. Cheaha Calendar finds your calendars from there.

For accounts with a password (iCloud, Exchange, Fastmail, Yahoo and other CalDAV), if the server can't be reached when you add the account, you can click Save Without Checking to keep it and let Cheaha Calendar try again at the next refresh.

Subscribed calendars

Many websites publish calendars you can subscribe to: public holidays, sports fixtures, school terms, or a calendar a friend shared. To subscribe:

  • Click Subscribe to Calendar in the left column, or press Cmd+Option+S (Ctrl+Alt+S on Windows and Linux).
  • Paste the calendar's address. It often starts with webcal:// or ends in .ics.
  • Optionally give it a Name. Left empty, it uses the calendar's own name.
  • Click Subscribe.

Clicking a webcal: link on a web page does the same, with the address already filled in.

Subscribed calendars are read-only. Cheaha Calendar downloads them again each time it refreshes your accounts, and only when they've changed. To stop, right-click the calendar and choose Unsubscribe.

Calendars on this computer

Local Calendars is always there, with Home and Work to start. Its events are kept only on this computer and are never sent anywhere. To make another one, right-click Local Calendars and choose New Calendar…. It can't be removed, but you can hide or delete its calendars.

Making calendars

Press Cmd+Option+N (Ctrl+Alt+N on Windows and Linux), or right-click an account and choose New Calendar…. Give it a name, a color and the account to make it in, then click Create. You can make calendars in Local Calendars and in any account except Google and subscribed calendars, as long as the server allows it. Google calendars are made at calendar.google.com.

Deleting a calendar in an online account deletes it, and its events, on the server and your other devices too.

Changing or removing an account

Right-click the account's name in the calendar list and choose Account Settings…, or open Settings, choose Accounts, select the account and click Edit…. For Google and Microsoft accounts, click Sign In Again… if Cheaha Calendar says your sign-in has expired.

To remove an account, select it in Settings > Accounts and click Remove. Its calendars are removed from this computer, along with its saved password or sign-in. They stay on the server and your other devices.

Where your passwords and sign-ins are kept

Cheaha Calendar keeps passwords, and Google and Microsoft sign-ins, in your computer's secure storage:

  • Mac: the Keychain.
  • Windows: a file in Cheaha Calendar's data folder, encrypted with Windows' own data protection for your user account.
  • Linux: your desktop's keyring (such as GNOME Keyring or KDE Wallet). On a desktop without a keyring, they're kept in a file in Cheaha Calendar's data folder that isn't encrypted.

For Google and Microsoft accounts, you sign in on their own page in your browser, so Cheaha Calendar never sees those passwords; it keeps only the sign-in that lets it reach your calendars. Removing the account deletes it. For more, see the privacy policy.

If something goes wrong

A warning sign beside an account's name means its last refresh didn't work. Hover over the account's name to see why, or look at the bottom of the window. Common causes:

  • The password is wrong, or you used your normal password where an app-specific password is needed (iCloud, Fastmail, Yahoo).
  • A Google or Microsoft sign-in has expired: open the account's settings and click Sign In Again….
  • The server or your internet connection is down. Cheaha Calendar tries again at the next refresh.

See also Troubleshooting.