node-mac-recorder 2.16.1 → 2.16.3

package/.claude/settings.local.json

@@ -44,7 +44,10 @@
       "Bash(ELECTRON_RUN_AS_NODE=1 node -e \"\nconsole.log(''🎤 Testing microphone only'');\nconst MacRecorder = require(''./index'');\nconst recorder = new MacRecorder();\n\nasync function testMicrophoneOnly() {\n  try {\n    const outputPath = ''./test-output/microphone-only-test.mov'';\n    console.log(''📹 Starting microphone only recording...'');\n    \n    const success = await recorder.startRecording(outputPath, {\n      captureCursor: false,\n      includeMicrophone: true,   // Sadece mikrofon AÇIK\n      includeSystemAudio: false  // Sistem sesi KAPALI\n    });\n    \n    if (success) {\n      console.log(''✅ Microphone recording started - waiting 3 seconds'');\n      await new Promise(resolve => setTimeout(resolve, 3000));\n      \n      console.log(''🛑 Stopping microphone recording...'');\n      await recorder.stopRecording();\n      console.log(''✅ Microphone only test completed!'');\n    } else {\n      console.log(''❌ Recording failed to start'');\n    }\n  } catch (error) {\n    console.log(''❌ Error:'', error.message);\n  }\n}\n\ntestMicrophoneOnly();\n\")",
       "Bash(ELECTRON_RUN_AS_NODE=1 node -e \"\nconsole.log(''🚀 Full stress test - All features + Both audio sources'');\nconst MacRecorder = require(''./index'');\nconst recorder = new MacRecorder();\n\nasync function fullStressTest() {\n  try {\n    const outputPath = ''./test-output/full-stress-test.mov'';\n    console.log(''📹 Starting full featured recording (stress test)...'');\n    \n    const success = await recorder.startRecording(outputPath, {\n      captureCursor: true,       // Cursor kayıt\n      includeMicrophone: true,   // Mikrofon kayıt\n      includeSystemAudio: true,  // Sistem sesi kayıt\n      captureArea: {             // Crop area\n        x: 300,\n        y: 300,\n        width: 800,\n        height: 500\n      }\n    });\n    \n    if (success) {\n      console.log(''✅ Full stress test started - waiting 6 seconds'');\n      await new Promise(resolve => setTimeout(resolve, 6000));\n      \n      console.log(''🛑 Stopping full stress test...'');\n      await recorder.stopRecording();\n      console.log(''🎉 FULL STRESS TEST COMPLETED WITHOUT CRASH!'');\n    } else {\n      console.log(''❌ Recording failed to start'');\n    }\n  } catch (error) {\n    console.log(''❌ Error:'', error.message);\n    console.log(''Stack:'', error.stack);\n  }\n}\n\nfullStressTest();\n\")",
       "Bash(ELECTRON_RUN_AS_NODE=1 node -e \"\nconsole.log(''🧪 Testing version detection and fallback system'');\nconst MacRecorder = require(''./index'');\nconst recorder = new MacRecorder();\n\nasync function testVersionDetection() {\n  try {\n    const outputPath = ''./test-output/version-detection-test.mov'';\n    console.log(''📹 Starting recording with version detection...'');\n    \n    const success = await recorder.startRecording(outputPath, {\n      captureCursor: true,\n      includeMicrophone: false,\n      includeSystemAudio: true\n    });\n    \n    if (success) {\n      console.log(''✅ Recording started - waiting 3 seconds'');\n      await new Promise(resolve => setTimeout(resolve, 3000));\n      \n      console.log(''🛑 Stopping recording...'');\n      await recorder.stopRecording();\n      console.log(''✅ Version detection test completed successfully!'');\n    } else {\n      console.log(''❌ Recording failed to start'');\n    }\n  } catch (error) {\n    console.log(''❌ Error:'', error.message);\n  }\n}\n\ntestVersionDetection();\n\")",
-      "Bash(ELECTRON_RUN_AS_NODE=1 node -e \"\nconsole.log(''🧪 Testing Electron safety measures'');\nconst MacRecorder = require(''./index'');\nconst recorder = new MacRecorder();\n\nasync function testElectronSafety() {\n  try {\n    const outputPath = ''./test-output/electron-safe-test.mov'';\n    console.log(''📹 Starting recording in Electron environment...'');\n    \n    const success = await recorder.startRecording(outputPath, {\n      captureCursor: true,\n      includeMicrophone: false,\n      includeSystemAudio: true\n    });\n    \n    if (success) {\n      console.log(''✅ Recording started safely in Electron - waiting 3 seconds'');\n      await new Promise(resolve => setTimeout(resolve, 3000));\n      \n      console.log(''🛑 Stopping recording...'');\n      await recorder.stopRecording();\n      console.log(''✅ Electron safety test completed successfully!'');\n    } else {\n      console.log(''⚠️ Recording failed to start (expected in some cases)'');\n    }\n  } catch (error) {\n    console.log(''❌ Error:'', error.message);\n  }\n}\n\ntestElectronSafety();\n\")"
+      "Bash(ELECTRON_RUN_AS_NODE=1 node -e \"\nconsole.log(''🧪 Testing Electron safety measures'');\nconst MacRecorder = require(''./index'');\nconst recorder = new MacRecorder();\n\nasync function testElectronSafety() {\n  try {\n    const outputPath = ''./test-output/electron-safe-test.mov'';\n    console.log(''📹 Starting recording in Electron environment...'');\n    \n    const success = await recorder.startRecording(outputPath, {\n      captureCursor: true,\n      includeMicrophone: false,\n      includeSystemAudio: true\n    });\n    \n    if (success) {\n      console.log(''✅ Recording started safely in Electron - waiting 3 seconds'');\n      await new Promise(resolve => setTimeout(resolve, 3000));\n      \n      console.log(''🛑 Stopping recording...'');\n      await recorder.stopRecording();\n      console.log(''✅ Electron safety test completed successfully!'');\n    } else {\n      console.log(''⚠️ Recording failed to start (expected in some cases)'');\n    }\n  } catch (error) {\n    console.log(''❌ Error:'', error.message);\n  }\n}\n\ntestElectronSafety();\n\")",
+      "Bash(FORCE_AVFOUNDATION=1 node -e \"\nconsole.log(''🧪 Testing AVFoundation fallback path'');\nconst MacRecorder = require(''./index'');\nconst recorder = new MacRecorder();\n\nasync function testAVFoundationPath() {\n  try {\n    const outputPath = ''./test-output/force-avfoundation-test.mov'';\n    console.log(''📹 Testing AVFoundation (force mode)...'');\n    \n    const success = await recorder.startRecording(outputPath, {\n      captureCursor: true,\n      includeMicrophone: false,\n      includeSystemAudio: true\n    });\n    \n    if (success) {\n      console.log(''✅ Recording started'');\n      await new Promise(resolve => setTimeout(resolve, 2000));\n      \n      await recorder.stopRecording();\n      console.log(''✅ AVFoundation test completed!'');\n    } else {\n      console.log(''❌ Recording failed'');\n    }\n  } catch (error) {\n    console.log(''❌ Error:'', error.message);\n  }\n}\n\ntestAVFoundationPath();\n\")",
+      "Bash(FORCE_AVFOUNDATION=1 node -e \"\nconsole.log(''🧪 Testing AVFoundation fallback path (macOS 14 simulation)'');\nconst MacRecorder = require(''./index'');\nconst recorder = new MacRecorder();\n\nasync function testAVFoundationPath() {\n  try {\n    const outputPath = ''./test-output/force-avfoundation-test.mov'';\n    console.log(''📹 Testing AVFoundation (simulating macOS 14)...'');\n    \n    const success = await recorder.startRecording(outputPath, {\n      captureCursor: true,\n      includeMicrophone: false,\n      includeSystemAudio: true\n    });\n    \n    if (success) {\n      console.log(''✅ Recording started with AVFoundation'');\n      await new Promise(resolve => setTimeout(resolve, 3000));\n      \n      await recorder.stopRecording();\n      console.log(''✅ AVFoundation test completed successfully!'');\n      console.log(''This is how it should work on macOS 14'');\n    } else {\n      console.log(''❌ Recording failed to start'');\n    }\n  } catch (error) {\n    console.log(''❌ Error:'', error.message);\n  }\n}\n\ntestAVFoundationPath();\n\")",
+      "Bash(FORCE_AVFOUNDATION=1 node -e \"\nconsole.log(''🧪 Testing AVFoundation with detailed debugging'');\nconst MacRecorder = require(''./index'');\nconst recorder = new MacRecorder();\n\nasync function testWithDebugging() {\n  try {\n    const outputPath = ''./test-output/debug-test.mov'';\n    console.log(''📹 Starting AVFoundation test with debugging...'');\n    console.log(''Expected to see detailed AVFoundation logs in console'');\n    \n    const success = await recorder.startRecording(outputPath, {\n      captureCursor: true,\n      includeMicrophone: false,\n      includeSystemAudio: true\n    });\n    \n    if (success) {\n      console.log(''✅ Recording started'');\n      await new Promise(resolve => setTimeout(resolve, 2000));\n      \n      await recorder.stopRecording();\n      console.log(''✅ Test completed'');\n    } else {\n      console.log(''❌ Recording failed - check console logs for AVFoundation details'');\n    }\n  } catch (error) {\n    console.log(''❌ Error:'', error.message);\n  }\n}\n\ntestWithDebugging();\n\")"
     ],
     "deny": []
   }

package/MACOS14_TROUBLESHOOTING.md

@@ -0,0 +1,111 @@
+# macOS 13/14 Recording Troubleshooting Guide
+
+## Expected Behavior by macOS Version
+
+The system automatically detects macOS version and uses the most compatible recording method:
+
+- **macOS 15+**: Uses ScreenCaptureKit (30fps, full features)
+- **macOS 14**: Uses AVFoundation fallback (15fps, stable)
+- **macOS 13**: Uses AVFoundation fallback (15fps, limited features)
+- **macOS < 13**: Not supported
+
+## Debug Steps for macOS 13/14 Issues
+
+### 1. Check Console Logs
+
+When running your application, check for these log messages:
+
+**macOS 14:**
+```
+🖥️ macOS Version: 14.x.x
+🎯 macOS 14 detected - using AVFoundation for better compatibility
+🎥 Using AVFoundation for macOS 14 compatibility
+🎥 RECORDING METHOD: AVFoundation (Fallback)
+```
+
+**macOS 13:**
+```
+🖥️ macOS Version: 13.x.x
+🎯 macOS 13 detected - using AVFoundation (limited features)
+🎥 Using AVFoundation for macOS 13 compatibility (limited features)
+🎥 RECORDING METHOD: AVFoundation (Fallback)
+```
+
+### 2. Test AVFoundation Directly
+
+You can force AVFoundation mode for testing:
+
+```javascript
+// Set environment variable before running
+process.env.FORCE_AVFOUNDATION = "1";
+
+const MacRecorder = require('node-mac-recorder');
+const recorder = new MacRecorder();
+
+async function test() {
+  const success = await recorder.startRecording('./test.mov', {
+    captureCursor: true,
+    includeMicrophone: false,
+    includeSystemAudio: true
+  });
+  
+  if (success) {
+    console.log('✅ AVFoundation recording started');
+    setTimeout(async () => {
+      await recorder.stopRecording();
+      console.log('✅ Recording completed');
+    }, 3000);
+  } else {
+    console.log('❌ Recording failed');
+  }
+}
+
+test();
+```
+
+### 3. Common Issues and Solutions
+
+**Issue**: Recording starts but no video file created
+- **Cause**: Permission issues
+- **Solution**: Check Screen Recording permission in System Preferences
+
+**Issue**: Audio not recorded
+- **Cause**: Microphone permission missing
+- **Solution**: Check Microphone permission in System Preferences
+
+**Issue**: Recording fails silently
+- **Cause**: Invalid display ID or output path
+- **Solution**: Use default display (don't specify displayId) and ensure output directory exists
+
+### 4. Permission Requirements
+
+macOS 14 requires these permissions:
+- ✅ Screen Recording (System Preferences > Privacy & Security)
+- ✅ Microphone (if includeMicrophone: true)
+- ✅ Accessibility (for cursor tracking)
+
+### 5. Technical Details
+
+**AVFoundation Implementation (macOS 14):**
+- Video: H.264 encoding at 15fps
+- Audio: AAC encoding at 44.1kHz
+- Screen capture: CGDisplayCreateImage
+- Memory management: Automatic cleanup
+
+**Differences from ScreenCaptureKit:**
+- Lower frame rate (15fps vs 30fps) for stability
+- No automatic window exclusion
+- Simpler audio routing
+
+**macOS 13 Specific Limitations:**
+- Audio features may have reduced compatibility
+- Some advanced recording options may not work
+- Recommended to test thoroughly on target systems
+
+## Contact
+
+If recording still fails on macOS 14 after following this guide, please provide:
+1. macOS version (`sw_vers`)
+2. Console logs from the application
+3. Permission status screenshots
+4. Minimal reproduction code

package/debug-macos14.js

@@ -0,0 +1,110 @@
+const MacRecorder = require('./index');
+
+console.log('🧪 macOS 14/13 Debug Test');
+console.log('=========================================');
+console.log('');
+console.log('This script helps debug recording issues on macOS 14 and earlier.');
+console.log('Please run this and share the complete console output.');
+console.log('');
+
+async function debugMacOS14() {
+  const recorder = new MacRecorder();
+  
+  try {
+    // Create test output directory
+    const fs = require('fs');
+    if (!fs.existsSync('./test-output')) {
+      fs.mkdirSync('./test-output');
+    }
+    
+    console.log('📋 System Information:');
+    const os = require('os');
+    console.log('  OS:', os.type(), os.release());
+    console.log('  Architecture:', os.arch());
+    console.log('  Platform:', os.platform());
+    
+    // Check permissions first
+    console.log('');
+    console.log('🔐 Checking Permissions...');
+    try {
+      const permissions = await recorder.checkPermissions();
+      console.log('  Screen Recording Permission:', permissions.screenRecording ? '✅ GRANTED' : '❌ DENIED');
+      console.log('  Accessibility Permission:', permissions.accessibility ? '✅ GRANTED' : '❌ DENIED');
+      
+      if (!permissions.screenRecording) {
+        console.log('');
+        console.log('❌ CRITICAL: Screen Recording permission is DENIED');
+        console.log('   Please grant permission in System Preferences > Security & Privacy > Privacy > Screen Recording');
+        console.log('   Then restart this test.');
+        return;
+      }
+    } catch (permError) {
+      console.log('  Permission check failed:', permError.message);
+    }
+    
+    console.log('');
+    console.log('🎯 Starting Recording Test...');
+    console.log('Expected behavior:');
+    console.log('  • System should detect macOS version');
+    console.log('  • macOS 15+ uses ScreenCaptureKit');  
+    console.log('  • macOS 14/13 uses AVFoundation fallback');
+    console.log('  • You should see detailed logs below');
+    console.log('');
+    
+    const outputPath = './test-output/debug-test.mov';
+    
+    const success = await recorder.startRecording(outputPath, {
+      captureCursor: true,
+      includeMicrophone: false,
+      includeSystemAudio: true,
+      displayId: null // Use primary display
+    });
+    
+    if (success) {
+      console.log('✅ Recording started successfully');
+      console.log('⏱️ Recording for 3 seconds...');
+      
+      await new Promise(resolve => setTimeout(resolve, 3000));
+      
+      console.log('🛑 Stopping recording...');
+      await recorder.stopRecording();
+      
+      // Check if file was created
+      const fs = require('fs');
+      if (fs.existsSync(outputPath)) {
+        const stats = fs.statSync(outputPath);
+        console.log('✅ Recording file created:', outputPath);
+        console.log('   File size:', Math.round(stats.size / 1024), 'KB');
+        console.log('');
+        console.log('🎉 SUCCESS: Recording works on your system!');
+      } else {
+        console.log('❌ Recording file was not created');
+        console.log('   Expected:', outputPath);
+      }
+    } else {
+      console.log('❌ Recording failed to start');
+      console.log('');
+      console.log('🔍 Troubleshooting Steps:');
+      console.log('1. Check console logs above for specific error messages');
+      console.log('2. Verify Screen Recording permission is granted');
+      console.log('3. Try restarting your application');
+      console.log('4. Check if output directory exists and is writable');
+    }
+    
+  } catch (error) {
+    console.log('❌ Error during test:', error.message);
+    if (error.stack) {
+      console.log('Stack trace:', error.stack);
+    }
+  }
+  
+  console.log('');
+  console.log('📞 Support Information:');
+  console.log('If recording still fails, please share:');
+  console.log('1. Complete console output from this test');
+  console.log('2. Your macOS version (System Settings > About)');
+  console.log('3. Permission screenshots from System Settings');
+}
+
+// Run the debug test
+debugMacOS14();

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "node-mac-recorder",
-	"version": "2.16.1",
+	"version": "2.16.3",
 	"description": "Native macOS screen recording package for Node.js applications",
 	"main": "index.js",
 	"keywords": [

package/src/avfoundation_recorder.mm

@@ -32,24 +32,40 @@ bool startAVFoundationRecording(const std::string& outputPath,
     }
     
     @try {
+        NSLog(@"🎬 AVFoundation: Starting recording initialization");
+        
         // Create output URL
         NSString *outputPathStr = [NSString stringWithUTF8String:outputPath.c_str()];
+        NSLog(@"🎬 AVFoundation: Output path string: %@", outputPathStr);
+        
         NSURL *outputURL = [NSURL fileURLWithPath:outputPathStr];
+        NSLog(@"🎬 AVFoundation: Output URL: %@", outputURL);
         
         // Remove existing file
-        [[NSFileManager defaultManager] removeItemAtURL:outputURL error:nil];
+        NSError *removeError = nil;
+        [[NSFileManager defaultManager] removeItemAtURL:outputURL error:&removeError];
+        if (removeError && removeError.code != NSFileNoSuchFileError) {
+            NSLog(@"⚠️ AVFoundation: Warning removing existing file: %@", removeError);
+        }
         
         // Create asset writer
+        NSLog(@"🎬 AVFoundation: Creating AVAssetWriter...");
         NSError *error = nil;
         g_avWriter = [[AVAssetWriter alloc] initWithURL:outputURL fileType:AVFileTypeQuickTimeMovie error:&error];
         if (!g_avWriter || error) {
-            NSLog(@"❌ Failed to create AVAssetWriter: %@", error);
+            NSLog(@"❌ AVFoundation: Failed to create AVAssetWriter: %@", error);
+            NSLog(@"❌ AVFoundation: Output URL was: %@", outputURL);
             return false;
         }
+        NSLog(@"✅ AVFoundation: AVAssetWriter created successfully");
         
         // Get display dimensions
+        NSLog(@"🎬 AVFoundation: Getting display dimensions for display ID %u", displayID);
         CGRect displayBounds = CGDisplayBounds(displayID);
+        NSLog(@"🎬 AVFoundation: Display bounds: %.0f x %.0f", displayBounds.size.width, displayBounds.size.height);
+        
         CGSize recordingSize = captureRect.size.width > 0 ? captureRect.size : displayBounds.size;
+        NSLog(@"🎬 AVFoundation: Recording size: %.0f x %.0f", recordingSize.width, recordingSize.height);
         
         // Video settings
         NSDictionary *videoSettings = @{

package/src/mac_recorder.mm

@@ -192,18 +192,23 @@ Napi::Value StartRecording(const Napi::CallbackInfo& info) {
         
         // Check macOS version for ScreenCaptureKit compatibility
         NSOperatingSystemVersion osVersion = [[NSProcessInfo processInfo] operatingSystemVersion];
-        BOOL isM15Plus = (osVersion.majorVersion > 15 || 
-                          (osVersion.majorVersion == 15 && osVersion.minorVersion >= 0));
-        BOOL isM14Plus = (osVersion.majorVersion > 14 || 
-                          (osVersion.majorVersion == 14 && osVersion.minorVersion >= 0));
+        BOOL isM15Plus = (osVersion.majorVersion >= 15);
+        BOOL isM14Plus = (osVersion.majorVersion >= 14);
+        BOOL isM13Plus = (osVersion.majorVersion >= 13);
         
         NSLog(@"🖥️ macOS Version: %ld.%ld.%ld", 
               (long)osVersion.majorVersion, (long)osVersion.minorVersion, (long)osVersion.patchVersion);
         
-        // Try ScreenCaptureKit on macOS 14+ (with better compatibility on 15+)
-        if (@available(macOS 12.3, *) && isM14Plus) {
-            NSLog(@"✅ macOS 14+ detected - ScreenCaptureKit available with %@ compatibility", 
-                  isM15Plus ? @"full" : @"limited");
+        // Force AVFoundation for debugging/testing
+        BOOL forceAVFoundation = (getenv("FORCE_AVFOUNDATION") != NULL);
+        if (forceAVFoundation) {
+            NSLog(@"🔧 FORCE_AVFOUNDATION environment variable detected - skipping ScreenCaptureKit");
+        }
+        
+        // Use ScreenCaptureKit only on macOS 15+ for maximum stability
+        // macOS 14 should use AVFoundation fallback
+        if (@available(macOS 12.3, *) && isM15Plus && !forceAVFoundation) {
+            NSLog(@"✅ macOS 15+ detected - ScreenCaptureKit available with full compatibility");
             
             // Try ScreenCaptureKit with extensive safety measures
             @try {
@@ -275,22 +280,42 @@ Napi::Value StartRecording(const Napi::CallbackInfo& info) {
                 NSLog(@"❌ Exception during ScreenCaptureKit availability check: %@", availabilityException.reason);
                 return Napi::Boolean::New(env, false);
             }
+        } else if (isM14Plus) {
+            // macOS 14 - directly use AVFoundation for better compatibility
+            NSLog(@"🎯 macOS 14 detected - using AVFoundation for better compatibility");
+        } else if (isM13Plus) {
+            // macOS 13 - use AVFoundation (limited features)
+            NSLog(@"🎯 macOS 13 detected - using AVFoundation (limited features)");
         } else {
-            NSLog(@"❌ macOS version too old for ScreenCaptureKit (< 12.3) - Recording not supported");
+            NSLog(@"❌ macOS version too old (< 13.0) - Recording not supported");
             return Napi::Boolean::New(env, false);
         }
         
-        // If we get here, ScreenCaptureKit failed
+        // AVFoundation fallback logic
         if (isElectron) {
             NSLog(@"❌ ScreenCaptureKit failed in Electron - AVFoundation disabled for stability");
             NSLog(@"❌ Recording not available in Electron when ScreenCaptureKit fails");
             return Napi::Boolean::New(env, false);
         }
         
-        // Try AVFoundation fallback (only in non-Electron environments)
-        NSLog(@"🔄 ScreenCaptureKit failed - attempting AVFoundation fallback");
+        // Try AVFoundation fallback (ScreenCaptureKit failed or macOS 13/14)
+        if (isM15Plus) {
+            NSLog(@"🔄 ScreenCaptureKit failed on macOS 15+ - attempting AVFoundation fallback");
+        } else if (isM14Plus) {
+            NSLog(@"🎥 Using AVFoundation for macOS 14 compatibility");
+        } else if (isM13Plus) {
+            NSLog(@"🎥 Using AVFoundation for macOS 13 compatibility (limited features)");
+        }
         
         @try {
+            NSLog(@"🔧 Attempting AVFoundation recording...");
+            NSLog(@"🔧 Output path: %s", outputPath.c_str());
+            NSLog(@"🔧 Display ID: %u", displayID);
+            NSLog(@"🔧 Cursor: %s, Mic: %s, System Audio: %s", 
+                  captureCursor ? "YES" : "NO",
+                  includeMicrophone ? "YES" : "NO", 
+                  includeSystemAudio ? "YES" : "NO");
+            
             // Import AVFoundation recording functions (if available)
             extern bool startAVFoundationRecording(const std::string& outputPath, 
                                                    CGDirectDisplayID displayID,
@@ -301,17 +326,23 @@ Napi::Value StartRecording(const Napi::CallbackInfo& info) {
                                                    bool includeSystemAudio,
                                                    NSString* audioDeviceId);
             
-            if (startAVFoundationRecording(outputPath, displayID, windowID, captureRect, 
-                                          captureCursor, includeMicrophone, includeSystemAudio, audioDeviceId)) {
+            NSLog(@"🔧 Calling startAVFoundationRecording...");
+            bool avResult = startAVFoundationRecording(outputPath, displayID, windowID, captureRect, 
+                                                      captureCursor, includeMicrophone, includeSystemAudio, audioDeviceId);
+            NSLog(@"🔧 AVFoundation result: %s", avResult ? "SUCCESS" : "FAILED");
+            
+            if (avResult) {
                 NSLog(@"🎥 RECORDING METHOD: AVFoundation (Fallback)");
                 NSLog(@"✅ AVFoundation recording started successfully");
                 g_isRecording = true;
                 return Napi::Boolean::New(env, true);
             } else {
-                NSLog(@"❌ AVFoundation recording also failed to start");
+                NSLog(@"❌ AVFoundation recording failed to start");
+                NSLog(@"❌ Check permissions and output path validity");
             }
         } @catch (NSException *avException) {
             NSLog(@"❌ Exception during AVFoundation startup: %@", avException.reason);
+            NSLog(@"❌ Stack trace: %@", [avException callStackSymbols]);
         }
         
         // Both ScreenCaptureKit and AVFoundation failed

package/test-macos14.js

@@ -0,0 +1,56 @@
+const MacRecorder = require('./index');
+
+async function testMacOS14Recording() {
+  const recorder = new MacRecorder();
+  
+  console.log('🧪 macOS 14 Recording Test');
+  console.log('This will test AVFoundation fallback path when ScreenCaptureKit fails or is not available');
+  console.log('');
+  
+  try {
+    const outputPath = './test-output/macos14-test.mov';
+    
+    console.log('📹 Starting recording test...');
+    console.log('Expected behavior on macOS 14:');
+    console.log('  1. System detects macOS 14.x');
+    console.log('  2. Skips ScreenCaptureKit (only for macOS 15+)');
+    console.log('  3. Uses AVFoundation fallback');
+    console.log('  4. Records at 15fps with H.264 encoding');
+    console.log('');
+    
+    const success = await recorder.startRecording(outputPath, {
+      captureCursor: true,
+      includeMicrophone: false,
+      includeSystemAudio: true,
+      displayId: null // Use main display
+    });
+    
+    if (success) {
+      console.log('✅ Recording started successfully');
+      console.log('⏱️ Recording for 3 seconds...');
+      
+      await new Promise(resolve => setTimeout(resolve, 3000));
+      
+      console.log('🛑 Stopping recording...');
+      await recorder.stopRecording();
+      
+      console.log('✅ macOS 14 test completed successfully!');
+      console.log('📁 Output file: ' + outputPath);
+    } else {
+      console.log('❌ Recording failed to start');
+      console.log('');
+      console.log('Troubleshooting steps:');
+      console.log('1. Check Screen Recording permission in System Preferences');
+      console.log('2. Ensure macOS version is 14.0 or later');
+      console.log('3. Check console logs for detailed error messages');
+    }
+  } catch (error) {
+    console.log('❌ Error during test:', error.message);
+    if (error.stack) {
+      console.log('Stack trace:', error.stack);
+    }
+  }
+}
+
+// Run the test
+testMacOS14Recording();