Reference

Every setting, in one map.

Meeting Maid groups meeting behavior, external connections, and note publishing separately. Use this reference to find a control and understand what changes with it.

Ten settings panes Shared AWS connection At least one app entry point

Setup

Setup is the permanent health view for microphone, Screen & System Audio Recording, Calendars, and Notifications. It shows live status and one request, enable, or Open System Settings action for anything that needs attention.

It also summarizes the selected transcription engine and Notes model, with direct actions to change or configure them. Meeting Maid rechecks access after launch and whenever it becomes active; revoking a previously granted permission also produces a dismissible repair banner in the menu bar and main window.

General

SectionControls
StartupLaunch at login; open the main window at launch
Where to Find Meeting MaidShow in menu bar; show in Dock. At least one remains enabled.
NotificationsEnable meeting alerts and update reminders; review or repair macOS notification access
UpdatesInstalled version, Check for Updates, and any reason a check or install was deferred
StorageOpen the managed application-support directory in Finder
Usage StatisticsEnable local collection or clear current-year and all-time totals
DiagnosticsLog level and the rotating log file location
Danger ZoneClear All App Data with typed confirmation, then quit and return to first-run setup

Recording

  • Automatic Recording: start and stop with detected Zoom or Teams calls.
  • Microphone: one selected input or System default, with disconnected-device fallback.
  • Other Participants: enable or disable system-audio capture.
  • Levels: live microphone and system meters for setup checks.
  • Source Audio Retention: storage report, reclaim preview, Apply, and confirmation.

See Record and import for behavior and safety limits.

Calendar

  • Enable read-only meeting identification and automatic best-match application.
  • Allow evidence-based speaker names from the invitation.
  • Filter all-day or long events, unaccepted events, and events without virtual links.
  • Show or hide meeting timing and choose 1 to 30 prior recording days.
  • Grant access and select the individual calendars that may identify recordings.

See Calendar and meetings for local-day and match semantics.

Transcription

Select WhisperKit, Apple Speech, or AWS Transcribe. WhisperKit exposes Tiny through Large model sizes. AWS Transcribe displays the shared AWS profile and region and links to the AWS pane.

The Engine Info section explains the selected engine's processing location, model download, FluidAudio speaker analysis, and text-based fallback boundary.

AWS

The AWS pane owns one shared profile and region for Transcribe, S3 batch processing, and Bedrock. It reads profile definitions from:

~/.aws/config
~/.aws/credentials

Access-key, IAM Identity Center (SSO), assumed-role, and credential_process profiles are supported. Detected Profiles shows inferred authentication type and source file.

  • Meeting Maid does not initiate interactive Identity Center sign-in. Run the sign-in flow outside the app, for example aws sso login --profile <profile-name>.
  • An assumed role's source profile must resolve.
  • A credential-process helper runs through the login shell so it can use the configured PATH.
  • Credential helpers time out after 30 seconds. Refresh AWS sign-in outside the app before retrying a timed-out helper.
  • Resolved access keys, tokens, and helper output are not displayed, saved, or copied into the log.
  • Check credentials confirms profile resolution and rejects a known past expiration; it does not test Transcribe, S3, or Bedrock service permissions.
  • The region selected in this pane is used by every AWS service and overrides region metadata in the profile.

Set up S3 batch transcription

  1. Use a dedicated bucket. Choose a globally unique name in the selected AWS region.
  2. Enter it under S3 Batch Transcription. Leave the field empty to use file streaming.
  3. Choose Set up bucket. Meeting Maid creates the bucket when needed and installs Transcribe access plus one-day cleanup.
Setup replaces bucket configuration

The automatic setup replaces the selected bucket's policy and lifecycle configuration; it does not merge existing statements or rules. Do not point it at a shared bucket.

AWS service permissions

The selected identity needs only the actions for the capabilities you use:

transcribe:StartStreamTranscription
transcribe:StartTranscriptionJob
transcribe:GetTranscriptionJob

s3:CreateBucket
s3:PutBucketPolicy
s3:PutLifecycleConfiguration
s3:PutObject
s3:GetObject
s3:DeleteObject

bedrock:ListFoundationModels
bedrock:ListInferenceProfiles
bedrock:InvokeModel
bedrock:InvokeModelWithResponseStream

bedrock-mantle:ListModels
bedrock-mantle:CreateInference

Identity Center login, assumed-role trust, and credential-process configuration are separate from these service permissions.

AI Models

  • Select AWS Bedrock or Ollama.
  • For Bedrock, manage the profile and region in AWS settings.
  • For Ollama, enter a local or remote host URL.
  • Fetch the available model list, then select Notes and optional Quick models.
  • Use Test Connection against the selected Notes model.

Bedrock foundation models, inference profiles, and models returned by the separate Bedrock Mantle endpoint are combined and deduplicated. Cross-region choices are labeled with geographic or global scope; global routing can process content outside the selected region.

Zero-retention eligibility is a filter, not an account setting

Models known not to offer a zero-retention mode stay hidden unless Allow models that cannot use zero data retention is enabled. This control does not change or verify the active retention or provider-data-sharing mode in your AWS account.

Connect Ollama

  1. Install Ollama and start its server.
  2. Pull at least one model, for example ollama pull llama3.
  3. In Settings > AI Models, select Ollama.
  4. Keep http://localhost:11434 for a local server or enter a remote host.
  5. Fetch Models, select a Notes model, and Test Connection.

A remote Ollama URL sends transcript and prompt content to that remote host. If Ollama is unavailable, transcription remains usable and notes can be generated later.

Prompts and Meeting Context

Prompts

Output instructions

Edit built-ins, add custom templates, set a default, use placeholders, and associate naming conventions.

Meeting Context

People and vocabulary

Define names, pronouns, product terms, acronyms, and guidance included in model requests.

Export

Configure publishing destination and format, optional transcript output, naming conventions, model-based vault placement, folder exclusions, categories, and subcategory hints. Destination validation warns when a destination is missing, is not a folder, or is not writable.

See Export and Obsidian for ownership and replacement semantics.