Skip to content

Fix Windows console window for chrome-headless-shell - #3432

Draft
aryansk wants to merge 1 commit into
heygen-com:mainfrom
aryansk:fix-windows-chrome-console-window-3430
Draft

Fix Windows console window for chrome-headless-shell#3432
aryansk wants to merge 1 commit into
heygen-com:mainfrom
aryansk:fix-windows-chrome-console-window-3430

Conversation

@aryansk

@aryansk aryansk commented Aug 23, 2026

Copy link
Copy Markdown

Fixes #3430

Problem

On Windows, every npx hyperframes render flashed a visible CMD/console window for each shot (78 windows for 78 shots). chrome-headless-shell.exe is a console-subsystem binary, so Node's child_process.spawn shows a console window unless windowsHide: true (CREATE_NO_WINDOW) is set. puppeteer-core's launch spawns the browser without windowsHide by default, so the window was visible on every launch, even from GUI apps with no terminal.

Change

Add windowsHide: true to all puppeteer.launch sites so the browser is launched hidden on Windows:

  • packages/engine/src/services/browserManager.ts (pooled browser for hyperframes render)
  • packages/cli/src/capture/*, packages/cli/src/beats/headlessAnalyzer.ts, packages/cli/src/commands/*, packages/studio/vite.browser.ts, packages/producer/src/parity-harness.ts

On non-Windows platforms windowsHide is ignored.

Validation

  • git diff --check clean
  • Change is isolated to puppeteer.launch options; existing chrome-headless-shell path resolution and launch-arg tests expected to be unaffected

Every 'npx hyperframes render' on Windows flashed a visible CMD
window for each shot (78 windows for 78 shots). chrome-headless-shell
is a console-subsystem binary, so Node's spawn shows a console
window unless windowsHide:true (CREATE_NO_WINDOW) is set.

Puppeteer-core's launch spawns the browser via child_process.spawn
without windowsHide by default. Add windowsHide:true to all
puppeteer.launch sites so the browser is hidden on Windows.

Fixes heygen-com#3430
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[Windows] chrome-headless-shell.exe opens a visible console window on every render

1 participant