Record your screen, ship a demo. Free and open-source, GPU-accelerated, no watermarks, no subscriptions. Windows, macOS, Linux. Actively maintained.
TypeScript cross-platformelectronffmpegopen-sourceproduct-demorustscreen-capturescreen-recorderscreen-recordingscreen-studioscreencastspeech-to-texttypescriptvideo-editingvideo-editorwaylandwgpuwhisper
fix(recording): offer no microphone on macOS 13 and 14
EtienneLescotfcfc6915e6c1
diff --git a/electron/electron-env.d.ts b/electron/electron-env.d.tsindex b3c78aaa2..29d5f828b 100644--- a/electron/electron-env.d.ts+++ b/electron/electron-env.d.ts@@ -431,6 +431,7 @@ interface Window {quitApp: () => void;setTitleBarOverlay: (color: string, symbolColor: string) => void;getPlatform: () => string;+ getSystemVersion: () => string;getAppInfo: () => Promise<{ version: string; canCheckForUpdates: boolean }>;checkForUpdates: () => Promise<void>;showAbout: () => Promise<void>;diff --git a/electron/ipc/handlers.ts b/electron/ipc/handlers.tsindex e4154703c..7ce5f4d80 100644--- a/electron/ipc/handlers.ts+++ b/electron/ipc/handlers.ts@@ -115,6 +115,7 @@ import {isSalvageableFragmentedCapture,NATIVE_WINDOWS_SALVAGEABLE_OUTPUT_BYTES,readMicrophoneDefaulted,+ readMicrophoneUnavailable,readWebcamFormat,readWebcamUnavailable,terminateNativeWindowsCapture,@@ -3124,6 +3125,17 @@ export function registerIpcHandlers(deviceName: request.audio.microphone.deviceName,});}+ // Where this happens the app offers no microphone (#700). A take that asks for one+ // anyway (`openscreen record --mic`) records without it, and this line is what the+ // CLI prints about it.+ const microphoneUnavailable =+ request.audio.microphone.enabled && readMicrophoneUnavailable(nativeMacCaptureOutput);+ if (microphoneUnavailable) {+ console.warn(+ "[native-sck] recording without the microphone; ScreenCaptureKit captures it from macOS 15",+ { macOS: process.getSystemVersion() },+ );+ }nativeMacCursorOffsetMs =cursorCaptureMode === "editable-overlay"? Math.max(0, captureStartedAtMs - cursorStartTimeMs)@@ -3140,6 +3152,7 @@ export function registerIpcHandlers(path: outputPath,helperPath,microphoneDefaulted,+ microphoneUnavailable,};} catch (error) {console.error("Failed to start native macOS recording:", error);diff --git a/electron/native/README.md b/electron/native/README.mdindex 5f977d65b..16013c4bd 100644--- a/electron/native/README.md+++ b/electron/native/README.md@@ -27,7 +27,7 @@ npm run build:native:macOn non-macOS hosts this command exits successfully and does not affect Windows/Linux development. On macOS it builds the Swift package at `electron/native/screencapturekit`, writes the development binaries to `electron/native/screencapturekit/build`, and copies redistributable binaries to `electron/native/bin/darwin-${arch}`.-The current helper implementation supports display/window ScreenCaptureKit video capture, control-window exclusion through the request's optional `excludedWindowIds` and `SCContentFilter(display:excludingWindows:)`, cursor exclusion through `SCStreamConfiguration.showsCursor`, H.264 encoding, MP4 muxing (with `AVAssetWriter.movieFragmentInterval` at 1s, so a helper that dies before `finishWriting()` still leaves a readable file — same reasoning as the Windows fragmented sink below), and ScreenCaptureKit system audio. Electron supplies only the HUD and an open Notes window as exclusions for full-display capture, so ordinary OpenScreen windows remain recordable. The helper adds Notification Center's windows on its own, and Finder's desktop-icon windows when the request sets `hideDesktopIcons`; a banner appears as a new window, so a direct capture re-reads the exclusion every 250 ms, while the system picker excludes Notification Center by bundle id. The helper also attempts native ScreenCaptureKit microphone capture when the running macOS version exposes that capability. Webcam recording currently stays as an Electron sidecar and is attached to the same recording session after the native screen capture stops.+The current helper implementation supports display/window ScreenCaptureKit video capture, control-window exclusion through the request's optional `excludedWindowIds` and `SCContentFilter(display:excludingWindows:)`, cursor exclusion through `SCStreamConfiguration.showsCursor`, H.264 encoding, MP4 muxing (with `AVAssetWriter.movieFragmentInterval` at 1s, so a helper that dies before `finishWriting()` still leaves a readable file — same reasoning as the Windows fragmented sink below), and ScreenCaptureKit system audio. Electron supplies only the HUD and an open Notes window as exclusions for full-display capture, so ordinary OpenScreen windows remain recordable. The helper adds Notification Center's windows on its own, and Finder's desktop-icon windows when the request sets `hideDesktopIcons`; a banner appears as a new window, so a direct capture re-reads the exclusion every 250 ms, while the system picker excludes Notification Center by bundle id. The helper also attempts native ScreenCaptureKit microphone capture when the running macOS version exposes that capability, which is macOS 15 and later. Below that it records the take without the microphone and emits a `microphone-unavailable` warning; the app does not offer the microphone there (`canRecordMicrophone` in `src/utils/platformUtils.ts`). Webcam recording currently stays as an Electron sidecar and is attached to the same recording session after the native screen capture stops.Electron exposes `is-native-mac-capture-available` for capability probing. It resolves the same helper locations listed above and reports `missing-helper` until a Swift helper binary is present. When available, macOS recording routes screen/window capture through the native helper so editable cursor recordings do not bake the system cursor into the video. Cursor positions are sampled in Electron; when the cursor helper is available and Accessibility is granted, samples are also tagged with link/text cursor hints such as `pointer`.diff --git a/electron/preload.ts b/electron/preload.tsindex 2e2bdcb82..80e583f24 100644--- a/electron/preload.ts+++ b/electron/preload.ts@@ -421,6 +421,9 @@ contextBridge.exposeInMainWorld("electronAPI", {ipcRenderer.send("set-titlebar-overlay", color, symbolColor);},getPlatform: () => PLATFORM,+ /** The OS version, as the main process reads it: "14.6.1" on macOS, not the Darwin+ * kernel's "23.6.0" that `os.release()` gives. Part of the sandboxed preload's `process`. */+ getSystemVersion: () => process.getSystemVersion(),/** App identity for the HUD's settings panel: the running version, and whether this copy* may offer an update check at all — a Store/Flathub/Snap/Nix install may not, see* electron/install-channel.ts. */diff --git a/electron/recording/nativeWindowsCaptureStop.test.ts b/electron/recording/nativeWindowsCaptureStop.test.tsindex 8c1d48caf..68ebf01c9 100644--- a/electron/recording/nativeWindowsCaptureStop.test.ts+++ b/electron/recording/nativeWindowsCaptureStop.test.ts@@ -6,6 +6,7 @@ import {isSalvageableFragmentedCapture,NATIVE_WINDOWS_SALVAGEABLE_OUTPUT_BYTES,readMicrophoneDefaulted,+ readMicrophoneUnavailable,readStoppedPath,readWebcamFormat,readWebcamUnavailable,@@ -124,6 +125,23 @@ describe("readMicrophoneDefaulted", () => {});});+describe("readMicrophoneUnavailable", () => {+ // The line ScreenCaptureRecorder.swift emits on macOS 13 and 14, which have no+ // `captureMicrophone`, before recording the take without it (#700).+ it("sees the macOS helper record without the microphone", () => {+ const output =+ '{"code":"microphone-unavailable","event":"warning","message":"Native microphone capture requires ScreenCaptureKit microphone support on this macOS version."}\n' ++ '{"event":"ready","schemaVersion":1}\n';+ expect(readMicrophoneUnavailable(output)).toBe(true);+ });++ it("is false when the microphone was only defaulted", () => {+ const output =+ '{"event":"warning","code":"microphone-defaulted","message":"The requested microphone could not be resolved; capturing the default input."}\n';+ expect(readMicrophoneUnavailable(output)).toBe(false);+ });+});+describe("readWebcamFormat", () => {it("reads the negotiated camera format", () => {const output =diff --git a/electron/recording/nativeWindowsCaptureStop.ts b/electron/recording/nativeWindowsCaptureStop.tsindex f472cad71..9f2e2db33 100644--- a/electron/recording/nativeWindowsCaptureStop.ts+++ b/electron/recording/nativeWindowsCaptureStop.ts@@ -122,6 +122,17 @@ export function readMicrophoneDefaulted(output: string) {return output.includes('"code":"microphone-defaulted"');}+/**+ * Did the macOS helper record without the microphone it was asked for?+ *+ * It captures the mic through ScreenCaptureKit's `captureMicrophone`, macOS 15+ * API. Earlier it says so and records the take anyway, and nothing read that:+ * the take came back with no voice and no word (getopenscreen/openscreen#700).+ */+export function readMicrophoneUnavailable(output: string) {+ return output.includes('"code":"microphone-unavailable"');+}+/*** Index of the `}` that closes the object starting at `start`, or -1.*diff --git a/src/components/ai-edition/v4/RecStage.test.tsx b/src/components/ai-edition/v4/RecStage.test.tsxindex c9b65ef77..f931783aa 100644--- a/src/components/ai-edition/v4/RecStage.test.tsx+++ b/src/components/ai-edition/v4/RecStage.test.tsx@@ -347,6 +347,40 @@ describe("RecStage controls", () => {expect(screen.queryByText("rec.hideDesktopIcons")).toBeNull();});+ // ScreenCaptureKit captures the microphone from macOS 15 only (#700).+ it("offers no microphone on macOS 14, and leaves a saved one unapplied", async () => {+ const { setRecordingPrefs } = stubRecordingPrefs({+ micEnabled: true,+ systemAudioEnabled: true,+ });+ Object.assign(window.electronAPI as object, {+ getPlatform: () => "darwin",+ getSystemVersion: () => "14.6.1",+ });+ renderRecStage();+ // The saved prefs have landed once system audio reads on.+ const systemAudioRow = (await screen.findByText("rec.systemAudio")).parentElement;+ if (!systemAudioRow) throw new Error("system audio row is missing");+ await within(systemAudioRow).findByRole("button", { name: "rec.on" });++ expect(screen.queryByText("rec.microphone")).toBeNull();+ expect(microphoneHook.call).toHaveBeenLastCalledWith(false, undefined, undefined);+ expect(audioMeter.call).toHaveBeenLastCalledWith({ enabled: false, deviceId: undefined });+ expect(setRecordingPrefs).not.toHaveBeenCalled();+ cleanup();++ stubRecordingPrefs({ micEnabled: true });+ Object.assign(window.electronAPI as object, {+ getPlatform: () => "darwin",+ getSystemVersion: () => "15.0",+ });+ renderRecStage();+ expect(await screen.findByText("rec.microphone")).toBeInTheDocument();+ await waitFor(() =>+ expect(microphoneHook.call).toHaveBeenLastCalledWith(true, undefined, undefined),+ );+ });+it("applies pushed preference events and ignores older initial preference and source reads", async () => {let resolvePrefs: ((value: RecordingPrefs) => void) | undefined;let resolveSource: ((value: SelectedSource) => void) | undefined;diff --git a/src/components/ai-edition/v4/RecStage.tsx b/src/components/ai-edition/v4/RecStage.tsxindex 72f51454c..aeb1a99a2 100644--- a/src/components/ai-edition/v4/RecStage.tsx+++ b/src/components/ai-edition/v4/RecStage.tsx@@ -20,7 +20,7 @@ import { useCameraDevices } from "@/hooks/useCameraDevices";import { useCameraPreviewStream } from "@/hooks/useCameraPreviewStream";import { useMicrophoneDevices } from "@/hooks/useMicrophoneDevices";import { usePortalOwnsSource } from "@/hooks/usePortalOwnsSource";-import { getPlatform } from "@/utils/platformUtils";+import { canRecordMicrophone, getPlatform } from "@/utils/platformUtils";import styles from "./EditorShellV4.module.css";interface RecordingPrefsState {@@ -50,10 +50,10 @@ const DEFAULT_PREFS: RecordingPrefsState = {};function normalizedRecordingPrefs(prefs: Partial<RecordingPrefsState>): RecordingPrefsState {- return {- ...DEFAULT_PREFS,- ...prefs,- };+ const next = { ...DEFAULT_PREFS, ...prefs };+ // A saved microphone is not applied where a take cannot record it (#700): no+ // meter holding the microphone open for a take that will not have it.+ return { ...next, micEnabled: next.micEnabled && canRecordMicrophone() };}/**@@ -359,59 +359,61 @@ export function RecStage({</button></div>- <div className={styles.recRow}>- <div className={styles.recRowLabel}>- {prefs.micEnabled ? <MicOn size={15} /> : <MicOff size={15} />}- {t("rec.microphone")}- </div>- <div className={styles.recRowControl}>- {prefs.micEnabled ? (- micDevices.isLoading || !micDevices.isReady ? (- <span className={styles.recRowMuted}>- <Loader2 size={13} className="animate-spin" />- {t("rec.loading")}- </span>- ) : micDevices.error ? (- <span className={styles.recRowMuted} title={micDevices.error}>- {t("rec.microphoneUnavailable")}- </span>- ) : micDevices.devices.length === 0 ? (- <span className={styles.recRowMuted}>{t("rec.noMicrophoneFound")}</span>- ) : (- <select- className={styles.recSelect}- value={micDevices.selectedDeviceId}- onChange={(e) => {- const deviceId = e.target.value;- micDevices.setSelectedDeviceId(deviceId);- // The label travels with the id: the native Windows- // helper selects a microphone by NAME, and records the- // Windows default endpoint when it is missing.- updatePrefs({- micDeviceId: deviceId,- micDeviceName:- micDevices.devices.find((d) => d.deviceId === deviceId)?.label ?? null,- });- }}- >- {micDevices.devices.map((d) => (- <option key={d.deviceId} value={d.deviceId}>- {d.label}- </option>- ))}- </select>- )- ) : null}- <button- type="button"- className={`${styles.recToggleBtn}${prefs.micEnabled ? ` ${styles.on}` : ""}`}- aria-pressed={prefs.micEnabled}- onClick={() => updatePrefs({ micEnabled: !prefs.micEnabled })}- >- {prefs.micEnabled ? t("rec.on") : t("rec.off")}- </button>+ {canRecordMicrophone() ? (+ <div className={styles.recRow}>+ <div className={styles.recRowLabel}>+ {prefs.micEnabled ? <MicOn size={15} /> : <MicOff size={15} />}+ {t("rec.microphone")}+ </div>+ <div className={styles.recRowControl}>+ {prefs.micEnabled ? (+ micDevices.isLoading || !micDevices.isReady ? (+ <span className={styles.recRowMuted}>+ <Loader2 size={13} className="animate-spin" />+ {t("rec.loading")}+ </span>+ ) : micDevices.error ? (+ <span className={styles.recRowMuted} title={micDevices.error}>+ {t("rec.microphoneUnavailable")}+ </span>+ ) : micDevices.devices.length === 0 ? (+ <span className={styles.recRowMuted}>{t("rec.noMicrophoneFound")}</span>+ ) : (+ <select+ className={styles.recSelect}+ value={micDevices.selectedDeviceId}+ onChange={(e) => {+ const deviceId = e.target.value;+ micDevices.setSelectedDeviceId(deviceId);+ // The label travels with the id: the native Windows+ // helper selects a microphone by NAME, and records the+ // Windows default endpoint when it is missing.+ updatePrefs({+ micDeviceId: deviceId,+ micDeviceName:+ micDevices.devices.find((d) => d.deviceId === deviceId)?.label ?? null,+ });+ }}+ >+ {micDevices.devices.map((d) => (+ <option key={d.deviceId} value={d.deviceId}>+ {d.label}+ </option>+ ))}+ </select>+ )+ ) : null}+ <button+ type="button"+ className={`${styles.recToggleBtn}${prefs.micEnabled ? ` ${styles.on}` : ""}`}+ aria-pressed={prefs.micEnabled}+ onClick={() => updatePrefs({ micEnabled: !prefs.micEnabled })}+ >+ {prefs.micEnabled ? t("rec.on") : t("rec.off")}+ </button>+ </div></div>- </div>+ ) : null}<div className={styles.recRow}><div className={styles.recRowLabel}>diff --git a/src/components/launch/HudDeviceSettings.tsx b/src/components/launch/HudDeviceSettings.tsxindex 7e854eaa4..d807f752b 100644--- a/src/components/launch/HudDeviceSettings.tsx+++ b/src/components/launch/HudDeviceSettings.tsx@@ -85,6 +85,7 @@ function CameraPreview({* the panel and are entirely separate from the recorder's capture streams.*/export const HudDeviceSettings = memo(function HudDeviceSettings({+ showMicrophone,micDevices,cameraDevices,activeMicId,@@ -101,6 +102,8 @@ export const HudDeviceSettings = memo(function HudDeviceSettings({onClose,panelRef,}: {+ /** False where a take cannot record the microphone (see `canRecordMicrophone`). */+ showMicrophone: boolean;micDevices: MicrophoneDevice[];cameraDevices: CameraDevice[];activeMicId: string | undefined;@@ -123,7 +126,7 @@ export const HudDeviceSettings = memo(function HudDeviceSettings({// on a machine with no webcam fires a getUserMedia that can only fail.const hasCamera = cameraDevices.length > 0 && !cameraError && !cameraLoading;const { level } = useAudioLevelMeter({- enabled: micDevices.length > 0,+ enabled: showMicrophone && micDevices.length > 0,deviceId: activeMicId && activeMicId !== "default" ? activeMicId : undefined,});const { stream, error: previewError } = useCameraPreviewStream({@@ -153,32 +156,36 @@ export const HudDeviceSettings = memo(function HudDeviceSettings({</button></div>- <div className={styles.hudMenuSectionLabel}>{labels.microphone}</div>- {micDevices.length === 0 ? (- <div className={styles.hudModalEmpty}>{labels.noMicrophones}</div>- ) : (- micDevices.map((device) => {- const isActive = device.deviceId === activeMicId;- return (- <button- key={device.deviceId}- type="button"- role="menuitemradio"- aria-checked={isActive}- onClick={() => onSelectMic(device)}- className={`${styles.languageMenuItem} ${isActive ? styles.languageMenuItemActive : ""}`}- >- <span className="truncate">{device.label}</span>- {isActive ? <Check size={14} className="text-white/85" /> : null}- </button>- );- })- )}- <div className={styles.hudModalMeterRow}>- <span className={styles.hudModalMeterLabel}>{labels.micLevel}</span>- <LevelMeter level={level} />- </div>- <div className={styles.hudModalHint}>{labels.micHint}</div>+ {showMicrophone ? (+ <>+ <div className={styles.hudMenuSectionLabel}>{labels.microphone}</div>+ {micDevices.length === 0 ? (+ <div className={styles.hudModalEmpty}>{labels.noMicrophones}</div>+ ) : (+ micDevices.map((device) => {+ const isActive = device.deviceId === activeMicId;+ return (+ <button+ key={device.deviceId}+ type="button"+ role="menuitemradio"+ aria-checked={isActive}+ onClick={() => onSelectMic(device)}+ className={`${styles.languageMenuItem} ${isActive ? styles.languageMenuItemActive : ""}`}+ >+ <span className="truncate">{device.label}</span>+ {isActive ? <Check size={14} className="text-white/85" /> : null}+ </button>+ );+ })+ )}+ <div className={styles.hudModalMeterRow}>+ <span className={styles.hudModalMeterLabel}>{labels.micLevel}</span>+ <LevelMeter level={level} />+ </div>+ <div className={styles.hudModalHint}>{labels.micHint}</div>+ </>+ ) : null}<div className={styles.hudMenuSectionLabel}>{labels.camera}</div>{cameraLoading ? (diff --git a/src/components/launch/LaunchWindow.test.tsx b/src/components/launch/LaunchWindow.test.tsxindex 112abaedd..ae4484864 100644--- a/src/components/launch/LaunchWindow.test.tsx+++ b/src/components/launch/LaunchWindow.test.tsx@@ -14,6 +14,8 @@ type SelectedSourceChangedListener = Parameters<>[0];const platformState = vi.hoisted(() => ({ value: "darwin" as NativePlatform }));+// A macOS whose ScreenCaptureKit captures the microphone, unless a test says otherwise.+const systemVersionState = vi.hoisted(() => ({ value: "15.5" }));const linuxHelperAvailable = vi.hoisted(() => ({ value: true }));const resizeCallbacks = vi.hoisted(() => [] as Array<ResizeObserverCallback>);@@ -77,15 +79,19 @@ vi.mock("../../hooks/useScreenRecorder", () => ({const micDevicesState = vi.hoisted(() => ({value: [] as Array<{ deviceId: string; label: string; groupId: string }>,+ enabled: undefined as boolean | undefined,}));vi.mock("../../hooks/useMicrophoneDevices", () => ({- useMicrophoneDevices: () => ({- devices: micDevicesState.value,- selectedDeviceId: "default",- setSelectedDeviceId: vi.fn(),- isReady: true,- }),+ useMicrophoneDevices: (enabled: boolean) => {+ micDevicesState.enabled = enabled;+ return {+ devices: micDevicesState.value,+ selectedDeviceId: "default",+ setSelectedDeviceId: vi.fn(),+ isReady: true,+ };+ },}));const cameraDevicesState = vi.hoisted(() => ({@@ -225,6 +231,7 @@ function stubElectronAPI(getSelectedSource: Window["electronAPI"]["getSelectedSo// invisible while only `nativeBridgeClient` was consulted for it — and// silently wrong the moment anything read the platform through here.getPlatform: vi.fn(() => platformState.value),+ getSystemVersion: vi.fn(() => systemVersionState.value),// Only the Linux tests read this; the helper being present is what hands// source selection to the portal.isNativeLinuxCaptureAvailable: vi.fn(async () => ({@@ -314,6 +321,8 @@ function resetLaunchMocks() {recorderState.value.recordingPrefsLoaded = true;cameraDevicesState.isReady = true;micDevicesState.value = [];+ micDevicesState.enabled = undefined;+ systemVersionState.value = "15.5";audioLevelMeter.call.mockClear();hudCursorListeners = [];selectedSourceChangedListeners = [];@@ -1495,6 +1504,54 @@ describe("LaunchWindow device settings", () => {});});+// ScreenCaptureKit captures the microphone from macOS 15 only; on 13 and 14 every take+// came out without the voice, and without a word (#700).+describe("LaunchWindow microphone before macOS 15", () => {+ beforeEach(() => {+ platformState.value = "darwin";+ resetLaunchMocks();+ micDevicesState.value = [{ deviceId: "mic-a", label: "Mic A", groupId: "g" }];+ });++ afterEach(() => {+ cleanup();+ vi.unstubAllGlobals();+ });++ async function openDeviceSettings() {+ renderLaunchWindow();+ fireEvent.click(await screen.findByTestId("launch-device-settings-button"));+ return screen.findByTestId("hud-device-settings");+ }++ it("offers no microphone on macOS 14: no button, no picker, no meter", async () => {+ systemVersionState.value = "14.6.1";++ const panel = await openDeviceSettings();++ expect(screen.queryByTestId("launch-microphone-button")).toBeNull();+ expect(within(panel).queryByText("Input device")).toBeNull();+ expect(within(panel).queryByRole("menuitemradio", { name: /Mic A/ })).toBeNull();+ // Nothing asks for the microphone: enumerating it is what raises the prompt.+ expect(micDevicesState.enabled).toBe(false);+ expect(audioLevelMeter.call).toHaveBeenLastCalledWith(+ expect.objectContaining({ enabled: false }),+ );+ expect(screen.getByTestId("launch-webcam-button")).toBeInTheDocument();+ });++ it("offers it from macOS 15", async () => {+ systemVersionState.value = "15.0";++ const panel = await openDeviceSettings();++ expect(screen.getByTestId("launch-microphone-button")).toBeInTheDocument();+ expect(within(panel).getByText("Input device")).toBeInTheDocument();+ expect(within(panel).getByRole("menuitemradio", { name: /Mic A/ })).toBeInTheDocument();+ expect(micDevicesState.enabled).toBe(true);+ });+});+describe("LaunchWindow HUD drag", () => {beforeEach(() => {platformState.value = "darwin";diff --git a/src/components/launch/LaunchWindow.tsx b/src/components/launch/LaunchWindow.tsxindex 5084a01ae..b7fcc9715 100644--- a/src/components/launch/LaunchWindow.tsx+++ b/src/components/launch/LaunchWindow.tsx@@ -3,6 +3,7 @@ import { useI18n, useScopedT } from "@/contexts/I18nContext";import { getAvailableLocales, getLocaleName } from "@/i18n/loader";import { loadUserPreferences, saveUserPreferences } from "@/lib/userPreferences";import { nativeBridgeClient } from "@/native";+import { canRecordMicrophone } from "@/utils/platformUtils";import { type CameraDevice } from "../../hooks/useCameraDevices";import { useCameraHudSync } from "../../hooks/useCameraHudSync";import {@@ -184,6 +185,8 @@ export function LaunchWindow() {setWebcamDeviceId,setWebcamDeviceName,});+ // macOS 13 and 14 cannot record the microphone (#700): no button, no picker, no meter.+ const microphoneOffered = canRecordMicrophone();// The microphone list stays lazy: enumerating it asks for mic permission,// which would light the OS "in use" indicator just for opening the HUD.const {@@ -192,7 +195,7 @@ export function LaunchWindow() {setSelectedDeviceId: setSelectedMicId,isReady: micDevicesReady,} = useMicrophoneDevices(- microphoneEnabled || isDeviceSettingsOpen,+ microphoneOffered && (microphoneEnabled || isDeviceSettingsOpen),microphoneDeviceId,microphoneDeviceName,);@@ -1154,12 +1157,16 @@ export function LaunchWindow() {<divclassName={`${styles.hudControlGroup} ${isVertical ? styles.hudControlGroupVertical : ""}`}>- <HudMicButton- enabled={microphoneEnabled}- disabled={controlsLocked}- label={microphoneEnabled ? t("audio.disableMicrophone") : t("audio.enableMicrophone")}- onClick={toggleMicrophone}- />+ {microphoneOffered && (+ <HudMicButton+ enabled={microphoneEnabled}+ disabled={controlsLocked}+ label={+ microphoneEnabled ? t("audio.disableMicrophone") : t("audio.enableMicrophone")+ }+ onClick={toggleMicrophone}+ />+ )}<HudCameraButtonenabled={webcamEnabled}disabled={controlsLocked}@@ -1260,6 +1267,7 @@ export function LaunchWindow() {<div className={styles.hudAbove}>{isDeviceSettingsOpen && (<HudDeviceSettings+ showMicrophone={microphoneOffered}micDevices={micDevices}cameraDevices={cameraDevices}activeMicId={microphoneDeviceId || selectedMicId}diff --git a/src/hooks/useScreenRecorder.nativeMacStartWarning.test.tsx b/src/hooks/useScreenRecorder.nativeMacStartWarning.test.tsxindex 040eeee6a..07733a3f0 100644--- a/src/hooks/useScreenRecorder.nativeMacStartWarning.test.tsx+++ b/src/hooks/useScreenRecorder.nativeMacStartWarning.test.tsx@@ -31,6 +31,8 @@ function stubElectronAPI() {cursorCaptureMode: "system",})),getPlatform: vi.fn(() => "darwin"),+ // ScreenCaptureKit captures the microphone from macOS 15.+ getSystemVersion: vi.fn(() => "15.5"),getSelectedSource: vi.fn(async () => SOURCE),isNativeMacCaptureAvailable: vi.fn(async () => ({ success: true, available: true })),startNativeMacRecording: vi.fn(async () => ({@@ -89,6 +91,46 @@ describe("useScreenRecorder native macOS start warnings", () => {expect(toast.error).toHaveBeenCalledWith("recording.microphoneDefaulted");});+ it("says so when the helper records without the microphone", async () => {+ api.startNativeMacRecording.mockResolvedValue({+ success: true,+ recordingId: 7,+ microphoneUnavailable: true,+ });+ const view = renderHook(() => useScreenRecorder());+ await settle();++ await act(async () => {+ view.result.current.toggleRecording();+ });+ await settle(3_500);++ expect(view.result.current.recording).toBe(true);+ expect(toast.error).toHaveBeenCalledWith("recording.microphoneUnavailable");+ });++ // macOS 13 and 14 have no `captureMicrophone`: a saved "mic on" would ask for the+ // microphone and record a take without it (#700).+ it("does not apply a saved microphone on macOS 14", async () => {+ api.getSystemVersion.mockReturnValue("14.6.1");+ const view = renderHook(() => useScreenRecorder());+ await settle();+ expect(view.result.current.microphoneEnabled).toBe(false);++ await act(async () => {+ view.result.current.toggleRecording();+ });+ await settle(3_500);++ expect(api.startNativeMacRecording).toHaveBeenCalledWith(+ expect.objectContaining({+ audio: expect.objectContaining({+ microphone: expect.objectContaining({ enabled: false }),+ }),+ }),+ );+ });+it("does not warn after the recording start is cancelled", async () => {let resolveStart:| ((result: Awaited<ReturnType<ElectronAPI["startNativeMacRecording"]>>) => void)diff --git a/src/hooks/useScreenRecorder.ts b/src/hooks/useScreenRecorder.tsindex c3fd3b05b..0d1460412 100644--- a/src/hooks/useScreenRecorder.ts+++ b/src/hooks/useScreenRecorder.ts@@ -19,6 +19,7 @@ import {import type { CursorCaptureMode, RecordedVideoAssetInput } from "@/lib/recordingSession";import { requestCameraAccess } from "@/lib/requestCameraAccess";import { loadUserPreferences, saveUserPreferences } from "@/lib/userPreferences";+import { canRecordMicrophone } from "@/utils/platformUtils";import { createRecorderHandle, type RecorderHandle } from "./recorderHandle";import { webcamDeviceIdentityFrom } from "./webcamDeviceIdentity";@@ -278,7 +279,9 @@ export function useScreenRecorder(): UseScreenRecorderReturn {cursorCaptureMode: CursorCaptureMode;}) => {if (cancelled) return;- setMicrophoneEnabled(prefs.micEnabled);+ // Not applied where a take cannot record the microphone (#700): it would ask+ // for the microphone, for a take that comes out without it.+ setMicrophoneEnabled(prefs.micEnabled && canRecordMicrophone());setMicrophoneDeviceId(prefs.micDeviceId ?? undefined);setMicrophoneDeviceName(prefs.micDeviceName ?? undefined);const isCliRecord =@@ -1415,6 +1418,9 @@ export function useScreenRecorder(): UseScreenRecorderReturn {if (result.microphoneDefaulted) {toast.error(t("recording.microphoneDefaulted"));}+ if (result.microphoneUnavailable) {+ toast.error(t("recording.microphoneUnavailable"));+ }// The IPC call above only resolves once the helper's stdout confirms its// screen capture has truly started (see waitForNativeMacCaptureStart indiff --git a/src/i18n/locales/ar/editor.json b/src/i18n/locales/ar/editor.jsonindex 26794c5fe..7fa393cd2 100644--- a/src/i18n/locales/ar/editor.json+++ b/src/i18n/locales/ar/editor.json@@ -48,6 +48,7 @@"cameraNotFound": "لم يتم العثور على كاميرا.","cameraCaptureUnavailable": "تعذّر فتح الكاميرا. يجري التسجيل بدون كاميرا.","microphoneDefaulted": "تعذّر تحديد الميكروفون المحدَّد؛ يجري التسجيل من الإدخال الافتراضي.",+ "microphoneUnavailable": "لا يمكن لهذا الإصدار من macOS تسجيل الميكروفون. يجري التسجيل بدون ميكروفون.","permissionDenied": "تم رفض إذن التسجيل. يرجى السماح بتسجيل الشاشة.","accessibilityAllowAndRetry": "اسمح بوصول تسهيلات الاستخدام لـ OpenScreen، ثم اضغط على التسجيل مرة أخرى لبدء العد التنازلي.","selectSource": "يرجى تحديد مصدر للتسجيل"diff --git a/src/i18n/locales/cs/editor.json b/src/i18n/locales/cs/editor.jsonindex 2395728cf..eba1a63c1 100644--- a/src/i18n/locales/cs/editor.json+++ b/src/i18n/locales/cs/editor.json@@ -48,6 +48,7 @@"cameraNotFound": "Kamera nenalezena.","cameraCaptureUnavailable": "Kameru se nepodařilo otevřít. Nahrávání probíhá bez ní.","microphoneDefaulted": "Vybraný mikrofon se nepodařilo identifikovat. Nahrávání bude pokračovat s výchozím vstupem.",+ "microphoneUnavailable": "Tato verze macOS neumí nahrávat mikrofon. Nahrávání probíhá bez něj.","permissionDenied": "Oprávnění k nahrávání odepřeno. Povolte prosím záznam obrazovky.","accessibilityAllowAndRetry": "Povolte přístup k usnadnění pro OpenScreen a poté znovu stiskněte tlačítko nahrávání pro zahájení odpočítávání.","selectSource": "Vyberte prosím zdroj pro nahrávání"diff --git a/src/i18n/locales/de/editor.json b/src/i18n/locales/de/editor.jsonindex 87f566c5c..6e65c4c17 100644--- a/src/i18n/locales/de/editor.json+++ b/src/i18n/locales/de/editor.json@@ -48,6 +48,7 @@"cameraNotFound": "Kamera nicht gefunden.","cameraCaptureUnavailable": "Die Kamera konnte nicht geöffnet werden. Die Aufnahme läuft ohne sie.","microphoneDefaulted": "Das gewählte Mikrofon konnte nicht identifiziert werden. Es wird der Standardeingang aufgenommen.",+ "microphoneUnavailable": "Diese macOS-Version kann das Mikrofon nicht aufnehmen. Die Aufnahme läuft ohne Mikrofon.","permissionDenied": "Aufnahmeberechtigung verweigert. Bitte erlaube die Bildschirmaufnahme.","accessibilityAllowAndRetry": "Erlaube OpenScreen den Zugriff auf die Bedienungshilfen und drücke dann erneut auf Aufnehmen, um den Countdown zu starten.","selectSource": "Bitte wähle eine Quelle für die Aufnahme"diff --git a/src/i18n/locales/en/editor.json b/src/i18n/locales/en/editor.jsonindex efb05622f..b241dba79 100644--- a/src/i18n/locales/en/editor.json+++ b/src/i18n/locales/en/editor.json@@ -48,6 +48,7 @@"cameraNotFound": "Camera not found.","cameraCaptureUnavailable": "The camera could not be opened. Recording without it.","microphoneDefaulted": "The chosen microphone could not be identified. Recording the default input.",+ "microphoneUnavailable": "This version of macOS can't record the microphone. Recording without it.","permissionDenied": "Recording permission denied. Please allow screen recording.","accessibilityAllowAndRetry": "Allow Accessibility access for OpenScreen, then press record again to start the countdown.","selectSource": "Choose a screen or window to record"diff --git a/src/i18n/locales/es/editor.json b/src/i18n/locales/es/editor.jsonindex 6189814bd..578b9cb12 100644--- a/src/i18n/locales/es/editor.json+++ b/src/i18n/locales/es/editor.json@@ -40,6 +40,7 @@"cameraNotFound": "Cámara no encontrada.","cameraCaptureUnavailable": "No se pudo abrir la cámara. Grabando sin ella.","microphoneDefaulted": "No se pudo identificar el micrófono elegido. Grabando la entrada predeterminada.",+ "microphoneUnavailable": "Esta versión de macOS no puede grabar el micrófono. Grabando sin él.","permissionDenied": "Permiso de grabación denegado. Por favor permite la grabación de pantalla.","accessibilityAllowAndRetry": "Permite el acceso de accesibilidad para OpenScreen y luego pulsa grabar de nuevo para iniciar la cuenta atrás.","selectSource": "Por favor selecciona una fuente para grabar"diff --git a/src/i18n/locales/fr/editor.json b/src/i18n/locales/fr/editor.jsonindex 599971a2b..8494f0f27 100644--- a/src/i18n/locales/fr/editor.json+++ b/src/i18n/locales/fr/editor.json@@ -46,6 +46,7 @@"cameraNotFound": "Caméra introuvable.","cameraCaptureUnavailable": "Impossible d'ouvrir la caméra. Enregistrement sans elle.","microphoneDefaulted": "Micro choisi non identifié. Enregistrement de l'entrée par défaut.",+ "microphoneUnavailable": "Cette version de macOS ne permet pas d'enregistrer le micro. Enregistrement sans lui.","permissionDenied": "Permission d'enregistrement refusée. Veuillez autoriser l'enregistrement d'écran.","accessibilityAllowAndRetry": "Autorisez l'accès Accessibilité pour OpenScreen, puis appuyez de nouveau sur enregistrer pour lancer le compte à rebours.","selectSource": "Veuillez sélectionner une source à enregistrer"diff --git a/src/i18n/locales/it/editor.json b/src/i18n/locales/it/editor.jsonindex 13a8c76e1..4b7480f11 100644--- a/src/i18n/locales/it/editor.json+++ b/src/i18n/locales/it/editor.json@@ -48,6 +48,7 @@"cameraNotFound": "Fotocamera non trovata.","cameraCaptureUnavailable": "Impossibile aprire la fotocamera. Registrazione senza di essa.","microphoneDefaulted": "Impossibile identificare il microfono scelto. Registrazione dall'ingresso predefinito.",+ "microphoneUnavailable": "Questa versione di macOS non può registrare il microfono. Registrazione senza microfono.","permissionDenied": "Autorizzazione di registrazione negata. Consenti la registrazione dello schermo.","accessibilityAllowAndRetry": "Consenti l'accesso all'accessibilità per OpenScreen, poi premi di nuovo registra per avviare il conto alla rovescia.","selectSource": "Seleziona una sorgente da registrare"diff --git a/src/i18n/locales/ja-JP/editor.json b/src/i18n/locales/ja-JP/editor.jsonindex f8bcbb8b6..97ca8c18e 100644--- a/src/i18n/locales/ja-JP/editor.json+++ b/src/i18n/locales/ja-JP/editor.json@@ -49,6 +49,7 @@"cameraNotFound": "カメラが見つかりません。","cameraCaptureUnavailable": "カメラを開けませんでした。カメラなしで録画します。","microphoneDefaulted": "選択したマイクを特定できませんでした。既定の入力を録音します。",+ "microphoneUnavailable": "このバージョンの macOS ではマイクを録音できません。マイクなしで録画します。","accessibilityAllowAndRetry": "OpenScreenにアクセシビリティアクセスを許可してから、もう一度録画を押してカウントダウンを開始してください。","selectSource": "録画するソースを選択してください"},diff --git a/src/i18n/locales/ko-KR/editor.json b/src/i18n/locales/ko-KR/editor.jsonindex 1bd3e8029..bb885f92e 100644--- a/src/i18n/locales/ko-KR/editor.json+++ b/src/i18n/locales/ko-KR/editor.json@@ -49,6 +49,7 @@"cameraNotFound": "카메라를 찾을 수 없습니다.","cameraCaptureUnavailable": "카메라를 열 수 없습니다. 카메라 없이 녹화합니다.","microphoneDefaulted": "선택한 마이크를 확인할 수 없습니다. 기본 입력을 녹음합니다.",+ "microphoneUnavailable": "이 버전의 macOS에서는 마이크를 녹음할 수 없습니다. 마이크 없이 녹화합니다.","accessibilityAllowAndRetry": "OpenScreen의 손쉬운 사용 접근을 허용한 다음, 카운트다운을 시작하려면 다시 녹화를 누르세요.","selectSource": "녹화할 소스를 선택해 주세요"},diff --git a/src/i18n/locales/pt-BR/editor.json b/src/i18n/locales/pt-BR/editor.jsonindex 35cd9df27..9f2cd0a50 100644--- a/src/i18n/locales/pt-BR/editor.json+++ b/src/i18n/locales/pt-BR/editor.json@@ -48,6 +48,7 @@"cameraNotFound": "Câmera não encontrada.","cameraCaptureUnavailable": "Não foi possível abrir a câmera. Gravando sem ela.","microphoneDefaulted": "Não foi possível identificar o microfone escolhido. Gravando a entrada padrão.",+ "microphoneUnavailable": "Esta versão do macOS não consegue gravar o microfone. Gravando sem ele.","permissionDenied": "Permissão de gravação negada. Por favor, permita a gravação de tela.","accessibilityAllowAndRetry": "Permita o acesso de Acessibilidade para o OpenScreen e pressione gravar novamente para iniciar a contagem regressiva.","selectSource": "Por favor, selecione uma fonte para gravar"diff --git a/src/i18n/locales/ru/editor.json b/src/i18n/locales/ru/editor.jsonindex 50e37fe18..f9a147890 100644--- a/src/i18n/locales/ru/editor.json+++ b/src/i18n/locales/ru/editor.json@@ -48,6 +48,7 @@"cameraNotFound": "Камера не найдена.","cameraCaptureUnavailable": "Не удалось открыть камеру. Запись идёт без неё.","microphoneDefaulted": "Не удалось определить выбранный микрофон. Записывается вход по умолчанию.",+ "microphoneUnavailable": "Эта версия macOS не может записывать микрофон. Запись идёт без него.","permissionDenied": "Разрешение на запись запрещено. Пожалуйста, разрешите запись экрана.","accessibilityAllowAndRetry": "Разрешите OpenScreen доступ к Универсальному доступу, затем снова нажмите запись, чтобы начать обратный отсчет.","selectSource": "Пожалуйста, выберите источник для записи"diff --git a/src/i18n/locales/tr/editor.json b/src/i18n/locales/tr/editor.jsonindex 4c4ddf7f4..96b0cb3c7 100644--- a/src/i18n/locales/tr/editor.json+++ b/src/i18n/locales/tr/editor.json@@ -41,6 +41,7 @@"cameraNotFound": "Kamera bulunamadı.","cameraCaptureUnavailable": "Kamera açılamadı. Kamerasız kaydediliyor.","microphoneDefaulted": "Seçilen mikrofon belirlenemedi. Varsayılan giriş kaydediliyor.",+ "microphoneUnavailable": "Bu macOS sürümü mikrofonu kaydedemiyor. Mikrofonsuz kaydediliyor.","accessibilityAllowAndRetry": "OpenScreen için Erişilebilirlik erişimine izin verin, ardından geri sayımı başlatmak için tekrar kayda basın.","selectSource": "Lütfen kayıt için bir kaynak seçin"},diff --git a/src/i18n/locales/vi/editor.json b/src/i18n/locales/vi/editor.jsonindex 9d952a874..2398c50d8 100644--- a/src/i18n/locales/vi/editor.json+++ b/src/i18n/locales/vi/editor.json@@ -48,6 +48,7 @@"cameraNotFound": "Không tìm thấy máy ảnh.","cameraCaptureUnavailable": "Không thể mở máy ảnh. Đang ghi mà không có máy ảnh.","microphoneDefaulted": "Không xác định được micrô đã chọn. Đang ghi từ đầu vào mặc định.",+ "microphoneUnavailable": "Phiên bản macOS này không thể ghi micrô. Đang ghi mà không có micrô.","permissionDenied": "Quyền ghi hình bị từ chối. Vui lòng cho phép ghi màn hình.","accessibilityAllowAndRetry": "Cho phép OpenScreen truy cập Trợ năng, sau đó nhấn ghi lại để bắt đầu đếm ngược.","selectSource": "Vui lòng chọn một nguồn để ghi"diff --git a/src/i18n/locales/zh-CN/editor.json b/src/i18n/locales/zh-CN/editor.jsonindex b4a877346..0e7bf99cb 100644--- a/src/i18n/locales/zh-CN/editor.json+++ b/src/i18n/locales/zh-CN/editor.json@@ -48,6 +48,7 @@"cameraNotFound": "未找到摄像头。","cameraCaptureUnavailable": "无法打开摄像头,正在不使用摄像头录制。","microphoneDefaulted": "无法识别所选麦克风,正在录制默认输入设备。",+ "microphoneUnavailable": "此版本的 macOS 无法录制麦克风,正在不使用麦克风录制。","permissionDenied": "录屏权限被拒绝。请允许屏幕录制。","accessibilityAllowAndRetry": "允许 OpenScreen 使用辅助功能权限,然后再次按录制以开始倒计时。","selectSource": "请选择要录制的源"diff --git a/src/i18n/locales/zh-TW/editor.json b/src/i18n/locales/zh-TW/editor.jsonindex 9ddf71a9c..e5f3a3f7e 100644--- a/src/i18n/locales/zh-TW/editor.json+++ b/src/i18n/locales/zh-TW/editor.json@@ -49,6 +49,7 @@"cameraNotFound": "找不到攝影機。","cameraCaptureUnavailable": "無法開啟攝影機,將在沒有攝影機的情況下錄製。","microphoneDefaulted": "無法辨識所選麥克風,將錄製預設輸入裝置。",+ "microphoneUnavailable": "此版本的 macOS 無法錄製麥克風,將在沒有麥克風的情況下錄製。","accessibilityAllowAndRetry": "允許 OpenScreen 使用輔助使用權限,然後再次按下錄製以開始倒數。","selectSource": "請選擇要錄製的來源"},diff --git a/src/lib/nativeMacRecording.ts b/src/lib/nativeMacRecording.tsindex dd33df699..6f269e4d9 100644--- a/src/lib/nativeMacRecording.ts+++ b/src/lib/nativeMacRecording.ts@@ -94,6 +94,8 @@ export type NativeMacRecordingStartResult = {helperPath?: string;/** The helper could not resolve the selected device and is using the system default. */microphoneDefaulted?: boolean;+ /** The microphone was asked for, but this macOS cannot capture it: the take has no voice. */+ microphoneUnavailable?: boolean;error?: string;};diff --git a/src/utils/platformUtils.test.ts b/src/utils/platformUtils.test.tsindex 41c11b8f6..29ef69deb 100644--- a/src/utils/platformUtils.test.ts+++ b/src/utils/platformUtils.test.ts@@ -1,6 +1,6 @@// @vitest-environment jsdomimport { afterEach, describe, expect, it } from "vitest";-import { getPlatform, isMac } from "./platformUtils";+import { canRecordMicrophone, getPlatform, isMac } from "./platformUtils";// The renderer has no Node `process` global (contextIsolation: true), and// browser mode has no `electronAPI` at all. jsdom provides `process`, so a@@ -26,3 +26,41 @@ describe("getPlatform", () => {expect(typeof getPlatform()).toBe("string");});});++describe("canRecordMicrophone", () => {+ const pin = (platform: string, systemVersion: string | undefined) => {+ window.electronAPI = {+ getPlatform: () => platform,+ getSystemVersion: () => systemVersion,+ } as unknown as typeof window.electronAPI;+ };++ // ScreenCaptureKit's `captureMicrophone` is macOS 15 API (#700).+ it("is false on macOS 13 and 14", () => {+ for (const version of ["13.0", "13.7.4", "14.0", "14.6.1"]) {+ pin("darwin", version);+ expect(canRecordMicrophone(), version).toBe(false);+ }+ });++ it("is true from macOS 15", () => {+ for (const version of ["15.0", "15.5", "26.5.0"]) {+ pin("darwin", version);+ expect(canRecordMicrophone(), version).toBe(true);+ }+ });++ it("leaves Windows and Linux alone", () => {+ pin("win32", "10.0.26200");+ expect(canRecordMicrophone()).toBe(true);+ pin("linux", "6.8.0-45-generic");+ expect(canRecordMicrophone()).toBe(true);+ });++ it("keeps the microphone when the macOS version is unknown", () => {+ pin("darwin", undefined);+ expect(canRecordMicrophone()).toBe(true);+ pin("darwin", "");+ expect(canRecordMicrophone()).toBe(true);+ });+});diff --git a/src/utils/platformUtils.ts b/src/utils/platformUtils.tsindex 4d933e865..ef68a79aa 100644--- a/src/utils/platformUtils.ts+++ b/src/utils/platformUtils.ts@@ -25,3 +25,18 @@ export function getPlatform(): NodeJS.Platform {* Detects if the current platform is macOS.*/export const isMac = (): boolean => getPlatform() === "darwin";++/**+ * Whether a take can record the microphone on this machine.+ *+ * Every macOS take goes through the ScreenCaptureKit helper, which records the+ * microphone with `captureMicrophone`: macOS 15 API. On 13 and 14 the take came+ * out without the voice and without a word (#700), so the microphone is not+ * offered there. A version that does not parse keeps it: the helper still says+ * when it records without the microphone.+ */+export function canRecordMicrophone(): boolean {+ if (getPlatform() !== "darwin") return true;+ const major = Number.parseInt(window.electronAPI?.getSystemVersion?.() ?? "", 10);+ return Number.isNaN(major) || major >= 15;+}diff --git a/technical-documentation/architecture/recording.md b/technical-documentation/architecture/recording.mdindex cad8f5ebe..3201817c1 100644--- a/technical-documentation/architecture/recording.md+++ b/technical-documentation/architecture/recording.md@@ -43,7 +43,7 @@ Stopping is the part of that boundary that has broken repeatedly (issues #34, #1| Schema | `schemaVersion: 2` | `schemaVersion: 1` | `schemaVersion: 1` || Source identity | `sourceId`, `displayId`, optional `windowHandle` | `sourceId`, `displayId`, optional `windowId` | **None, and none is possible.** See below || Video | FPS, dimensions, bitrate | FPS, dimensions, bitrate, and `hideSystemCursor` | FPS and optional bitrate; dimensions come from what the compositor negotiates |-| Audio | System loopback and selected microphone flags/device metadata | System audio and microphone flags/device metadata; microphone support is runtime-gated | System and microphone flags; the microphone is matched by PipeWire `node.description`, not by Chromium device id |+| Audio | System loopback and selected microphone flags/device metadata | System audio and microphone flags/device metadata; the microphone needs macOS 15 (`captureMicrophone`), so the HUD and the Rec stage do not offer it on 13 and 14, and a take that asks anyway records without it and reports `microphone-unavailable` | System and microphone flags; the microphone is matched by PipeWire `node.description`, not by Chromium device id || Webcam | Native Media Foundation first, exact Electron-resolved DirectShow fallback; muxed into primary MP4 by default | Electron sidecar attached to the session | Electron sidecar attached to the session || Output | `screenPath`, session manifest, and optional `webcamPath` | `screenPath` and session manifest | `screenPath`, session manifest, and a `.cursor.json` sidecar || Runtime control | stdin pause/resume/stop/cancel; JSON events plus legacy text compatibility | Process events and the same lifecycle commands as the process boundary evolves | stdin pause/resume/stop; NDJSON events on stdout |