node-mac-recorder 2.22.2 → 2.22.3

package/.claude/settings.local.json

@@ -49,7 +49,8 @@
       "Bash(timeout 10 ffprobe:*)",
       "Bash(ffmpeg:*)",
       "Bash(timeout 30 node:*)",
-      "Bash(MAC_RECORDER_DEBUG=1 node test-camera-audio-sync.js:*)"
+      "Bash(MAC_RECORDER_DEBUG=1 node test-camera-audio-sync.js:*)",
+      "WebSearch"
     ],
     "deny": [],
     "ask": []

package/package.json

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

package/src/audio_recorder.mm

@@ -45,6 +45,22 @@ static NSString *g_lastStandaloneAudioOutputPath = nil;
     return [AVCaptureDevice defaultDeviceWithMediaType:AVMediaTypeAudio];
 }
 
+- (BOOL)configureVoiceProcessingForDevice:(AVCaptureDevice *)device {
+    // NOTE: Voice Isolation (microphoneMode) is iOS-only and not available on macOS
+    // For macOS noise reduction, users should:
+    // 1. Enable "Voice Isolation" in macOS Control Center > Microphone menu (macOS 13+)
+    // 2. Or use third-party apps like Krisp, RTX Voice, or SoundSource
+    //
+    // AVCaptureDevice on macOS does not expose noise reduction or voice processing properties
+    // Alternative approaches would require:
+    // - Core Audio AUVoiceIO unit (complex, requires audio graph restructuring)
+    // - AVAudioEngine with voice processing (causes crashes on macOS with aggregate devices)
+    // - Custom DSP filtering (significant development effort, may not be effective)
+
+    MRLog(@"ℹ️ macOS microphone noise reduction: Use System Settings or Control Center to enable Voice Isolation");
+    return NO;
+}
+
 - (BOOL)setupWriterWithSampleBuffer:(CMSampleBufferRef)sampleBuffer error:(NSError **)error {
     if (self.writer) {
         return YES;
@@ -167,7 +183,10 @@ static NSString *g_lastStandaloneAudioOutputPath = nil;
         }
         return NO;
     }
-    
+
+    // Configure voice processing to filter keyboard/mouse clicks and background noise
+    [self configureVoiceProcessingForDevice:device];
+
     self.outputPath = outputPath;
     self.session = [[AVCaptureSession alloc] init];
     

package/src/screen_capture_kit.mm

@@ -1516,6 +1516,11 @@ static void SCKPerformRecordingSetup(NSDictionary *config, SCShareableContent *c
                     micIdToUse = nil;
                 }
             }
+
+            // NOTE: Voice processing (microphoneMode) is iOS-only and not available on macOS
+            // Voice isolation is configured in audio_recorder.mm for AVFoundation-based recordings
+            // ScreenCaptureKit microphone capture on macOS 15+ doesn't support microphoneMode
+
             if (micIdToUse && micIdToUse.length > 0) {
                 streamConfig.microphoneCaptureDeviceID = micIdToUse;
             }