Getting started with Cheaha Calendar

Cheaha Calendar

Cheaha Calendar is a simple calendar for your desktop. It shows the calendars from your iCloud, Google, Microsoft 365, Exchange, Fastmail, Yahoo and other CalDAV accounts in one window, along with calendars you subscribe to (such as holidays or a team's fixtures) and calendars kept only on your computer. It does calendars only: no tasks, reminder lists or contacts.

To install it, see Installing and updating.

The first time you open it

There is no setup to go through. Cheaha Calendar opens in the Week view with one account already in place, Local Calendars, which holds two calendars kept only on this computer: Home and Work. You can add events to them straight away.

To see your online calendars too:

  • Click Add Account in the left column.
  • Choose the kind of account, fill in what it asks for, and click Sign In (or Sign In with Google or Sign In with Microsoft).

Cheaha Calendar then downloads that account's calendars. A progress bar runs at the bottom of the window while it does. See Adding accounts for each kind of account.

Your calendars are also kept on your computer, so the app opens straight away next time and you can look at your events when you're offline.

The window

The window has up to three columns.

  • The calendar list (left). New Event at the top, then a small month you can click to jump to a day (use the arrows beside it to change month), then Add Account and Subscribe to Calendar, then each account with its calendars.
  • The calendar (middle). The day, week, month or year you're looking at.
  • The inspector (right). Appears when you open or make an event, and shows its details. See Events.

Across the top is the blue header bar. From left to right:

  • Show or hide the calendar list, to make more room.
  • Search events, to find an event as you type.
  • Refresh calendars, to check your accounts for changes now.
  • Settings.
  • About Cheaha Calendar, which shows the version.

The line at the bottom of the window says what the app is doing, such as "Checking for changes…" or "Updated at 10:42", and shows any problem.

In a narrow window, Cheaha Calendar shows one column at a time, with a Back button to return to the previous one. The header then has a More button (three dots) with every command in one menu.

Views

Choose Day, Week, Month or Year at the top of the calendar. Today is marked in blue, and in Day and Week a line across the day shows the current time.

  • Day and Week. All-day events are in a strip at the top, and the hours of the day below, with overlapping events side by side. The view opens scrolled to 8 AM; you can change that in Settings. In Week, the week shown is shaded in the small month on the left.
  • Month. Events that last all day or several days are bars across the days they span. Timed events show a dot, their time and their title. When a day has more than fits, click N more to open that day. Scroll to move between months.
  • Year. Twelve months, with a dot under each day that has events. Click a month's name to open it, or double-click a day to open that day.

Getting around

  • Use the arrow buttons on either side of Today to go back or forward a day, week, month or year.
  • Click Today to come back to today.
  • Click a day in the small month on the left to go to it. Double-click it to open that day in the Day view.
  • Click a day's heading in Week view to open that day.

Showing and hiding calendars

Each calendar in the left column has a checkbox in its color. Clear it to hide that calendar's events; tick it to show them again. Right-click a calendar for more:

  • Get Info… to rename it or change its color.
  • Show Only This Calendar to hide all the others.
  • Use for New Events to make it the calendar new events go in.
  • Delete Calendar… (or Unsubscribe for a subscribed calendar).

Right-click an account's name for New Calendar… and Account Settings….

Click Search events (or press Cmd+F on a Mac, Ctrl+F on Windows and Linux) and type. Cheaha Calendar looks in event titles, locations and notes as you type. Each event appears once, at its next occurrence (or its most recent one if it's in the past). Click a result to open it, or press Return to open the first one. Press Esc to clear the search.

Keyboard shortcuts

Use Cmd on a Mac, and Ctrl on Windows and Linux. Where a shortcut uses Option, use Alt on Windows and Linux. On a Mac these commands are also in the menu bar, under File and View.

  • New event: Cmd+N
  • New calendar: Cmd+Option+N
  • New calendar subscription: Cmd+Option+S
  • Import an .ics file: Cmd+Shift+I
  • Day, Week, Month, Year: Cmd+1, Cmd+2, Cmd+3, Cmd+4
  • Previous and next: Cmd+Left and Cmd+Right (or just Left and Right when you aren't typing)
  • Go to today: Cmd+T
  • Refresh calendars: Cmd+R
  • Show or hide the calendar list: Cmd+Option+L
  • Search: Cmd+F
  • Delete the selected event: Delete or Backspace
  • Close the inspector: Esc
  • Settings (Mac only): Cmd+,

Cheaha Calendar can open .ics calendar files, such as ones attached to an invitation or exported from another calendar. Double-click one, use Open With, or drop it on the app's icon, and Cheaha Calendar asks which calendar to add its events to. You can also press Cmd+Shift+I (Ctrl+Shift+I on Windows and Linux) to choose a file.

Clicking a webcal: link on a web page opens New Calendar Subscription with its address filled in. See Adding accounts.