What It Does
CalendarUpcoming sits silently in the menu bar as a plain calendar icon. When an event is approaching, the icon changes colour and pulses with a glow to get your attention.
- Blue — event approaching (within your configured look-ahead window)
- Amber — event starting within 5 minutes
- Red — event is currently in progress
Click the icon to see a popover listing all upcoming events with time remaining, clock time, and calendar name with a colour bar.
Calendar Support
Monitors all calendars registered with macOS, including:
- Apple Calendar
- iCloud
- Google Calendar
- Outlook / Exchange (via System Settings → Internet Accounts)
All-day events and declined events are automatically filtered.
Controls
| Action | Result |
|---|---|
| Left-click icon | Open popover with upcoming events |
| Right-click icon | Settings menu (look-ahead period, quit) |
| Escape / click outside | Close popover |
Settings
Right-click the icon to access Settings. You can configure the look-ahead period — how far ahead CalendarUpcoming scans for events:
- 5, 10, 15, 30, or 60 minutes
The setting is persisted across restarts.
Installation
- Download CalendarUpcoming.zip from the link above
- Unzip and double-click
CalendarUpcoming.appto launch - Grant Full Access to calendars when prompted
To start at login, add it to System Settings → General → Login Items.
Permissions
Calendar — Full Access is required. On first launch, macOS will prompt for permission. Grant Full Access (not Write Only).
If the popover shows “Full calendar access needed”, go to System Settings → Privacy & Security → Calendars, find CalendarUpcoming, and switch from Write Only to Full Access.
Building from Source
Requires Xcode and a valid Apple developer certificate (the app must be code-signed for calendar permission tracking to work).
- Clone the repo:
git clone https://github.com/PerpetualBeta/CalendarUpcoming.git - Open
CalendarUpcoming.xcodeprojin Xcode - Build with Cmd+B or run with Cmd+R
Requirements
macOS 13 (Ventura) or later.