Skip to content

A mac app that auto-records meetings for Zoom, Google Meet and Teams.

License

Notifications You must be signed in to change notification settings

crshdn/MacMeetingAutoRecorder

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

5 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

🎬 MacMeetingAutoRecorder

A lightweight macOS menu bar app that automatically detects and records your video meetings β€” no manual clicking required.

The Problem

We've all been there: you finish an important meeting and realize you can't remember half of what was discussed. Action items get lost, key decisions fade from memory, and you're left piecing together notes that don't quite capture everything.

The usual solution? Manually start a screen recording before every call. But let's be honest β€” when you're rushing to join a meeting, hitting "record" is the last thing on your mind.

The Solution

MacMeetingAutoRecorder runs quietly in your menu bar and watches for video calls. The moment you open Zoom, Microsoft Teams, or Google Meet, it detects it and prompts you to record. When the meeting ends, it automatically stops and asks where you'd like to save the file.

No apps to open. No buttons to click. No meetings forgotten. And lightweight!

It just works.


✨ Features

Feature Description
πŸ” Auto-Detection Automatically detects when Zoom, Teams, or Google Meet starts
πŸ–₯️ Display Selection Choose which monitor to record (great for multi-monitor setups)
🎀 Full Audio Captures system audio + your microphone
πŸ“ Smart Saving Prompts to name and save when the meeting ends
βš™οΈ Preferences Remember display choices, set default save folder
πŸš€ Launch at Login Optional auto-start when you log in
πŸ”΄ Recording Indicator Menu bar icon shows when recording is active

πŸ“¦ Installation

Option 1: Download Release (Recommended)

  1. Go to Releases
  2. Download MacMeetingAutoRecorder.app.zip
  3. Unzip and drag to /Applications
  4. Double-click to run

Option 2: Build from Source

# Clone the repo
git clone https://github.com/crshdn/MacMeetingAutoRecorder.git
cd MacMeetingAutoRecorder

# Build with Xcode
cd AutoCallRecorder
xcodebuild -project AutoCallRecorder.xcodeproj \
           -scheme AutoCallRecorder \
           -configuration Release \
           build

# The app will be in:
# ~/Library/Developer/Xcode/DerivedData/AutoCallRecorder-*/Build/Products/Release/

Or open AutoCallRecorder/AutoCallRecorder.xcodeproj in Xcode and press ⌘R.


πŸ” Permissions Required

On first run, macOS will ask for these permissions. All are required for full functionality:

Permission Why It's Needed How to Grant
Screen Recording To capture your display System Settings β†’ Privacy & Security β†’ Screen Recording
Microphone To record your voice System Settings β†’ Privacy & Security β†’ Microphone
Accessibility To detect Google Meet in browsers System Settings β†’ Privacy & Security β†’ Accessibility

πŸ’‘ Tip: If the app can't record, check that all permissions are enabled in System Settings.


πŸš€ How It Works

Fully Automatic Mode (Default)

  1. Launch the app β€” It runs in your menu bar (⏺ icon)
  2. Join a meeting β€” Open Zoom, Teams, or Google Meet
  3. Recording starts automatically β€” You'll see a notification
  4. End the meeting β€” Close the app or leave the call
  5. Auto-saved! β€” Recording saves to your default folder automatically

That's it. No clicking. No dialogs. Just works.

πŸ’‘ Recordings are saved to ~/Movies/Call Recordings/ by default. Change this in Preferences.

Manual Mode (Optional)

If you prefer more control, disable "Fully Automatic Mode" in Preferences:

  • Choose which display to record
  • Name and save files manually after each recording

🎯 Supported Apps

Native Apps (Auto-detected)

  • βœ… Zoom (us.zoom.xos)
  • βœ… Microsoft Teams (new and legacy versions)

Browser-Based (Window Title Detection)

  • βœ… Google Meet - Works in any browser:
    • Safari
    • Chrome / Comet
    • Firefox
    • Microsoft Edge
    • Arc
    • Brave
    • Opera
    • Vivaldi

βš™οΈ Preferences

Click the menu bar icon β†’ Preferences to configure:

Setting Description
Fully Automatic Mode Zero-interaction recording (enabled by default)
Watched Apps Toggle which apps trigger recordings
Default Save Folder Where recordings are auto-saved
Display Selection (Manual mode) Ask every time vs. remember per app
Start at Login Auto-launch when you log in

πŸ“Ή Recording Specs

Property Value
Resolution 1080p (scaled from your display)
Frame Rate 30 fps
Video Codec H.264 (hardware accelerated)
Audio 48kHz stereo AAC
File Format .mov (QuickTime)
Audio Sources System audio + Microphone

πŸ› οΈ Troubleshooting

App doesn't appear in menu bar

  • Check if it's running: ps aux | grep AutoCallRecorder
  • Try launching from Terminal: open /Applications/MacMeetingAutoRecorder.app

Recording permission denied

  1. Open System Settings β†’ Privacy & Security β†’ Screen Recording
  2. Find and enable MacMeetingAutoRecorder
  3. Restart the app

No audio in recordings

  1. Open System Settings β†’ Privacy & Security β†’ Microphone
  2. Enable MacMeetingAutoRecorder

Google Meet not detected

  1. Open System Settings β†’ Privacy & Security β†’ Accessibility
  2. Enable MacMeetingAutoRecorder
  3. Restart the app

Recording is black/empty

  • Ensure you selected the correct display
  • Some apps (like DRM-protected content) cannot be captured

πŸ—οΈ Project Structure

MacMeetingAutoRecorder/
β”œβ”€β”€ AutoCallRecorder/
β”‚   β”œβ”€β”€ AutoCallRecorder.xcodeproj/
β”‚   └── Sources/
β”‚       β”œβ”€β”€ AutoCallRecorderApp.swift    # Main entry point
β”‚       β”œβ”€β”€ Models/
β”‚       β”‚   β”œβ”€β”€ RecordingState.swift     # State machine
β”‚       β”‚   β”œβ”€β”€ WatchedApp.swift         # App definitions
β”‚       β”‚   └── DisplayInfo.swift        # Display wrapper
β”‚       β”œβ”€β”€ Managers/
β”‚       β”‚   β”œβ”€β”€ AppWatcher.swift         # Native app detection
β”‚       β”‚   β”œβ”€β”€ BrowserWatcher.swift     # Google Meet detection
β”‚       β”‚   β”œβ”€β”€ ScreenCaptureManager.swift
β”‚       β”‚   β”œβ”€β”€ RecordingManager.swift   # Orchestration
β”‚       β”‚   β”œβ”€β”€ PreferencesManager.swift
β”‚       β”‚   └── LoginItemManager.swift
β”‚       └── Views/
β”‚           β”œβ”€β”€ MenuBarView.swift
β”‚           β”œβ”€β”€ ScreenSelectionView.swift
β”‚           β”œβ”€β”€ PreferencesView.swift
β”‚           └── SaveDialogHelper.swift
β”œβ”€β”€ README.md
β”œβ”€β”€ CHANGELOG.md
└── SPEC.md

πŸ“‹ Requirements

  • macOS 14.0 (Sonoma) or later
  • Xcode 15+ (for building from source)

πŸ“„ License

This project is licensed under the MIT License - see the LICENSE file for details.


🀝 Contributing

Contributions are welcome! Feel free to:

  • πŸ› Report bugs
  • πŸ’‘ Suggest features
  • πŸ”§ Submit pull requests

πŸ“¬ Contact

Created by @crshdn


Never forget to record an important meeting again.

About

A mac app that auto-records meetings for Zoom, Google Meet and Teams.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages