How nostrapollo/next-meeting-menu-bar works
NextMeeting is a local macOS menu-bar meeting countdown and one-step join app. Its main workflow reads permitted calendar events, filters and orders them, extracts supported conferencing links, and presents the next/current meeting; the global shortcut joins it by opening its URL. Calendar refresh and alert timing are coordinated by the calendar service, while settings configure calendars, timing, alerts, and the shortcut. The graph captures documented capabilities and sampled calls; some alert-window internals were not excerpted, so their implementation details are omitted.
Main entry points: NextMeetingApp.swift App coordinator · CalendarService.swift Calendar service · SettingsView.swift Settings controls · MenuContentView.swift Menu countdown
Components 16
App coordination
- App coordinator
NextMeeting/NextMeeting/NextMeetingApp.swift
Meeting pipeline
- Calendar service
NextMeeting/NextMeeting/Services/CalendarService.swift - Meeting model
NextMeeting/NextMeeting/Models/Meeting.swift - URL extraction
NextMeeting/NextMeeting/Services/MeetingURLExtractor.swift - Alert timing
NextMeeting/NextMeeting/Services/MeetingAlertPolicy.swift
User interface
- Menu countdown
NextMeeting/NextMeeting/Views/MenuContentView.swift - Full-screen alert
NextMeeting/NextMeeting/Views/MeetingAlertWindow.swift - Settings window
NextMeeting/NextMeeting/Views/SettingsWindowController.swift - Settings controls
NextMeeting/NextMeeting/Views/SettingsView.swift
Preferences and integrations
- Preferences service
NextMeeting/NextMeeting/Services/PreferencesService.swift - Global shortcut
NextMeeting/NextMeeting/Services/KeyboardShortcutService.swift - Launch at login
NextMeeting/NextMeeting/Services/LaunchAtLoginService.swift - UserDefaults
Other components
- User
- macOS calendars
- macOS URL opener
Connections 25
- User → Menu countdown: views meetings
README.md - App coordinator → Preferences service: creates
NextMeeting/NextMeeting/NextMeetingApp.swift - App coordinator → Calendar service: creates
NextMeeting/NextMeeting/NextMeetingApp.swift - App coordinator → Global shortcut: registers
NextMeeting/NextMeeting/NextMeetingApp.swift - App coordinator → Launch at login: creates
NextMeeting/NextMeeting/NextMeetingApp.swift - App coordinator → Menu countdown: shows
NextMeeting/NextMeeting/NextMeetingApp.swift - macOS calendars → Calendar service: provides events
README.md - Calendar service → Preferences service: reads settings
NextMeeting/NextMeeting/Services/CalendarService.swift - Calendar service → macOS calendars: fetches events
NextMeeting/NextMeeting/Services/CalendarService.swift - Calendar service → Meeting model: builds meetings
NextMeeting/NextMeeting/Services/CalendarService.swift - Calendar service → URL extraction: extracts links
NextMeeting/NextMeeting/Services/CalendarService.swift - Calendar service → Alert timing: checks alert timing
NextMeeting/NextMeeting/Services/CalendarService.swift - Menu countdown → Calendar service: displays meetings
NextMeeting/NextMeeting/Views/MenuContentView.swift - Menu countdown → Settings window: opens settings
NextMeeting/NextMeeting/Views/MenuContentView.swift - Settings window → Settings controls: creates view
NextMeeting/NextMeeting/Views/SettingsWindowController.swift - Settings controls → Preferences service: edits options
NextMeeting/NextMeeting/Views/SettingsView.swift - Settings controls → Calendar service: loads calendars
NextMeeting/NextMeeting/Views/SettingsView.swift - Settings controls → Global shortcut: configures shortcut
NextMeeting/NextMeeting/Views/SettingsView.swift - Preferences service → UserDefaults: persists options
NextMeeting/NextMeeting/Services/PreferencesService.swift - App coordinator → Full-screen alert: shows alert
NextMeeting/NextMeeting/NextMeetingApp.swift - Global shortcut → App coordinator: triggers join
NextMeeting/NextMeeting/NextMeetingApp.swift - App coordinator → Calendar service: selects meeting
NextMeeting/NextMeeting/NextMeetingApp.swift - App coordinator → macOS URL opener: opens meeting link
NextMeeting/NextMeeting/NextMeetingApp.swift - App coordinator → Launch at login: enables login start
README.md - User → Global shortcut: presses shortcut
README.md