Open-Source macOS Screen Recorder for Node.js
Native ScreenCaptureKit + AVFoundation recorder with window selection, multi-display, overlay exclusion, granular audio, camera capture and cursor tracking. The same engine that powers Creavit Studio.
Powered by ScreenCaptureKit
Modern, high-performance capture with native macOS APIs.
Window / Display / Area Recording
Full screen, window-specific or custom region recording with automatic overlay window exclusion via ScreenCaptureKit.
Camera Capture
Video-only camera companion clip saved with shared session timestamp. Device listing with resolution metadata.
Granular Audio Control
Separate microphone and system audio toggles with device selection. Audio saved to a synchronized companion file.
Cursor Tracking
Track mouse position, cursor types (pointer, text, grab, crosshair) and click events to JSON in real time.
Multi-Display Support
Accurate coordinate mapping across multiple displays. Automatic display detection for window recording.
Electron Compatible
Crash protection for Electron environments. Window/display thumbnails for selection UIs. Never blocks the main process.
Why ScreenCaptureKit + AVFoundation?
Combines the best of both native macOS frameworks: ScreenCaptureKit for screen recording (macOS 12.3+), AVFoundation for camera capture and audio processing.
- Native overlay window exclusion for clean videos
- Low-latency, low-CPU capture optimized for macOS
- Multi-display awareness with coordinate mapping
- Rock-solid stability in Electron environments
Built for Creavit Studio
node-mac-recorder powers Creavit Studio's recording engine. We open-sourced it so other developers can build their own screen recording applications with native macOS performance.
- MIT licensed — free for commercial use
- Simple API: startRecording, stopRecording, getWindows
- Synchronized output files with shared session timestamp
- macOS 12.3+, Node.js 14+, Xcode CLI Tools
node-mac-recorder vs Other Approaches
Frequently Asked
Questions
Common questions about the open-source recording library.
Explore More
Start Building Today
Free and open source under MIT license. Build professional macOS screen recording apps with native ScreenCaptureKit performance.