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 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.
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.
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.
Itsycal's menu bar display can be customized extensively to display not just the date, but also the time as well as arbitrary text.
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.|
|⌘N||Create a new event.|
|⌘O||Open default calendar app.|
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.
I aim to make software that provides you with both value and a smile. Your appreciation and generosity means a lot.