Meeting app detection and calendar matching

Remembering to manually open a note and hit record when jumping into back-to-back calls is difficult. Oyma includes an intelligent, privacy-preserving meeting app detector that recognizes when a video conference begins on your Mac and offers to start taking notes with a single keyboard shortcut.

Meeting detection operates entirely locally through macOS CoreAudio subsystems, without running invasive screen capture or monitoring background keystrokes.

Supported meeting applications

Oyma actively detects audio sessions from 8 major communication tools:

Platform / Application	Detection Mechanism	Browser Support
Zoom Client	CoreAudio process stream (us.zoom.xos)	Native Desktop App
Google Meet	WebKit / Chromium audio stream monitor	Safari, Chrome, Arc, Brave, Edge
Microsoft Teams	Audio output session (com.microsoft.teams2)	Native Desktop App & Web
Cisco Webex	Process stream (com.cisco.webexmeetingsapp)	Native Desktop App
Slack Huddles	Active huddle voice channel hook	Native Desktop App
Discord	Voice channel active state	Native Desktop App
Around	Audio stream hook (co.around.around)	Native Desktop App
Whereby	WebRTC audio stream monitor	Supported Browsers

How meeting detection works under the hood

Unlike cloud recording bots that must be invited to calendar invites or join calls as intrusive extra participants, Oyma operates entirely on your Mac through native macOS system APIs:

1. CoreAudio event listener: Oyma registers a lightweight listener with Apple’s CoreAudio framework. When a communication application opens an active two-way audio stream (using microphone input and speaker output simultaneously), macOS notifies Oyma.
2. Zero polling overhead: Because the mechanism is completely event-driven, Oyma sits idle at virtually 0.0% CPU usage until a call actually begins.
3. No screen scraping: Detection never reads pixels off your monitor or scans your browser history. It only notices that an audio stream matching a supported app has started playing.

The meeting detection prompt workflow

When an active call begins, Oyma provides a seamless entry flow:

1. Unobtrusive prompt: A lightweight notification banner appears in the corner of your screen (or above the editor window):

   “Zoom meeting detected: Q4 Product Strategy. Start taking notes?”

2. Instant keyboard trigger:
   • Press Enter (or click Start) to begin recording immediately.
   • Press Esc to dismiss the prompt without recording.
3. Automatic note scaffolding: Oyma immediately:
   • Creates a new note in your vault titled with today’s date and the call topic.
   • Pre-populates frontmatter metadata (date, time, attendees, meeting URL).
   • Initializes the dual-track audio recorder in the dock.

Matching attendees from macOS Calendar

To eliminate manual data entry, Oyma can optionally integrate with your local macOS Calendar via Apple’s native EventKit framework:

Enabling calendar matching

1. Open Settings (⌘,) → Meetings.
2. Under Calendar integration, toggle Read macOS Calendar events.
3. macOS displays a system permission dialog asking whether to grant calendar access to Oyma. Click Allow.

Privacy boundaries and data protection

• Local only: Calendar data is queried directly from local SQLite databases on your Mac. It is never uploaded or synced to external servers.
• Narrow time window: Oyma only queries events scheduled within a 15-minute window of the current time.
• Frontmatter population: When a matching event is identified, Oyma extracts the meeting title and participant list:

---
title: "Weekly Engineering Architecture Sync"
date: 2026-10-08
time: "14:00"
calendar_event_id: "ek-cal-94827"
attendees:
  - "Sarah Chen <sarah@example.com>"
  - "David Miller <david@example.com>"
  - "Elena Rostova <elena@example.com>"
tags:
  - meeting
  - architecture
---

Customizing detection behavior

In Settings → Meetings, you can customize detection rules to fit your workday:

• Quiet hours: Silence meeting prompts outside working hours (e.g., disable prompts after 6:00 PM and on weekends).
• App-specific rules: Disable detection for personal applications (e.g., ignore Discord gaming sessions while keeping Zoom and Meet active).
• Auto-record trusted meetings: For recurring 1-on-1s or standups, configure Oyma to automatically begin recording system audio without requiring a confirmation click.
• Snooze detection: If you are in a casual call that does not require notes, right-click the status bar icon and choose Snooze detection for 1 hour.

Troubleshooting meeting detection

Issue	Root Cause	Solution
Prompt does not appear for Google Meet	Browser audio permissions or non-standard Chromium fork.	Ensure audio is actively playing through browser and grant system audio permissions in macOS Settings.
Calendar attendee names are empty	Calendar permission denied in macOS System Settings.	Open System Settings → Privacy & Security → Calendars and toggle Oyma on.
Prompt appears for short notification sounds	Short audio bursts from messaging apps.	Oyma waits for sustained audio streams (>3 seconds) to prevent false positives from message chimes.
System audio recording fails	macOS 14.2+ Screen & System Audio permissions not granted.	See our dedicated guide on granting recording permissions.

To learn how to record meetings live without invite bots, read our guide to recording a meeting. For details on configuring automated templates for daily logs, see daily notes.