How eshwarmuthusamy/klaxon works
Klaxon is a local macOS meeting-alert daemon: it polls the synced Calendar app, detects eligible upcoming events, and presents a persistent audible alert until dismissed, joined, or the meeting ends. The main orchestration lives in the poller; calendar parsing, alert presentation, configuration, and deduplication state are separate runtime layers. The README documents the Chrome/Edge kiosk and dialog fallback; the sampled alert source confirms both paths. The graph omits setup and launch-agent mechanics, which are deployment rather than product runtime.
Main entry points: localAlert.js Alert coordinator · index.js Poll orchestrator · config.js Settings · localCalendar.js Calendar reader
Components 12
Event polling
- Poll orchestrator
src/index.js
Calendar access
- Calendar reader
src/localCalendar.js - icalBuddy
Alert experience
- Alert coordinator
src/localAlert.js - Kiosk page and server
src/localAlert.js - Chrome or Edge
- macOS dialog
- afplay sound loop
- Meeting link
Runtime support
- Settings
src/config.js - Alert state
src/state.js
Other components
- Mac user
Connections 14
- Poll orchestrator → Calendar reader: fetches events
src/index.js - Calendar reader → icalBuddy: reads calendar
src/localCalendar.js - Poll orchestrator → Alert state: loads and saves
src/index.js - Poll orchestrator → Alert coordinator: starts alert
src/index.js - Poll orchestrator → Settings: reads settings
src/index.js - Alert coordinator → Settings: reads sound settings
src/localAlert.js - Alert state → Settings: uses state path
src/state.js - Alert coordinator → Kiosk page and server: serves kiosk alert
src/localAlert.js - Alert coordinator → Chrome or Edge: launches isolated kiosk
src/localAlert.js - Alert coordinator → macOS dialog: falls back to dialog
src/localAlert.js - Alert coordinator → afplay sound loop: starts and stops loop
src/localAlert.js - Alert coordinator → Meeting link: opens on join
src/localAlert.js - Mac user → Kiosk page and server: dismisses or joins
src/localAlert.js - Mac user → macOS dialog: dismisses or joins
README.md