Skip to content

v0.1.0 — First release

Choose a tag to compare

@BozhengLong BozhengLong released this 24 May 01:58
· 3 commits to main since this release

First public release of MeetRec — a minimal macOS menu-bar recorder for system audio + microphone.

What's in this release

  • Menu-bar app (no dock icon)
  • System audio capture via ScreenCaptureKit (works with AirPods, built-in speakers, external DACs)
  • Microphone capture via AVAudioEngine
  • Single stereo m4a output: L = system audio, R = microphone, AAC 128 kbps @ 48 kHz
  • Per-channel mute with global hotkeys:
    • `⌥⌘M` — toggle microphone
    • `⌥⌘S` — toggle system audio
    • `⌥⌘R` — start / stop recording
  • Saves to `~/Recordings/YYYY-MM-DD_HHMM.m4a`, reveals in Finder on stop
  • Diagnostic log at `~/Recordings/meetrec.log`

Requirements

  • macOS 14.2 or later
  • Apple Silicon or Intel Mac
  • Microphone permission + Screen Recording permission (used only for audio capture; no video is saved)

Install

  1. Download `MeetRec.app.zip` below, unzip
  2. Drag `MeetRec.app` to `/Applications`
  3. Double-click to launch

First launch will be blocked by Gatekeeper

This build is ad-hoc signed only (not notarized by Apple), so macOS will refuse to open it the first time. Two options:

Option A — System Settings:

  1. Try to open the app once (it'll be blocked)
  2. System Settings → Privacy & Security → scroll down → click Open Anyway next to MeetRec

Option B — terminal one-liner (faster):
```bash
xattr -dr com.apple.quarantine /Applications/MeetRec.app
```

Then double-click normally. A record icon will appear in your menu bar.

Known limitations

  • No transcription — by design. Feed the m4a to MacWhisper / Buzz / whisper.cpp / ChatGPT.
  • No pause within a single file — stop & restart creates a new file.
  • Switching output device mid-recording is untested.

Build from source instead

If you'd rather not deal with the unsigned binary:

```bash
git clone https://github.com/BozhengLong/meetrec.git
cd meetrec
./make-app.sh
```