Skip to content

[Bug]: macOS 15.7 — Window recording produces a black video while full-display recording works #1620

Closed as not planned

Description

@lushengyin

Search existing issues

  • I have searched the existing issues

Describe the bug

On macOS 15.7.3 (Apple Silicon), selecting Window as the recording source produces a completely black video. Recording the entire display on the same machine, same app session, works normally.

So far:

  • Display capture: works, frames are correct.
  • Window capture: recording completes and produces a file, but every frame is black.
  • Reproduced after a fresh app launch; not tied to a specific project or editor state.

This looks like a regression or an unimplemented path in the macOS window-capture route rather than a permission problem — display capture with the same Screen Recording grant is fine in the same session.

Expected behavior

The recorded clip should show the selected window's content, the same way whole-display recording shows the display.

To Reproduce

  1. Launch Openscreen 2.3.0 on macOS.
  2. Start a new recording and choose Window as the source.
  3. Pick any regular app window (e.g. Finder, VS Code, Chrome).
  4. Record for a few seconds, then stop.
  5. Open the resulting clip.

Result: the clip is entirely black.
Control: repeat with Full screen / Display selected — the clip records correctly.

Screenshots

Not attached yet; can provide a short black clip and a working display clip if useful.

OS

macOS 15.7.3 (24G419), Apple Silicon (arm64)

OS Version

15.7.3

Other OS

None

Browser

None

Browser Version

None

Device Type

Desktop / MacBook

Other Device

None

Additional context

Environment details that may help narrow it down:

  • App version: 2.3.0 (latest release at time of writing), bundle id com.etiennelescot.openscreen.
  • Screen Recording permission is granted and demonstrably working: whole-display recording succeeds in the same session, so a stale TCC grant is unlikely.
  • Toggling the Screen Recording permission off/on and fully quitting the app did not change the behaviour.
  • No other screen-capture or virtual-camera software is running (no Zoom/Teams/OBS in the background).
  • The window-capture path appears to go through the bundled helper Contents/Resources/electron/native/bin/darwin-arm64/openscreen-screencapturekit-helper (signed, Team ID M4LK7C6S84, minos 13.0, built against SDK 26.5), while display capture likely uses a different path — which would explain why only window capture is broken.
  • Displays: single built-in display, no external monitor, no virtual display.
  • No MDM, no unusual privacy tooling.

Happy to run a debug build, collect logs, or test a patch — just say what you need.

Activity

  1. lushengyin commented on Nov 18, 2026

    @lushengyin
    Author

    Closing this as a false alarm — sorry for the noise.

    Root cause found on my side: a third-party desktop overlay app was running, creating a 1900×983 transparent window at window level 8 (above every normal window, covering essentially the whole screen except the menu bar).

    Because of that:

    • The window picker could only ever resolve to that overlay (it is the topmost window anywhere you click).
    • Capturing it produced black frames, since it is a transparent Electron overlay that draws no opaque content.

    After quitting the overlay app, selecting a normal window records correctly, and the whole-display path was never affected. So this is not an OpenScreen bug — nothing in 2.3.0 broke window capture.

    For anyone hitting something similar: check CGWindowListCopyWindowInfo for windows at a non-zero kCGWindowLayer that cover the display, or simply quit overlay/pet/widget apps before recording a specific window.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions