Skip to content

[Bug]: v2.3.0 — HUD recording bar never renders on macOS 15.3.1 (window exists, paints nothing); v2.2.2 works #1639

Open

Description

@quzhupeng

Summary

On macOS 15.3.1 the app launches, the process stays alive and the menu-bar (tray) icon appears, but the HUD recording bar never renders — nothing is visible on screen at all. Downgrading to v2.2.2 on the same machine fixes it, so this looks like a 2.3.0 regression.

Environment

  • OpenScreen 2.3.0 (Openscreen-macOS-Apple-Silicon-2.3.0.dmg, notarized build)
  • macOS 15.3.1 (24D70)
  • Mac mini (Apple M4, 10-core GPU), 16 GB
  • Single display: 1600×900 @ 1x, 60 Hz
  • Electron 41.2.1 (same Electron build as v2.2.2)

Steps to reproduce

  1. Install 2.3.0, launch it (double-click in Finder or open -a Openscreen).
  2. Look at the bottom of the screen where the HUD bar normally sits.

Expected

The dark HUD recorder bar is visible at the bottom of the screen.

Actual

Nothing is drawn. No window chrome, no bar, no error dialog. Launching again does nothing visible (second-instance path). There are no crashes and no Gatekeeper/AMFI/TCC denials in the unified log.

Diagnostics

While 2.3.0 was running with the HUD "shown":

$ pgrep -fl "MacOS/Openscreen"
/Applications/Openscreen.app/Contents/MacOS/Openscreen

CGWindowListCopyWindowInfo (owner = Openscreen):
  layer=25  "Item-0"      x=921 y=0   w=32  h=24   kCGWindowSharingState=1   (tray icon — drawn correctly)
  layer=3   "openscreen"  x=321 y=219 w=913 h=696  kCGWindowSharingState=0
                                                       kCGWindowAlpha=1
                                                       kCGWindowIsOnscreen=1

So the HUD BrowserWindow exists, is on screen, has alpha 1 and the expected 913×696 geometry — it simply paints nothing.

The renderer itself is fine. Attaching to the ?windowType=hud-overlay target with the remote debugger and calling Page.captureScreenshot returns the fully rendered bar (icons, "Screen" label, red record button, etc.), and document.body.innerText is "Screen | EN | Switch to vertical bar". So it is a native-window/compositing problem, not a React/renderer problem.

The content-protection code path is implicated

Launching the same 2.3.0 build with:

OPENSCREEN_DISABLE_CONTENT_PROTECTION=1 open -a Openscreen

makes the bar appear immediately and normally, and kCGWindowSharingState switches to 1. Unsetting the variable brings the invisible-window state back. The only code path this variable touches is d_() (the setContentProtection(true) helper), which logs:

[content-protection] OFF for the HUD window (OPENSCREEN_DISABLE_CONTENT_PROTECTION=1) — it will appear in screen captures, including recordings.

Note that this helper already contains a guard for this class of problem:

[content-protection] OFF for the ... window — macOS ${version} never displays a content-protected window, so enabling it would make this window permanently invisible.

but the guard only trips for macOS >= 26:

const Klt = (() => {
  if (process.platform !== "darwin") return !1;
  const e = Number.parseInt(process.getSystemVersion().split(".")[0] ?? "", 10);
  return Number.isFinite(e) && e >= 26;
})();

On 15.3.1 Klt is false, so setContentProtection(true) is still applied to the HUD window.

Version comparison

Version Electron HUD visible on this machine kCGWindowSharingState of HUD
2.3.0 41.2.1 ❌ invisible 0
2.2.2 41.2.1 ✅ visible 0

v2.2.2 contains the same setContentProtection helper with the same >= 26 guard, so content protection by itself is evidently not sufficient to hide the window — something else changed in 2.3.0 that makes the combination fatal on this system. Worth diffing the HUD window creation/show ordering between 2.2.2 and 2.3.0.

Workaround

Downgrade to 2.2.2, or run 2.3.0 with OPENSCREEN_DISABLE_CONTENT_PROTECTION=1 (e.g. launchctl setenv OPENSCREEN_DISABLE_CONTENT_PROTECTION 1), accepting that the HUD bar will then show up in recordings and screen captures.

Suggested fix

  • Either extend the "never displays a content-protected window" guard to the macOS versions actually affected (at minimum 15.x on Apple silicon), or
  • stop relying on setContentProtection for the HUD and park the bar off-screen while recording instead.

Happy to test a build — I have the machine and a reliable reproducer (2.3.0 invisible / 2.2.2 visible, toggled only by the env var).

Activity

  1. EtienneLescot commented on Nov 21, 2026

    @EtienneLescot
    Member

    Thanks for the thorough report, it narrowed this down a lot.

    #1647 is a candidate fix: since 2.3.0 the HUD also opened a hidden, content-protected camera preview window at launch, and that is the only new window macOS gets compared with 2.2.2. We have no macOS 15 machine, so we could not reproduce it. If you can build the branch (git checkout fix/1639-mac-hud-invisible-camera-preview && npm ci && npm run build:mac), could you tell us:

    1. whether the bar shows at launch without OPENSCREEN_DISABLE_CONTENT_PROTECTION;
    2. whether it stays visible after turning the camera on.
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