Skip to content

tenequm/blackbox

Repository files navigation

Blackbox

Blackbox

macOS menu bar app that automatically records audio from your calls.

Detects when your microphone becomes active (e.g. during calls) and records system audio automatically. Works with any app - Zoom, Meet, Teams, Discord, FaceTime, Telegram, and more. Saves M4A files locally.

Blackbox recordings window

Install

Download the latest .dmg from Releases, open it, and drag Blackbox to Applications.

On first launch, grant Screen Recording and Microphone permissions when prompted.

Features

  • Auto-records when your microphone becomes active (any calling app)
  • Manual record/stop for on-demand system audio capture
  • Dual-track M4A (system audio + microphone in manual recordings)
  • Notification when recording is saved (click to reveal in Finder)
  • Configurable grace period, save location, and notification preferences
  • Auto-updates

Build from source

git clone https://github.com/tenequm/blackbox.git
cd blackbox
make install
open /Applications/Blackbox.app

Requires macOS 15+ and Swift 6.2+ (Xcode 16+).

Acknowledgments

Blackbox's ScreenCaptureKit audio capture architecture was informed by studying Azayaka by Martin Persson - a clean, well-built macOS screen and audio recorder. Azayaka's approach to dual-track recording and its PCM buffer conversion patterns (based on Apple's ScreenCaptureKit documentation and this gist by aibo-cora) were valuable references during development.

License

GPL v3 - see LICENSE

About

Auto-records every call on macOS. Detects mic activity, captures system audio + mic, saves as M4A. No bots, no browser extensions - just a menu bar icon.

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors