fix: macOS webcam permission request and camera access not working

[rofeels]

Summary

• Add "camera" to setPermissionCheckHandler / setPermissionRequestHandler — without this, Electron silently blocks all getUserMedia({ video: true }) calls from the renderer
• Add com.apple.security.device.camera, microphone, and audio-input entitlements to both entitlements.mac.plist and entitlements.mac.inherit.plist — required for Hardened Runtime signed builds
• Add NSCameraUsageDescription to extendInfo in electron-builder.json5 and remove the misplaced com.apple.security.device.audio-input key from there

Root Cause

Signed builds with Hardened Runtime enforce entitlements strictly — any permission not declared is silently denied by macOS. In dev mode the app runs unsigned, so entitlements are never checked and the webcam worked fine. In production builds, the missing camera entitlement caused macOS to block the permission request entirely, so the app never appeared in System Settings › Privacy & Security › Camera.

Test plan

• Build the app (npm run build:mac)
• Reset TCC: tccutil reset Camera com.newturn2017.screencraft
• Launch the app — camera permission dialog should appear
• Check System Settings › Privacy & Security › Camera — ScreenCraft should be listed
• Verify webcam overlay shows available camera devices

🤖 Generated with Claude Code

Summary by CodeRabbit

• New Features
  • Enabled camera, microphone, and audio input permissions on macOS, allowing the app to provide webcam overlay and audio capture capabilities.

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 3b42b251-0288-4cd8-9de4-0a47c5468c2a

📥 Commits

Reviewing files that changed from the base of the PR and between 0377ab7 and 13ff571.

📒 Files selected for processing (4)

• build/entitlements.mac.inherit.plist
• build/entitlements.mac.plist
• electron-builder.json5
• electron/main.ts

---

📝 Walkthrough

Walkthrough

These changes grant the macOS application runtime access to camera and microphone devices by adding corresponding entitlements to the app's plist configuration files, updating the build configuration with a camera usage description, and extending Electron's permission handler to allow camera access requests.

Changes

Cohort / File(s)	Summary
macOS Entitlements build/entitlements.mac.inherit.plist, build/entitlements.mac.plist	Added three new device access entitlements: com.apple.security.device.camera, com.apple.security.device.microphone, and com.apple.security.device.audio-input, each set to true.
Build Configuration electron-builder.json5	Modified macOS extendInfo section: added NSCameraUsageDescription string describing camera access purpose for webcam overlay; removed com.apple.security.device.audio-input entry.
Electron Permission Handler electron/main.ts	Extended the allowed permissions array in both setPermissionCheckHandler and setPermissionRequestHandler to include "camera" alongside existing "media", "audioCapture", and "microphone" permissions.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~15 minutes

Poem

🐰 A rabbit hopped through code so small,
Adding cameras one and all,
Microphones and audio rings,
Now the app can hear all things! 🎤📹

🚥 Pre-merge checks | ✅ 3

✅ Passed checks (3 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title accurately and concisely describes the main fix: enabling macOS webcam permission requests and camera access functionality.
Description check	✅ Passed	The description includes clear motivation, root cause analysis, and a detailed test plan, though it lacks some template sections like Screenshots/Video and formal Type of Change checkbox.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}