Itsycal on Mac: how to set it up

A new menu bar calendar app does nothing useful until a few decisions get made. Calendar access has to be granted, the calendars worth showing have to be picked, and the menu bar display has to be sized so it does not crowd out everything sitting next to it. None of this is hard, but the order matters, and the app's own settings panel does not walk anyone through it. What follows uses only what the developer's help pages and version history publish, and puts the setup steps in the order that avoids backtracking.

Get the version that matches the Mac

The current release requires macOS 11 (Big Sur) or later. Older builds are still hosted for older systems: 0.14.1 covers macOS 10.14 and up, 0.11.17 covers 10.12 and up, 0.10.16 covers 10.10 and up, and 0.8.15 covers 10.8 and up. Since version 0.13.0 the app has shipped as a Universal binary, so it runs natively on both Intel and Apple Silicon Macs without Rosetta.

The download is a zip file, not an installer package. After expanding it, the app has to be dragged into the Applications folder by hand. On macOS 10.12 and later this step is not optional: the app checks that it is actually running from Applications and will prompt if it is launched from somewhere else, such as the Downloads folder. Doing this before the first launch avoids a second round of dragging and relaunching later.

Grant calendar access, then pick which calendars show

The first launch asks for permission to read calendars. Declining this, even by accident, means no events will ever appear, with no error message explaining why. If that happens, the fix is in System Settings, under Privacy & Security, in the Calendars section, where the permission can be switched on after the fact.

Permission alone is not enough. A second step, easy to miss, decides what actually gets displayed: the General tab of the settings panel lists every calendar already configured in the Mac's Calendar app, each with its own checkbox. Nothing is shown until at least one box is checked. Anyone who splits work and personal events into separate calendars can use this list to show only one side in the menu bar view, which keeps the agenda shorter and easier to scan.

Some calendars will not appear on that list at all. Delegate calendars, the kind another person has granted access to, are not supported directly. The one documented workaround applies when the delegate calendar is a Google Calendar: in Google Calendar's own delegate sync settings, selecting the calendars to sync makes them show up as ordinary calendars inside the Mac Calendar app, and from there they become selectable like any other calendar. There is no equivalent workaround documented for delegate calendars on other services.

New events created from inside the app do not have their own default calendar setting. They follow whatever default calendar is set in the Mac Calendar app's own General preferences. Looking for that option inside the menu bar app's settings will not turn up anything, because the setting lives elsewhere.

Find the settings panel without hunting for it

The settings panel opens from a small gear icon below the calendar view, reached by clicking the menu bar icon first. A keyboard shortcut can also be assigned to open the app directly, from the General tab, by clicking into the shortcut field and typing the desired combination. Once a shortcut exists, the calendar can be reached from any app without touching the mouse.

The following covers the minimum setup sequence in the order that avoids redoing earlier steps:

• Move the app to the Applications folder
• Grant calendar access when prompted
• Check the calendars to display, in the General tab
• Assign a keyboard shortcut, in the General tab

That fourth step is easy to postpone, but it is worth doing early. Once a shortcut is set, opening the calendar no longer depends on finding the icon in a crowded menu bar, which becomes relevant in the next section.

Decide what the menu bar actually shows

This is the setting with the most lasting effect, because it is the hardest to change without noticing the ripple effect on everything next to it. It lives in the Appearance tab.

The icon itself has a few forms: a filled square showing the date, an outlined square, a generic calendar glyph, or the app's own icon. Checkboxes layered on top of the filled or outlined square can add the month and the day of the week.

Setting	Example
Date only	18
Date with month	Mar 18
Date with weekday	18 Thu
Date with both	Thu, Mar 18

Separately, a custom date-time pattern can be typed in, and that text is drawn to the right of the icon using the same system font macOS uses for its own clock. Once a pattern is set, an option appears to hide the icon entirely, which turns this into a replacement for the standard menu bar clock rather than an addition next to it.

Pattern	Example
h:mm a	18 11:12 AM
E h:mm	18 Thu 11:12
E MMM d h:mm a, icon hidden	Thu Mar 18 11:12 AM

Every one of these choices adds width, and menu bar width is the one resource that cannot be created out of nothing. A date-only icon costs almost nothing. A full pattern with weekday, month, day, and time costs several times that. On a Mac with a notch, the usable width is already reduced, so this setting decides, indirectly, how many other menu bar items still have room to appear.

The same Appearance tab also has settings that change nothing about width: a theme choice (system, light, or dark), a text size slider with three steps, and an option to show empty days in the agenda list in a dimmed color. These affect only what appears after the calendar is opened, not the menu bar footprint, so they can be adjusted freely without any of the crowding concerns above.

Match week numbers to the ISO standard, or don't

The General tab has a setting for which day starts the week, defaulting to whatever is conventional for the Mac's region (Sunday in the United States, Monday in most other places). Changing it is purely a matter of preference.

Week numbers are a separate and more confusing case. A checkbox in the Appearance tab turns on a week-number column in the calendar view itself, and pressing W does the same from the keyboard. That column is calculated according to the ISO 8601 standard. The text drawn in the menu bar, by contrast, is rendered by macOS itself, and macOS does not follow ISO 8601 by default. The result can be two different week numbers for the same week, one in the calendar's own column and a different one in the menu bar text. Getting them to agree means changing the calendar system in System Settings, under Language & Region, from Gregorian to ISO 8601. That setting lives entirely outside the app, which is why searching the app's own settings for it turns up nothing.

Only the Gregorian calendar is supported for dates themselves. Anyone using a different calendar system, such as the Buddhist calendar, will see dates that do not match, and this is documented as a current limitation rather than something a setting can fix.

Operate it without touching the mouse

The keyboard layout borrows from vim conventions, including the ability to prefix a movement key with a repeat count.

Key	Action
Left/Right arrows or Shift+H / Shift+L	Previous/next month
Up/Down arrows or Shift+K / Shift+J	Previous/next year
H / L	Previous/next day
K / J	Previous/next week
Space	Jump to today
Shift+Cmd+T	Go to a specific date
Cmd+N	Create a new event
Cmd+J	Join the first active virtual meeting in the agenda
Cmd+O	Open the default calendar app
P	Pin the window open when switching to other apps
W	Toggle week numbers
Ctrl+J / Ctrl+K	Add or remove rows in the calendar grid

A count typed before a direction key changes its meaning: pressing 5 then the up arrow moves back five years, and pressing 2, then 1, then L moves forward twenty-one days. Cmd+J in particular removes a small but repeated task, hunting for a meeting link inside an event, by jumping straight to the first meeting currently active in the agenda. The app also registers a URL scheme, itsycal://date/DATE, which opens directly to a given date and can be triggered from a launcher or a keyboard shortcut tool outside the app itself.

Cmd+O deserves a second look, because what it opens depends on a setting that lives outside the app. By default it opens the Mac's own Calendar app, but if BusyCal or Fantastical has been set as the default calendar app in Calendar's own General preferences, Cmd+O opens that instead. The developer's help pages note that a macOS bug occasionally prevents this from working as expected, in which case the fix documented is on Apple's side, not inside the settings panel here. Anyone relying on Cmd+O as a bridge to a heavier calendar app should confirm the default is set correctly before assuming the shortcut itself is broken.

The P key is worth calling out on its own, since it changes behavior rather than navigation. Pressing it pins the window open, so switching to another app to check something no longer closes the calendar in the background. Toggling it off returns to the normal behavior, where clicking anywhere else dismisses the view. Combined with a keyboard shortcut to open the app in the first place, this makes it possible to keep an agenda visible in a corner of the screen while working in another app entirely, without a mouse click at any point in the sequence.

Decide where the icon sits, and why it matters

Any menu bar icon can be repositioned by holding Cmd and dragging it, and the developer's own documentation recommends placing this one toward the right side of the menu bar. The reason is practical: when the menu bar fills up, macOS silently stops drawing whatever does not fit, without any warning that this has happened. Icons placed further right are less likely to be the ones dropped when space runs out. On Macs with a notch, that squeeze happens sooner, since the notch itself removes usable width from the center of the bar. On macOS 26 Tahoe, there is an additional place to check: a Menu Bar section in System Settings can independently prevent an app's icon from showing, on top of the crowding issue.

An icon that goes missing after an update is not necessarily broken. It is worth first quitting a few other menu bar apps temporarily to free up space and seeing whether it reappears, before assuming something else is wrong.

What to decide first

Start with calendar access and the calendar checklist, since nothing shows without both. Then choose a menu bar display that fits the available width, since that choice determines how much room is left for every other icon competing for the same bar. If the real complaint is a menu bar that is already too crowded to find anything in, adjusting one app's display is a partial fix at best. A menu bar manager such as Koffret is built for that broader problem, letting icons stay installed and functional while only appearing when actually needed.