Skip to content

mac-rec 0.4.0 — first public build

Choose a tag to compare

@joelburlin joelburlin released this 30 Aug 22:53
· 5 commits to main since this release

macOS 15 (Sequoia) or later · universal (Apple silicon + Intel) · 2.2 MB

Download Mac-Rec-0.4.0.dmg below, drag it to Applications, then right-click → Open the first time.

⚠️ First launch needs a right-click. This build is open source and unnotarized (notarizing requires a paid Apple Developer ID), so macOS quarantines it on download. Right-click → Open → Open — once. If macOS still refuses: xattr -dr com.apple.quarantine /Applications/Mac-Rec.app

Prefer to build it yourself? git clone + ./make-app.sh takes about a minute and skips Gatekeeper entirely.

On first record, macOS asks for Screen Recording (and Microphone, if you want narration). The app spawns the recorder daemon, so one grant covers the menu-bar UI, the mac-rec CLI, and any agent.

What's in it

  • Live rewind — record into 2-second fragments; rewinding deletes trailing fragments, so it's instant and lossless
  • Capture a display, a single window, or a dragged region, with system audio + microphone on separate tracks
  • Captions — whisper.cpp with word timings, five burn-in templates (classic / boxed / bold / karaoke / minimal), rendered with CoreText so Hebrew and Arabic come out right
  • AI re-narration — replace your recorded voice with an ElevenLabs voice, sentence-anchored so captions and picture stay in sync
  • Mic that survives reality — auto-gain for quiet webcam mics, denoise, live mute, level meter on the floating pill
  • Agent-drivable — every verb is a hotkey, a --json CLI command, and a localhost REST call. Drop skills/mac-rec into ~/.claude/skills/ and an agent can record itself working.

Needs

ffmpeg for the finalize pipeline (brew install ffmpeg), whisper-cpp for captions, gcloud only for uploads.

Full docs: https://screenrecording.dev