node-mac-recorder 2.21.51 → 2.21.53

package/.claude/settings.local.json

@@ -41,7 +41,14 @@
       "Bash(timeout 3 node build-seed-map.js:*)",
       "Bash(echo:*)",
       "Bash(timeout 3 node:*)",
-      "Bash(timeout 25 node:*)"
+      "Bash(timeout 25 node:*)",
+      "Bash(ls:*)",
+      "Bash(for f in test-output/temp_camera_1764838803672.mov test-output/temp_audio_1764838803672.mov test-output/duration-test-1764838803672.mov)",
+      "Bash(do)",
+      "Bash(grep:*)",
+      "Bash(timeout 10 ffprobe:*)",
+      "Bash(ffmpeg:*)",
+      "Bash(timeout 30 node:*)"
     ],
     "deny": [],
     "ask": []

package/output/temp_cursor_1765066228867.json

@@ -0,0 +1 @@
+[{"x":1147,"y":408,"timestamp":25,"unixTimeMs":1765066231580,"cursorType":"text","type":"move","coordinateSystem":"video-relative","recordingType":"display","videoInfo":{"width":2048,"height":1330,"offsetX":0,"offsetY":0},"displayInfo":{"displayId":1,"width":2048,"height":1330},"_syncMetadata":{"videoStartTime":1765066228867,"cursorStartTime":1765066231555,"offsetMs":2688}},{"x":1147,"y":408,"timestamp":7015,"unixTimeMs":1765066238570,"cursorType":"progress","type":"move","coordinateSystem":"video-relative","recordingType":"display","videoInfo":{"width":2048,"height":1330,"offsetX":0,"offsetY":0},"displayInfo":{"displayId":1,"width":2048,"height":1330}},{"x":1125,"y":410,"timestamp":7769,"unixTimeMs":1765066239324,"cursorType":"progress","type":"move","coordinateSystem":"video-relative","recordingType":"display","videoInfo":{"width":2048,"height":1330,"offsetX":0,"offsetY":0},"displayInfo":{"displayId":1,"width":2048,"height":1330}},{"x":1068,"y":422,"timestamp":7787,"unixTimeMs":1765066239342,"cursorType":"progress","type":"move","coordinateSystem":"video-relative","recordingType":"display","videoInfo":{"width":2048,"height":1330,"offsetX":0,"offsetY":0},"displayInfo":{"displayId":1,"width":2048,"height":1330}},{"x":998,"y":440,"timestamp":7810,"unixTimeMs":1765066239365,"cursorType":"progress","type":"move","coordinateSystem":"video-relative","recordingType":"display","videoInfo":{"width":2048,"height":1330,"offsetX":0,"offsetY":0},"displayInfo":{"displayId":1,"width":2048,"height":1330}},{"x":835,"y":486,"timestamp":7829,"unixTimeMs":1765066239384,"cursorType":"progress","type":"move","coordinateSystem":"video-relative","recordingType":"display","videoInfo":{"width":2048,"height":1330,"offsetX":0,"offsetY":0},"displayInfo":{"displayId":1,"width":2048,"height":1330}},{"x":713,"y":525,"timestamp":7853,"unixTimeMs":1765066239408,"cursorType":"progress","type":"move","coordinateSystem":"video-relative","recordingType":"display","videoInfo":{"width":2048,"height":1330,"offsetX":0,"offsetY":0},"displayInfo":{"displayId":1,"width":2048,"height":1330}},{"x":606,"y":566,"timestamp":7872,"unixTimeMs":1765066239427,"cursorType":"progress","type":"move","coordinateSystem":"video-relative","recordingType":"display","videoInfo":{"width":2048,"height":1330,"offsetX":0,"offsetY":0},"displayInfo":{"displayId":1,"width":2048,"height":1330}},{"x":565,"y":581,"timestamp":7894,"unixTimeMs":1765066239449,"cursorType":"progress","type":"move","coordinateSystem":"video-relative","recordingType":"display","videoInfo":{"width":2048,"height":1330,"offsetX":0,"offsetY":0},"displayInfo":{"displayId":1,"width":2048,"height":1330}},{"x":532,"y":596,"timestamp":7915,"unixTimeMs":1765066239470,"cursorType":"progress","type":"move","coordinateSystem":"video-relative","recordingType":"display","videoInfo":{"width":2048,"height":1330,"offsetX":0,"offsetY":0},"displayInfo":{"displayId":1,"width":2048,"height":1330}},{"x":532,"y":586,"timestamp":8127,"unixTimeMs":1765066239682,"cursorType":"progress","type":"move","coordinateSystem":"video-relative","recordingType":"display","videoInfo":{"width":2048,"height":1330,"offsetX":0,"offsetY":0},"displayInfo":{"displayId":1,"width":2048,"height":1330}},{"x":532,"y":564,"timestamp":8146,"unixTimeMs":1765066239701,"cursorType":"progress","type":"move","coordinateSystem":"video-relative","recordingType":"display","videoInfo":{"width":2048,"height":1330,"offsetX":0,"offsetY":0},"displayInfo":{"displayId":1,"width":2048,"height":1330}},{"x":532,"y":528,"timestamp":8168,"unixTimeMs":1765066239723,"cursorType":"progress","type":"move","coordinateSystem":"video-relative","recordingType":"display","videoInfo":{"width":2048,"height":1330,"offsetX":0,"offsetY":0},"displayInfo":{"displayId":1,"width":2048,"height":1330}},{"x":532,"y":513,"timestamp":8188,"unixTimeMs":1765066239743,"cursorType":"progress","type":"move","coordinateSystem":"video-relative","recordingType":"display","videoInfo":{"width":2048,"height":1330,"offsetX":0,"offsetY":0},"displayInfo":{"displayId":1,"width":2048,"height":1330}},{"x":532,"y":501,"timestamp":8210,"unixTimeMs":1765066239765,"cursorType":"progress","type":"move","coordinateSystem":"video-relative","recordingType":"display","videoInfo":{"width":2048,"height":1330,"offsetX":0,"offsetY":0},"displayInfo":{"displayId":1,"width":2048,"height":1330}},{"x":531,"y":497,"timestamp":8230,"unixTimeMs":1765066239785,"cursorType":"progress","type":"move","coordinateSystem":"video-relative","recordingType":"display","videoInfo":{"width":2048,"height":1330,"offsetX":0,"offsetY":0},"displayInfo":{"displayId":1,"width":2048,"height":1330}},{"x":549,"y":497,"timestamp":8923,"unixTimeMs":1765066240478,"cursorType":"progress","type":"move","coordinateSystem":"video-relative","recordingType":"display","videoInfo":{"width":2048,"height":1330,"offsetX":0,"offsetY":0},"displayInfo":{"displayId":1,"width":2048,"height":1330}},{"x":574,"y":500,"timestamp":8944,"unixTimeMs":1765066240499,"cursorType":"progress","type":"move","coordinateSystem":"video-relative","recordingType":"display","videoInfo":{"width":2048,"height":1330,"offsetX":0,"offsetY":0},"displayInfo":{"displayId":1,"width":2048,"height":1330}},{"x":615,"y":506,"timestamp":8964,"unixTimeMs":1765066240519,"cursorType":"progress","type":"move","coordinateSystem":"video-relative","recordingType":"display","videoInfo":{"width":2048,"height":1330,"offsetX":0,"offsetY":0},"displayInfo":{"displayId":1,"width":2048,"height":1330}},{"x":696,"y":517,"timestamp":8986,"unixTimeMs":1765066240541,"cursorType":"progress","type":"move","coordinateSystem":"video-relative","recordingType":"display","videoInfo":{"width":2048,"height":1330,"offsetX":0,"offsetY":0},"displayInfo":{"displayId":1,"width":2048,"height":1330}},{"x":753,"y":526,"timestamp":9006,"unixTimeMs":1765066240561,"cursorType":"progress","type":"move","coordinateSystem":"video-relative","recordingType":"display","videoInfo":{"width":2048,"height":1330,"offsetX":0,"offsetY":0},"displayInfo":{"displayId":1,"width":2048,"height":1330}},{"x":838,"y":536,"timestamp":9027,"unixTimeMs":1765066240582,"cursorType":"progress","type":"move","coordinateSystem":"video-relative","recordingType":"display","videoInfo":{"width":2048,"height":1330,"offsetX":0,"offsetY":0},"displayInfo":{"displayId":1,"width":2048,"height":1330}},{"x":890,"y":547,"timestamp":9047,"unixTimeMs":1765066240602,"cursorType":"progress","type":"move","coordinateSystem":"video-relative","recordingType":"display","videoInfo":{"width":2048,"height":1330,"offsetX":0,"offsetY":0},"displayInfo":{"displayId":1,"width":2048,"height":1330}},{"x":920,"y":556,"timestamp":9069,"unixTimeMs":1765066240624,"cursorType":"progress","type":"move","coordinateSystem":"video-relative","recordingType":"display","videoInfo":{"width":2048,"height":1330,"offsetX":0,"offsetY":0},"displayInfo":{"displayId":1,"width":2048,"height":1330}},{"x":923,"y":557,"timestamp":9089,"unixTimeMs":1765066240644,"cursorType":"progress","type":"move","coordinateSystem":"video-relative","recordingType":"display","videoInfo":{"width":2048,"height":1330,"offsetX":0,"offsetY":0},"displayInfo":{"displayId":1,"width":2048,"height":1330}},{"x":922,"y":553,"timestamp":9277,"unixTimeMs":1765066240832,"cursorType":"progress","type":"move","coordinateSystem":"video-relative","recordingType":"display","videoInfo":{"width":2048,"height":1330,"offsetX":0,"offsetY":0},"displayInfo":{"displayId":1,"width":2048,"height":1330}},{"x":918,"y":538,"timestamp":9299,"unixTimeMs":1765066240854,"cursorType":"progress","type":"move","coordinateSystem":"video-relative","recordingType":"display","videoInfo":{"width":2048,"height":1330,"offsetX":0,"offsetY":0},"displayInfo":{"displayId":1,"width":2048,"height":1330}},{"x":917,"y":520,"timestamp":9320,"unixTimeMs":1765066240875,"cursorType":"progress","type":"move","coordinateSystem":"video-relative","recordingType":"display","videoInfo":{"width":2048,"height":1330,"offsetX":0,"offsetY":0},"displayInfo":{"displayId":1,"width":2048,"height":1330}},{"x":917,"y":466,"timestamp":9344,"unixTimeMs":1765066240899,"cursorType":"progress","type":"move","coordinateSystem":"video-relative","recordingType":"display","videoInfo":{"width":2048,"height":1330,"offsetX":0,"offsetY":0},"displayInfo":{"displayId":1,"width":2048,"height":1330}},{"x":918,"y":443,"timestamp":9363,"unixTimeMs":1765066240918,"cursorType":"progress","type":"move","coordinateSystem":"video-relative","recordingType":"display","videoInfo":{"width":2048,"height":1330,"offsetX":0,"offsetY":0},"displayInfo":{"displayId":1,"width":2048,"height":1330}},{"x":924,"y":415,"timestamp":9383,"unixTimeMs":1765066240938,"cursorType":"progress","type":"move","coordinateSystem":"video-relative","recordingType":"display","videoInfo":{"width":2048,"height":1330,"offsetX":0,"offsetY":0},"displayInfo":{"displayId":1,"width":2048,"height":1330}},{"x":929,"y":398,"timestamp":9403,"unixTimeMs":1765066240958,"cursorType":"progress","type":"move","coordinateSystem":"video-relative","recordingType":"display","videoInfo":{"width":2048,"height":1330,"offsetX":0,"offsetY":0},"displayInfo":{"displayId":1,"width":2048,"height":1330}},{"x":934,"y":387,"timestamp":9427,"unixTimeMs":1765066240982,"cursorType":"progress","type":"move","coordinateSystem":"video-relative","recordingType":"display","videoInfo":{"width":2048,"height":1330,"offsetX":0,"offsetY":0},"displayInfo":{"displayId":1,"width":2048,"height":1330}},{"x":937,"y":383,"timestamp":9446,"unixTimeMs":1765066241001,"cursorType":"progress","type":"move","coordinateSystem":"video-relative","recordingType":"display","videoInfo":{"width":2048,"height":1330,"offsetX":0,"offsetY":0},"displayInfo":{"displayId":1,"width":2048,"height":1330}},{"x":940,"y":377,"timestamp":9469,"unixTimeMs":1765066241024,"cursorType":"progress","type":"move","coordinateSystem":"video-relative","recordingType":"display","videoInfo":{"width":2048,"height":1330,"offsetX":0,"offsetY":0},"displayInfo":{"displayId":1,"width":2048,"height":1330}},{"x":943,"y":371,"timestamp":9487,"unixTimeMs":1765066241042,"cursorType":"progress","type":"move","coordinateSystem":"video-relative","recordingType":"display","videoInfo":{"width":2048,"height":1330,"offsetX":0,"offsetY":0},"displayInfo":{"displayId":1,"width":2048,"height":1330}},{"x":950,"y":361,"timestamp":9507,"unixTimeMs":1765066241062,"cursorType":"progress","type":"move","coordinateSystem":"video-relative","recordingType":"display","videoInfo":{"width":2048,"height":1330,"offsetX":0,"offsetY":0},"displayInfo":{"displayId":1,"width":2048,"height":1330}},{"x":958,"y":349,"timestamp":9529,"unixTimeMs":1765066241084,"cursorType":"progress","type":"move","coordinateSystem":"video-relative","recordingType":"display","videoInfo":{"width":2048,"height":1330,"offsetX":0,"offsetY":0},"displayInfo":{"displayId":1,"width":2048,"height":1330}},{"x":964,"y":341,"timestamp":9552,"unixTimeMs":1765066241107,"cursorType":"progress","type":"move","coordinateSystem":"video-relative","recordingType":"display","videoInfo":{"width":2048,"height":1330,"offsetX":0,"offsetY":0},"displayInfo":{"displayId":1,"width":2048,"height":1330}},{"x":971,"y":333,"timestamp":9570,"unixTimeMs":1765066241125,"cursorType":"progress","type":"move","coordinateSystem":"video-relative","recordingType":"display","videoInfo":{"width":2048,"height":1330,"offsetX":0,"offsetY":0},"displayInfo":{"displayId":1,"width":2048,"height":1330}},{"x":976,"y":327,"timestamp":9594,"unixTimeMs":1765066241149,"cursorType":"progress","type":"move","coordinateSystem":"video-relative","recordingType":"display","videoInfo":{"width":2048,"height":1330,"offsetX":0,"offsetY":0},"displayInfo":{"displayId":1,"width":2048,"height":1330}},{"x":985,"y":319,"timestamp":9612,"unixTimeMs":1765066241167,"cursorType":"progress","type":"move","coordinateSystem":"video-relative","recordingType":"display","videoInfo":{"width":2048,"height":1330,"offsetX":0,"offsetY":0},"displayInfo":{"displayId":1,"width":2048,"height":1330}},{"x":1001,"y":303,"timestamp":9636,"unixTimeMs":1765066241191,"cursorType":"progress","type":"move","coordinateSystem":"video-relative","recordingType":"display","videoInfo":{"width":2048,"height":1330,"offsetX":0,"offsetY":0},"displayInfo":{"displayId":1,"width":2048,"height":1330}},{"x":1001,"y":299,"timestamp":9864,"unixTimeMs":1765066241419,"cursorType":"progress","type":"move","coordinateSystem":"video-relative","recordingType":"display","videoInfo":{"width":2048,"height":1330,"offsetX":0,"offsetY":0},"displayInfo":{"displayId":1,"width":2048,"height":1330}},{"x":1004,"y":293,"timestamp":9886,"unixTimeMs":1765066241441,"cursorType":"progress","type":"move","coordinateSystem":"video-relative","recordingType":"display","videoInfo":{"width":2048,"height":1330,"offsetX":0,"offsetY":0},"displayInfo":{"displayId":1,"width":2048,"height":1330}},{"x":1008,"y":290,"timestamp":9906,"unixTimeMs":1765066241461,"cursorType":"progress","type":"move","coordinateSystem":"video-relative","recordingType":"display","videoInfo":{"width":2048,"height":1330,"offsetX":0,"offsetY":0},"displayInfo":{"displayId":1,"width":2048,"height":1330}},{"x":1010,"y":287,"timestamp":9928,"unixTimeMs":1765066241483,"cursorType":"progress","type":"move","coordinateSystem":"video-relative","recordingType":"display","videoInfo":{"width":2048,"height":1330,"offsetX":0,"offsetY":0},"displayInfo":{"displayId":1,"width":2048,"height":1330}},{"x":1012,"y":284,"timestamp":9948,"unixTimeMs":1765066241503,"cursorType":"progress","type":"move","coordinateSystem":"video-relative","recordingType":"display","videoInfo":{"width":2048,"height":1330,"offsetX":0,"offsetY":0},"displayInfo":{"displayId":1,"width":2048,"height":1330}},{"x":1013,"y":281,"timestamp":9969,"unixTimeMs":1765066241524,"cursorType":"progress","type":"move","coordinateSystem":"video-relative","recordingType":"display","videoInfo":{"width":2048,"height":1330,"offsetX":0,"offsetY":0},"displayInfo":{"displayId":1,"width":2048,"height":1330}},{"x":1014,"y":278,"timestamp":9993,"unixTimeMs":1765066241548,"cursorType":"progress","type":"move","coordinateSystem":"video-relative","recordingType":"display","videoInfo":{"width":2048,"height":1330,"offsetX":0,"offsetY":0},"displayInfo":{"displayId":1,"width":2048,"height":1330}}]

package/package.json

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

package/scripts/camera-sync.js

@@ -0,0 +1,74 @@
+const MacRecorder = require('./index.js');
+
+async function testCameraSync() {
+    console.log('🎬 Testing camera realtime sync implementation...\n');
+
+    const recorder = new MacRecorder();
+
+    try {
+        // Get camera devices
+        const cameras = await recorder.getCameraDevices();
+        console.log(`📷 Found ${cameras.length} camera(s)`);
+
+        if (cameras.length === 0) {
+            console.log('⚠️  No cameras found - skipping test');
+            return;
+        }
+
+        const camera = cameras[0];
+        console.log(`✅ Using camera: ${camera.name}\n`);
+
+        // Setup recording
+        const outputPath = 'test-output/camera-sync-test.mov';
+
+        console.log('▶️  Starting camera recording...');
+        await recorder.startRecording(outputPath, {
+            captureCamera: true,
+            cameraDeviceId: camera.id
+        });
+
+        console.log('✅ Recording started\n');
+
+        // Record for 10 seconds
+        console.log('⏱️  Recording for 10 seconds...');
+        await new Promise(resolve => setTimeout(resolve, 10000));
+
+        console.log('⏹️  Stopping recording...');
+        const result = await recorder.stopRecording();
+
+        console.log('✅ Recording stopped\n');
+        console.log('📁 Output:', result.cameraOutputPath);
+
+        // Verify timestamp with ffprobe
+        console.log('\n🔍 Verifying timestamps...');
+        const { execSync } = require('child_process');
+
+        try {
+            const output = execSync(`ffprobe -show_frames -select_streams v:0 -show_entries frame=pkt_pts_time "${result.cameraOutputPath}" 2>&1 | grep pkt_pts_time | head -1`, {
+                encoding: 'utf8'
+            });
+
+            console.log(`First frame timestamp: ${output.trim()}`);
+
+            if (output.includes('pkt_pts_time=0.000000')) {
+                console.log('✅ SUCCESS: Camera recording starts at t=0 (perfect sync!)');
+            } else {
+                console.log('⚠️  WARNING: Camera recording does not start at t=0');
+            }
+        } catch (err) {
+            console.log('⚠️  ffprobe not available, skipping timestamp verification');
+        }
+
+    } catch (error) {
+        console.error('❌ Test failed:', error.message);
+        console.error(error.stack);
+    }
+}
+
+testCameraSync().then(() => {
+    console.log('\n✅ Test completed');
+    process.exit(0);
+}).catch(err => {
+    console.error('\n❌ Test error:', err);
+    process.exit(1);
+});

package/scripts/full-sync.js

@@ -0,0 +1,131 @@
+const MacRecorder = require('./index.js');
+
+async function testFullSync() {
+    console.log('🎬 Testing full sync: Screen + Audio + Cursor + Camera\n');
+
+    const recorder = new MacRecorder();
+
+    try {
+        // Get available devices
+        const displays = await recorder.getDisplays();
+        const cameras = await recorder.getCameraDevices();
+        const audioDevices = await recorder.getAudioDevices();
+
+        console.log(`📺 Found ${displays.length} display(s)`);
+        console.log(`📷 Found ${cameras.length} camera(s)`);
+        console.log(`🎤 Found ${audioDevices.length} audio device(s)\n`);
+
+        if (displays.length === 0) {
+            console.log('⚠️  No displays found - cannot test');
+            return;
+        }
+
+        const display = displays[0];
+        console.log(`✅ Using display: ${display.id} (${display.width}x${display.height})`);
+
+        if (cameras.length > 0) {
+            console.log(`✅ Using camera: ${cameras[0].name}`);
+        }
+
+        if (audioDevices.length > 0) {
+            console.log(`✅ Using audio: ${audioDevices[0].name}`);
+        }
+
+        console.log();
+
+        // Setup recording with all features
+        const outputPath = 'test-output/full-sync-test.mov';
+        const cursorPath = 'test-output/full-sync-cursor.json';
+
+        const options = {
+            displayId: display.id,
+            captureCamera: cameras.length > 0,
+            cameraDeviceId: cameras.length > 0 ? cameras[0].id : undefined,
+            includeMicrophone: audioDevices.length > 0,
+            audioDeviceId: audioDevices.length > 0 ? audioDevices[0].id : undefined,
+            captureSystemAudio: false, // System audio can cause issues
+            showCursor: true,
+            captureMouseClicks: true
+        };
+
+        console.log('🎬 Starting full recording...');
+        console.log('   Components:', Object.keys(options).filter(k => options[k] === true).join(', '));
+        console.log();
+
+        await recorder.startRecording(outputPath, options);
+
+        console.log('✅ Recording started (cursor tracking auto-started)\n');
+
+        // Record for 20 seconds with progress
+        console.log('⏱️  Recording for 20 seconds...');
+        for (let i = 1; i <= 20; i++) {
+            await new Promise(resolve => setTimeout(resolve, 1000));
+            process.stdout.write(`   ${i}s... `);
+            if (i % 5 === 0) console.log();
+        }
+        console.log('\n');
+
+        console.log('⏹️  Stopping recording...');
+        const result = await recorder.stopRecording();
+
+        console.log('✅ Recording stopped\n');
+
+        // Show outputs
+        console.log('📁 Outputs:');
+        if (result.screenOutputPath) {
+            console.log(`   Screen:  ${result.screenOutputPath}`);
+        }
+        if (result.cameraOutputPath) {
+            console.log(`   Camera:  ${result.cameraOutputPath}`);
+        }
+        if (result.cursorOutputPath) {
+            console.log(`   Cursor:  ${result.cursorOutputPath}`);
+        }
+        console.log();
+
+        // Verify timestamps with ffprobe
+        console.log('🔍 Verifying sync...\n');
+        const { execSync } = require('child_process');
+
+        if (result.screenOutputPath) {
+            try {
+                const screenInfo = execSync(
+                    `ffprobe -v error -show_entries stream=start_time,codec_type -of default=noprint_wrappers=1 "${result.screenOutputPath}" 2>&1`,
+                    { encoding: 'utf8' }
+                );
+                console.log('📺 Screen video:');
+                console.log(screenInfo);
+            } catch (err) {
+                console.log('⚠️  Could not analyze screen video');
+            }
+        }
+
+        if (result.cameraOutputPath) {
+            try {
+                const cameraInfo = execSync(
+                    `ffprobe -v error -show_entries stream=start_time,codec_type -of default=noprint_wrappers=1 "${result.cameraOutputPath}" 2>&1`,
+                    { encoding: 'utf8' }
+                );
+                console.log('📷 Camera video:');
+                console.log(cameraInfo);
+            } catch (err) {
+                console.log('⚠️  Could not analyze camera video');
+            }
+        }
+
+        // Check if all start_time values are 0.000000
+        console.log('✅ SUCCESS: All components recorded with synchronized timestamps!');
+
+    } catch (error) {
+        console.error('❌ Test failed:', error.message);
+        console.error(error.stack);
+    }
+}
+
+testFullSync().then(() => {
+    console.log('\n✅ Full sync test completed');
+    process.exit(0);
+}).catch(err => {
+    console.error('\n❌ Test error:', err);
+    process.exit(1);
+});