Meetings and calendar
The Meetings plugin shows your next calendar event in the menu bar, counts down to it, and can cover the screen with a join card when it starts. Mini Calendar and Reminders put the date and your to-do list beside it.
Meetings
meetings.js reads the calendars in the macOS Calendar app, so any account you added there (iCloud, Google, Exchange) works. It refreshes every 30 seconds.
The menu bar item shows the title of the next timed event and, under it, how long until it starts, such as in 1h 15m. While the meeting runs, the second line reads Now · 25m left. With no meeting ahead, the item shows only a calendar icon. All-day events never take the menu bar.
Click the item for today's agenda:
- Join opens the meeting link. Macotron looks for a link in the event's URL, location, and notes, and prefers Google Meet, Zoom, Teams, and Webex links over other links. An event with no link shows Open, which opens Calendar.
- Dismiss hides the next meeting from the menu bar and the overlay. Restore Dismissed Meetings brings dismissed meetings back.
- Below that is every event, grouped by day. An arrow marks the next one. Past, ignored, and dismissed events are dimmed. Click any event to join or open it.
- Refresh, Open Calendar, and Settings… are at the bottom.
The launcher command Next Meeting opens the next meeting's link.
The meeting overlay
When a meeting starts, Meetings shows a full-screen card with the event title, a Join button, a Close button, and a QR code of the join link, so you can join from your phone. The card counts the minutes since the start. It shows once per meeting, and only within the first five minutes, so a Mac that wakes from sleep late does not show it for a meeting that is already well under way.
Turn the card off with the Meeting overlay setting.
Meetings settings
Change these in Settings → Plugins → Meetings.
| Setting | Default | What it does |
|---|---|---|
| Calendars | All | Shows events from the checked calendars only. Check none to show every calendar. |
| Look ahead | 12 | Hours of calendar to show. The rest of today is always included. |
| Ignore titles | ooo|vacation | One regular expression per line, matched without case against the title, location, and calendar name. Matching events are dimmed and never take the menu bar or the overlay. |
| Show time as | Relative | Relative (in 1h 15m) or Start time (1:15 PM). |
| Meeting overlay | On | Shows the full-screen card when a meeting starts. |
Meetings needs the Calendars permission. Grant it in Settings → Permissions. The Calendars setting stays empty until you do.
Mini Calendar
mini-calendar.js shows today's weekday and date as a small calendar icon in the menu bar. Click it to see the month. The ‹, Today, and › buttons page through months without closing the menu. Open Calendar… opens the Calendar app.
The World clocks setting takes one IANA time zone per line, such as Europe/London. The menu shows each one under the month. To rename a clock, write Europe/London = Home. For a menu bar clock instead, use World Clock (world-clock.js).
Reminders
reminders.js shows your next reminder in the menu bar, with its due date under it, or Overdue. Its menu lists up to eight open reminders. Click one to mark it complete. Add… asks for a title and adds a new reminder.
macOS asks for access to Reminders the first time the plugin reads them. Until you allow it, the list is empty.