node-mac-recorder 2.1.3 → 2.4.0

package/.claude/settings.local.json

@@ -17,7 +17,12 @@
       "Bash(touch:*)",
       "Bash(git add:*)",
       "Bash(git commit:*)",
-      "Bash(find:*)"
+      "Bash(find:*)",
+      "WebFetch(domain:developer.apple.com)",
+      "WebFetch(domain:github.com)",
+      "WebFetch(domain:nonstrict.eu)",
+      "Bash(cp:*)",
+      "Bash(git checkout:*)"
     ],
     "deny": []
   }

package/README.md

@@ -1,6 +1,6 @@
 # node-mac-recorder
 
-A powerful native macOS screen recording Node.js package with advanced window selection, multi-display support, and granular audio controls. Built with AVFoundation and ScreenCaptureKit for optimal performance.
+A powerful native macOS screen recording Node.js package with advanced window selection, multi-display support, and granular audio controls. Built with AVFoundation for optimal performance.
 
 ## Features
 
@@ -12,7 +12,6 @@ A powerful native macOS screen recording Node.js package with advanced window se
 - 🖱️ **Multi-Display Support** - Automatic display detection and selection
 - 🎨 **Cursor Control** - Toggle cursor visibility in recordings
 - 🖱️ **Cursor Tracking** - Track mouse position, cursor types, and click events
-- 🚫 **Exclude Apps/Windows (macOS 15+)** - Use ScreenCaptureKit to exclude specific apps (bundle id/PID) and windows
 
 🎵 **Granular Audio Controls**
 
@@ -50,11 +49,6 @@ npm install node-mac-recorder
 - **Screen Recording Permission** (automatically requested)
 - **CPU Architecture**: Intel (x64) and Apple Silicon (ARM64) supported
 
-ScreenCaptureKit path and exclusion support:
-
-- Requires macOS 15.0+ for on-disk recording via `SCRecordingOutput`
-- On older systems (<=14), the library falls back to AVFoundation automatically (exclusions not available)
-
 ### Build Requirements
 
 ```bash
@@ -116,22 +110,9 @@ await recorder.startRecording("./recording.mov", {
 	quality: "high", // 'low', 'medium', 'high'
 	frameRate: 30, // FPS (15, 30, 60)
 	captureCursor: false, // Show cursor (default: false)
-
-	// ScreenCaptureKit (macOS 15+) - optional, backward compatible
-	useScreenCaptureKit: false, // If true and available, prefers ScreenCaptureKit
-	excludedAppBundleIds: ["com.apple.Safari"], // Exclude by bundle id
-	excludedPIDs: [process.pid], // Exclude by PID
-	excludedWindowIds: [12345, 67890], // Exclude specific window IDs
-	// When running under Electron, autoExcludeSelf defaults to true
-	autoExcludeSelf: true,
 });
 ```
 
-Notes
-
-- If any of `excludedAppBundleIds`, `excludedPIDs`, `excludedWindowIds` are provided, the library automatically switches to ScreenCaptureKit on supported macOS versions.
-- When running inside Electron, the current app PID is excluded by default (`autoExcludeSelf: true`).
-
 #### `stopRecording()`
 
 Stops the current recording.
@@ -324,29 +305,6 @@ await new Promise((resolve) => setTimeout(resolve, 10000)); // 10 seconds
 await recorder.stopRecording();
 ```
 
-### Exclude Electron app and other windows (ScreenCaptureKit)
-
-```javascript
-const recorder = new MacRecorder();
-
-// By default, when running inside Electron, your app is auto-excluded.
-// You can also exclude other apps/windows explicitly:
-await recorder.startRecording("./excluded.mov", {
-	captureCursor: true,
-	// Prefer SC explicitly (optional — auto-enabled when exclusions are set)
-	useScreenCaptureKit: true,
-	excludedAppBundleIds: ["com.apple.Safari"],
-	excludedWindowIds: [
-		/* CGWindowID list */
-	],
-	// autoExcludeSelf is true by default on Electron; set false to include your app
-	// autoExcludeSelf: false,
-});
-
-// ... later
-await recorder.stopRecording();
-```
-
 ### Multi-Display Recording
 
 ```javascript
@@ -404,17 +362,16 @@ audioDevices.forEach((device, i) => {
 });
 
 // Find system audio device (like BlackHole, Soundflower, etc.)
-const systemAudioDevice = audioDevices.find(
-	(device) =>
-		device.name.toLowerCase().includes("blackhole") ||
-		device.name.toLowerCase().includes("soundflower") ||
-		device.name.toLowerCase().includes("loopback") ||
-		device.name.toLowerCase().includes("aggregate")
+const systemAudioDevice = audioDevices.find(device => 
+	device.name.toLowerCase().includes('blackhole') ||
+	device.name.toLowerCase().includes('soundflower') ||
+	device.name.toLowerCase().includes('loopback') ||
+	device.name.toLowerCase().includes('aggregate')
 );
 
 if (systemAudioDevice) {
 	console.log(`Using system audio device: ${systemAudioDevice.name}`);
-
+	
 	// Record with specific system audio device
 	await recorder.startRecording("./system-audio-specific.mov", {
 		includeMicrophone: false,
@@ -423,10 +380,8 @@ if (systemAudioDevice) {
 		captureArea: { x: 0, y: 0, width: 1, height: 1 }, // Minimal video
 	});
 } else {
-	console.log(
-		"No system audio device found. Installing BlackHole or Soundflower recommended."
-	);
-
+	console.log("No system audio device found. Installing BlackHole or Soundflower recommended.");
+	
 	// Record with default system audio capture (may not work without virtual audio device)
 	await recorder.startRecording("./system-audio-default.mov", {
 		includeMicrophone: false,
@@ -436,7 +391,7 @@ if (systemAudioDevice) {
 }
 
 // Record for 10 seconds
-await new Promise((resolve) => setTimeout(resolve, 10000));
+await new Promise(resolve => setTimeout(resolve, 10000));
 await recorder.stopRecording();
 ```
 
@@ -445,7 +400,7 @@ await recorder.stopRecording();
 For reliable system audio capture, install a virtual audio device:
 
 1. **BlackHole** (Free): https://github.com/ExistentialAudio/BlackHole
-2. **Soundflower** (Free): https://github.com/mattingalls/Soundflower
+2. **Soundflower** (Free): https://github.com/mattingalls/Soundflower  
 3. **Loopback** (Paid): https://rogueamoeba.com/loopback/
 
 These create aggregate audio devices that the package can detect and use for system audio capture.
@@ -765,11 +720,6 @@ npm cache clean --force
 xcode-select --install
 ```
 
-### ScreenCaptureKit availability
-
-- Exclusions require macOS 15+ (uses `SCRecordingOutput`).
-- On macOS 12.3–14, the module will fall back to AVFoundation (no exclusions). This is automatic and backward-compatible.
-
 ### Recording Issues
 
 1. **Empty/Black Video**: Check screen recording permissions
@@ -824,24 +774,12 @@ MIT License - see [LICENSE](LICENSE) file for details.
 
 ### Latest Updates
 
-- ✅ ScreenCaptureKit path with exclusions (apps by bundle id/PID and window IDs) on macOS 15+
-- ✅ Electron apps auto-excluded by default (can be disabled with `autoExcludeSelf: false`)
-- ✅ Prebuilt binaries for darwin-arm64 and darwin-x64; automatic loading via `node-gyp-build`
-- ✅ Cursor Tracking: Track mouse position, cursor types, and click events with JSON export
-- ✅ Window Recording: Automatic coordinate conversion for multi-display setups
-- ✅ Audio Controls: Separate microphone and system audio controls
-- ✅ Display Selection: Multi-monitor support with automatic detection
-- ✅ Smart Filtering: Improved window detection and filtering
-- ✅ Performance: Optimized native implementation
-
-## Prebuilt binaries
-
-This package ships prebuilt native binaries for macOS:
-
-- darwin-arm64 (Apple Silicon)
-- darwin-x64 (Intel)
-
-At runtime, the correct binary is loaded automatically via `node-gyp-build`. If a prebuilt is not available for your environment, the module falls back to a local build.
+- ✅ **Cursor Tracking**: Track mouse position, cursor types, and click events with JSON export
+- ✅ **Window Recording**: Automatic coordinate conversion for multi-display setups
+- ✅ **Audio Controls**: Separate microphone and system audio controls
+- ✅ **Display Selection**: Multi-monitor support with automatic detection
+- ✅ **Smart Filtering**: Improved window detection and filtering
+- ✅ **Performance**: Optimized native implementation
 
 ---
 

package/backup/binding.gyp

@@ -0,0 +1,44 @@
+{
+  "targets": [
+    {
+      "target_name": "mac_recorder",
+      "sources": [
+        "src/mac_recorder.mm",
+        "src/screen_capture.mm",
+        "src/audio_capture.mm",
+        "src/cursor_tracker.mm",
+        "src/window_selector.mm"
+      ],
+      "include_dirs": [
+        "<!@(node -p \"require('node-addon-api').include\")"
+      ],
+      "dependencies": [
+        "<!(node -p \"require('node-addon-api').gyp\")"
+      ],
+      "cflags!": [ "-fno-exceptions" ],
+      "cflags_cc!": [ "-fno-exceptions" ],
+      "xcode_settings": {
+        "GCC_ENABLE_CPP_EXCEPTIONS": "YES",
+        "CLANG_CXX_LIBRARY": "libc++",
+        "MACOSX_DEPLOYMENT_TARGET": "10.15",
+        "OTHER_CFLAGS": [
+          "-ObjC++"
+        ]
+      },
+      "link_settings": {
+        "libraries": [
+          "-framework AVFoundation",
+          "-framework CoreMedia",
+          "-framework CoreVideo",
+          "-framework Foundation",
+          "-framework AppKit",
+          "-framework ScreenCaptureKit",
+          "-framework ApplicationServices",
+          "-framework Carbon",
+          "-framework Accessibility"
+        ]
+      },
+      "defines": [ "NAPI_DISABLE_CPP_EXCEPTIONS" ]
+    }
+  ]
+} 

package/backup/src/audio_capture.mm

@@ -0,0 +1,116 @@
+#import <AVFoundation/AVFoundation.h>
+#import <CoreAudio/CoreAudio.h>
+
+@interface AudioCapture : NSObject
+
++ (NSArray *)getAudioDevices;
++ (BOOL)hasAudioPermission;
++ (void)requestAudioPermission:(void(^)(BOOL granted))completion;
+
+@end
+
+@implementation AudioCapture
+
++ (NSArray *)getAudioDevices {
+    NSMutableArray *devices = [NSMutableArray array];
+    
+    // Get all audio devices
+    NSArray *audioDevices = [AVCaptureDevice devicesWithMediaType:AVMediaTypeAudio];
+    
+    for (AVCaptureDevice *device in audioDevices) {
+        NSDictionary *deviceInfo = @{
+            @"id": device.uniqueID,
+            @"name": device.localizedName,
+            @"manufacturer": device.manufacturer ?: @"Unknown",
+            @"isDefault": @([device isEqual:[AVCaptureDevice defaultDeviceWithMediaType:AVMediaTypeAudio]])
+        };
+        
+        [devices addObject:deviceInfo];
+    }
+    
+    // Also get system audio devices using Core Audio
+    AudioObjectPropertyAddress propertyAddress = {
+        kAudioHardwarePropertyDevices,
+        kAudioObjectPropertyScopeGlobal,
+        kAudioObjectPropertyElementMaster
+    };
+    
+    UInt32 dataSize = 0;
+    OSStatus status = AudioObjectGetPropertyDataSize(kAudioObjectSystemObject, &propertyAddress, 0, NULL, &dataSize);
+    
+    if (status == kAudioHardwareNoError) {
+        UInt32 deviceCount = dataSize / sizeof(AudioDeviceID);
+        AudioDeviceID *audioDeviceIDs = (AudioDeviceID *)malloc(dataSize);
+        
+        status = AudioObjectGetPropertyData(kAudioObjectSystemObject, &propertyAddress, 0, NULL, &dataSize, audioDeviceIDs);
+        
+        if (status == kAudioHardwareNoError) {
+            for (UInt32 i = 0; i < deviceCount; i++) {
+                AudioDeviceID deviceID = audioDeviceIDs[i];
+                
+                // Get device name
+                propertyAddress.mSelector = kAudioDevicePropertyDeviceNameCFString;
+                propertyAddress.mScope = kAudioObjectPropertyScopeGlobal;
+                
+                CFStringRef deviceName = NULL;
+                dataSize = sizeof(deviceName);
+                
+                status = AudioObjectGetPropertyData(deviceID, &propertyAddress, 0, NULL, &dataSize, &deviceName);
+                
+                if (status == kAudioHardwareNoError && deviceName) {
+                    // Check if it's an input device
+                    propertyAddress.mSelector = kAudioDevicePropertyStreamConfiguration;
+                    propertyAddress.mScope = kAudioDevicePropertyScopeInput;
+                    
+                    AudioObjectGetPropertyDataSize(deviceID, &propertyAddress, 0, NULL, &dataSize);
+                    
+                    if (dataSize > 0) {
+                        AudioBufferList *bufferList = (AudioBufferList *)malloc(dataSize);
+                        AudioObjectGetPropertyData(deviceID, &propertyAddress, 0, NULL, &dataSize, bufferList);
+                        
+                        if (bufferList->mNumberBuffers > 0) {
+                            NSDictionary *deviceInfo = @{
+                                @"id": @(deviceID),
+                                @"name": (__bridge NSString *)deviceName,
+                                @"type": @"System Audio Input",
+                                @"isSystemDevice": @YES
+                            };
+                            
+                            [devices addObject:deviceInfo];
+                        }
+                        
+                        free(bufferList);
+                    }
+                    
+                    CFRelease(deviceName);
+                }
+            }
+        }
+        
+        free(audioDeviceIDs);
+    }
+    
+    return [devices copy];
+}
+
++ (BOOL)hasAudioPermission {
+    if (@available(macOS 10.14, *)) {
+        AVAuthorizationStatus status = [AVCaptureDevice authorizationStatusForMediaType:AVMediaTypeAudio];
+        return status == AVAuthorizationStatusAuthorized;
+    }
+    return YES; // Older versions don't require explicit permission
+}
+
++ (void)requestAudioPermission:(void(^)(BOOL granted))completion {
+    if (@available(macOS 10.14, *)) {
+        [AVCaptureDevice requestAccessForMediaType:AVMediaTypeAudio completionHandler:^(BOOL granted) {
+            dispatch_async(dispatch_get_main_queue(), ^{
+                completion(granted);
+            });
+        }];
+    } else {
+        completion(YES);
+    }
+}
+
+@end