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 5107e1c
Browse filesBrowse the repository at this point in the historyBrowse files
|`--composition, -c`|`index.html`| Render a different composition file. Sub-compositions using `<template>` wrappers must be referenced from `index.html` via `data-composition-src`. |
858
-
|`--format`|`mp4`|`mp4`, `webm`, `mov`, `gif`, or `png-sequence`. WebM and MOV carry transparency; `png-sequence` writes RGBA frames to a directory. |
861
+
|`--format`|`mp4`|`mp4`, `webm`, `mov`, `gif`, `png-sequence`, or `hls`. WebM and MOV carry transparency; `png-sequence` writes RGBA frames to a directory; `hls` writes a VOD playlist directory.|
859
862
|`--fps, -f`| root `data-fps`, otherwise 30 | 1–240, or an ffmpeg rational like `30000/1001` for 29.97 |
|`--resolution`| the composition's size | Supersample to a preset via Chrome's `deviceScaleFactor`. Aspect ratio must match and the scale must be a whole multiple. Not with `--hdr`. See [4K rendering](/guides/4k-rendering). |
@@ -873,6 +876,7 @@ Quality and file size:
873
876
|`--video-bitrate`| from `--quality`| Target MP4/WebM bitrate, e.g. `10M` or `5000k`. Not with `--crf`; rejected for MOV. |
874
877
|`--vp9-cpu-used`| encoder default | libvpx-vp9 speed/quality trade-off for WebM, -8 to 8. Env: `PRODUCER_VP9_CPU_USED`. |
875
878
|`--gif-loop`|`0`| GIF loop count, `0` for forever. Range 0–65535, `--format gif` only. |
879
+
|`--hls-segment-seconds`|`4`| HLS target segment length in whole seconds, 1–60. `--format hls` only. Also fixes the encoder GOP so every segment starts on a keyframe. |
876
880
|`--video-frame-format`|`auto`| How source video frames are extracted: `auto`, `jpg`, `png`. Use `png` for UI recordings, screen captures, and other colour-sensitive footage. |
877
881
|`--hdr`| off | Force HDR even with no HDR sources. MP4 only. See [HDR rendering](/guides/hdr). |
878
882
|`--sdr`| off | Force SDR even when HDR sources are detected |
`Install an FFmpeg build with libx264 support (${getFFmpegInstallHint()}), or render WebM instead: hyperframes render --format webm --output output.webm`,
961
+
`Install an FFmpeg build with libx264 support (${getFFmpegInstallHint()})`+
@@ -943,6 +972,14 @@ async function executeLocalRender(
943
972
console.warn(c.warn(` Unable to probe H.264 encoder capabilities: ${detail}`));
944
973
}
945
974
}
975
+
if(encoderMode==="gpu"&&isHls){
976
+
errorBox(
977
+
"HLS H.264 encoder unavailable",
978
+
"FFmpeg does not include libx264, and HLS cannot fall back to VideoToolbox: fixed-length segments require the software encoder's forced-keyframe lock.",
979
+
`Install an FFmpeg build with libx264 support (${getFFmpegInstallHint()}).`,
980
+
);
981
+
failCommand();
982
+
}
946
983
if(encoderMode==="gpu"){
947
984
console.warn(
948
985
c.warn(" FFmpeg does not include libx264; falling back to VideoToolbox H.264 encoding."),
@@ -991,6 +1028,7 @@ async function executeLocalRender(
991
1028
quality: options.quality,
992
1029
format: options.format,
993
1030
gifLoop: options.gifLoop,
1031
+
hlsSegmentSeconds: options.hlsSegmentSeconds,
994
1032
workers: options.workers,
995
1033
useGpu: options.gpu,
996
1034
hdrMode: options.hdrMode,
@@ -1055,13 +1093,14 @@ async function executeLocalRender(
0 commit comments