Releases: BozhengLong/meetrec
v0.1.1 — Polish: level meters, timer in menu bar, app icon
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 resetfix. - 🧰 Icon build pipeline —
make-icon.py+make-icon.shregenerate the icon from parameters. Changing colors / shape is now a one-commit edit.
Install
Same as v0.1.0:
- Download
MeetRec.app.zipbelow, unzip - Drag
MeetRec.appto/Applications - First launch: System Settings → Privacy & Security → Open Anyway, or:
xattr -dr com.apple.quarantine /Applications/MeetRec.app
- Grant Microphone and Screen Recording permissions when prompted
- 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.shWhat'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 (
⌥⌘Bto drop a timestamp into a sidecar file)
Full changelog: v0.1.0...v0.1.1
v0.1.0 — First 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
- Download `MeetRec.app.zip` below, unzip
- Drag `MeetRec.app` to `/Applications`
- 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:
- Try to open the app once (it'll be blocked)
- 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
```