Skip to content

Releases: BozhengLong/meetrec

v0.1.1 — Polish: level meters, timer in menu bar, app icon

24 May 03:02

Choose a tag to compare

A polish release. No new core functionality — everything from v0.1.0 still works the same way — but the daily-use experience is meaningfully better.

What's new

  • 🎨 App icon — Finder, LaunchPad, Cmd+Tab, and Spotlight now show a proper red-record-dot squircle instead of the generic macOS app placeholder.
  • 📊 Live level meters in the menu bar popover — one bar per channel, green → yellow → red. Confirms at a glance that audio is actually flowing, and makes muted channels visually obvious.
  • ⏱️ Elapsed time in the menu bar — recording duration is shown directly next to the icon (e.g. 🔴 01:23), so you don't have to open the popover to check.
  • 📖 README rewrite — leads with the product value, adds a comparison table vs Granola / Audio Hijack / BlackHole+OBS, collapses the architecture/internals into expandable sections, adds shields.io badges.
  • 🛠️ TCC troubleshooting — documented the most common "permission silently denied after rebuild" gotcha, with a one-line tccutil reset fix.
  • 🧰 Icon build pipelinemake-icon.py + make-icon.sh regenerate the icon from parameters. Changing colors / shape is now a one-commit edit.

Install

Same as v0.1.0:

  1. Download MeetRec.app.zip below, unzip
  2. Drag MeetRec.app to /Applications
  3. First launch: System Settings → Privacy & Security → Open Anyway, or:
    xattr -dr com.apple.quarantine /Applications/MeetRec.app
  4. Grant Microphone and Screen Recording permissions when prompted
  5. If you only get mic audio after rebuilding, the Screen Recording TCC may be stuck:
    tccutil reset ScreenCapture com.local.meetrec

Build from source

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

What's still missing (planned)

  • Demo gif in the README — soon
  • GitHub Actions to auto-build releases on tag push — soon-ish
  • Pause/resume within a single file
  • Bookmark markers (⌥⌘B to drop a timestamp into a sidecar file)

Full changelog: v0.1.0...v0.1.1

v0.1.0 — First release

24 May 01:58

Choose a tag to compare

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
```