You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Commit 06d0bd3
Browse filesBrowse the repository at this point in the historyBrowse files
A render that stalls while its pages load now retries with fewer workers instead of hanging. A full disk now says so, and splitting a clip that follows another clip cuts where it plays.
17
+
18
+
## Fixes
19
+
20
+
- **Producer:** Retry with fewer workers when every page times out loading ([04bc4737ad1d3](https://github.com/heygen-com/hyperframes/commit/04bc4737ad1d300e45c8ad3ebb220ebec1b7ed2d), [#7171](https://github.com/heygen-com/hyperframes/pull/7171)).
21
+
- **Lint:** Flag a data-automation or data-fx-chain the render cannot read ([cd7b7383cb19c](https://github.com/heygen-com/hyperframes/commit/cd7b7383cb19c36d63e6d7ad039221bcaccce34a), [#7169](https://github.com/heygen-com/hyperframes/pull/7169)).
22
+
- **Studio Server:** Splitting a clip that starts after another clip cuts where it plays ([0bbc9b2943ad6](https://github.com/heygen-com/hyperframes/commit/0bbc9b2943ad6d97edd4acd9b50bb8d648e208d2), [#7172](https://github.com/heygen-com/hyperframes/pull/7172)).
23
+
- **Producer:** A drive that refuses frame links gets a copy, whatever code it refuses with ([845bd638a7784](https://github.com/heygen-com/hyperframes/commit/845bd638a7784d0859df047e16c61b8790b9a8bb), [#7163](https://github.com/heygen-com/hyperframes/pull/7163)).
24
+
- **Engine:** A full disk during frame extraction says so, not that the video is broken ([ac1948a88b89a](https://github.com/heygen-com/hyperframes/commit/ac1948a88b89a2ef08d02d748f107d55e50d3f9c), [#7161](https://github.com/heygen-com/hyperframes/pull/7161)).
25
+
- **CLI:** Address skills install and update hints to the person ([604a25fbaaba5](https://github.com/heygen-com/hyperframes/commit/604a25fbaaba5c3b9dac5deab1d51859fee2516c), [#7160](https://github.com/heygen-com/hyperframes/pull/7160)).
26
+
- **CLI:** A failed run exits 1 when its output pipe closes early ([b3b6a8116bb58](https://github.com/heygen-com/hyperframes/commit/b3b6a8116bb58afd100d6a16a79d03310ad486f8), [#7158](https://github.com/heygen-com/hyperframes/pull/7158)).
27
+
28
+
## Docs & Examples
29
+
30
+
- Discord in the top bar and footer, and each Discord link tagged by where it sits ([21f2119194ffd](https://github.com/heygen-com/hyperframes/commit/21f2119194ffdf525ff9f423d67cf09e788afa6c), [#7153](https://github.com/heygen-com/hyperframes/pull/7153)).
31
+
32
+
[View the full commit range](https://github.com/heygen-com/hyperframes/compare/v0.9.12...v0.9.13).
# The voice clones on the account that makes the film
659
+
# The voice clones and avatar looks on the account that makes the film
660
660
npx hyperframes media-use voices
661
+
npx hyperframes media-use avatars --limit 10
661
662
662
663
# Check the setup, and see what has been used
663
664
npx hyperframes media-use doctor
@@ -676,6 +677,7 @@ file yourself.
676
677
|`adopt`| Record the files already in `assets/` so later requests find them, with duration and size read by `ffprobe`|
677
678
|`analyze`| Measure an image or video and print suggested exposure and color corrections, saving nothing. Needs `--type grade --for <file>`|
678
679
|`voices`| List the voice clones on the HyperFrames account you are signed in with, for `--voice` in `generate`. Never lists the separate `heygen` CLI's account |
680
+
|`avatars`| List the avatar looks on the HyperFrames account you are signed in with, as `{avatars: [{avatar_id, name, avatar_type, group_id, gender, status, default_voice_id, preview_image_url}]}`, for `--avatar` in `generate --type avatar`. `--limit` (default 20). Never lists the separate `heygen` CLI's account |
679
681
|`doctor`| Check ffmpeg, ffprobe, Node.js, the bundled sound library, and the `heygen` CLI (installed, v0.3.0 or newer, signed in). Changes nothing |
680
682
|`stats`| Count requests, misses, and reuse from the project's `.media/` and the global `~/.media/`|
npx hyperframes check [dir] --strict # warnings fail too
1210
1212
```
1211
1213
1212
-
`check` runs the linter first and skips the browser entirely on a lint error.
1214
+
`check` runs the linter first. A lint error fails the check but does not stop
1215
+
it: the browser checks still run and both are reported, unless the lint error
1216
+
leaves no composition to load (a root with no `data-composition-id`).
1213
1217
Then it loads the bundled composition once and sweeps a single seek grid,
1214
1218
running every audit at every sample: runtime console errors and failed requests,
1215
1219
layout defects (overflow, clipping, held overlaps, occlusion, coordinate-frame
@@ -1221,8 +1225,8 @@ a source with no audio track or that cannot be read as audio (error: render
1221
1225
stops), a clip that starts past the end of its file, a clip whose played part is
1222
1226
silent (warnings), and a film with no sound at all (info).
1223
1227
1224
-
When the browser never ran (lint errors, a linter crash, or a browser launch
1225
-
failure), `browserSkipped` is `true` and the `layout`, `motion` and `contrast`
1228
+
When the browser never ran (no composition to load, a linter crash, or a
1229
+
browser launch failure), `browserSkipped` is `true` and the `layout`, `motion` and `contrast`
1226
1230
sections are empty, not clean.
1227
1231
1228
1232
Scoped checks add `scope` to the JSON report with the requested range and
@@ -1820,13 +1824,23 @@ How it uses the machine, and when it gives up:
1820
1824
|`--frames-cache-dir`|`<tmpdir>/hyperframes-extract-cache-<uid>`| Where extracted source frames cache. `off`, `none`, `false`, or `0` disables it. `doctor` reports the live value. |
1821
1825
|`--max-concurrent-renders`|`2`| Concurrent jobs on the Producer server, 1–10 |
1822
1826
|`--best-effort` / `--no-best-effort`| on | Finish with capture-readiness warnings, or fail when media is missing or unready |
1827
+
|`--wait` / `--no-wait`| on | One local render at a time per user account: wait while another runs, or fail at once. Env: `HYPERFRAMES_RENDER_LOCK=off` renders side by side. |
1823
1828
|`--strict` / `--strict-all`| off | Fail on lint errors, or on errors and warnings |
1824
1829
|`--strict-variables`| off | Fail rather than warn on an undeclared or mistyped variable key |
1825
1830
|`--batch-concurrency` / `--batch-fail-fast`|`1` / off | Batch rows at once, and whether the first failure stops the rest |
1826
1831
|`--debug`| off | Keep intermediates and write diagnostics under the Producer `.debug` directory |
1827
1832
|`--quiet`| off | Less output |
1828
1833
|`--skill`| — | Record which authoring workflow started this render, in usage telemetry |
1829
1834
1835
+
Renders started side by side starve each other of CPU and GPU until frames stop
1836
+
landing, so a second local or `--docker` render from the same user account waits
1837
+
for the first and says which render it is waiting for (pid and project). The
1838
+
slot is a lock file in that account's HyperFrames cache folder, so renders by
1839
+
different user accounts do not queue behind each other; set
1840
+
`HYPERFRAMES_CACHE_DIR` to a folder they share to give them one slot. A render
1841
+
whose process died frees its slot on its own. `--workers` is unaffected: it sets
1842
+
the parallelism inside the one render that runs.
1843
+
1830
1844
Low-memory detection reads **host** RAM, not cgroup or container limits, so
1831
1845
containerised callers — including `--docker` — should set
1832
1846
`PRODUCER_LOW_MEMORY_MODE` explicitly.
@@ -2559,7 +2573,7 @@ Render parameters mirror local `hyperframes render` where they overlap:
2559
2573
|`--quality`|`standard`|`draft`, `standard`, or `high`|
2560
2574
|`--format`|`mp4`|`mp4`, `webm`, or `mov`|
2561
2575
|`--resolution`|`1080p`|`1080p` or `4k`. 4k bills at 1.5×. |
2562
-
|`--aspect-ratio`| auto |`16:9`, `9:16`, or `1:1`. Auto-detected from a local project's `data-width` and `data-height`, so you rarely need it. The renderer cannot reshape a composition — a value that disagrees with the authored ratio is an error. With `--asset-id` or `--url` the server defaults to `16:9`. |
2576
+
|`--aspect-ratio`| auto |Any `W:H`, auto-detected from a local project's `data-width` and `data-height`, so you rarely need it. At `1080p` the output keeps the composition's own size, whatever its ratio (a 1920×960 composition renders 1920×960). `4k` scales only `16:9`, `9:16` and `1:1` compositions and refuses any other ratio before upload. The renderer cannot reshape a composition — a value that disagrees with the authored ratio is an error. |
2563
2577
|`--composition` / `-c`|`index.html`| Entry HTML file inside the zip |
**Fix:** Declare each family with `@font-face` pointing at the captured `.woff2` files, or bundle the font under `capture/assets/fonts/`.
779
779
780
-
The declaration may use a quoted or unquoted family name. If `font-family` is the last descriptor in the block, its final semicolon is optional.
780
+
The declaration may use a quoted or unquoted family name. If `font-family` is the last descriptor in the block, its final semicolon is optional. Families named in a `font` shorthand (`font: 500 16px/1 "PingFang SC", sans-serif`) count the same as `font-family`.
781
+
782
+
### `font_face_local_only`
783
+
784
+
**Warning.** An `@font-face` names only `local()` sources. A local render draws the font installed on this machine; a cloud render, or another machine without it, falls back to a different font.
785
+
786
+
**Fix:** Add a `url()` source pointing at a `.woff2` file inside the project, or use a Google Fonts family.
0 commit comments