Itsycal's settings live in the Preferences panel. To open the panel, click on the small gear-shaped icon below the calendar and choose Preferences... in the drop-down menu that appears. The Preferences panel will open.
By default, Itsycal will draw the calendar using the first day of the week that is conventional for your locale (Sunday in the US, Monday in much of the rest of the world).
To change the default, open the Preferences panel and choose the General tab. Toward the top you will see a drop-down button for First day of week.
Itsycal can display events from calendars you have set up in the Mac Calendar app.
To display events in Itsycal, open the Preferences panel and choose the General tab. You should see a list of the calendars you have set up in the Mac Calendar app. Put a checkmark next to the calendars you want Itsycal to track.
Itsycal cannot display delegate calendar events directly, but there is a workaround if your delegate calendars are Google calendars.
Go to Google Calendar Sync Settings and select the delegate calendars you want to view in Itsycal. Click Save. These calendars should now appear as regular calendars in the Mac Calendar app, and thus in Itsycal as well.
Open the Preferences panel and choose the General tab. Click in the box under Keyboard shortcut to assign your desired shortcut.
Click the pin button below the calendar to keep Itsycal open. You can also use the keyboard shortcut P to toggle this setting.
Itsycal honors the default calendar selection that is set in the Mac Calendar app's General preferences.
Itsycal currently only supports the Gregorian calendar. If you use a different calendar (e.g. Buddhist), the dates will be wrong. I'm hoping to address this issue in the future.
Itsycal can display the week-of-the-year in the left side of the calendar as well as in the menu bar. You may notice a discrepancy between the numbers Itsycal shows in either location or between Itsycal and another app like Apple's Calendar app.
Itsycal implements the ISO 8601 standard for displaying week numbers. The week number Itsycal displays in the left side of the calendar is correct according to the ISO standard.
MacOS draws the text in the menu bar. It interprets the date/time pattern and outputs text. By default, macOS does not adhere to ISO 8601. To get it to use the standard, go to your Mac's System Preferences and open the Language & Region panel. Change your calendar from Gregorian to ISO 8601.
Yes. As of version 0.13.0, Itsycal is a Universal app that runs natively on both Intel and ARM Macs.
If your Mac has a notch in the menu bar, it may be hiding Itsycal. When the menu bar fills up with menu items, macOS silently hides new items it can't find room for. There is no indication this is happening and the notch occupies valuable menu bar space making this situation more likely. Remove other menu bar items to make room. Once Itsycal appears, you can move it to the right so that it is less likely to be hidden in the future.
Please read this for a possible solution.
Open the Preferences panel and choose the Appearance tab. About halfway down you will see a drop-down button for Theme. The default setting is System which means Itsycal will honor the mode you've set in your Mac's System Preferences. Alternatively, you can explicitly set either Light or Dark.
Open the Preferences panel and choose the Appearance tab. Toward the bottom you will see a checkbox for Show calendar weeks. You can also toggle this setting from Itsycal itself by pressing the W key.
Itsycal implements the ISO 8601 standard for displaying week numbers. The week number Itsycal displays in the left side of the calendar is correct according to the ISO standard. Keep that in mind if you notice a discrepancy between Itsycal and another app like Mac Calendar.
Open the Preferences panel and choose the Appearance tab. You will see a slider which lets you choose between 3 different text sizes.
Hold down the command ⌘ key and drag Itsycal in the menu bar to your desired location. This technique works with all of the icons in your menu bar so you can reorder all of them to your liking.
It is a good idea to position Itsycal toward the right side of your menu bar so that it is less likely to be hidden by macOS if your menu bar gets crowded.
Itsycal's menu bar display can be customized extensively to display not just the date, but also the time as well as arbitrary text.
Please see Menu Bar Customization for instructions. If you are looking for help specifically about datetime patterns, please see Date & Time Patterns.
Itsycal's shortcuts add vim to your workflow. There are shortcuts for much of Itsycal's functionality. In fact, there is even some esoteric functionality that is only accessible from the keyboard. Behold:
|◀ ▶ or shift-H shift-L||Go to previous/next month.|
|▲ ▼ or shift-K shift-J||Go to previous/next year.|
|shift-◀ shift-▶ or H L||Go to previous/next day.|
|shift-▲ shift-▼ or K J||Go to previous/next week.|
|The above commands may be preceded by a repeat count. For example, 5 ▲ goes back 5 years. 2 1 L goes forward 21 days.|
|space key||Go to today.|
|#||Show selected day's offset from today and the day-of-the-year. Totally useless until it's surprisingly useful.|
|control-J control-K||Add/remove weeks in the calendar. You can also drag the handle below the calendar.|
|P||Pin/unpin Itsycal. When pinned, Itsycal will stay open when you navigate to other apps.|
|W||Show/hide calendar weeks.|
|. (period)||Show/hide event locations in the agenda.|
|⌘O||Open the default calendar app.|
|⌘J||Open the first active virtual meeting in the agenda view.|
|⌘N||Create a new event.|
Huh? See keyboard shortcuts to understand how this works.
You can use the keyboard shortcuts control-J and control-K to add or remove extra rows, or you can use the mouse to drag the handle located just below the calendar.