@remotion/renderer 4.0.465 → 4.0.467

package/dist/esm/index.mjs

@@ -1,13 +1,17 @@
 import { createRequire } from "node:module";
 var __defProp = Object.defineProperty;
 var __commonJS = (cb, mod) => () => (mod || cb((mod = { exports: {} }).exports, mod), mod.exports);
+var __returnValue = (v) => v;
+function __exportSetter(name, newValue) {
+  this[name] = __returnValue.bind(null, newValue);
+}
 var __export = (target, all) => {
   for (var name in all)
     __defProp(target, name, {
       get: all[name],
       enumerable: true,
       configurable: true,
-      set: (newValue) => all[name] = () => newValue
+      set: __exportSetter.bind(all, name)
     });
 };
 var __require = /* @__PURE__ */ createRequire(import.meta.url);
@@ -21442,8 +21446,19 @@ var validV5ColorSpaces = ["bt601", "bt709", "bt2020-ncl"];
 var validColorSpaces = NoReactInternals13.ENABLE_V5_BREAKING_CHANGES ? validV5ColorSpaces : validV4ColorSpaces;
 var DEFAULT_COLOR_SPACE = NoReactInternals13.ENABLE_V5_BREAKING_CHANGES ? "bt709" : "default";
 
-// src/options/x264-preset.tsx
+// src/options/gop-size.tsx
 import { jsx as jsx5, jsxs as jsxs5, Fragment as Fragment5 } from "react/jsx-runtime";
+var validateGopSize = (value) => {
+  if (value === null) {
+    return;
+  }
+  if (typeof value !== "number" || !Number.isFinite(value) || !Number.isInteger(value) || value <= 0) {
+    throw new TypeError("The GOP size must be an integer greater than 0 or null.");
+  }
+};
+
+// src/options/x264-preset.tsx
+import { jsx as jsx6, jsxs as jsxs6, Fragment as Fragment6 } from "react/jsx-runtime";
 var x264PresetOptions = [
   "ultrafast",
   "superfast",
@@ -21570,6 +21585,7 @@ var firstEncodingStepOnly = ({
   proResProfileName,
   pixelFormat,
   x264Preset,
+  gopSize,
   codec,
   crf,
   videoBitrate,
@@ -21580,11 +21596,13 @@ var firstEncodingStepOnly = ({
   if (hasPreencoded || codec === "gif") {
     return [];
   }
+  validateGopSize(gopSize);
   return [
     proResProfileName ? ["-profile:v", proResProfileName] : null,
     ["-pix_fmt", pixelFormat],
     pixelFormat === "yuva420p" ? ["-auto-alt-ref", "0"] : null,
     x264Preset ? ["-preset", x264Preset] : null,
+    gopSize === null ? null : ["-g", String(gopSize)],
     ["-video_track_timescale", "90000"],
     validateQualitySettings({
       crf,
@@ -21601,6 +21619,7 @@ var generateFfmpegArgs = ({
   proResProfileName,
   pixelFormat,
   x264Preset,
+  gopSize,
   codec,
   crf,
   videoBitrate,
@@ -21659,6 +21678,7 @@ var generateFfmpegArgs = ({
       encodingMaxRate,
       encodingBufferSize,
       x264Preset,
+      gopSize,
       hardwareAcceleration
     })
   ].filter(truthy);
@@ -21760,6 +21780,7 @@ var prespawnFfmpeg = (options2) => {
       proResProfileName,
       pixelFormat,
       x264Preset: options2.x264Preset,
+      gopSize: options2.gopSize,
       codec,
       crf: options2.crf,
       videoBitrate: options2.videoBitrate,
@@ -22854,6 +22875,7 @@ var innerStitchFramesToVideo = async ({
   cancelSignal,
   codec,
   crf,
+  gopSize,
   enforceAudioTrack,
   ffmpegOverride,
   force,
@@ -22901,6 +22923,7 @@ var innerStitchFramesToVideo = async ({
   validateBitrate(videoBitrate, "videoBitrate");
   validateBitrate(maxRate, "maxRate");
   validateBitrate(bufferSize, "bufferSize");
+  validateGopSize(gopSize);
   validateFps(fps, "in `stitchFramesToVideo()`", false);
   assetsInfo.downloadMap.preventCleanup();
   const proResProfileName = getProResProfileName(codec, proResProfile);
@@ -23035,6 +23058,7 @@ var innerStitchFramesToVideo = async ({
       proResProfileName,
       pixelFormat,
       x264Preset,
+      gopSize,
       colorSpace,
       hardwareAcceleration,
       indent,
@@ -23138,6 +23162,7 @@ var stitchFramesToVideo = ({
   cancelSignal,
   codec,
   crf,
+  gopSize,
   enforceAudioTrack,
   ffmpegOverride,
   muted,
@@ -23168,6 +23193,7 @@ var stitchFramesToVideo = ({
     cancelSignal: cancelSignal ?? null,
     codec: codec ?? DEFAULT_CODEC,
     crf: crf ?? null,
+    gopSize: gopSize ?? null,
     enforceAudioTrack: enforceAudioTrack ?? false,
     ffmpegOverride: ffmpegOverride ?? null,
     force: force ?? true,
@@ -23316,6 +23342,7 @@ var MAX_RECENT_FRAME_TIMINGS = 150;
 var internalRenderMediaRaw = ({
   proResProfile,
   x264Preset,
+  gopSize,
   crf,
   composition: compositionWithPossibleUnevenDimensions,
   serializedInputPropsWithCustomSchema,
@@ -23396,6 +23423,7 @@ var internalRenderMediaRaw = ({
     encodingBufferSize,
     hardwareAcceleration
   });
+  validateGopSize(gopSize);
   validateBitrate(audioBitrate, "audioBitrate");
   validateBitrate(videoBitrate, "videoBitrate");
   validateBitrate(encodingMaxRate, "encodingMaxRate");
@@ -23553,6 +23581,7 @@ var internalRenderMediaRaw = ({
         encodingBufferSize,
         indent,
         x264Preset: x264Preset ?? null,
+        gopSize,
         colorSpace,
         binariesDirectory,
         hardwareAcceleration
@@ -23717,6 +23746,7 @@ var internalRenderMediaRaw = ({
         codec,
         proResProfile,
         crf,
+        gopSize,
         assetsInfo,
         onProgress: (frame) => {
           if (preEncodedFileLocation) {
@@ -23834,6 +23864,7 @@ var internalRenderMedia = wrapWithErrorHandling(internalRenderMediaRaw);
 var renderMedia = ({
   proResProfile,
   x264Preset,
+  gopSize,
   crf,
   composition,
   inputProps,
@@ -23902,6 +23933,7 @@ var renderMedia = ({
   return internalRenderMedia({
     proResProfile: proResProfile ?? undefined,
     x264Preset: x264Preset ?? null,
+    gopSize: gopSize ?? null,
     codec,
     composition,
     serveUrl,
@@ -25121,11 +25153,11 @@ var getVideoMetadata = async (videoSource, options2) => {
   return JSON.parse(new TextDecoder("utf-8").decode(metadataResponse));
 };
 // src/options/chrome-mode.tsx
-import { jsx as jsx6, jsxs as jsxs6, Fragment as Fragment6 } from "react/jsx-runtime";
-// src/options/number-of-gif-loops.tsx
 import { jsx as jsx7, jsxs as jsxs7, Fragment as Fragment7 } from "react/jsx-runtime";
-// src/options/on-browser-download.tsx
+// src/options/number-of-gif-loops.tsx
 import { jsx as jsx8, jsxs as jsxs8, Fragment as Fragment8 } from "react/jsx-runtime";
+// src/options/on-browser-download.tsx
+import { jsx as jsx9, jsxs as jsxs9, Fragment as Fragment9 } from "react/jsx-runtime";
 // src/index.ts
 var RenderInternals = {
   resolveConcurrency,

package/dist/ffmpeg-args.d.ts

@@ -1,8 +1,9 @@
-export declare const generateFfmpegArgs: ({ hasPreencoded, proResProfileName, pixelFormat, x264Preset, codec, crf, videoBitrate, encodingMaxRate, encodingBufferSize, colorSpace, hardwareAcceleration, indent, logLevel, }: {
+export declare const generateFfmpegArgs: ({ hasPreencoded, proResProfileName, pixelFormat, x264Preset, gopSize, codec, crf, videoBitrate, encodingMaxRate, encodingBufferSize, colorSpace, hardwareAcceleration, indent, logLevel, }: {
     hasPreencoded: boolean;
     proResProfileName: string | null;
     pixelFormat: "yuv420p" | "yuv420p10le" | "yuv422p" | "yuv422p10le" | "yuv444p" | "yuv444p10le" | "yuva420p" | "yuva444p10le";
     x264Preset: "fast" | "faster" | "medium" | "placebo" | "slow" | "slower" | "superfast" | "ultrafast" | "veryfast" | "veryslow" | null;
+    gopSize: number | null;
     crf: unknown;
     codec: "aac" | "av1" | "gif" | "h264" | "h264-mkv" | "h264-ts" | "h265" | "mp3" | "prores" | "vp8" | "vp9" | "wav";
     videoBitrate: string | null;

package/dist/ffmpeg-args.js

@@ -5,11 +5,13 @@ const crf_1 = require("./crf");
 const get_codec_name_1 = require("./get-codec-name");
 const logger_1 = require("./logger");
 const color_space_1 = require("./options/color-space");
+const gop_size_1 = require("./options/gop-size");
 const truthy_1 = require("./truthy");
-const firstEncodingStepOnly = ({ hasPreencoded, proResProfileName, pixelFormat, x264Preset, codec, crf, videoBitrate, encodingMaxRate, encodingBufferSize, hardwareAcceleration, }) => {
+const firstEncodingStepOnly = ({ hasPreencoded, proResProfileName, pixelFormat, x264Preset, gopSize, codec, crf, videoBitrate, encodingMaxRate, encodingBufferSize, hardwareAcceleration, }) => {
     if (hasPreencoded || codec === 'gif') {
         return [];
     }
+    (0, gop_size_1.validateGopSize)(gopSize);
     return [
         proResProfileName ? ['-profile:v', proResProfileName] : null,
         ['-pix_fmt', pixelFormat],
@@ -17,6 +19,7 @@ const firstEncodingStepOnly = ({ hasPreencoded, proResProfileName, pixelFormat,
         // transparent WebM generation doesn't work
         pixelFormat === 'yuva420p' ? ['-auto-alt-ref', '0'] : null,
         x264Preset ? ['-preset', x264Preset] : null,
+        gopSize === null ? null : ['-g', String(gopSize)],
         // Apply a fixed a timescale across all environments:
         // https://discord.com/channels/809501355504959528/817306238811111454/1437471619089170613
         ['-video_track_timescale', '90000'],
@@ -30,7 +33,7 @@ const firstEncodingStepOnly = ({ hasPreencoded, proResProfileName, pixelFormat,
         }),
     ].filter(truthy_1.truthy);
 };
-const generateFfmpegArgs = ({ hasPreencoded, proResProfileName, pixelFormat, x264Preset, codec, crf, videoBitrate, encodingMaxRate, encodingBufferSize, colorSpace, hardwareAcceleration, indent, logLevel, }) => {
+const generateFfmpegArgs = ({ hasPreencoded, proResProfileName, pixelFormat, x264Preset, gopSize, codec, crf, videoBitrate, encodingMaxRate, encodingBufferSize, colorSpace, hardwareAcceleration, indent, logLevel, }) => {
     const encoderSettings = (0, get_codec_name_1.getCodecName)({
         codec,
         encodingMaxRate,
@@ -92,6 +95,7 @@ const generateFfmpegArgs = ({ hasPreencoded, proResProfileName, pixelFormat, x26
             encodingMaxRate,
             encodingBufferSize,
             x264Preset,
+            gopSize,
             hardwareAcceleration,
         }),
     ].filter(truthy_1.truthy);

package/dist/options/gop-size.d.ts

@@ -0,0 +1,17 @@
+export declare const validateGopSize: (value: number | null) => void;
+export declare const gopSizeOption: {
+    name: string;
+    cliFlag: "gop";
+    description: () => import("react/jsx-runtime").JSX.Element;
+    ssrName: string;
+    docLink: string;
+    type: number | null;
+    getValue: ({ commandLine }: {
+        commandLine: Record<string, unknown>;
+    }) => {
+        value: number | null;
+        source: string;
+    };
+    setConfig: (value: number | null) => void;
+    id: "gop";
+};

package/dist/options/gop-size.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.gopSizeOption = exports.validateGopSize = void 0;
+const jsx_runtime_1 = require("react/jsx-runtime");
+let gopSize = null;
+const validateGopSize = (value) => {
+    if (value === null) {
+        return;
+    }
+    if (typeof value !== 'number' ||
+        !Number.isFinite(value) ||
+        !Number.isInteger(value) ||
+        value <= 0) {
+        throw new TypeError('The GOP size must be an integer greater than 0 or null.');
+    }
+};
+exports.validateGopSize = validateGopSize;
+const cliFlag = 'gop';
+exports.gopSizeOption = {
+    name: 'GOP size',
+    cliFlag,
+    description: () => (jsx_runtime_1.jsxs(jsx_runtime_1.Fragment, { children: ["Set the maximum number of frames between two keyframes. This maps to FFmpeg's ",
+            jsx_runtime_1.jsx("code", { children: "-g" }),
+            " option. Default: Let the encoder decide."] })),
+    ssrName: 'gopSize',
+    docLink: 'https://www.remotion.dev/docs/config#setgopsize',
+    type: null,
+    getValue: ({ commandLine }) => {
+        const value = commandLine[cliFlag];
+        if (value !== undefined) {
+            (0, exports.validateGopSize)(value);
+            return { value: value, source: 'cli' };
+        }
+        return { value: gopSize, source: gopSize === null ? 'default' : 'config' };
+    },
+    setConfig: (value) => {
+        (0, exports.validateGopSize)(value);
+        gopSize = value;
+    },
+    id: cliFlag,
+};

package/dist/options/index.d.ts

@@ -409,6 +409,22 @@ export declare const allOptions: {
         setConfig: (value: "angle" | "angle-egl" | "egl" | "swangle" | "swiftshader" | "vulkan" | null) => void;
         id: "gl";
     };
+    gopSizeOption: {
+        name: string;
+        cliFlag: "gop";
+        description: () => import("react/jsx-runtime").JSX.Element;
+        ssrName: string;
+        docLink: string;
+        type: number | null;
+        getValue: ({ commandLine }: {
+            commandLine: Record<string, unknown>;
+        }) => {
+            value: number | null;
+            source: string;
+        };
+        setConfig: (value: number | null) => void;
+        id: "gop";
+    };
     enableLambdaInsights: {
         name: string;
         cliFlag: "enable-lambda-insights";

package/dist/options/index.js

@@ -36,6 +36,7 @@ const for_seamless_aac_concatenation_1 = require("./for-seamless-aac-concatenati
 const force_new_studio_1 = require("./force-new-studio");
 const frames_1 = require("./frames");
 const gl_1 = require("./gl");
+const gop_size_1 = require("./gop-size");
 const hardware_acceleration_1 = require("./hardware-acceleration");
 const headless_1 = require("./headless");
 const ignore_certificate_errors_1 = require("./ignore-certificate-errors");
@@ -115,6 +116,7 @@ exports.allOptions = {
     folderExpiryOption: folder_expiry_1.folderExpiryOption,
     enableMultiprocessOnLinuxOption: enable_multiprocess_on_linux_1.enableMultiprocessOnLinuxOption,
     glOption: gl_1.glOption,
+    gopSizeOption: gop_size_1.gopSizeOption,
     enableLambdaInsights: enable_lambda_insights_1.enableLambdaInsights,
     encodingMaxRateOption: encoding_max_rate_1.encodingMaxRateOption,
     encodingBufferSizeOption: encoding_buffer_size_1.encodingBufferSizeOption,

package/dist/options/options-map.d.ts

@@ -127,6 +127,22 @@ export declare const optionsMap: {
             setConfig: (profile: "fast" | "faster" | "medium" | "placebo" | "slow" | "slower" | "superfast" | "ultrafast" | "veryfast" | "veryslow" | null) => void;
             id: "x264-preset";
         };
+        readonly gopSize: {
+            name: string;
+            cliFlag: "gop";
+            description: () => import("react/jsx-runtime").JSX.Element;
+            ssrName: string;
+            docLink: string;
+            type: number | null;
+            getValue: ({ commandLine }: {
+                commandLine: Record<string, unknown>;
+            }) => {
+                value: number | null;
+                source: string;
+            };
+            setConfig: (value: number | null) => void;
+            id: "gop";
+        };
         readonly audioBitrate: {
             name: string;
             cliFlag: "audio-bitrate";
@@ -1308,6 +1324,22 @@ export declare const optionsMap: {
             setConfig: (profile: "fast" | "faster" | "medium" | "placebo" | "slow" | "slower" | "superfast" | "ultrafast" | "veryfast" | "veryslow" | null) => void;
             id: "x264-preset";
         };
+        readonly gopSize: {
+            name: string;
+            cliFlag: "gop";
+            description: () => import("react/jsx-runtime").JSX.Element;
+            ssrName: string;
+            docLink: string;
+            type: number | null;
+            getValue: ({ commandLine }: {
+                commandLine: Record<string, unknown>;
+            }) => {
+                value: number | null;
+                source: string;
+            };
+            setConfig: (value: number | null) => void;
+            id: "gop";
+        };
         readonly encodingMaxRate: {
             name: string;
             cliFlag: "max-rate";
@@ -1871,6 +1903,22 @@ export declare const optionsMap: {
             setConfig: (profile: "fast" | "faster" | "medium" | "placebo" | "slow" | "slower" | "superfast" | "ultrafast" | "veryfast" | "veryslow" | null) => void;
             id: "x264-preset";
         };
+        readonly gopSize: {
+            name: string;
+            cliFlag: "gop";
+            description: () => import("react/jsx-runtime").JSX.Element;
+            ssrName: string;
+            docLink: string;
+            type: number | null;
+            getValue: ({ commandLine }: {
+                commandLine: Record<string, unknown>;
+            }) => {
+                value: number | null;
+                source: string;
+            };
+            setConfig: (value: number | null) => void;
+            id: "gop";
+        };
         readonly encodingMaxRate: {
             name: string;
             cliFlag: "max-rate";

package/dist/options/options-map.js

@@ -14,6 +14,7 @@ const encoding_buffer_size_1 = require("./encoding-buffer-size");
 const encoding_max_rate_1 = require("./encoding-max-rate");
 const enforce_audio_1 = require("./enforce-audio");
 const for_seamless_aac_concatenation_1 = require("./for-seamless-aac-concatenation");
+const gop_size_1 = require("./gop-size");
 const hardware_acceleration_1 = require("./hardware-acceleration");
 const image_sequence_pattern_1 = require("./image-sequence-pattern");
 const jpeg_quality_1 = require("./jpeg-quality");
@@ -44,6 +45,7 @@ exports.optionsMap = {
         numberOfGifLoops: number_of_gif_loops_1.numberOfGifLoopsOption,
         repro: repro_1.reproOption,
         x264Preset: x264_preset_1.x264Option,
+        gopSize: gop_size_1.gopSizeOption,
         audioBitrate: audio_bitrate_1.audioBitrateOption,
         colorSpace: color_space_1.colorSpaceOption,
         codec: video_codec_1.videoCodecOption,
@@ -125,6 +127,7 @@ exports.optionsMap = {
         audioBitrate: audio_bitrate_1.audioBitrateOption,
         deleteAfter: delete_after_1.deleteAfterOption,
         x264Preset: x264_preset_1.x264Option,
+        gopSize: gop_size_1.gopSizeOption,
         encodingMaxRate: encoding_max_rate_1.encodingMaxRateOption,
         encodingBufferSize: encoding_buffer_size_1.encodingBufferSizeOption,
         colorSpace: color_space_1.colorSpaceOption,
@@ -163,6 +166,7 @@ exports.optionsMap = {
         audioBitrate: audio_bitrate_1.audioBitrateOption,
         videoBitrate: video_bitrate_1.videoBitrateOption,
         x264Preset: x264_preset_1.x264Option,
+        gopSize: gop_size_1.gopSizeOption,
         encodingMaxRate: encoding_max_rate_1.encodingMaxRateOption,
         encodingBufferSize: encoding_buffer_size_1.encodingBufferSizeOption,
         muted: mute_1.mutedOption,

package/dist/prespawn-ffmpeg.d.ts

@@ -28,6 +28,7 @@ type PreStitcherOptions = {
     codec: Codec | undefined;
     crf: number | null | undefined;
     x264Preset: X264Preset | null;
+    gopSize: number | null;
     onProgress: (progress: number) => void;
     proResProfile: _InternalTypes['ProResProfile'] | undefined;
     logLevel: LogLevel;

package/dist/prespawn-ffmpeg.js

@@ -44,6 +44,7 @@ const prespawnFfmpeg = (options) => {
             proResProfileName,
             pixelFormat,
             x264Preset: options.x264Preset,
+            gopSize: options.gopSize,
             codec,
             crf: options.crf,
             videoBitrate: options.videoBitrate,

package/dist/render-media.d.ts

@@ -148,5 +148,5 @@ type RenderMediaResult = {
     contentType: string;
 };
 export declare const internalRenderMedia: (args_0: InternalRenderMediaOptions) => Promise<RenderMediaResult>;
-export declare const renderMedia: ({ proResProfile, x264Preset, crf, composition, inputProps, pixelFormat, codec, envVariables, frameRange, puppeteerInstance, outputLocation, onProgress, overwrite, onDownload, onBrowserLog, onStart, timeoutInMilliseconds, chromiumOptions, scale, browserExecutable, port, cancelSignal, muted, enforceAudioTrack, ffmpegOverride, audioBitrate, videoBitrate, encodingMaxRate, encodingBufferSize, audioCodec, jpegQuality, concurrency, serveUrl, disallowParallelEncoding, everyNthFrame, imageFormat, numberOfGifLoops, dumpBrowserLogs, preferLossless, verbose, quality, logLevel: passedLogLevel, offthreadVideoCacheSizeInBytes, colorSpace, repro, binariesDirectory, separateAudioTo, forSeamlessAacConcatenation, onBrowserDownload, onArtifact, metadata, hardwareAcceleration, chromeMode, offthreadVideoThreads, compositionStart, mediaCacheSizeInBytes, isProduction, sampleRate, ...apiKeyOrLicenseKey }: RenderMediaOptions) => Promise<RenderMediaResult>;
+export declare const renderMedia: ({ proResProfile, x264Preset, gopSize, crf, composition, inputProps, pixelFormat, codec, envVariables, frameRange, puppeteerInstance, outputLocation, onProgress, overwrite, onDownload, onBrowserLog, onStart, timeoutInMilliseconds, chromiumOptions, scale, browserExecutable, port, cancelSignal, muted, enforceAudioTrack, ffmpegOverride, audioBitrate, videoBitrate, encodingMaxRate, encodingBufferSize, audioCodec, jpegQuality, concurrency, serveUrl, disallowParallelEncoding, everyNthFrame, imageFormat, numberOfGifLoops, dumpBrowserLogs, preferLossless, verbose, quality, logLevel: passedLogLevel, offthreadVideoCacheSizeInBytes, colorSpace, repro, binariesDirectory, separateAudioTo, forSeamlessAacConcatenation, onBrowserDownload, onArtifact, metadata, hardwareAcceleration, chromeMode, offthreadVideoThreads, compositionStart, mediaCacheSizeInBytes, isProduction, sampleRate, ...apiKeyOrLicenseKey }: RenderMediaOptions) => Promise<RenderMediaResult>;
 export {};

package/dist/render-media.js

@@ -31,6 +31,7 @@ const logger_1 = require("./logger");
 const make_cancel_signal_1 = require("./make-cancel-signal");
 const mime_types_1 = require("./mime-types");
 const color_space_1 = require("./options/color-space");
+const gop_size_1 = require("./options/gop-size");
 const offthreadvideo_threads_1 = require("./options/offthreadvideo-threads");
 const x264_preset_1 = require("./options/x264-preset");
 const overwrite_1 = require("./overwrite");
@@ -55,7 +56,7 @@ const validate_videobitrate_1 = require("./validate-videobitrate");
 const wrap_with_error_handling_1 = require("./wrap-with-error-handling");
 const SLOWEST_FRAME_COUNT = 10;
 const MAX_RECENT_FRAME_TIMINGS = 150;
-const internalRenderMediaRaw = ({ proResProfile, x264Preset, crf, composition: compositionWithPossibleUnevenDimensions, serializedInputPropsWithCustomSchema, pixelFormat: userPixelFormat, codec, envVariables, frameRange, puppeteerInstance, outputLocation, onProgress, overwrite, onDownload, onBrowserLog, onStart, timeoutInMilliseconds, chromiumOptions, scale, browserExecutable, port, cancelSignal, muted, enforceAudioTrack, ffmpegOverride, audioBitrate, videoBitrate, encodingMaxRate, encodingBufferSize, audioCodec, concurrency, disallowParallelEncoding, everyNthFrame, imageFormat: provisionalImageFormat, indent, jpegQuality, numberOfGifLoops, onCtrlCExit, preferLossless, serveUrl, server: reusedServer, logLevel, serializedResolvedPropsWithCustomSchema, offthreadVideoCacheSizeInBytes, colorSpace, repro, binariesDirectory, separateAudioTo, forSeamlessAacConcatenation, compositionStart, onBrowserDownload, onArtifact, metadata, hardwareAcceleration, chromeMode, offthreadVideoThreads, mediaCacheSizeInBytes, onLog, licenseKey, isProduction, sampleRate, }) => {
+const internalRenderMediaRaw = ({ proResProfile, x264Preset, gopSize, crf, composition: compositionWithPossibleUnevenDimensions, serializedInputPropsWithCustomSchema, pixelFormat: userPixelFormat, codec, envVariables, frameRange, puppeteerInstance, outputLocation, onProgress, overwrite, onDownload, onBrowserLog, onStart, timeoutInMilliseconds, chromiumOptions, scale, browserExecutable, port, cancelSignal, muted, enforceAudioTrack, ffmpegOverride, audioBitrate, videoBitrate, encodingMaxRate, encodingBufferSize, audioCodec, concurrency, disallowParallelEncoding, everyNthFrame, imageFormat: provisionalImageFormat, indent, jpegQuality, numberOfGifLoops, onCtrlCExit, preferLossless, serveUrl, server: reusedServer, logLevel, serializedResolvedPropsWithCustomSchema, offthreadVideoCacheSizeInBytes, colorSpace, repro, binariesDirectory, separateAudioTo, forSeamlessAacConcatenation, compositionStart, onBrowserDownload, onArtifact, metadata, hardwareAcceleration, chromeMode, offthreadVideoThreads, mediaCacheSizeInBytes, onLog, licenseKey, isProduction, sampleRate, }) => {
     var _a, _b;
     const pixelFormat = (_a = userPixelFormat !== null && userPixelFormat !== void 0 ? userPixelFormat : compositionWithPossibleUnevenDimensions.defaultPixelFormat) !== null && _a !== void 0 ? _a : pixel_format_1.DEFAULT_PIXEL_FORMAT;
     if (repro) {
@@ -78,6 +79,7 @@ const internalRenderMediaRaw = ({ proResProfile, x264Preset, crf, composition: c
         encodingBufferSize,
         hardwareAcceleration,
     });
+    (0, gop_size_1.validateGopSize)(gopSize);
     (0, validate_videobitrate_1.validateBitrate)(audioBitrate, 'audioBitrate');
     (0, validate_videobitrate_1.validateBitrate)(videoBitrate, 'videoBitrate');
     (0, validate_videobitrate_1.validateBitrate)(encodingMaxRate, 'encodingMaxRate');
@@ -245,6 +247,7 @@ const internalRenderMediaRaw = ({ proResProfile, x264Preset, crf, composition: c
                 encodingBufferSize,
                 indent,
                 x264Preset: x264Preset !== null && x264Preset !== void 0 ? x264Preset : null,
+                gopSize,
                 colorSpace,
                 binariesDirectory,
                 hardwareAcceleration,
@@ -426,6 +429,7 @@ const internalRenderMediaRaw = ({ proResProfile, x264Preset, crf, composition: c
                 codec,
                 proResProfile,
                 crf,
+                gopSize,
                 assetsInfo,
                 onProgress: (frame) => {
                     // With seamless AAC concatenation, the amount of rendered frames
@@ -570,7 +574,7 @@ exports.internalRenderMedia = (0, wrap_with_error_handling_1.wrapWithErrorHandli
  * @description Render a video or an audio programmatically.
  * @see [Documentation](https://www.remotion.dev/docs/renderer/render-media)
  */
-const renderMedia = ({ proResProfile, x264Preset, crf, composition, inputProps, pixelFormat, codec, envVariables, frameRange, puppeteerInstance, outputLocation, onProgress, overwrite, onDownload, onBrowserLog, onStart, timeoutInMilliseconds, chromiumOptions, scale, browserExecutable, port, cancelSignal, muted, enforceAudioTrack, ffmpegOverride, audioBitrate, videoBitrate, encodingMaxRate, encodingBufferSize, audioCodec, jpegQuality, concurrency, serveUrl, disallowParallelEncoding, everyNthFrame, imageFormat, numberOfGifLoops, dumpBrowserLogs, preferLossless, verbose, quality, logLevel: passedLogLevel, offthreadVideoCacheSizeInBytes, colorSpace, repro, binariesDirectory, separateAudioTo, forSeamlessAacConcatenation, onBrowserDownload, onArtifact, metadata, hardwareAcceleration, chromeMode, offthreadVideoThreads, compositionStart, mediaCacheSizeInBytes, isProduction, sampleRate, ...apiKeyOrLicenseKey }) => {
+const renderMedia = ({ proResProfile, x264Preset, gopSize, crf, composition, inputProps, pixelFormat, codec, envVariables, frameRange, puppeteerInstance, outputLocation, onProgress, overwrite, onDownload, onBrowserLog, onStart, timeoutInMilliseconds, chromiumOptions, scale, browserExecutable, port, cancelSignal, muted, enforceAudioTrack, ffmpegOverride, audioBitrate, videoBitrate, encodingMaxRate, encodingBufferSize, audioCodec, jpegQuality, concurrency, serveUrl, disallowParallelEncoding, everyNthFrame, imageFormat, numberOfGifLoops, dumpBrowserLogs, preferLossless, verbose, quality, logLevel: passedLogLevel, offthreadVideoCacheSizeInBytes, colorSpace, repro, binariesDirectory, separateAudioTo, forSeamlessAacConcatenation, onBrowserDownload, onArtifact, metadata, hardwareAcceleration, chromeMode, offthreadVideoThreads, compositionStart, mediaCacheSizeInBytes, isProduction, sampleRate, ...apiKeyOrLicenseKey }) => {
     var _a, _b, _c, _d;
     const indent = false;
     const logLevel = verbose || dumpBrowserLogs ? 'verbose' : (passedLogLevel !== null && passedLogLevel !== void 0 ? passedLogLevel : 'info');
@@ -582,6 +586,7 @@ const renderMedia = ({ proResProfile, x264Preset, crf, composition, inputProps,
     return (0, exports.internalRenderMedia)({
         proResProfile: proResProfile !== null && proResProfile !== void 0 ? proResProfile : undefined,
         x264Preset: x264Preset !== null && x264Preset !== void 0 ? x264Preset : null,
+        gopSize: gopSize !== null && gopSize !== void 0 ? gopSize : null,
         codec,
         composition,
         serveUrl,

package/dist/stitch-frames-to-video.d.ts

@@ -27,6 +27,7 @@ type InternalStitchFramesToVideoOptions = {
     codec: Codec;
     audioCodec: AudioCodec | null;
     crf: number | null;
+    gopSize: number | null;
     onProgress?: null | ((progress: number) => void);
     onDownload: undefined | RenderMediaOnDownload;
     proResProfile: undefined | _InternalTypes['ProResProfile'];
@@ -60,6 +61,7 @@ export type StitchFramesToVideoOptions = {
     codec?: Codec;
     audioCodec?: AudioCodec | null;
     crf?: number | null;
+    gopSize?: number | null;
     onProgress?: (progress: number) => void;
     onDownload?: RenderMediaOnDownload;
     proResProfile?: _InternalTypes['ProResProfile'];
@@ -75,5 +77,5 @@ export type StitchFramesToVideoOptions = {
     sampleRate?: number;
 } & Partial<ToOptions<typeof optionsMap.stitchFramesToVideo>>;
 export declare const internalStitchFramesToVideo: (options: InternalStitchFramesToVideoOptions) => Promise<Buffer | null>;
-export declare const stitchFramesToVideo: ({ assetsInfo, force, fps, height, width, audioBitrate, audioCodec, cancelSignal, codec, crf, enforceAudioTrack, ffmpegOverride, muted, numberOfGifLoops, onDownload, onProgress, outputLocation, pixelFormat, proResProfile, verbose, videoBitrate, maxRate, bufferSize, x264Preset, colorSpace, binariesDirectory, separateAudioTo, metadata, hardwareAcceleration, sampleRate, }: StitchFramesToVideoOptions) => Promise<Buffer | null>;
+export declare const stitchFramesToVideo: ({ assetsInfo, force, fps, height, width, audioBitrate, audioCodec, cancelSignal, codec, crf, gopSize, enforceAudioTrack, ffmpegOverride, muted, numberOfGifLoops, onDownload, onProgress, outputLocation, pixelFormat, proResProfile, verbose, videoBitrate, maxRate, bufferSize, x264Preset, colorSpace, binariesDirectory, separateAudioTo, metadata, hardwareAcceleration, sampleRate, }: StitchFramesToVideoOptions) => Promise<Buffer | null>;
 export {};

package/dist/stitch-frames-to-video.js

@@ -23,6 +23,7 @@ const make_cancel_signal_1 = require("./make-cancel-signal");
 const make_metadata_args_1 = require("./make-metadata-args");
 const audio_codec_1 = require("./options/audio-codec");
 const color_space_1 = require("./options/color-space");
+const gop_size_1 = require("./options/gop-size");
 const parse_ffmpeg_progress_1 = require("./parse-ffmpeg-progress");
 const pixel_format_1 = require("./pixel-format");
 const prores_profile_1 = require("./prores-profile");
@@ -30,7 +31,7 @@ const render_has_audio_1 = require("./render-has-audio");
 const validate_1 = require("./validate");
 const validate_even_dimensions_with_codec_1 = require("./validate-even-dimensions-with-codec");
 const validate_videobitrate_1 = require("./validate-videobitrate");
-const innerStitchFramesToVideo = async ({ assetsInfo, audioBitrate, audioCodec: audioCodecSetting, cancelSignal, codec, crf, enforceAudioTrack, ffmpegOverride, force, fps, height, indent, muted, onDownload, outputLocation, pixelFormat, preEncodedFileLocation, preferLossless, proResProfile, logLevel, videoBitrate, maxRate, bufferSize, width, numberOfGifLoops, onProgress, x264Preset, colorSpace, binariesDirectory, separateAudioTo, metadata, hardwareAcceleration, sampleRate, }, remotionRoot) => {
+const innerStitchFramesToVideo = async ({ assetsInfo, audioBitrate, audioCodec: audioCodecSetting, cancelSignal, codec, crf, gopSize, enforceAudioTrack, ffmpegOverride, force, fps, height, indent, muted, onDownload, outputLocation, pixelFormat, preEncodedFileLocation, preferLossless, proResProfile, logLevel, videoBitrate, maxRate, bufferSize, width, numberOfGifLoops, onProgress, x264Preset, colorSpace, binariesDirectory, separateAudioTo, metadata, hardwareAcceleration, sampleRate, }, remotionRoot) => {
     var _a;
     (0, validate_1.validateDimension)(height, 'height', 'passed to `stitchFramesToVideo()`');
     (0, validate_1.validateDimension)(width, 'width', 'passed to `stitchFramesToVideo()`');
@@ -52,6 +53,7 @@ const innerStitchFramesToVideo = async ({ assetsInfo, audioBitrate, audioCodec:
     (0, validate_videobitrate_1.validateBitrate)(maxRate, 'maxRate');
     // bufferSize is not a bitrate but need to be validated using the same format
     (0, validate_videobitrate_1.validateBitrate)(bufferSize, 'bufferSize');
+    (0, gop_size_1.validateGopSize)(gopSize);
     (0, validate_1.validateFps)(fps, 'in `stitchFramesToVideo()`', false);
     assetsInfo.downloadMap.preventCleanup();
     const proResProfileName = (0, get_prores_profile_name_1.getProResProfileName)(codec, proResProfile);
@@ -201,6 +203,7 @@ const innerStitchFramesToVideo = async ({ assetsInfo, audioBitrate, audioCodec:
             proResProfileName,
             pixelFormat,
             x264Preset,
+            gopSize,
             colorSpace,
             hardwareAcceleration,
             indent,
@@ -312,7 +315,7 @@ exports.internalStitchFramesToVideo = internalStitchFramesToVideo;
  * @description Takes a series of images and audio information generated by renderFrames() and encodes it to a video.
  * @see [Documentation](https://www.remotion.dev/docs/renderer/stitch-frames-to-video)
  */
-const stitchFramesToVideo = ({ assetsInfo, force, fps, height, width, audioBitrate, audioCodec, cancelSignal, codec, crf, enforceAudioTrack, ffmpegOverride, muted, numberOfGifLoops, onDownload, onProgress, outputLocation, pixelFormat, proResProfile, verbose, videoBitrate, maxRate, bufferSize, x264Preset, colorSpace, binariesDirectory, separateAudioTo, metadata, hardwareAcceleration, sampleRate, }) => {
+const stitchFramesToVideo = ({ assetsInfo, force, fps, height, width, audioBitrate, audioCodec, cancelSignal, codec, crf, gopSize, enforceAudioTrack, ffmpegOverride, muted, numberOfGifLoops, onDownload, onProgress, outputLocation, pixelFormat, proResProfile, verbose, videoBitrate, maxRate, bufferSize, x264Preset, colorSpace, binariesDirectory, separateAudioTo, metadata, hardwareAcceleration, sampleRate, }) => {
     return (0, exports.internalStitchFramesToVideo)({
         assetsInfo,
         audioBitrate: audioBitrate !== null && audioBitrate !== void 0 ? audioBitrate : null,
@@ -322,6 +325,7 @@ const stitchFramesToVideo = ({ assetsInfo, force, fps, height, width, audioBitra
         cancelSignal: cancelSignal !== null && cancelSignal !== void 0 ? cancelSignal : null,
         codec: codec !== null && codec !== void 0 ? codec : codec_1.DEFAULT_CODEC,
         crf: crf !== null && crf !== void 0 ? crf : null,
+        gopSize: gopSize !== null && gopSize !== void 0 ? gopSize : null,
         enforceAudioTrack: enforceAudioTrack !== null && enforceAudioTrack !== void 0 ? enforceAudioTrack : false,
         ffmpegOverride: ffmpegOverride !== null && ffmpegOverride !== void 0 ? ffmpegOverride : null,
         force: force !== null && force !== void 0 ? force : true,

package/package.json

@@ -3,7 +3,7 @@
 		"url": "https://github.com/remotion-dev/remotion/tree/main/packages/renderer"
 	},
 	"name": "@remotion/renderer",
-	"version": "4.0.465",
+	"version": "4.0.467",
 	"description": "Render Remotion videos using Node.js or Bun",
 	"main": "dist/index.js",
 	"types": "dist/index.d.ts",
@@ -22,11 +22,11 @@
 	},
 	"dependencies": {
 		"execa": "5.1.1",
-		"remotion": "4.0.465",
-		"@remotion/streaming": "4.0.465",
+		"remotion": "4.0.467",
+		"@remotion/streaming": "4.0.467",
 		"source-map": "0.8.0-beta.0",
 		"ws": "8.20.1",
-		"@remotion/licensing": "4.0.465"
+		"@remotion/licensing": "4.0.467"
 	},
 	"peerDependencies": {
 		"react": ">=16.8.0",
@@ -40,19 +40,19 @@
 		"react-dom": "19.2.3",
 		"@typescript/native-preview": "7.0.0-dev.20260217.1",
 		"@types/ws": "8.5.10",
-		"@remotion/example-videos": "4.0.465",
-		"@remotion/eslint-config-internal": "4.0.465",
+		"@remotion/example-videos": "4.0.467",
+		"@remotion/eslint-config-internal": "4.0.467",
 		"eslint": "9.19.0",
 		"@types/node": "20.12.14"
 	},
 	"optionalDependencies": {
-		"@remotion/compositor-darwin-arm64": "4.0.465",
-		"@remotion/compositor-darwin-x64": "4.0.465",
-		"@remotion/compositor-linux-arm64-gnu": "4.0.465",
-		"@remotion/compositor-linux-arm64-musl": "4.0.465",
-		"@remotion/compositor-linux-x64-gnu": "4.0.465",
-		"@remotion/compositor-linux-x64-musl": "4.0.465",
-		"@remotion/compositor-win32-x64-msvc": "4.0.465"
+		"@remotion/compositor-darwin-arm64": "4.0.467",
+		"@remotion/compositor-darwin-x64": "4.0.467",
+		"@remotion/compositor-linux-arm64-gnu": "4.0.467",
+		"@remotion/compositor-linux-arm64-musl": "4.0.467",
+		"@remotion/compositor-linux-x64-gnu": "4.0.467",
+		"@remotion/compositor-linux-x64-musl": "4.0.467",
+		"@remotion/compositor-win32-x64-msvc": "4.0.467"
 	},
 	"keywords": [
 		"remotion",