meetingnotes/README.md

Meetingnotes

The Free, Open-Source AI Notetaker for Busy Engineers
Download for MacOS 14+

Recall.ai - Meeting Transcription API

Meetingnotes runs locally, capturing two streams: system & mic.

If you’re looking for a transcription API for meetings, consider checking out Recall.ai, an API that works with Zoom, Google Meet, Microsoft Teams, and more. Recall.ai diarizes by pulling the speaker data and separate audio streams from the meeting platforms, which means 100% accurate speaker diarization with actual speaker names.

Demo

https://github.com/user-attachments/assets/cadd4504-e9d9-4ccd-874d-41d8a84f4c9d

Features

Implemented:

• Recording mic & system audio
• End-of-meeting transcription through your Coder service
• Ability to also write down additional notes
• AI generated enhanced notes
• Copy functionality
• Meeting deletion functionality
• Meeting search functionality
• Abilty to edit system prompt
• Select any compatible Coder model for transcription and note generation
• Automatic start and stop from MuteDeck through a compatible local API
• Auto updates
• Text formatting
• Different note templates
• Integrate with Posthog for anonymous analytics (installs, opens, meetings created)
• Onboarding screen to enable settings and set API key

Todo:

• improve provider balance and token validation errors
• add padding to text inputs
• add confirmation when clicking the copy button

Later:

• Cool recording indicator (dancing bars)
• Connecting to your Google calendar
• AI chat for asking questions about a meeting
• Integrations for email, Slack, Notion, etc.

Local Development

Open the project in Xcode. Command+R to build it and run it.

Releasing a New Version

Production releases are Developer ID signed, notarized by Apple, published to GitHub Releases, and signed for Sparkle auto-updates.

Prerequisites

• Apple Developer Program membership
• A Developer ID Application certificate exported from Keychain Access as a password-protected .p12
• An Apple ID app-specific password for notarization
• GitHub CLI: brew install gh

Configure the Apple release secrets once:

./scripts/configure_github_release_secrets.sh

The Sparkle private key is stored only as the SPARKLE_PRIVATE_KEY Actions secret. Its matching public key is committed in meetingnotes/Info.plist.

Release Process

1. Update the version number:

   # For bug fixes (1.0 → 1.0.1):
   ./scripts/update_version.sh patch
   
   # For new features (1.0 → 1.1):
   ./scripts/update_version.sh minor
   
   # For major changes (1.0 → 2.0):
   ./scripts/update_version.sh major
   
   # For custom version:
   ./scripts/update_version.sh custom 1.2.0
   

2. Commit and push the version change to main.

3. Run the Release workflow from GitHub Actions and enter the version without the v prefix. The workflow signs and notarizes the app, generates the signed appcast, creates the version tag, and publishes both release assets.

The app checks https://github.com/superdooper86/meetingnotes/releases/latest/download/appcast.xml and installs later releases automatically through Sparkle.

Recovering Meetings

The first Developer ID signed build may not automatically inherit data from an older ad-hoc signed build. In Settings, use Import Meetings... and select the old Meetings folder. After this one-time transition, the stable signing identity keeps the same sandbox container across updates.