Repository navigation
Description
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
- Install 2.3.0, launch it (double-click in Finder or
open -a Openscreen). - 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
setContentProtectionfor 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
EtienneLescot commentedon Nov 21, 2026
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:OPENSCREEN_DISABLE_CONTENT_PROTECTION;