wehub-resource-sync
85453da49f
regression / regression-shards (style-16-prod style-9-prod style-17-prod iframe-render-compat variables-prod mp4-h265-sdr, shard-4) (push) Has been cancelled
regression / regression-shards (style-4-prod style-11-prod style-2-prod animejs-adapter typegpu-adapter parallel-capture-regression, shard-5) (push) Has been cancelled
regression / regression-shards (style-7-prod style-8-prod style-10-prod css-spinner-render-compat webm-transparency mp4-h264-sdr webm-vp9, shard-3) (push) Has been cancelled
regression / regression-shards (sub-composition-video style-18-prod raf-ball-render-compat font-variant-numeric sub-comp-t0 sub-comp-id-selector, shard-7) (push) Has been cancelled
Windows render verification / Detect changes (push) Has been cancelled
Windows render verification / Preflight (lint + format) (push) Has been cancelled
Windows render verification / Render on windows-latest (push) Has been cancelled
Windows render verification / Tests on windows-latest (push) Has been cancelled
CI / Detect changes (push) Has been cancelled
CI / Build (push) Has been cancelled
CI / Lint (push) Has been cancelled
CI / Fallow audit (push) Has been cancelled
CI / Format (push) Has been cancelled
CI / Typecheck (push) Has been cancelled
CI / Test (push) Has been cancelled
CI / Producer: integration tests (push) Has been cancelled
CI / Producer: unit tests (push) Has been cancelled
CI / File size check (push) Has been cancelled
CI / Test: skills (push) Has been cancelled
CI / Skills: manifest in sync (push) Has been cancelled
CI / CLI: npx shim (macos-latest) (push) Has been cancelled
CI / CLI: npx shim (ubuntu-latest) (push) Has been cancelled
CI / CLI: npx shim (windows-latest) (push) Has been cancelled
CI / SDK: unit + contract + smoke (push) Has been cancelled
CI / Test: runtime contract (push) Has been cancelled
CI / Studio: load smoke (push) Has been cancelled
CI / Smoke: global install (push) Has been cancelled
CI / CLI smoke (required) (push) Has been cancelled
CI / Semantic PR title (push) Has been cancelled
Player perf / Detect changes (push) Has been cancelled
Player perf / Preflight (lint + format) (push) Has been cancelled
Player perf / player-perf (push) Has been cancelled
Player perf / Perf: drift (push) Has been cancelled
Player perf / Perf: fps (push) Has been cancelled
Player perf / Perf: parity (push) Has been cancelled
Player perf / Perf: scrub (push) Has been cancelled
Player perf / Perf: load (push) Has been cancelled
preview-regression / Detect changes (push) Has been cancelled
preview-regression / Preflight (lint + format) (push) Has been cancelled
preview-regression / Preview parity (push) Has been cancelled
preview-regression / preview-regression (push) Has been cancelled
regression / regression (push) Has been cancelled
regression / Detect changes (push) Has been cancelled
regression / Preflight (lint + format) (push) Has been cancelled
regression / regression-shards (hdr-regression style-5-prod style-3-prod mov-prores, shard-1) (push) Has been cancelled
regression / regression-shards (overlay-montage-prod style-12-prod chat missing-host-comp-id png-sequence portrait-edge-bleed, shard-6) (push) Has been cancelled
regression / regression-shards (style-13-prod style-6-prod vignelli-stacking gsap-letters-render-compat audio-mux-parity, shard-8) (push) Has been cancelled
regression / regression-shards (style-15-prod hdr-hlg-regression style-1-prod many-cuts vfr-screen-recording render-symlinked-assets, shard-2) (push) Has been cancelled
CodeQL / Analyze (actions) (push) Has been cancelled
CodeQL / Analyze (javascript-typescript) (push) Has been cancelled
CodeQL / Analyze (python) (push) Has been cancelled
Docs / Validate docs (push) Has been cancelled
Sync skills to ClawHub / Publish changed skills (push) Has been cancelled
46 lines
1.7 KiB
Markdown
46 lines
1.7 KiB
Markdown
# doctor, browser
|
|
|
|
Environment diagnosis and bundled-Chrome management. Run these first when a render or preview fails.
|
|
|
|
## doctor
|
|
|
|
```bash
|
|
npx hyperframes doctor
|
|
npx hyperframes doctor --json # CI / agent output (always exit 0; gate on payload `ok`)
|
|
```
|
|
|
|
Runs independent checks and reports each as ok/warn/fail:
|
|
|
|
- **Version** — installed CLI vs latest on npm (hints upgrade when stale)
|
|
- **Node.js** — ≥ 22 required
|
|
- **CPU**, **Memory**, **Disk** — host resources
|
|
- **Environment** — env vars that affect the renderer
|
|
- **FFmpeg** / **FFprobe** — found, version, codecs
|
|
- **Chrome** — bundled or system, version, path
|
|
- **Docker** / **Docker running** — required only for `render --docker`
|
|
- **/dev/shm** — inside containers only
|
|
|
|
Run `doctor` first when:
|
|
|
|
- `render` fails with a Chrome or FFmpeg error.
|
|
- `preview` opens but the composition fails to load.
|
|
- A fresh machine has never run HyperFrames.
|
|
|
|
Common issues:
|
|
|
|
- **Missing FFmpeg** — install via `brew install ffmpeg` (macOS) or your package manager.
|
|
- **Missing bundled Chrome** — run `npx hyperframes browser ensure`.
|
|
- **Low memory** — close other Chromes, reduce `--workers`, or use `--quality draft`.
|
|
|
|
## browser
|
|
|
|
```bash
|
|
npx hyperframes browser ensure # find or download the pinned Chrome
|
|
npx hyperframes browser path # print the browser executable path (for scripting)
|
|
npx hyperframes browser clear # remove the cached Chrome download
|
|
```
|
|
|
|
Manage the Chrome build HyperFrames uses for rendering. The pinned version exists because pixel output drifts across Chrome versions — using the bundled build keeps rendered output reproducible across machines.
|
|
|
|
Use `path` to embed the binary in scripts: `$(npx hyperframes browser path)`.
|