node-mac-recorder 2.2.1 → 2.4.1

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/binding.gyp

@@ -5,7 +5,6 @@
       "sources": [
         "src/mac_recorder.mm",
         "src/screen_capture.mm",
-        "src/screen_capture_kit.mm",
         "src/audio_capture.mm",
         "src/cursor_tracker.mm",
         "src/window_selector.mm"
@@ -22,11 +21,8 @@
         "GCC_ENABLE_CPP_EXCEPTIONS": "YES",
         "CLANG_CXX_LIBRARY": "libc++",
         "MACOSX_DEPLOYMENT_TARGET": "12.3",
-<<<<<<< HEAD
-=======
         "ARCHS": ["arm64"],
         "VALID_ARCHS": ["arm64"],
->>>>>>> screencapture
         "OTHER_CFLAGS": [
           "-ObjC++",
           "-fmodules"
@@ -35,22 +31,15 @@
       },
       "link_settings": {
         "libraries": [
-<<<<<<< HEAD
-=======
           "-framework ScreenCaptureKit",
           "-framework AVFoundation",
           "-framework CoreMedia",
           "-framework CoreVideo",
->>>>>>> screencapture
           "-framework Foundation",
           "-framework AppKit",
           "-framework ApplicationServices",
           "-framework Carbon",
-          "-framework Accessibility",
-          "-framework CoreAudio",
-          "-framework AVFoundation",
-          "-framework CoreMedia",
-          "-framework CoreVideo"
+          "-framework Accessibility"
         ]
       },
       "defines": [ 

package/index.js

@@ -2,22 +2,26 @@ const { EventEmitter } = require("events");
 const path = require("path");
 const fs = require("fs");
 
-// Native modülü yükle (prebuilt > local build fallback)
+// Native modülü yükle
 let nativeBinding;
 try {
-	// Prebuilt
-	nativeBinding = require("node-gyp-build")(__dirname);
-} catch (e) {
+	// Prefer prebuild on arm64
+	if (process.platform === "darwin" && process.arch === "arm64") {
+		nativeBinding = require("./prebuilds/darwin-arm64/node.napi.node");
+	} else {
+		nativeBinding = require("./build/Release/mac_recorder.node");
+	}
+} catch (error) {
 	try {
 		nativeBinding = require("./build/Release/mac_recorder.node");
-	} catch (error) {
+	} catch (_) {
 		try {
 			nativeBinding = require("./build/Debug/mac_recorder.node");
 		} catch (debugError) {
 			throw new Error(
 				'Native module not found. Please run "npm run build" to compile the native module.\n' +
 					"Original error: " +
-					(error?.message || e?.message)
+					error.message
 			);
 		}
 	}
@@ -50,12 +54,6 @@ class MacRecorder extends EventEmitter {
 			showClicks: false,
 			displayId: null, // Hangi ekranı kaydedeceği (null = ana ekran)
 			windowId: null, // Hangi pencereyi kaydedeceği (null = tam ekran)
-			// SC (gizli, opsiyonel) - mevcut kullanıcıları bozmaz
-			useScreenCaptureKit: false,
-			excludedAppBundleIds: [],
-			excludedPIDs: [],
-			excludedWindowIds: [],
-			autoExcludeSelf: !!(process.versions && process.versions.electron),
 		};
 
 		// Display cache için async initialization
@@ -129,22 +127,11 @@ class MacRecorder extends EventEmitter {
 			audioDeviceId: options.audioDeviceId || null, // null = default device
 			systemAudioDeviceId: options.systemAudioDeviceId || null, // null = auto-detect system audio device
 			captureArea: options.captureArea || null,
-<<<<<<< HEAD
-			useScreenCaptureKit: options.useScreenCaptureKit || false,
-			excludedAppBundleIds: options.excludedAppBundleIds || [],
-			excludedPIDs: options.excludedPIDs || [],
-			excludedWindowIds: options.excludedWindowIds || [],
-			autoExcludeSelf:
-				typeof options.autoExcludeSelf === "boolean"
-					? options.autoExcludeSelf
-					: !!(process.versions && process.versions.electron),
-=======
 			// Exclusion options
 			excludeCurrentApp: options.excludeCurrentApp || false,
 			excludeWindowIds: Array.isArray(options.excludeWindowIds)
 				? options.excludeWindowIds
 				: [],
->>>>>>> screencapture
 		};
 	}
 
@@ -305,17 +292,9 @@ class MacRecorder extends EventEmitter {
 					windowId: this.options.windowId || null, // null = tam ekran
 					audioDeviceId: this.options.audioDeviceId || null, // null = default device
 					systemAudioDeviceId: this.options.systemAudioDeviceId || null, // null = auto-detect system audio device
-<<<<<<< HEAD
-					useScreenCaptureKit: this.options.useScreenCaptureKit || false,
-					excludedAppBundleIds: this.options.excludedAppBundleIds || [],
-					excludedPIDs: this.options.excludedPIDs || [],
-					excludedWindowIds: this.options.excludedWindowIds || [],
-					autoExcludeSelf: this.options.autoExcludeSelf === true,
-=======
 					// Exclusion options passthrough
 					excludeCurrentApp: this.options.excludeCurrentApp || false,
 					excludeWindowIds: this.options.excludeWindowIds || [],
->>>>>>> screencapture
 				};
 
 				// Manuel captureArea varsa onu kullan
@@ -328,34 +307,10 @@ class MacRecorder extends EventEmitter {
 					};
 				}
 
-				// SC yolu: kullanıcıdan SC talebi varsa veya exclude listeleri doluysa ve SC mevcutsa otomatik kullan
-				let success;
-				try {
-					const wantsSC = !!(
-						this.options.useScreenCaptureKit ||
-						this.options.excludedAppBundleIds?.length ||
-						this.options.excludedPIDs?.length ||
-						this.options.excludedWindowIds?.length
-					);
-					const scAvailable =
-						typeof nativeBinding.isScreenCaptureKitAvailable === "function" &&
-						nativeBinding.isScreenCaptureKitAvailable();
-					if (wantsSC && scAvailable) {
-						const scOptions = {
-							...recordingOptions,
-							useScreenCaptureKit: true,
-						};
-						success = nativeBinding.startRecording(outputPath, scOptions);
-					} else {
-						success = nativeBinding.startRecording(
-							outputPath,
-							recordingOptions
-						);
-					}
-				} catch (e) {
-					// Fallback AVFoundation
-					success = nativeBinding.startRecording(outputPath, recordingOptions);
-				}
+				const success = nativeBinding.startRecording(
+					outputPath,
+					recordingOptions
+				);
 
 				if (success) {
 					this.isRecording = true;

package/install.js

@@ -2,7 +2,7 @@ const { spawn } = require("child_process");
 const fs = require("fs");
 const path = require("path");
 
-console.log("🔨 Building native macOS recorder module...\n");
+console.log("🔨 Installing node-mac-recorder...\n");
 
 // Check if we're on macOS
 if (process.platform !== "darwin") {
@@ -10,7 +10,24 @@ if (process.platform !== "darwin") {
 	process.exit(1);
 }
 
-// Check if Xcode Command Line Tools are installed
+// Prefer prebuilds on supported platforms
+const prebuildPath = path.join(
+	__dirname,
+	"prebuilds",
+	`darwin-${process.arch}`,
+	"node.napi.node"
+);
+if (
+	process.platform === "darwin" &&
+	process.arch === "arm64" &&
+	fs.existsSync(prebuildPath)
+) {
+	console.log("✅ Using prebuilt binary:", prebuildPath);
+	console.log("🎉 node-mac-recorder is ready to use (no compilation needed)");
+	process.exit(0);
+}
+
+// Fallback to building from source
 console.log("🔍 Checking Xcode Command Line Tools...");
 const xcodebuild = spawn("xcode-select", ["--print-path"], { stdio: "pipe" });
 

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "node-mac-recorder",
-	"version": "2.2.1",
+	"version": "2.4.1",
 	"description": "Native macOS screen recording package for Node.js applications",
 	"main": "index.js",
 	"keywords": [
@@ -37,20 +37,19 @@
 		"install": "node install.js",
 		"build": "node-gyp build",
 		"rebuild": "node-gyp rebuild",
+		"prebuild:node-arm64": "prebuildify --platform darwin --arch arm64 --napi --strip",
+		"prebuild:electron-arm64": "prebuildify --platform darwin --arch arm64 --napi --strip --targets electron@27.0.0",
+		"prebuild:all-arm64": "npm run prebuild:node-arm64 && npm run prebuild:electron-arm64",
 		"clean": "node-gyp clean",
-		"prebuild:darwin:arm64": "prebuildify --napi --strip --platform darwin --arch arm64",
-		"prebuild:darwin:x64": "prebuildify --napi --strip --platform darwin --arch x64",
-		"prebuild": "npm run prebuild:darwin:arm64 && npm run prebuild:darwin:x64",
 		"test:window-selector": "node window-selector-test.js",
 		"example:window-selector": "node examples/window-selector-example.js"
 	},
 	"dependencies": {
-		"node-addon-api": "^7.0.0",
-		"node-gyp-build": "^4.6.0"
+		"node-addon-api": "^7.0.0"
 	},
 	"devDependencies": {
 		"node-gyp": "^10.0.0",
-		"prebuildify": "^5.0.0"
+		"prebuildify": "^6.0.1"
 	},
 	"gypfile": true
 }