@remotion/renderer 4.0.530 → 4.0.531

package/dist/aac-priming.d.ts

@@ -0,0 +1,6 @@
+export declare const LIBFDK_AAC_LC_ENCODER_DELAY_IN_SAMPLES = 2048;
+export declare const getAacPrimingInputArgs: ({ audioCodec, sampleRate, outputExtension, }: {
+    audioCodec: "aac" | "mp3" | "opus" | "pcm-16" | null;
+    sampleRate: number;
+    outputExtension: string | null;
+}) => string[];

package/dist/aac-priming.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getAacPrimingInputArgs = exports.LIBFDK_AAC_LC_ENCODER_DELAY_IN_SAMPLES = void 0;
+// libfdk_aac (AAC-LC) prepends 2048 samples of encoder delay ("priming") to
+// its output. The audio is encoded to ADTS first (compressAudio, combineAudio),
+// and ADTS cannot signal that delay, so stream-copying it into an MP4 or MOV
+// produced an edit list starting at media time 0: players then played the
+// priming as content and the audio was 2048 / sampleRate late (42.67ms at
+// 48kHz). Shifting the ADTS input back by the delay makes the muxer write an
+// edit list that skips the priming, like encoding straight to MP4 does.
+exports.LIBFDK_AAC_LC_ENCODER_DELAY_IN_SAMPLES = 2048;
+const getAacPrimingInputArgs = ({ audioCodec, sampleRate, outputExtension, }) => {
+    if (audioCodec !== 'aac') {
+        return [];
+    }
+    // Only containers with edit lists can carry the shift
+    const extension = outputExtension === null || outputExtension === void 0 ? void 0 : outputExtension.toLowerCase();
+    if (extension !== 'mp4' && extension !== 'mov') {
+        return [];
+    }
+    const delayInMicroseconds = Math.round((exports.LIBFDK_AAC_LC_ENCODER_DELAY_IN_SAMPLES / sampleRate) * 1000000);
+    return ['-itsoffset', `-${delayInMicroseconds}us`];
+};
+exports.getAacPrimingInputArgs = getAacPrimingInputArgs;

package/dist/combine-chunks.js

@@ -124,6 +124,8 @@ const internalCombineChunks = async ({ outputLocation: output, onProgress, codec
             cancelSignal,
             metadata,
             numberOfGifLoops,
+            audioCodec: resolvedAudioCodec,
+            sampleRate,
         });
         onProgress({ totalProgress: 1, frames: numberOfFrames });
         (0, node_fs_1.rmSync)(filelistDir, { recursive: true });

package/dist/crf.js

@@ -60,6 +60,12 @@ const validateQualitySettings = ({ codec, crf, videoBitrate, encodingMaxRate, en
     if (encodingMaxRate && !encodingBufferSize) {
         throw new Error('"encodingMaxRate" can not be set without also setting "encodingBufferSize".');
     }
+    // libvpx and libaom-av1 reject -maxrate and -bufsize without -b:v
+    if ((encodingMaxRate || encodingBufferSize) &&
+        !videoBitrate &&
+        (codec === 'vp8' || codec === 'vp9' || codec === 'av1')) {
+        throw new Error(`The ${codec} codec needs "videoBitrate" when "encodingMaxRate" or "encodingBufferSize" is set.`);
+    }
     const bufSizeArray = encodingBufferSize
         ? ['-bufsize', encodingBufferSize]
         : [];

package/dist/esm/client.mjs

@@ -1974,7 +1974,7 @@ var encodingBufferSizeOption = {
       /* @__PURE__ */ jsx27("code", {
         children: "-bufsize"
       }),
-      " flag of FFmpeg. Should be used in conjunction with the encoding max rate flag."
+      " flag of FFmpeg. Should be used in conjunction with the encoding max rate flag. With the VP8, VP9 and AV1 codecs, a video bitrate must also be set."
     ]
   }),
   ssrName: "encodingBufferSize",
@@ -2015,7 +2015,7 @@ var encodingMaxRateOption = {
       /* @__PURE__ */ jsx28("code", {
         children: "-maxrate"
       }),
-      " flag of FFmpeg. Should be used in conjunction with the encoding buffer size flag."
+      " flag of FFmpeg. Should be used in conjunction with the encoding buffer size flag. With the VP8, VP9 and AV1 codecs, a video bitrate must also be set."
     ]
   }),
   ssrName: "encodingMaxRate",

package/dist/esm/index.mjs

@@ -21643,6 +21643,9 @@ var validateQualitySettings = ({
   if (encodingMaxRate && !encodingBufferSize) {
     throw new Error('"encodingMaxRate" can not be set without also setting "encodingBufferSize".');
   }
+  if ((encodingMaxRate || encodingBufferSize) && !videoBitrate && (codec === "vp8" || codec === "vp9" || codec === "av1")) {
+    throw new Error(`The ${codec} codec needs "videoBitrate" when "encodingMaxRate" or "encodingBufferSize" is set.`);
+  }
   const bufSizeArray = encodingBufferSize ? ["-bufsize", encodingBufferSize] : [];
   const maxRateArray = encodingMaxRate ? ["-maxrate", encodingMaxRate] : [];
   if (videoBitrate) {
@@ -22388,6 +22391,24 @@ var validateSelectedCodecAndProResCombination = ({
 import { cpSync as cpSync2, promises as promises5, rmSync as rmSync4 } from "node:fs";
 import path29 from "node:path";
 
+// src/aac-priming.ts
+var LIBFDK_AAC_LC_ENCODER_DELAY_IN_SAMPLES = 2048;
+var getAacPrimingInputArgs = ({
+  audioCodec,
+  sampleRate,
+  outputExtension
+}) => {
+  if (audioCodec !== "aac") {
+    return [];
+  }
+  const extension = outputExtension?.toLowerCase();
+  if (extension !== "mp4" && extension !== "mov") {
+    return [];
+  }
+  const delayInMicroseconds = Math.round(LIBFDK_AAC_LC_ENCODER_DELAY_IN_SAMPLES / sampleRate * 1e6);
+  return ["-itsoffset", `-${delayInMicroseconds}us`];
+};
+
 // src/convert-number-of-gif-loops-to-ffmpeg.ts
 var convertNumberOfGifLoopsToFfmpegSyntax = (loops) => {
   if (loops === null) {
@@ -23768,7 +23789,17 @@ var innerStitchFramesToVideo = async ({
       ["-i", assetsInfo.imageSequenceName],
       codec === "gif" ? ["-filter_complex", "split[v],palettegen,[v]paletteuse"] : null
     ],
-    audio && !separateAudioTo ? ["-i", audio, "-c:a", "copy"] : ["-an"],
+    audio && !separateAudioTo ? [
+      ...getAacPrimingInputArgs({
+        audioCodec: resolvedAudioCodec,
+        sampleRate,
+        outputExtension
+      }),
+      "-i",
+      audio,
+      "-c:a",
+      "copy"
+    ] : ["-an"],
     numberOfGifLoops === null ? null : ["-loop", convertNumberOfGifLoopsToFfmpegSyntax(numberOfGifLoops)],
     ...generateFfmpegArgs({
       codec,
@@ -25633,7 +25664,9 @@ var muxVideoAndAudio = async ({
   fps,
   cancelSignal,
   metadata,
-  numberOfGifLoops
+  numberOfGifLoops,
+  audioCodec,
+  sampleRate
 }) => {
   const startTime = Date.now();
   Log.verbose({ indent, logLevel }, "Muxing video and audio together");
@@ -25643,6 +25676,11 @@ var muxVideoAndAudio = async ({
     "-hide_banner",
     videoOutput ? "-i" : null,
     videoOutput,
+    ...audioOutput ? getAacPrimingInputArgs({
+      audioCodec,
+      sampleRate,
+      outputExtension
+    }) : [],
     audioOutput ? "-i" : null,
     audioOutput,
     videoOutput ? "-c:v" : null,
@@ -25791,7 +25829,9 @@ var internalCombineChunks = async ({
       fps,
       cancelSignal,
       metadata,
-      numberOfGifLoops
+      numberOfGifLoops,
+      audioCodec: resolvedAudioCodec,
+      sampleRate
     });
     onProgress({ totalProgress: 1, frames: numberOfFrames });
     rmSync6(filelistDir, { recursive: true });

package/dist/mux-video-and-audio.d.ts

@@ -1,5 +1,5 @@
 import type { CancelSignal } from './make-cancel-signal';
-export declare const muxVideoAndAudio: ({ videoOutput, audioOutput, output, indent, logLevel, onProgress, binariesDirectory, fps, cancelSignal, metadata, numberOfGifLoops, }: {
+export declare const muxVideoAndAudio: ({ videoOutput, audioOutput, output, indent, logLevel, onProgress, binariesDirectory, fps, cancelSignal, metadata, numberOfGifLoops, audioCodec, sampleRate, }: {
     videoOutput: string | null;
     audioOutput: string | null;
     output: string;
@@ -11,4 +11,6 @@ export declare const muxVideoAndAudio: ({ videoOutput, audioOutput, output, inde
     cancelSignal: CancelSignal | undefined;
     metadata?: Record<string, string> | null | undefined;
     numberOfGifLoops: number | null;
+    audioCodec: "aac" | "mp3" | "opus" | "pcm-16" | null;
+    sampleRate: number;
 }) => Promise<void>;

package/dist/mux-video-and-audio.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.muxVideoAndAudio = void 0;
+const aac_priming_1 = require("./aac-priming");
 const call_ffmpeg_1 = require("./call-ffmpeg");
 const convert_number_of_gif_loops_to_ffmpeg_1 = require("./convert-number-of-gif-loops-to-ffmpeg");
 const get_extension_of_filename_1 = require("./get-extension-of-filename");
@@ -9,7 +10,7 @@ const logger_1 = require("./logger");
 const make_metadata_args_1 = require("./make-metadata-args");
 const parse_ffmpeg_progress_1 = require("./parse-ffmpeg-progress");
 const truthy_1 = require("./truthy");
-const muxVideoAndAudio = async ({ videoOutput, audioOutput, output, indent, logLevel, onProgress, binariesDirectory, fps, cancelSignal, metadata, numberOfGifLoops, }) => {
+const muxVideoAndAudio = async ({ videoOutput, audioOutput, output, indent, logLevel, onProgress, binariesDirectory, fps, cancelSignal, metadata, numberOfGifLoops, audioCodec, sampleRate, }) => {
     var _a;
     const startTime = Date.now();
     logger_1.Log.verbose({ indent, logLevel }, 'Muxing video and audio together');
@@ -21,6 +22,13 @@ const muxVideoAndAudio = async ({ videoOutput, audioOutput, output, indent, logL
         '-hide_banner',
         videoOutput ? '-i' : null,
         videoOutput,
+        ...(audioOutput
+            ? (0, aac_priming_1.getAacPrimingInputArgs)({
+                audioCodec,
+                sampleRate,
+                outputExtension,
+            })
+            : []),
         audioOutput ? '-i' : null,
         audioOutput,
         videoOutput ? '-c:v' : null,

package/dist/options/encoding-buffer-size.js

@@ -15,7 +15,7 @@ exports.encodingBufferSizeOption = {
     cliFlag,
     description: () => (jsx_runtime_1.jsxs(jsx_runtime_1.Fragment, { children: ["The value for the ",
             jsx_runtime_1.jsx("code", { children: "-bufsize" }),
-            " flag of FFmpeg. Should be used in conjunction with the encoding max rate flag."] })),
+            " flag of FFmpeg. Should be used in conjunction with the encoding max rate flag. With the VP8, VP9 and AV1 codecs, a video bitrate must also be set."] })),
     ssrName: 'encodingBufferSize',
     docLink: 'https://www.remotion.dev/docs/renderer/render-media#encodingbuffersize',
     type: '',

package/dist/options/encoding-max-rate.js

@@ -9,7 +9,7 @@ exports.encodingMaxRateOption = {
     cliFlag,
     description: () => (jsx_runtime_1.jsxs(jsx_runtime_1.Fragment, { children: ["The value for the ",
             jsx_runtime_1.jsx("code", { children: "-maxrate" }),
-            " flag of FFmpeg. Should be used in conjunction with the encoding buffer size flag."] })),
+            " flag of FFmpeg. Should be used in conjunction with the encoding buffer size flag. With the VP8, VP9 and AV1 codecs, a video bitrate must also be set."] })),
     ssrName: 'encodingMaxRate',
     docLink: 'https://www.remotion.dev/docs/renderer/render-media#encodingmaxrate',
     type: '',

package/dist/options/{sidebar-tabs.d.ts → experimental-client-side-rendering.d.ts}

@@ -1,6 +1,6 @@
-export declare const sidebarTabsOption: {
+export declare const experimentalClientSideRenderingOption: {
     name: string;
-    cliFlag: "disable-sidebar-tabs";
+    cliFlag: "enable-experimental-client-side-rendering";
     description: () => import("react/jsx-runtime").JSX.Element;
     ssrName: null;
     docLink: string;
@@ -12,7 +12,5 @@ export declare const sidebarTabsOption: {
         source: string;
     };
     setConfig(value: boolean): void;
-    getConfigValue: () => boolean | null;
-    reset: () => void;
-    id: "disable-sidebar-tabs";
+    id: "enable-experimental-client-side-rendering";
 };

package/dist/options/experimental-client-side-rendering.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.experimentalClientSideRenderingOption = void 0;
+const jsx_runtime_1 = require("react/jsx-runtime");
+let experimentalClientSideRenderingEnabled = false;
+const cliFlag = 'enable-experimental-client-side-rendering';
+exports.experimentalClientSideRenderingOption = {
+    name: 'Enable Experimental Client-Side Rendering',
+    cliFlag,
+    description: () => (jsx_runtime_1.jsx(jsx_runtime_1.Fragment, { children: "Enable WIP client-side rendering in the Remotion Studio. See https://www.remotion.dev/docs/client-side-rendering/ for notes." })),
+    ssrName: null,
+    docLink: 'https://www.remotion.dev/docs/client-side-rendering',
+    type: false,
+    getValue: ({ commandLine }) => {
+        if (commandLine[cliFlag] !== null) {
+            return {
+                value: commandLine[cliFlag],
+                source: 'cli',
+            };
+        }
+        return {
+            value: experimentalClientSideRenderingEnabled,
+            source: 'config',
+        };
+    },
+    setConfig(value) {
+        experimentalClientSideRenderingEnabled = value;
+    },
+    id: cliFlag,
+};

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

@@ -6,6 +6,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.stitchFramesToVideo = exports.internalStitchFramesToVideo = void 0;
 const node_fs_1 = require("node:fs");
 const node_path_1 = __importDefault(require("node:path"));
+const aac_priming_1 = require("./aac-priming");
 const download_map_1 = require("./assets/download-map");
 const call_ffmpeg_1 = require("./call-ffmpeg");
 const codec_1 = require("./codec");
@@ -224,7 +225,19 @@ const innerStitchFramesToVideo = async ({ assetsInfo, audioBitrate, audioCodec:
                     ? ['-filter_complex', 'split[v],palettegen,[v]paletteuse']
                     : null,
             ]),
-        audio && !separateAudioTo ? ['-i', audio, '-c:a', 'copy'] : ['-an'],
+        audio && !separateAudioTo
+            ? [
+                ...(0, aac_priming_1.getAacPrimingInputArgs)({
+                    audioCodec: resolvedAudioCodec,
+                    sampleRate,
+                    outputExtension,
+                }),
+                '-i',
+                audio,
+                '-c:a',
+                'copy',
+            ]
+            : ['-an'],
         numberOfGifLoops === null
             ? null
             : ['-loop', (0, convert_number_of_gif_loops_to_ffmpeg_1.convertNumberOfGifLoopsToFfmpegSyntax)(numberOfGifLoops)],

package/package.json

@@ -3,7 +3,7 @@
 		"url": "https://github.com/remotion-dev/remotion/tree/main/packages/renderer"
 	},
 	"name": "@remotion/renderer",
-	"version": "4.0.530",
+	"version": "4.0.531",
 	"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.530",
-		"@remotion/streaming": "4.0.530",
+		"remotion": "4.0.531",
+		"@remotion/streaming": "4.0.531",
 		"source-map": "0.8.0",
 		"ws": "8.21.0",
-		"@remotion/licensing": "4.0.530"
+		"@remotion/licensing": "4.0.531"
 	},
 	"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.530",
-		"@remotion/eslint-config-internal": "4.0.530",
+		"@remotion/example-videos": "4.0.531",
+		"@remotion/eslint-config-internal": "4.0.531",
 		"eslint": "9.19.0",
 		"@types/node": "20.12.14"
 	},
 	"optionalDependencies": {
-		"@remotion/compositor-darwin-arm64": "4.0.530",
-		"@remotion/compositor-darwin-x64": "4.0.530",
-		"@remotion/compositor-linux-arm64-gnu": "4.0.530",
-		"@remotion/compositor-linux-arm64-musl": "4.0.530",
-		"@remotion/compositor-linux-x64-gnu": "4.0.530",
-		"@remotion/compositor-linux-x64-musl": "4.0.530",
-		"@remotion/compositor-win32-x64-msvc": "4.0.530"
+		"@remotion/compositor-darwin-arm64": "4.0.531",
+		"@remotion/compositor-darwin-x64": "4.0.531",
+		"@remotion/compositor-linux-arm64-gnu": "4.0.531",
+		"@remotion/compositor-linux-arm64-musl": "4.0.531",
+		"@remotion/compositor-linux-x64-gnu": "4.0.531",
+		"@remotion/compositor-linux-x64-musl": "4.0.531",
+		"@remotion/compositor-win32-x64-msvc": "4.0.531"
 	},
 	"keywords": [
 		"remotion",

package/dist/options/sidebar-tabs.js

@@ -1,38 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.sidebarTabsOption = void 0;
-const jsx_runtime_1 = require("react/jsx-runtime");
-let sidebarTabsEnabled = true;
-let configuredSidebarTabsEnabled = null;
-const cliFlag = 'disable-sidebar-tabs';
-exports.sidebarTabsOption = {
-    name: 'Disable or enable Studio sidebar tabs',
-    cliFlag,
-    description: () => (jsx_runtime_1.jsx(jsx_runtime_1.Fragment, { children: "Enable or disable the tabs at the top of the Studio sidebars." })),
-    ssrName: null,
-    docLink: 'https://www.remotion.dev/docs/config#setsidebartabsenabled',
-    type: false,
-    getValue: ({ commandLine }) => {
-        if (commandLine[cliFlag] !== undefined && commandLine[cliFlag] !== null) {
-            sidebarTabsEnabled = commandLine[cliFlag] === false;
-            return {
-                value: sidebarTabsEnabled,
-                source: 'cli',
-            };
-        }
-        return {
-            value: sidebarTabsEnabled,
-            source: 'config',
-        };
-    },
-    setConfig(value) {
-        sidebarTabsEnabled = value;
-        configuredSidebarTabsEnabled = value;
-    },
-    getConfigValue: () => configuredSidebarTabsEnabled,
-    reset: () => {
-        sidebarTabsEnabled = true;
-        configuredSidebarTabsEnabled = null;
-    },
-    id: cliFlag,
-};