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
docs(testing): run Apple's picker checks before the Screen Recording grant
EtienneLescot53f72846be71
diff --git a/technical-documentation/testing/manual-e2e-checklist.md b/technical-documentation/testing/manual-e2e-checklist.mdindex 1f1cd1e11..14c63ebd6 100644--- a/technical-documentation/testing/manual-e2e-checklist.md+++ b/technical-documentation/testing/manual-e2e-checklist.md@@ -851,10 +851,10 @@ On macOS 15.2+ it opens at launch, until it has been closed once, while one of iApple's picker is owned by Control Centre, and computer-use cannot be granted Control Centre: no click and no key reaches the picker. Left as is, a human clicks *Share Entire Screen* for every take. Instead:-1. **Once per Mac and app identity**, the Mac owner allows OpenScreen under System Settings → Privacy & Security → *Screen & System Audio Recording*. The app reads that grant at launch, so relaunch after giving it. TCC keys the grant on the signature: a Developer ID build keeps it from one RC to the next, while an ad hoc signed local package asks again after each build.-2. **Launch with `OPENSCREEN_MAC_SOURCE_PICKER=legacy`** from the shell, like the content-protection flag. The HUD's source button and Record mode's Source row then open the app's own *Screens* / *Windows* selector, which computer-use drives exactly as on Windows. Every other section runs from there without a human.-3. **macOS may ask, about once a month, whether OpenScreen may keep bypassing the private window picker.** That alert is a system one too: the operator answers it. It is the only prompt left, and one more reason the grant has to be in place before the run, not discovered during it.-4. **Run the human slice first, in one sitting:** the [Apple's source picker](#apples-source-picker--macos-152-v200) checks below, and the permissions window's 15.2+ rows, on a launch *without* the variable. A few minutes of clicks, after which the operator can leave and the agent relaunches with `legacy` for the rest.+1. **Run the human slice first, in one sitting, before any Screen Recording grant:** the [Apple's source picker](#apples-source-picker--macos-152-v200) checks below, and the permissions window's 15.2+ rows, on a launch *without* the variable. One of them confirms the picker records with no Screen Recording grant, which only means something while the grant is absent: on a Mac that already holds it, that part needs the grant reset (`tccutil reset ScreenCapture com.etiennelescot.openscreen`), the Mac owner's decision, or it is skipped with that reason. A few minutes of clicks, after which the operator can leave.+2. **Then, once per Mac and app identity**, the Mac owner allows OpenScreen under System Settings → Privacy & Security → *Screen & System Audio Recording*, and the app is relaunched: it reads that grant at launch. TCC keys the grant on the signature: a Developer ID build keeps it from one RC to the next, while an ad hoc signed local package asks again after each build.+3. **Relaunch with `OPENSCREEN_MAC_SOURCE_PICKER=legacy`** from the shell, like the content-protection flag. The HUD's source button and Record mode's Source row then open the app's own *Screens* / *Windows* selector, which computer-use drives exactly as on Windows. Every other section runs from there without a human.+4. **macOS may ask, about once a month, whether OpenScreen may keep bypassing the private window picker.** That alert is a system one too: the operator answers it. It is the only prompt left, and one more reason the grant has to be in place before the legacy run, not discovered during it.5. **Say it in the results row.** A pass run under `legacy` did not exercise Apple's picker, so the row names which takes used which picker. For a release candidate, the human slice is part of "the whole file": skipping it makes the row `Partial`.Recording through the stdio MCP server or the CLI also bypasses the picker: `startRecording` and `record` pick a display or window by name, headless. They need the classic Screen Recording grant too, given to whatever launched them (the agent's terminal or IDE for the stdio server). That makes a take, not a HUD check — use it to get footage for the editor sections, never to tick a recording check.