Skip to content

Rename Screen Recording to System Audio, upgrade Electron 39#420

Merged
gabrielste1n merged 1 commit intomainfrom
feature/system-audio-permissions-electron-39
Mar 12, 2026
Merged

Rename Screen Recording to System Audio, upgrade Electron 39#420
gabrielste1n merged 1 commit intomainfrom
feature/system-audio-permissions-electron-39

Conversation

@gabrielste1n
Copy link
Collaborator

Summary

  • Permission copy overhaul: Renamed "Screen Recording" → "System Audio" across all permission prompts, onboarding, and settings in all 10 locales. Microphone now reads "Captures your voice for transcription"; System Audio reads "Captures other participants' audio from calls and meetings. We never record your screen."
  • Electron 36 → 39: Uses CoreAudio Tap API by default on macOS 14.2+, which presents the cleaner "System Audio Recording Only" permission instead of "Screen & System Audio Recording" — no more purple menu-bar indicator, no more "Your screen is being observed" on the lock screen
  • NSAudioCaptureUsageDescription: Added to Info.plist via electron-builder.json for the new macOS audio-only permission dialog
  • better-sqlite3 11 → 12: Required for V8 compatibility with Electron 39's Chromium
  • Version bump to 1.6.3, CHANGELOG updated, README prerequisites updated (Node 22+, macOS 12+), lockfile regenerated with Node 22

Platform impact

Platform Impact
macOS 14.2+ New "System Audio Recording Only" permission prompt (one-time re-grant). No purple dot, no lock-screen warning
macOS < 14.2 Falls back to legacy Screen & System Audio Recording (existing grant still works)
Windows No permission changes — copy-only updates
Linux No permission changes — copy-only updates

Files changed

  • package.json / package-lock.json — Electron 39, better-sqlite3 12, version 1.6.3
  • electron-builder.json — Updated NSMicrophoneUsageDescription, added NSAudioCaptureUsageDescription
  • src/locales/*/translation.json — All 10 language files updated (en, pt, de, es, fr, it, ru, ja, zh-CN, zh-TW)
  • CHANGELOG.md — v1.6.3 entry
  • README.md — Updated prerequisites to Node 22+, macOS 12+
  • CLAUDE.md — Electron version reference updated

Clarify permission prompts so users understand that the microphone captures
their voice while system audio captures other participants in calls. Adds
"We never record your screen" messaging across all 10 locales.

Electron 39 switches macOS audio capture to the CoreAudio Tap API, which
presents a "System Audio Recording Only" permission instead of the old
"Screen & System Audio Recording" grant — eliminating the purple menu-bar
indicator and the "Your screen is being observed" lock-screen message.

- Rename all "Screen Recording" UI text to "System Audio" (10 languages)
- Update microphone copy: "Captures your voice for transcription"
- Add NSAudioCaptureUsageDescription to electron-builder.json
- Upgrade Electron ^36.9.5 → ^39.0.0
- Upgrade better-sqlite3 ^11.10.0 → ^12.4.2 (V8 compat)
- Bump version to 1.6.3, update CHANGELOG, README prerequisites
- Regenerate lockfile with Node 22
@gabrielste1n gabrielste1n merged commit ca98a7c into main Mar 12, 2026
0 of 4 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant