TinyCal user manual (v3.0 · 2026-11-08)

Review draft for the standalone Swift edition. Requires macOS 14 or later.

Put TinyCal in your Applications folder and open it from there. If TinyCal offers Show in Finder, use it to locate the app, then drag the app to Applications. Allow calendar access if you want TinyCal to display your events.

TinyCal lives in the menu bar. Click the small calendar page with today’s date to open the mini calendar. Right-click the same icon to open a separate menu with Show Calendar, Go to Today, Settings…, Open Calendar.app, and Quit TinyCal.

Mini calendar

TinyCal with two months side by side. The version and build sit on the left, and the Help button sits on the right.

Today is a rounded-rectangle outline, not a filled blob. Other-month days are gray. Colored dots are events/holidays.

Click a day to peek a compact event list under the grid (tap again to hide). Peek + adds an event. Click × to close the list. If you see View only, your 30-day trial has ended and TinyCal does not have an active license. You can still browse your calendars and read events. A license lets you add, change or delete events and save preference changes. A shared or subscribed calendar may have its own editing restrictions.

Toggle — click the menu-bar extra to open; click again to close. The close chevron does the same.

At the bottom right, click ? to open this manual. At the bottom left, click the version and build number to open the TinyCal changelog.

Tear-off — grab the TinyCal drag strip at the top of the panel and move it. It stays where you drop it (frontmost, clickable) until you close it. Closing and opening again attaches it under the extra.

+ event form — Title is focused so you can type immediately. The panel grows so Title, Notes, Calendar, All day, Starts, Ends, Repeat, Reminder, and Add/Cancel are visible without an inner scrollbar (scroll only if the screen is too short).

Preferences

Window title follows the tab: TinyCal - General, TinyCal - Calendar, and so on.

Every Preferences tab has Quit on the left and OK on the right. In the center, click the version and build number for the changelog or ? for help with the selected tab.

General — launch at login and choose the layout, size and first month. Use Check for updates now or set an automatic check interval. About is its own toolbar icon. Holidays uses a second row: National | Religious | Sports | Misc.

General Preferences controls for the calendar layout, size and update checks.

Calendar — Apple or Google, both from EventKit (no Google sign-in inside TinyCal).

Creating and editing events uses EventKit on whichever writable calendar is selected in that list — including Google-backed calendars.

Holidays — National / Religious / Sports / Misc. Enable a row to show those dates as dots. United States and Christian holidays are computed in-app. Others also match EventKit calendars named like holidays. Sports rows remind you to subscribe in Calendar.app (Google’s old public sports feeds are gone).

Advanced — first weekday, custom calendar, secondary calendar (aux day numbers), week numbers, today outline color, recordable hotkeys with clear (X).

License — Try TinyCal for 30 days from first launch. Open Preferences → License and choose Purchase TinyCal when checkout is available. Paste the key from your receipt and click Activate. If you need to remove the activation from this Mac, click Deactivate. Builds without checkout show Visit TinyCal Website at the top of the License tab.

Voice and scripts

Say “Show TinyCal” or “What’s on my calendar today” (Shortcuts / Siri). Or tinycal://show. In Shortcuts, find Show TinyCal, Hide TinyCal, Go to Today in TinyCal, TinyCal Next Month, TinyCal Previous Month, and Open TinyCal Settings. What’s on my calendar today opens TinyCal at today.

If your events don’t appear

Check System Settings → Privacy & Security → Calendars and give TinyCal calendar access. Then open the calendar and click Refresh. If only one calendar is missing, check that it appears in Apple Calendar and that the right account is selected under Preferences → Calendar.

If the calendar behaves unexpectedly after a system update, note the version and build shown at the bottom left before contacting Plum Amazing.

Revision history

Date App version Changes
2026-11-08 3.0 Draft for the standalone Swift edition. Covers opening the mini calendar, editing events, and view-only behavior.