Skip to content

Record your screen, ship a demo. Free and open-source, GPU-accelerated, no watermarks, no subscriptions. Windows, macOS, Linux. Actively maintained.

docs(testing): grant wgc-capture.exe so computer-use leaves the icon cover up

EtienneLescot3fb242885142
diff --git a/AGENTS.md b/AGENTS.md
index fef6b71b5..268e56567 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -112,7 +112,7 @@ This section is the *mechanics*. **What to actually run is [`technical-documenta
**Granting access**
-- `request_access` resolves names against installed apps. A **dev build runs as `electron.exe`** (or `Electron.app`), *not* the installed `Openscreen` — grant **`electron.exe`** or the dev window stays masked in screenshots. An installed build, CI artifact included, is the other way round: grant **`Openscreen`**. Non-allowlisted windows are masked (solid rectangles); the screenshot note lists their process names to add.
+- `request_access` resolves names against installed apps. A **dev build runs as `electron.exe`** (or `Electron.app`), *not* the installed `Openscreen` — grant **`electron.exe`** or the dev window stays masked in screenshots. An installed build, CI artifact included, is the other way round: grant **`Openscreen`**. Non-allowlisted windows are masked (solid rectangles); the screenshot note lists their process names to add. On Windows they are also **minimized** whenever computer-use brings an app forward, which is why Hide desktop icons needs `wgc-capture.exe` granted mid-take (see that check in the checklist).
- **Start the app before asking for it.** `electron.exe` is not an installed app, so the resolver only finds it once the process exists *and* owns a window; ask any earlier and the call fails with `doesn't match any installed or running application` — and one unresolvable name short-circuits the whole request, including the names that would have resolved. Granting `Openscreen` instead is not a workaround: it resolves to `…\programs\openscreen\openscreen.exe`, so the dev window stays masked while the grant reports success.
- **Some windows a pass needs are not OpenScreen's.** The macOS permission prompts are drawn by system processes, the Linux portal picker by the desktop's portal. Which process owns each is not recorded yet: grant the one the screenshot note names, and write it into the checklist's grant step for the next run.
- **Apple's source picker (macOS 15.2+) belongs to Control Centre, which computer-use cannot be granted.** Launch with `OPENSCREEN_MAC_SOURCE_PICKER=legacy` so the source button opens the app's own selector instead, which the agent drives; the cost is a one-time Screen Recording grant. Only the checks on Apple's picker itself are left to a human. Recipe: [Running the pass unattended on macOS](technical-documentation/testing/manual-e2e-checklist.md#running-the-pass-unattended-on-macos).
diff --git a/technical-documentation/testing/manual-e2e-checklist.md b/technical-documentation/testing/manual-e2e-checklist.md
index b956b36e3..18567a97b 100644
--- a/technical-documentation/testing/manual-e2e-checklist.md
+++ b/technical-documentation/testing/manual-e2e-checklist.md
@@ -33,6 +33,8 @@ Sections and checks marked **post-2.0.0** cover what has landed on `main` since
On macOS 26 the Screen Recording and Accessibility prompts are windows of `universalAccessAuthWarn` (measured 2026-10-14). It is not an installed app, so `request_access` cannot grant it: the prompt stays masked and the operator answers it. `UserNotificationCenter` is an installed app that `request_access` does resolve: granting it unmasks the system alerts it draws, an Automation consent dialog among them, so the agent can see what is blocking its clicks. That grant is computer-use access to those windows, not the Automation (Apple Events) permission itself, which stays the operator's answer to the prompt. The save panel shows nothing in screenshots either; typing the base name and pressing Return still saves.
+ **On Windows, an ungranted window does not just stay masked: it gets minimized.** computer-use minimizes every window it was not granted whenever it brings an app forward, and leaves it so. Anything the pass checks on screen must therefore be granted, even a window the agent never clicks, such as the Hide desktop icons cover (see that check).
+
**Apple's source picker (macOS 15.2+) cannot be granted.** It is drawn by Control Centre, which computer-use refuses, so an agent sees the picker and cannot click it: every take started through it waits for a human (rc.8, rc.12 and rc.13 runs). Do not try to grant it. Run the pass on the app's own picker instead, and keep Apple's picker for a short human slice: [Running the pass unattended on macOS](#running-the-pass-unattended-on-macos).
**Name them the way the Start menu does, in the system's own language.** The resolver matches installed-app display names, not executables: on a French Windows the shell is `Explorateur de fichiers` and `explorer.exe` fails outright — `notInstalled`, with a nonsense suggestion attached — which then voids every other name in the same call. On an English install it is `File Explorer`. When unsure, ask rather than guess; the tool lists the installed names it knows.
@@ -153,6 +155,8 @@ Record mode is the editor's pre-flight panel for the HUD: it edits the same sett
- [ ] Turn Editable cursor Off and confirm the Auto-zoom after recording row disappears; confirm a take recorded that way opens without automatic zooms.
- [ ] On Windows, turn Hide desktop icons On, record a screen, and confirm the recording shows the wallpaper where the icons were, and that the icons are back when the take stops. On macOS, confirm the icons are absent from the recording while they stay on the desktop.
+ **On Windows, grant `wgc-capture.exe` once the take is running, before the first click.** The cover over the icons is a window of that helper, and computer-use minimizes every window it was not granted as soon as it brings an app forward. Ungranted, the icons come back at the agent's first click and stay for the rest of the take: that reads as a product defect and is not one (measured 2026-10-15 on v2.1.0-rc.1, Windows 11 26200). A user's own clicks never move the cover. The helper only exists while recording, so the step-4 batch cannot resolve it unless a take is already running.
+
### Webcam capture quality — v2.0.0
The camera is captured at its own resolution and frame rate, and the resolution is the HUD's *Camera quality* setting (1080p, 1440p, 4K). Before that, nothing asked the camera for a size, so a UVC camera answered with the first format it lists, often 640x480, and the editor upscaled it. No unit test reaches a physical camera, so every check here is read off a real take. They need a physical camera, and `ffprobe` and `ffmpeg` from any install.