@remotion/renderer 4.0.522 → 4.0.523

package/dist/client.d.ts

@@ -422,7 +422,7 @@ export declare const BrowserSafeApis: {
         enforceAudioOption: {
             name: string;
             cliFlag: "enforce-audio-track";
-            description: () => import("react/jsx-runtime").JSX.Element;
+            description: (mode: "cli" | "ssr") => import("react/jsx-runtime").JSX.Element;
             ssrName: string;
             docLink: string;
             type: boolean;
@@ -3973,7 +3973,7 @@ export declare const BrowserSafeApis: {
             readonly enforceAudioTrack: {
                 name: string;
                 cliFlag: "enforce-audio-track";
-                description: () => import("react/jsx-runtime").JSX.Element;
+                description: (mode: "cli" | "ssr") => import("react/jsx-runtime").JSX.Element;
                 ssrName: string;
                 docLink: string;
                 type: boolean;

package/dist/create-audio.d.ts

@@ -7,7 +7,7 @@ export type SeamlessAudioInfo = {
     trimLeftOffset: number;
     trimRightOffset: number;
 };
-export declare const createAudio: ({ assets, onDownload, fps, logLevel, onProgress, downloadMap, remotionRoot, indent, binariesDirectory, audioBitrate, audioCodec, cancelSignal, chunkLengthInSeconds, trimLeftOffset, trimRightOffset, forSeamlessAacConcatenation, sampleRate, }: {
+export declare const createAudio: ({ assets, onDownload, fps, logLevel, onProgress, downloadMap, remotionRoot, indent, binariesDirectory, audioBitrate, audioCodec, cancelSignal, chunkLengthInSeconds, trimLeftOffset, trimRightOffset, forSeamlessAacConcatenation, sampleRate, enforceAudioTrack, }: {
     assets: FrameAndAssets[];
     onDownload: RenderMediaOnDownload | undefined;
     fps: number;
@@ -25,4 +25,5 @@ export declare const createAudio: ({ assets, onDownload, fps, logLevel, onProgre
     trimRightOffset: number;
     forSeamlessAacConcatenation: boolean;
     sampleRate: number;
-}) => Promise<string>;
+    enforceAudioTrack: boolean;
+}) => Promise<string | null>;

package/dist/create-audio.js

@@ -16,7 +16,7 @@ const merge_inline_audio_tracks_1 = require("./merge-inline-audio-tracks");
 const audio_codec_1 = require("./options/audio-codec");
 const preprocess_audio_track_1 = require("./preprocess-audio-track");
 const truthy_1 = require("./truthy");
-const createAudio = async ({ assets, onDownload, fps, logLevel, onProgress, downloadMap, remotionRoot, indent, binariesDirectory, audioBitrate, audioCodec, cancelSignal, chunkLengthInSeconds, trimLeftOffset, trimRightOffset, forSeamlessAacConcatenation, sampleRate, }) => {
+const createAudio = async ({ assets, onDownload, fps, logLevel, onProgress, downloadMap, remotionRoot, indent, binariesDirectory, audioBitrate, audioCodec, cancelSignal, chunkLengthInSeconds, trimLeftOffset, trimRightOffset, forSeamlessAacConcatenation, sampleRate, enforceAudioTrack, }) => {
     const fileUrlAssets = await (0, convert_assets_to_file_urls_1.convertAssetsToFileUrls)({
         assets,
         onDownload: onDownload !== null && onDownload !== void 0 ? onDownload : (() => () => undefined),
@@ -98,6 +98,11 @@ const createAudio = async ({ assets, onDownload, fps, logLevel, onProgress, down
             ]
             : []),
     ];
+    if (!enforceAudioTrack && preprocessed.length === 0) {
+        (0, delete_directory_1.deleteDirectory)(downloadMap.audioMixing);
+        onProgress(1);
+        return null;
+    }
     const merged = path_1.default.join(downloadMap.audioPreprocessing, 'merged.wav');
     const extension = (0, audio_codec_1.getExtensionFromAudioCodec)(audioCodec);
     const outName = path_1.default.join(downloadMap.audioPreprocessing, `audio.${extension}`);

package/dist/esm/client.mjs

@@ -480,7 +480,7 @@ var DEFAULT = null;
 var cliFlag5 = "separate-audio-to";
 var separateAudioOption = {
   cliFlag: cliFlag5,
-  description: () => `If set, the audio will not be included in the main output but rendered as a separate file at the location you pass. It is recommended to use an absolute path. If a relative path is passed, it is relative to the Remotion Root.`,
+  description: () => `If set, the audio will not be included in the main output but rendered as a separate file at the location you pass. If the render contains no audio, a silent audio file is produced even when enforceAudioTrack is false. The muted option still takes precedence. It is recommended to use an absolute path. If a relative path is passed, it is relative to the Remotion Root.`,
   docLink: "https://remotion.dev/docs/renderer/render-media",
   getValue: ({ commandLine }) => {
     if (commandLine[cliFlag5]) {
@@ -1891,15 +1891,71 @@ var encodingMaxRateOption = {
 };
 
 // src/options/enforce-audio.tsx
-import { jsx as jsx28, Fragment as Fragment28 } from "react/jsx-runtime";
+import { jsx as jsx28, jsxs as jsxs21, Fragment as Fragment28 } from "react/jsx-runtime";
 var DEFAULT_ENFORCE_AUDIO_TRACK = false;
 var enforceAudioTrackState = DEFAULT_ENFORCE_AUDIO_TRACK;
 var cliFlag31 = "enforce-audio-track";
 var enforceAudioOption = {
   name: "Enforce Audio Track",
   cliFlag: cliFlag31,
-  description: () => /* @__PURE__ */ jsx28(Fragment28, {
-    children: "Render a silent audio track if there would be none otherwise."
+  description: (mode) => /* @__PURE__ */ jsxs21(Fragment28, {
+    children: [
+      /* @__PURE__ */ jsxs21("p", {
+        children: [
+          "Defaults to ",
+          /* @__PURE__ */ jsx28("code", {
+            children: "false"
+          }),
+          ". If ",
+          /* @__PURE__ */ jsx28("code", {
+            children: "true"
+          }),
+          ", include a silent audio track when the render contains no audio. If ",
+          /* @__PURE__ */ jsx28("code", {
+            children: "false"
+          }),
+          ", omit the audio track when no audio is present. Audio-only exports and",
+          " ",
+          /* @__PURE__ */ jsx28("code", {
+            children: mode === "cli" ? "--separate-audio-to" : "separateAudioTo"
+          }),
+          " ",
+          "still produce an audio file, even when silent."
+        ]
+      }),
+      /* @__PURE__ */ jsxs21("p", {
+        children: [
+          mode === "cli" ? /* @__PURE__ */ jsxs21(Fragment28, {
+            children: [
+              "Pass ",
+              /* @__PURE__ */ jsx28("code", {
+                children: "--enforce-audio-track"
+              })
+            ]
+          }) : /* @__PURE__ */ jsxs21(Fragment28, {
+            children: [
+              "Set this to ",
+              /* @__PURE__ */ jsx28("code", {
+                children: "true"
+              })
+            ]
+          }),
+          " ",
+          "for",
+          " ",
+          /* @__PURE__ */ jsx28("a", {
+            href: "/docs/distributed-rendering",
+            children: "chunks that will later be concatenated"
+          }),
+          ", because other chunks may contain audio.",
+          " ",
+          /* @__PURE__ */ jsx28("code", {
+            children: mode === "cli" ? "--muted" : "muted: true"
+          }),
+          " takes precedence."
+        ]
+      })
+    ]
   }),
   ssrName: "enforceAudioTrack",
   docLink: "https://www.remotion.dev/docs/config#setenforceaudiotrack-",
@@ -1929,13 +1985,13 @@ var enforceAudioOption = {
 };
 
 // src/options/env-file.tsx
-import { jsx as jsx29, jsxs as jsxs21, Fragment as Fragment29 } from "react/jsx-runtime";
+import { jsx as jsx29, jsxs as jsxs22, Fragment as Fragment29 } from "react/jsx-runtime";
 var cliFlag32 = "env-file";
 var envFileLocation = null;
 var envFileOption = {
   name: "Env File",
   cliFlag: cliFlag32,
-  description: () => /* @__PURE__ */ jsxs21(Fragment29, {
+  description: () => /* @__PURE__ */ jsxs22(Fragment29, {
     children: [
       "Specify a location for a dotenv file. Default ",
       /* @__PURE__ */ jsx29("code", {
@@ -1972,14 +2028,14 @@ var envFileOption = {
 };
 
 // src/options/every-nth-frame.tsx
-import { jsx as jsx30, jsxs as jsxs22, Fragment as Fragment30 } from "react/jsx-runtime";
+import { jsx as jsx30, jsxs as jsxs23, Fragment as Fragment30 } from "react/jsx-runtime";
 var DEFAULT_EVERY_NTH_FRAME = 1;
 var everyNthFrame = DEFAULT_EVERY_NTH_FRAME;
 var cliFlag33 = "every-nth-frame";
 var everyNthFrameOption = {
   name: "Every nth frame",
   cliFlag: cliFlag33,
-  description: () => /* @__PURE__ */ jsxs22(Fragment30, {
+  description: () => /* @__PURE__ */ jsxs23(Fragment30, {
     children: [
       "This option may only be set when rendering GIFs. It determines how many frames are rendered, while the other ones get skipped in order to lower the FPS of the GIF. For example, if the ",
       /* @__PURE__ */ jsx30("code", {
@@ -2025,13 +2081,13 @@ var everyNthFrameOption = {
 };
 
 // src/options/experimental-keep-audio-context-alive.tsx
-import { jsx as jsx31, jsxs as jsxs23, Fragment as Fragment31 } from "react/jsx-runtime";
+import { jsx as jsx31, jsxs as jsxs24, Fragment as Fragment31 } from "react/jsx-runtime";
 var experimentalKeepAudioContextAlive = false;
 var cliFlag34 = "experimental-keep-audio-context-alive";
 var experimentalKeepAudioContextAliveOption = {
   name: "Keep AudioContext alive (experimental)",
   cliFlag: cliFlag34,
-  description: () => /* @__PURE__ */ jsxs23(Fragment31, {
+  description: () => /* @__PURE__ */ jsxs24(Fragment31, {
     children: [
       "Keeps the shared ",
       /* @__PURE__ */ jsx31("code", {
@@ -2062,14 +2118,14 @@ var experimentalKeepAudioContextAliveOption = {
 };
 
 // src/options/folder-expiry.tsx
-import { jsx as jsx32, jsxs as jsxs24, Fragment as Fragment32 } from "react/jsx-runtime";
+import { jsx as jsx32, jsxs as jsxs25, Fragment as Fragment32 } from "react/jsx-runtime";
 var enableFolderExpiry = null;
 var cliFlag35 = "enable-folder-expiry";
 var folderExpiryOption = {
   name: "Lambda render expiration",
   cliFlag: cliFlag35,
   description: () => {
-    return /* @__PURE__ */ jsxs24(Fragment32, {
+    return /* @__PURE__ */ jsxs25(Fragment32, {
       children: [
         "When deploying sites, enable or disable S3 Lifecycle policies which allow for renders to auto-delete after a certain time. Default is",
         " ",
@@ -2113,14 +2169,14 @@ var folderExpiryOption = {
 };
 
 // src/options/for-seamless-aac-concatenation.tsx
-import { jsx as jsx33, jsxs as jsxs25, Fragment as Fragment33 } from "react/jsx-runtime";
+import { jsx as jsx33, jsxs as jsxs26, Fragment as Fragment33 } from "react/jsx-runtime";
 var DEFAULT3 = false;
 var forSeamlessAacConcatenation = DEFAULT3;
 var cliFlag36 = "for-seamless-aac-concatenation";
 var forSeamlessAacConcatenationOption = {
   name: "For seamless AAC concatenation",
   cliFlag: cliFlag36,
-  description: () => /* @__PURE__ */ jsxs25(Fragment33, {
+  description: () => /* @__PURE__ */ jsxs26(Fragment33, {
     children: [
       "If enabled, the audio is trimmed to the nearest AAC frame, which is required for seamless concatenation of AAC files. This is a requirement if you later want to combine multiple video snippets seamlessly.",
       /* @__PURE__ */ jsx33("br", {}),
@@ -2302,7 +2358,7 @@ var validateSelectedFrames = ({
 };
 
 // src/options/frames.tsx
-import { jsx as jsx35, jsxs as jsxs26, Fragment as Fragment35 } from "react/jsx-runtime";
+import { jsx as jsx35, jsxs as jsxs27, Fragment as Fragment35 } from "react/jsx-runtime";
 var cliFlag38 = "frames";
 var frameSelection = null;
 var parseFrameRangeFromCli = (newFrameRange) => {
@@ -2381,7 +2437,7 @@ var parseFrameRangeFromCli = (newFrameRange) => {
 var framesOption = {
   name: "Frame Range",
   cliFlag: cliFlag38,
-  description: () => /* @__PURE__ */ jsxs26(Fragment35, {
+  description: () => /* @__PURE__ */ jsxs27(Fragment35, {
     children: [
       "Render a subset of a video. Pass a single number to render a still, or a range (e.g. ",
       /* @__PURE__ */ jsx35("code", {
@@ -2432,7 +2488,7 @@ var framesOption = {
 
 // src/options/gl.tsx
 import { NoReactInternals as NoReactInternals2 } from "remotion/no-react";
-import { jsx as jsx36, jsxs as jsxs27, Fragment as Fragment36 } from "react/jsx-runtime";
+import { jsx as jsx36, jsxs as jsxs28, Fragment as Fragment36 } from "react/jsx-runtime";
 var validOpenGlRenderers = [
   "swangle",
   "angle",
@@ -2447,15 +2503,15 @@ var getDefaultOpenGlRenderer = (enableV5BreakingChanges) => {
 var DEFAULT_OPENGL_RENDERER = getDefaultOpenGlRenderer(NoReactInternals2.ENABLE_V5_BREAKING_CHANGES);
 var openGlRenderer = DEFAULT_OPENGL_RENDERER;
 var AngleChangelog = () => {
-  return /* @__PURE__ */ jsxs27("details", {
+  return /* @__PURE__ */ jsxs28("details", {
     style: { fontSize: "0.9em", marginBottom: "1em" },
     children: [
       /* @__PURE__ */ jsx36("summary", {
         children: "Changelog"
       }),
-      /* @__PURE__ */ jsxs27("ul", {
+      /* @__PURE__ */ jsxs28("ul", {
         children: [
-          /* @__PURE__ */ jsxs27("li", {
+          /* @__PURE__ */ jsxs28("li", {
             children: [
               "From Remotion v2.6.7 until v3.0.7, the default for Remotion Lambda was",
               " ",
@@ -2470,7 +2526,7 @@ var AngleChangelog = () => {
               " (Swiftshader on Angle) since Chrome 101 added support for it."
             ]
           }),
-          /* @__PURE__ */ jsxs27("li", {
+          /* @__PURE__ */ jsxs28("li", {
             children: [
               "From Remotion v2.4.3 until v2.6.6, the default was ",
               /* @__PURE__ */ jsx36("code", {
@@ -2479,7 +2535,7 @@ var AngleChangelog = () => {
               ", however it turns out to have a small memory leak that could crash long Remotion renders."
             ]
           }),
-          NoReactInternals2.ENABLE_V5_BREAKING_CHANGES ? /* @__PURE__ */ jsxs27("li", {
+          NoReactInternals2.ENABLE_V5_BREAKING_CHANGES ? /* @__PURE__ */ jsxs28("li", {
             children: [
               "From Remotion v5.0, the default is ",
               /* @__PURE__ */ jsx36("code", {
@@ -2501,17 +2557,17 @@ var glOption = {
   type: "angle",
   ssrName: "gl",
   description: () => {
-    return /* @__PURE__ */ jsxs27(Fragment36, {
+    return /* @__PURE__ */ jsxs28(Fragment36, {
       children: [
         /* @__PURE__ */ jsx36(AngleChangelog, {}),
-        /* @__PURE__ */ jsxs27("p", {
+        /* @__PURE__ */ jsxs28("p", {
           children: [
             "Select the OpenGL renderer backend for Chromium. ",
             /* @__PURE__ */ jsx36("br", {}),
             "Accepted values:"
           ]
         }),
-        /* @__PURE__ */ jsxs27("ul", {
+        /* @__PURE__ */ jsxs28("ul", {
           children: [
             /* @__PURE__ */ jsx36("li", {
               children: /* @__PURE__ */ jsx36("code", {
@@ -2533,7 +2589,7 @@ var glOption = {
                 children: '"swangle"'
               })
             }),
-            /* @__PURE__ */ jsxs27("li", {
+            /* @__PURE__ */ jsxs28("li", {
               children: [
                 /* @__PURE__ */ jsx36("code", {
                   children: '"vulkan"'
@@ -2545,7 +2601,7 @@ var glOption = {
                 ")"
               ]
             }),
-            /* @__PURE__ */ jsxs27("li", {
+            /* @__PURE__ */ jsxs28("li", {
               children: [
                 /* @__PURE__ */ jsx36("code", {
                   children: '"angle-egl"'
@@ -2559,7 +2615,7 @@ var glOption = {
             })
           ]
         }),
-        /* @__PURE__ */ jsxs27("p", {
+        /* @__PURE__ */ jsxs28("p", {
           children: [
             "The default is",
             " ",
@@ -2612,7 +2668,7 @@ var validateOpenGlRenderer = (option2) => {
 };
 
 // src/options/gop-size.tsx
-import { jsx as jsx37, jsxs as jsxs28, Fragment as Fragment37 } from "react/jsx-runtime";
+import { jsx as jsx37, jsxs as jsxs29, Fragment as Fragment37 } from "react/jsx-runtime";
 var gopSize = null;
 var validateGopSize = (value) => {
   if (value === null) {
@@ -2626,7 +2682,7 @@ var cliFlag40 = "gop";
 var gopSizeOption = {
   name: "GOP size",
   cliFlag: cliFlag40,
-  description: () => /* @__PURE__ */ jsxs28(Fragment37, {
+  description: () => /* @__PURE__ */ jsxs29(Fragment37, {
     children: [
       "Set the maximum number of frames between two keyframes. This maps to FFmpeg's ",
       /* @__PURE__ */ jsx37("code", {
@@ -2706,14 +2762,14 @@ var hardwareAccelerationOption = {
 };
 
 // src/options/headless.tsx
-import { jsx as jsx38, jsxs as jsxs29, Fragment as Fragment38 } from "react/jsx-runtime";
+import { jsx as jsx38, jsxs as jsxs30, Fragment as Fragment38 } from "react/jsx-runtime";
 var DEFAULT4 = true;
 var headlessMode = DEFAULT4;
 var cliFlag42 = "disable-headless";
 var headlessOption = {
   name: "Disable Headless Mode",
   cliFlag: cliFlag42,
-  description: () => /* @__PURE__ */ jsxs29(Fragment38, {
+  description: () => /* @__PURE__ */ jsxs30(Fragment38, {
     children: [
       "If disabled, the render will open an actual Chrome window where you can see the render happen. This requires",
       " ",
@@ -2790,13 +2846,13 @@ var ignoreCertificateErrorsOption = {
 };
 
 // src/options/image-sequence.tsx
-import { jsx as jsx40, jsxs as jsxs30, Fragment as Fragment40 } from "react/jsx-runtime";
+import { jsx as jsx40, jsxs as jsxs31, Fragment as Fragment40 } from "react/jsx-runtime";
 var cliFlag44 = "sequence";
 var imageSequence = false;
 var imageSequenceOption = {
   name: "Image Sequence",
   cliFlag: cliFlag44,
-  description: () => /* @__PURE__ */ jsxs30(Fragment40, {
+  description: () => /* @__PURE__ */ jsxs31(Fragment40, {
     children: [
       "Pass this flag to output an image sequence instead of a video. The default image format is JPEG. See",
       " ",
@@ -2832,14 +2888,14 @@ var imageSequenceOption = {
 };
 
 // src/options/image-sequence-pattern.tsx
-import { jsx as jsx41, jsxs as jsxs31, Fragment as Fragment41 } from "react/jsx-runtime";
+import { jsx as jsx41, jsxs as jsxs32, Fragment as Fragment41 } from "react/jsx-runtime";
 var cliFlag45 = "image-sequence-pattern";
 var currentImageSequencePattern = null;
 var imageSequencePatternOption = {
   name: "Image Sequence Pattern",
   cliFlag: cliFlag45,
   ssrName: "imageSequencePattern",
-  description: () => /* @__PURE__ */ jsxs31(Fragment41, {
+  description: () => /* @__PURE__ */ jsxs32(Fragment41, {
     children: [
       "Pattern for naming image sequence files. Supports ",
       /* @__PURE__ */ jsx41("code", {
@@ -2946,13 +3002,13 @@ var ipv4Option = {
 };
 
 // src/options/is-production.tsx
-import { jsx as jsx44, jsxs as jsxs32, Fragment as Fragment44 } from "react/jsx-runtime";
+import { jsx as jsx44, jsxs as jsxs33, Fragment as Fragment44 } from "react/jsx-runtime";
 var cliFlag48 = "is-production";
 var currentIsProductionKey = null;
 var isProductionOption = {
   name: "Is Production",
   cliFlag: cliFlag48,
-  description: () => /* @__PURE__ */ jsxs32(Fragment44, {
+  description: () => /* @__PURE__ */ jsxs33(Fragment44, {
     children: [
       "Pass ",
       /* @__PURE__ */ jsx44("code", {
@@ -3078,13 +3134,13 @@ var keyboardShortcutsOption = {
 };
 
 // src/options/latency-hint.tsx
-import { jsx as jsx47, jsxs as jsxs33, Fragment as Fragment47 } from "react/jsx-runtime";
+import { jsx as jsx47, jsxs as jsxs34, Fragment as Fragment47 } from "react/jsx-runtime";
 var cliFlag51 = "audio-latency-hint";
 var value = null;
 var audioLatencyHintOption = {
   name: "Audio Latency Hint",
   cliFlag: cliFlag51,
-  description: () => /* @__PURE__ */ jsxs33(Fragment47, {
+  description: () => /* @__PURE__ */ jsxs34(Fragment47, {
     children: [
       "Sets the",
       " ",
@@ -3138,13 +3194,13 @@ var audioLatencyHintOption = {
 };
 
 // src/options/license-key.tsx
-import { jsx as jsx48, jsxs as jsxs34, Fragment as Fragment48 } from "react/jsx-runtime";
+import { jsx as jsx48, jsxs as jsxs35, Fragment as Fragment48 } from "react/jsx-runtime";
 var currentLicenseKey = null;
 var cliFlag52 = "license-key";
 var licenseKeyOption = {
   name: "License key",
   cliFlag: cliFlag52,
-  description: () => /* @__PURE__ */ jsxs34(Fragment48, {
+  description: () => /* @__PURE__ */ jsxs35(Fragment48, {
     children: [
       "License key for sending a usage event using",
       " ",
@@ -3176,7 +3232,7 @@ var licenseKeyOption = {
 };
 
 // src/options/log-level.tsx
-import { jsx as jsx49, jsxs as jsxs35, Fragment as Fragment49 } from "react/jsx-runtime";
+import { jsx as jsx49, jsxs as jsxs36, Fragment as Fragment49 } from "react/jsx-runtime";
 var logLevel = "info";
 var configuredLogLevel = null;
 var cliFlag53 = "log";
@@ -3184,7 +3240,7 @@ var logLevelOption = {
   cliFlag: cliFlag53,
   name: "Log Level",
   ssrName: "logLevel",
-  description: () => /* @__PURE__ */ jsxs35(Fragment49, {
+  description: () => /* @__PURE__ */ jsxs36(Fragment49, {
     children: [
       "One of ",
       /* @__PURE__ */ jsx49("code", {
@@ -3246,7 +3302,7 @@ var logLevelOption = {
 };
 
 // src/options/metadata.tsx
-import { jsx as jsx50, jsxs as jsxs36, Fragment as Fragment50 } from "react/jsx-runtime";
+import { jsx as jsx50, jsxs as jsxs37, Fragment as Fragment50 } from "react/jsx-runtime";
 var metadata = {};
 var cliFlag54 = "metadata";
 var metadataOption = {
@@ -3254,7 +3310,7 @@ var metadataOption = {
   cliFlag: cliFlag54,
   description: (mode) => {
     if (mode === "ssr") {
-      return /* @__PURE__ */ jsxs36(Fragment50, {
+      return /* @__PURE__ */ jsxs37(Fragment50, {
         children: [
           "An object containing metadata to be embedded in the video. See",
           " ",
@@ -3266,7 +3322,7 @@ var metadataOption = {
         ]
       });
     }
-    return /* @__PURE__ */ jsxs36(Fragment50, {
+    return /* @__PURE__ */ jsxs37(Fragment50, {
       children: [
         "Metadata to be embedded in the video. See",
         " ",
@@ -3393,7 +3449,7 @@ var noOpenOption = {
 };
 
 // src/options/number-of-gif-loops.tsx
-import { jsx as jsx53, jsxs as jsxs37, Fragment as Fragment53 } from "react/jsx-runtime";
+import { jsx as jsx53, jsxs as jsxs38, Fragment as Fragment53 } from "react/jsx-runtime";
 var currentLoop = null;
 var validate = (newLoop) => {
   if (newLoop !== null && typeof newLoop !== "number") {
@@ -3405,12 +3461,12 @@ var numberOfGifLoopsOption = {
   name: "Number of GIF loops",
   cliFlag: cliFlag57,
   description: () => {
-    return /* @__PURE__ */ jsxs37(Fragment53, {
+    return /* @__PURE__ */ jsxs38(Fragment53, {
       children: [
         "Allows you to set the number of loops as follows:",
-        /* @__PURE__ */ jsxs37("ul", {
+        /* @__PURE__ */ jsxs38("ul", {
           children: [
-            /* @__PURE__ */ jsxs37("li", {
+            /* @__PURE__ */ jsxs38("li", {
               children: [
                 /* @__PURE__ */ jsx53("code", {
                   children: "null"
@@ -3418,7 +3474,7 @@ var numberOfGifLoopsOption = {
                 " (or omitting in the CLI) plays the GIF indefinitely."
               ]
             }),
-            /* @__PURE__ */ jsxs37("li", {
+            /* @__PURE__ */ jsxs38("li", {
               children: [
                 /* @__PURE__ */ jsx53("code", {
                   children: "0"
@@ -3426,7 +3482,7 @@ var numberOfGifLoopsOption = {
                 " disables looping"
               ]
             }),
-            /* @__PURE__ */ jsxs37("li", {
+            /* @__PURE__ */ jsxs38("li", {
               children: [
                 /* @__PURE__ */ jsx53("code", {
                   children: "1"
@@ -3434,7 +3490,7 @@ var numberOfGifLoopsOption = {
                 " loops the GIF once (plays twice in total)"
               ]
             }),
-            /* @__PURE__ */ jsxs37("li", {
+            /* @__PURE__ */ jsxs38("li", {
               children: [
                 /* @__PURE__ */ jsx53("code", {
                   children: "2"
@@ -3477,14 +3533,14 @@ var numberOfGifLoopsOption = {
 };
 
 // src/options/number-of-shared-audio-tags.tsx
-import { jsx as jsx54, jsxs as jsxs38, Fragment as Fragment54 } from "react/jsx-runtime";
+import { jsx as jsx54, jsxs as jsxs39, Fragment as Fragment54 } from "react/jsx-runtime";
 var numberOfSharedAudioTags = 0;
 var configuredNumberOfSharedAudioTags = null;
 var cliFlag58 = "number-of-shared-audio-tags";
 var numberOfSharedAudioTagsOption = {
   name: "Number of shared audio tags",
   cliFlag: cliFlag58,
-  description: () => /* @__PURE__ */ jsxs38(Fragment54, {
+  description: () => /* @__PURE__ */ jsxs39(Fragment54, {
     children: [
       "Set number of shared audio tags. See",
       " ",
@@ -3524,13 +3580,13 @@ var numberOfSharedAudioTagsOption = {
 };
 
 // src/options/offthreadvideo-cache-size.tsx
-import { jsx as jsx55, jsxs as jsxs39, Fragment as Fragment55 } from "react/jsx-runtime";
+import { jsx as jsx55, jsxs as jsxs40, Fragment as Fragment55 } from "react/jsx-runtime";
 var offthreadVideoCacheSizeInBytes = null;
 var cliFlag59 = "offthreadvideo-cache-size-in-bytes";
 var offthreadVideoCacheSizeInBytesOption = {
   name: "OffthreadVideo cache size",
   cliFlag: cliFlag59,
-  description: () => /* @__PURE__ */ jsxs39(Fragment55, {
+  description: () => /* @__PURE__ */ jsxs40(Fragment55, {
     children: [
       "From v4.0, Remotion has a cache for",
       " ",
@@ -3585,13 +3641,13 @@ var offthreadVideoCacheSizeInBytesOption = {
 };
 
 // src/options/offthreadvideo-threads.tsx
-import { jsx as jsx56, jsxs as jsxs40, Fragment as Fragment56 } from "react/jsx-runtime";
+import { jsx as jsx56, jsxs as jsxs41, Fragment as Fragment56 } from "react/jsx-runtime";
 var value2 = null;
 var cliFlag60 = "offthreadvideo-video-threads";
 var offthreadVideoThreadsOption = {
   name: "OffthreadVideo threads",
   cliFlag: cliFlag60,
-  description: () => /* @__PURE__ */ jsxs40(Fragment56, {
+  description: () => /* @__PURE__ */ jsxs41(Fragment56, {
     children: [
       "The number of threads that",
       /* @__PURE__ */ jsx56("a", {
@@ -3636,12 +3692,12 @@ var offthreadVideoThreadsOption = {
 var DEFAULT_RENDER_FRAMES_OFFTHREAD_VIDEO_THREADS = 2;
 
 // src/options/on-browser-download.tsx
-import { jsx as jsx57, jsxs as jsxs41, Fragment as Fragment57 } from "react/jsx-runtime";
+import { jsx as jsx57, jsxs as jsxs42, Fragment as Fragment57 } from "react/jsx-runtime";
 var cliFlag61 = "on-browser-download";
 var onBrowserDownloadOption = {
   name: "Browser download callback function",
   cliFlag: cliFlag61,
-  description: () => /* @__PURE__ */ jsxs41(Fragment57, {
+  description: () => /* @__PURE__ */ jsxs42(Fragment57, {
     children: [
       "Gets called when no compatible local browser is detected on the system and this API needs to download a browser. Return a callback to observe progress.",
       " ",
@@ -3664,14 +3720,14 @@ var onBrowserDownloadOption = {
 };
 
 // src/options/out-dir.tsx
-import { jsx as jsx58, jsxs as jsxs42, Fragment as Fragment58 } from "react/jsx-runtime";
+import { jsx as jsx58, jsxs as jsxs43, Fragment as Fragment58 } from "react/jsx-runtime";
 var cliFlag62 = "out-dir";
 var currentOutDir = null;
 var outDirOption = {
   name: "Output Directory",
   cliFlag: cliFlag62,
   description: () => {
-    return /* @__PURE__ */ jsxs42(Fragment58, {
+    return /* @__PURE__ */ jsxs43(Fragment58, {
       children: [
         "Define the location of the resulting bundle. By default it is a folder called ",
         /* @__PURE__ */ jsx58("code", {
@@ -3899,7 +3955,7 @@ var overrideWidthOption = {
 };
 
 // src/options/overwrite.tsx
-import { jsx as jsx63, jsxs as jsxs43, Fragment as Fragment63 } from "react/jsx-runtime";
+import { jsx as jsx63, jsxs as jsxs44, Fragment as Fragment63 } from "react/jsx-runtime";
 var shouldOverwrite = null;
 var cliFlag67 = "overwrite";
 var validate2 = (value3) => {
@@ -3910,7 +3966,7 @@ var validate2 = (value3) => {
 var overwriteOption = {
   name: "Overwrite output",
   cliFlag: cliFlag67,
-  description: () => /* @__PURE__ */ jsxs43(Fragment63, {
+  description: () => /* @__PURE__ */ jsxs44(Fragment63, {
     children: [
       "If set to ",
       /* @__PURE__ */ jsx63("code", {
@@ -3956,14 +4012,14 @@ var overwriteOption = {
 };
 
 // src/options/package-manager.tsx
-import { jsx as jsx64, jsxs as jsxs44, Fragment as Fragment64 } from "react/jsx-runtime";
+import { jsx as jsx64, jsxs as jsxs45, Fragment as Fragment64 } from "react/jsx-runtime";
 var cliFlag68 = "package-manager";
 var currentPackageManager = null;
 var packageManagerOption = {
   name: "Package Manager",
   cliFlag: cliFlag68,
   description: () => {
-    return /* @__PURE__ */ jsxs44(Fragment64, {
+    return /* @__PURE__ */ jsxs45(Fragment64, {
       children: [
         "Forces a specific package manager to be used. By default, Remotion will auto-detect the package manager based on your lockfile.",
         /* @__PURE__ */ jsx64("br", {}),
@@ -4039,13 +4095,13 @@ var validPixelFormatsForCodec = (codec) => {
 };
 
 // src/options/pixel-format.tsx
-import { jsx as jsx65, jsxs as jsxs45, Fragment as Fragment65 } from "react/jsx-runtime";
+import { jsx as jsx65, jsxs as jsxs46, Fragment as Fragment65 } from "react/jsx-runtime";
 var currentPixelFormat = DEFAULT_PIXEL_FORMAT;
 var cliFlag69 = "pixel-format";
 var pixelFormatOption = {
   name: "Pixel format",
   cliFlag: cliFlag69,
-  description: () => /* @__PURE__ */ jsxs45(Fragment65, {
+  description: () => /* @__PURE__ */ jsxs46(Fragment65, {
     children: [
       "Sets the pixel format in FFmpeg. See",
       " ",
@@ -4138,13 +4194,13 @@ var portOption = {
 };
 
 // src/options/prefer-lossless.tsx
-import { jsx as jsx67, jsxs as jsxs46, Fragment as Fragment67 } from "react/jsx-runtime";
+import { jsx as jsx67, jsxs as jsxs47, Fragment as Fragment67 } from "react/jsx-runtime";
 var cliFlag71 = "prefer-lossless";
 var input = false;
 var preferLosslessAudioOption = {
   name: "Prefer lossless",
   cliFlag: cliFlag71,
-  description: () => /* @__PURE__ */ jsxs46(Fragment67, {
+  description: () => /* @__PURE__ */ jsxs47(Fragment67, {
     children: [
       "Uses a lossless audio codec, if one is available for the codec. If you set",
       /* @__PURE__ */ jsx67("code", {
@@ -4177,13 +4233,13 @@ var preferLosslessAudioOption = {
 };
 
 // src/options/preview-sample-rate.tsx
-import { jsx as jsx68, jsxs as jsxs47, Fragment as Fragment68 } from "react/jsx-runtime";
+import { jsx as jsx68, jsxs as jsxs48, Fragment as Fragment68 } from "react/jsx-runtime";
 var cliFlag72 = "preview-sample-rate";
 var currentPreviewSampleRate = null;
 var previewSampleRateOption = {
   name: "Preview Sample Rate",
   cliFlag: cliFlag72,
-  description: () => /* @__PURE__ */ jsxs47(Fragment68, {
+  description: () => /* @__PURE__ */ jsxs48(Fragment68, {
     children: [
       "Controls the sample rate used for audio playback during preview. When unset, Remotion uses ",
       /* @__PURE__ */ jsx68("code", {
@@ -4211,15 +4267,15 @@ var previewSampleRateOption = {
 };
 
 // src/options/props.tsx
-import { jsx as jsx69, jsxs as jsxs48, Fragment as Fragment69 } from "react/jsx-runtime";
+import { jsx as jsx69, jsxs as jsxs49, Fragment as Fragment69 } from "react/jsx-runtime";
 var cliFlag73 = "props";
 var propsOption = {
   name: "Input Props",
   cliFlag: cliFlag73,
-  description: () => /* @__PURE__ */ jsxs48(Fragment69, {
+  description: () => /* @__PURE__ */ jsxs49(Fragment69, {
     children: [
       "Input Props to pass to the selected composition of your video. Must be a serialized JSON string (",
-      /* @__PURE__ */ jsxs48("code", {
+      /* @__PURE__ */ jsxs49("code", {
         children: [
           "--props='",
           "{",
@@ -4257,7 +4313,7 @@ var propsOption = {
 };
 
 // src/options/prores-profile.tsx
-import { jsx as jsx70, jsxs as jsxs49, Fragment as Fragment70 } from "react/jsx-runtime";
+import { jsx as jsx70, jsxs as jsxs50, Fragment as Fragment70 } from "react/jsx-runtime";
 var validProResProfiles = [
   "4444-xq",
   "4444",
@@ -4271,7 +4327,7 @@ var cliFlag74 = "prores-profile";
 var proResProfileOption = {
   name: "ProRes profile",
   cliFlag: cliFlag74,
-  description: () => /* @__PURE__ */ jsxs49(Fragment70, {
+  description: () => /* @__PURE__ */ jsxs50(Fragment70, {
     children: [
       "Set the ProRes profile. This option is only valid if the codec has been set to ",
       /* @__PURE__ */ jsx70("code", {
@@ -4334,14 +4390,14 @@ var proResProfileOption = {
 };
 
 // src/options/public-dir.tsx
-import { jsx as jsx71, jsxs as jsxs50, Fragment as Fragment71 } from "react/jsx-runtime";
+import { jsx as jsx71, jsxs as jsxs51, Fragment as Fragment71 } from "react/jsx-runtime";
 var cliFlag75 = "public-dir";
 var currentPublicDir = null;
 var publicDirOption = {
   name: "Public Directory",
   cliFlag: cliFlag75,
   description: () => {
-    return /* @__PURE__ */ jsxs50(Fragment71, {
+    return /* @__PURE__ */ jsxs51(Fragment71, {
       children: [
         "Define the location of the",
         " ",
@@ -4383,13 +4439,13 @@ var publicDirOption = {
 };
 
 // src/options/public-license-key.tsx
-import { jsx as jsx72, jsxs as jsxs51, Fragment as Fragment72 } from "react/jsx-runtime";
+import { jsx as jsx72, jsxs as jsxs52, Fragment as Fragment72 } from "react/jsx-runtime";
 var cliFlag76 = "public-license-key";
 var currentPublicLicenseKey = null;
 var publicLicenseKeyOption = {
   name: "Public License Key",
   cliFlag: cliFlag76,
-  description: () => /* @__PURE__ */ jsxs51(Fragment72, {
+  description: () => /* @__PURE__ */ jsxs52(Fragment72, {
     children: [
       "The public license key for your company license, obtained from the License keys page on ",
       /* @__PURE__ */ jsx72("a", {
@@ -4430,14 +4486,14 @@ var publicLicenseKeyOption = {
 };
 
 // src/options/public-path.tsx
-import { jsx as jsx73, jsxs as jsxs52, Fragment as Fragment73 } from "react/jsx-runtime";
+import { jsx as jsx73, jsxs as jsxs53, Fragment as Fragment73 } from "react/jsx-runtime";
 var cliFlag77 = "public-path";
 var currentPublicPath = null;
 var publicPathOption = {
   name: "Public Path",
   cliFlag: cliFlag77,
   description: () => {
-    return /* @__PURE__ */ jsxs52(Fragment73, {
+    return /* @__PURE__ */ jsxs53(Fragment73, {
       children: [
         "The path of the URL where the bundle is going to be hosted. By default it is ",
         /* @__PURE__ */ jsx73("code", {
@@ -4555,14 +4611,14 @@ var rspackOption = {
 };
 
 // src/options/runs.tsx
-import { jsx as jsx76, jsxs as jsxs53, Fragment as Fragment76 } from "react/jsx-runtime";
+import { jsx as jsx76, jsxs as jsxs54, Fragment as Fragment76 } from "react/jsx-runtime";
 var DEFAULT_RUNS = 3;
 var currentRuns = DEFAULT_RUNS;
 var cliFlag80 = "runs";
 var runsOption = {
   name: "Benchmark runs",
   cliFlag: cliFlag80,
-  description: () => /* @__PURE__ */ jsxs53(Fragment76, {
+  description: () => /* @__PURE__ */ jsxs54(Fragment76, {
     children: [
       "Specify how many times the video should be rendered during a benchmark. Default ",
       /* @__PURE__ */ jsx76("code", {
@@ -4597,13 +4653,13 @@ var runsOption = {
 };
 
 // src/options/sample-rate.tsx
-import { jsx as jsx77, jsxs as jsxs54, Fragment as Fragment77 } from "react/jsx-runtime";
+import { jsx as jsx77, jsxs as jsxs55, Fragment as Fragment77 } from "react/jsx-runtime";
 var cliFlag81 = "sample-rate";
 var currentSampleRate = 48000;
 var sampleRateOption = {
   name: "Sample Rate",
   cliFlag: cliFlag81,
-  description: () => /* @__PURE__ */ jsxs54(Fragment77, {
+  description: () => /* @__PURE__ */ jsxs55(Fragment77, {
     children: [
       "Controls the sample rate of the output audio. The default is",
       " ",
@@ -4638,7 +4694,7 @@ var sampleRateOption = {
 };
 
 // src/options/scale.tsx
-import { jsx as jsx78, jsxs as jsxs55, Fragment as Fragment78 } from "react/jsx-runtime";
+import { jsx as jsx78, jsxs as jsxs56, Fragment as Fragment78 } from "react/jsx-runtime";
 var currentScale = 1;
 var cliFlag82 = "scale";
 var validateScale = (value3) => {
@@ -4649,7 +4705,7 @@ var validateScale = (value3) => {
 var scaleOption = {
   name: "Scale",
   cliFlag: cliFlag82,
-  description: () => /* @__PURE__ */ jsxs55(Fragment78, {
+  description: () => /* @__PURE__ */ jsxs56(Fragment78, {
     children: [
       "Scales the output dimensions by a factor. For example, a 1280x720px frame will become a 1920x1080px frame with a scale factor of ",
       /* @__PURE__ */ jsx78("code", {
@@ -4723,7 +4779,7 @@ var skipSkillsOption = {
 
 // src/options/still-frame.tsx
 import { NoReactInternals as NoReactInternals4 } from "remotion/no-react";
-import { jsx as jsx80, jsxs as jsxs56, Fragment as Fragment80 } from "react/jsx-runtime";
+import { jsx as jsx80, jsxs as jsxs57, Fragment as Fragment80 } from "react/jsx-runtime";
 var cliFlag84 = "frame";
 var currentFrame = null;
 var validate3 = (frame) => {
@@ -4736,7 +4792,7 @@ var validate3 = (frame) => {
 var stillFrameOption = {
   name: "Frame",
   cliFlag: cliFlag84,
-  description: () => /* @__PURE__ */ jsxs56(Fragment80, {
+  description: () => /* @__PURE__ */ jsxs57(Fragment80, {
     children: [
       "Which frame should be rendered when rendering a still. Default",
       " ",
@@ -4784,13 +4840,13 @@ var stillFrameOption = {
 };
 
 // src/options/still-image-format.tsx
-import { jsx as jsx81, jsxs as jsxs57, Fragment as Fragment81 } from "react/jsx-runtime";
+import { jsx as jsx81, jsxs as jsxs58, Fragment as Fragment81 } from "react/jsx-runtime";
 var currentStillImageFormat = null;
 var cliFlag85 = "image-format";
 var stillImageFormatOption = {
   name: "Still Image Format",
   cliFlag: cliFlag85,
-  description: () => /* @__PURE__ */ jsxs57(Fragment81, {
+  description: () => /* @__PURE__ */ jsxs58(Fragment81, {
     children: [
       "The image format to use when rendering a still. Must be one of",
       " ",
@@ -4873,7 +4929,7 @@ var throwIfSiteExistsOption = {
 };
 
 // src/options/timeout.tsx
-import { jsx as jsx82, jsxs as jsxs58, Fragment as Fragment82 } from "react/jsx-runtime";
+import { jsx as jsx82, jsxs as jsxs59, Fragment as Fragment82 } from "react/jsx-runtime";
 var currentTimeout = DEFAULT_TIMEOUT;
 var validate4 = (value3) => {
   if (typeof value3 !== "number") {
@@ -4884,7 +4940,7 @@ var cliFlag87 = "timeout";
 var delayRenderTimeoutInMillisecondsOption = {
   name: "delayRender() timeout",
   cliFlag: cliFlag87,
-  description: () => /* @__PURE__ */ jsxs58(Fragment82, {
+  description: () => /* @__PURE__ */ jsxs59(Fragment82, {
     children: [
       "A number describing how long the render may take to resolve all",
       " ",
@@ -5005,13 +5061,13 @@ var versionFlagOption = {
 };
 
 // src/options/video-bitrate.tsx
-import { jsx as jsx85, jsxs as jsxs59, Fragment as Fragment85 } from "react/jsx-runtime";
+import { jsx as jsx85, jsxs as jsxs60, Fragment as Fragment85 } from "react/jsx-runtime";
 var videoBitrate = null;
 var cliFlag90 = "video-bitrate";
 var videoBitrateOption = {
   name: "Video Bitrate",
   cliFlag: cliFlag90,
-  description: () => /* @__PURE__ */ jsxs59(Fragment85, {
+  description: () => /* @__PURE__ */ jsxs60(Fragment85, {
     children: [
       "Specify the target bitrate for the generated video. The syntax for FFmpeg",
       "'",
@@ -5058,13 +5114,13 @@ var videoBitrateOption = {
 };
 
 // src/options/video-cache-size.tsx
-import { jsx as jsx86, jsxs as jsxs60, Fragment as Fragment86 } from "react/jsx-runtime";
+import { jsx as jsx86, jsxs as jsxs61, Fragment as Fragment86 } from "react/jsx-runtime";
 var mediaCacheSizeInBytes = null;
 var cliFlag91 = "media-cache-size-in-bytes";
 var mediaCacheSizeInBytesOption = {
   name: "@remotion/media cache size",
   cliFlag: cliFlag91,
-  description: () => /* @__PURE__ */ jsxs60(Fragment86, {
+  description: () => /* @__PURE__ */ jsxs61(Fragment86, {
     children: [
       "Specify the memory budget for decoded media cached by",
       " ",
@@ -5332,13 +5388,13 @@ var videoCodecOption = {
 };
 
 // src/options/video-image-format.tsx
-import { jsx as jsx88, jsxs as jsxs61, Fragment as Fragment88 } from "react/jsx-runtime";
+import { jsx as jsx88, jsxs as jsxs62, Fragment as Fragment88 } from "react/jsx-runtime";
 var currentVideoImageFormat = null;
 var cliFlag93 = "image-format";
 var videoImageFormatOption = {
   name: "Video Image Format",
   cliFlag: cliFlag93,
-  description: () => /* @__PURE__ */ jsxs61(Fragment88, {
+  description: () => /* @__PURE__ */ jsxs62(Fragment88, {
     children: [
       "The image format to use when rendering frames for a video. Must be one of",
       " ",
@@ -5426,12 +5482,12 @@ var videoImageFormatOption = {
 };
 
 // src/options/webhook-custom-data.tsx
-import { jsxs as jsxs62, Fragment as Fragment89 } from "react/jsx-runtime";
+import { jsxs as jsxs63, Fragment as Fragment89 } from "react/jsx-runtime";
 var cliFlag94 = "webhook-custom-data";
 var webhookCustomDataOption = {
   name: "Webhook custom data",
   cliFlag: cliFlag94,
-  description: (type) => /* @__PURE__ */ jsxs62(Fragment89, {
+  description: (type) => /* @__PURE__ */ jsxs63(Fragment89, {
     children: [
       "Pass up to 1,024 bytes of a JSON-serializable object to the webhook. This data will be included in the webhook payload.",
       " ",
@@ -5495,7 +5551,7 @@ var webpackPollOption = {
 };
 
 // src/options/x264-preset.tsx
-import { jsx as jsx90, jsxs as jsxs63, Fragment as Fragment91 } from "react/jsx-runtime";
+import { jsx as jsx90, jsxs as jsxs64, Fragment as Fragment91 } from "react/jsx-runtime";
 var x264PresetOptions = [
   "ultrafast",
   "superfast",
@@ -5514,7 +5570,7 @@ var DEFAULT_PRESET = "medium";
 var x264Option = {
   name: "x264 Preset",
   cliFlag: cliFlag96,
-  description: () => /* @__PURE__ */ jsxs63(Fragment91, {
+  description: () => /* @__PURE__ */ jsxs64(Fragment91, {
     children: [
       "Sets a x264 preset profile. Only applies to videos rendered with",
       " ",

package/dist/esm/index.mjs

@@ -19493,7 +19493,7 @@ var DEFAULT = null;
 var cliFlag = "separate-audio-to";
 var separateAudioOption = {
   cliFlag,
-  description: () => `If set, the audio will not be included in the main output but rendered as a separate file at the location you pass. It is recommended to use an absolute path. If a relative path is passed, it is relative to the Remotion Root.`,
+  description: () => `If set, the audio will not be included in the main output but rendered as a separate file at the location you pass. If the render contains no audio, a silent audio file is produced even when enforceAudioTrack is false. The muted option still takes precedence. It is recommended to use an absolute path. If a relative path is passed, it is relative to the Remotion Root.`,
   docLink: "https://remotion.dev/docs/renderer/render-media",
   getValue: ({ commandLine }) => {
     if (commandLine[cliFlag]) {
@@ -23284,7 +23284,8 @@ var createAudio = async ({
   trimLeftOffset,
   trimRightOffset,
   forSeamlessAacConcatenation,
-  sampleRate
+  sampleRate,
+  enforceAudioTrack
 }) => {
   const fileUrlAssets = await convertAssetsToFileUrls({
     assets,
@@ -23363,6 +23364,11 @@ var createAudio = async ({
       })
     ] : []
   ];
+  if (!enforceAudioTrack && preprocessed.length === 0) {
+    deleteDirectory(downloadMap.audioMixing);
+    onProgress(1);
+    return null;
+  }
   const merged = path27.join(downloadMap.audioPreprocessing, "merged.wav");
   const extension = getExtensionFromAudioCodec(audioCodec);
   const outName = path27.join(downloadMap.audioPreprocessing, `audio.${extension}`);
@@ -23524,7 +23530,10 @@ var getShouldRenderAudio = ({
   if (assetsInfo === null) {
     return "maybe";
   }
-  return assetsInfo.assets.flat(1).length > 0 ? "yes" : "no";
+  if (!codecSupportsMedia(codec).video) {
+    return "yes";
+  }
+  return assetsInfo.assets.some((frame) => frame.audioAndVideoAssets.length > 0 || frame.inlineAudioAssets.length > 0) ? "yes" : "no";
 };
 
 // src/validate-videobitrate.ts
@@ -23605,10 +23614,11 @@ var innerStitchFramesToVideo = async ({
   assetsInfo.downloadMap.preventCleanup();
   const proResProfileName = getProResProfileName(codec, proResProfile);
   const mediaSupport = codecSupportsMedia(codec);
+  const enforceAudioTrackForOutput = enforceAudioTrack || Boolean(separateAudioTo);
   const renderAudioEvaluation = getShouldRenderAudio({
     assetsInfo,
     codec,
-    enforceAudioTrack,
+    enforceAudioTrack: enforceAudioTrackForOutput,
     muted
   });
   if (renderAudioEvaluation === "maybe") {
@@ -23690,7 +23700,8 @@ var innerStitchFramesToVideo = async ({
     trimLeftOffset: assetsInfo.trimLeftOffset,
     trimRightOffset: assetsInfo.trimRightOffset,
     forSeamlessAacConcatenation: assetsInfo.forSeamlessAacConcatenation,
-    sampleRate
+    sampleRate,
+    enforceAudioTrack: enforceAudioTrackForOutput || !shouldRenderVideo
   }) : null;
   if (mediaSupport.audio && !mediaSupport.video) {
     if (!resolvedAudioCodec) {
@@ -23718,6 +23729,9 @@ var innerStitchFramesToVideo = async ({
     assetsInfo.downloadMap.allowCleanup();
     return Promise.resolve(file);
   }
+  if (separateAudioTo && !audio) {
+    throw new Error(`\`separateAudioTo\` was set to ${JSON.stringify(separateAudioTo)}, but this render included no audio. Audio output is disabled by the muted option or selected codec.`);
+  }
   const resolvedHardwareAcceleration = preEncodedFileLocation ? "disable" : resolveHardwareAcceleration({
     codec,
     hardwareAcceleration,
@@ -23801,10 +23815,7 @@ var innerStitchFramesToVideo = async ({
       }
     }
   });
-  if (separateAudioTo) {
-    if (!audio) {
-      throw new Error(`\`separateAudioTo\` was set to ${JSON.stringify(separateAudioTo)}, but this render included no audio`);
-    }
+  if (separateAudioTo && audio) {
     const finalDestination = path29.resolve(remotionRoot, separateAudioTo);
     cpSync2(audio, finalDestination);
     rmSync4(audio);

package/dist/esm/pure.mjs

@@ -315,7 +315,7 @@ var DEFAULT = null;
 var cliFlag = "separate-audio-to";
 var separateAudioOption = {
   cliFlag,
-  description: () => `If set, the audio will not be included in the main output but rendered as a separate file at the location you pass. It is recommended to use an absolute path. If a relative path is passed, it is relative to the Remotion Root.`,
+  description: () => `If set, the audio will not be included in the main output but rendered as a separate file at the location you pass. If the render contains no audio, a silent audio file is produced even when enforceAudioTrack is false. The muted option still takes precedence. It is recommended to use an absolute path. If a relative path is passed, it is relative to the Remotion Root.`,
   docLink: "https://remotion.dev/docs/renderer/render-media",
   getValue: ({ commandLine }) => {
     if (commandLine[cliFlag]) {

package/dist/options/enforce-audio.d.ts

@@ -1,7 +1,7 @@
 export declare const enforceAudioOption: {
     name: string;
     cliFlag: "enforce-audio-track";
-    description: () => import("react/jsx-runtime").JSX.Element;
+    description: (mode: "cli" | "ssr") => import("react/jsx-runtime").JSX.Element;
     ssrName: string;
     docLink: string;
     type: boolean;

package/dist/options/enforce-audio.js

@@ -8,7 +8,21 @@ const cliFlag = 'enforce-audio-track';
 exports.enforceAudioOption = {
     name: 'Enforce Audio Track',
     cliFlag,
-    description: () => (jsx_runtime_1.jsx(jsx_runtime_1.Fragment, { children: "Render a silent audio track if there would be none otherwise." })),
+    description: (mode) => (jsx_runtime_1.jsxs(jsx_runtime_1.Fragment, { children: [
+            jsx_runtime_1.jsxs("p", { children: ["Defaults to ",
+                    jsx_runtime_1.jsx("code", { children: "false" }),
+                    ". If ",
+                    jsx_runtime_1.jsx("code", { children: "true" }),
+                    ", include a silent audio track when the render contains no audio. If ",
+                    jsx_runtime_1.jsx("code", { children: "false" }),
+                    ", omit the audio track when no audio is present. Audio-only exports and", ' ', jsx_runtime_1.jsx("code", { children: mode === 'cli' ? '--separate-audio-to' : 'separateAudioTo' }), ' ', "still produce an audio file, even when silent."] }), jsx_runtime_1.jsxs("p", { children: [mode === 'cli' ? (jsx_runtime_1.jsxs(jsx_runtime_1.Fragment, { children: ["Pass ",
+                            jsx_runtime_1.jsx("code", { children: "--enforce-audio-track" })
+                        ] })) : (jsx_runtime_1.jsxs(jsx_runtime_1.Fragment, { children: ["Set this to ",
+                            jsx_runtime_1.jsx("code", { children: "true" })
+                        ] })), ' ', "for", ' ', jsx_runtime_1.jsx("a", { href: "/docs/distributed-rendering", children: "chunks that will later be concatenated" }),
+                    ", because other chunks may contain audio.", ' ', jsx_runtime_1.jsx("code", { children: mode === 'cli' ? '--muted' : 'muted: true' }),
+                    " takes precedence."] })
+        ] })),
     ssrName: 'enforceAudioTrack',
     docLink: 'https://www.remotion.dev/docs/config#setenforceaudiotrack-',
     type: false,

package/dist/options/index.d.ts

@@ -172,7 +172,7 @@ export declare const allOptions: {
     enforceAudioOption: {
         name: string;
         cliFlag: "enforce-audio-track";
-        description: () => import("react/jsx-runtime").JSX.Element;
+        description: (mode: "cli" | "ssr") => import("react/jsx-runtime").JSX.Element;
         ssrName: string;
         docLink: string;
         type: boolean;

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

@@ -2031,7 +2031,7 @@ export declare const optionsMap: {
         readonly enforceAudioTrack: {
             name: string;
             cliFlag: "enforce-audio-track";
-            description: () => import("react/jsx-runtime").JSX.Element;
+            description: (mode: "cli" | "ssr") => import("react/jsx-runtime").JSX.Element;
             ssrName: string;
             docLink: string;
             type: boolean;

package/dist/options/separate-audio.js

@@ -5,7 +5,7 @@ const DEFAULT = null;
 const cliFlag = 'separate-audio-to';
 exports.separateAudioOption = {
     cliFlag,
-    description: () => `If set, the audio will not be included in the main output but rendered as a separate file at the location you pass. It is recommended to use an absolute path. If a relative path is passed, it is relative to the Remotion Root.`,
+    description: () => `If set, the audio will not be included in the main output but rendered as a separate file at the location you pass. If the render contains no audio, a silent audio file is produced even when enforceAudioTrack is false. The muted option still takes precedence. It is recommended to use an absolute path. If a relative path is passed, it is relative to the Remotion Root.`,
     docLink: 'https://remotion.dev/docs/renderer/render-media',
     getValue: ({ commandLine }) => {
         if (commandLine[cliFlag]) {

package/dist/render-has-audio.js

@@ -15,6 +15,12 @@ const getShouldRenderAudio = ({ codec, assetsInfo, enforceAudioTrack, muted, })
     if (assetsInfo === null) {
         return 'maybe';
     }
-    return assetsInfo.assets.flat(1).length > 0 ? 'yes' : 'no';
+    if (!(0, codec_supports_media_1.codecSupportsMedia)(codec).video) {
+        return 'yes';
+    }
+    return assetsInfo.assets.some((frame) => frame.audioAndVideoAssets.length > 0 ||
+        frame.inlineAudioAssets.length > 0)
+        ? 'yes'
+        : 'no';
 };
 exports.getShouldRenderAudio = getShouldRenderAudio;

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

@@ -64,10 +64,11 @@ const innerStitchFramesToVideo = async ({ assetsInfo, audioBitrate, audioCodec:
     assetsInfo.downloadMap.preventCleanup();
     const proResProfileName = (0, get_prores_profile_name_1.getProResProfileName)(codec, proResProfile);
     const mediaSupport = (0, codec_supports_media_1.codecSupportsMedia)(codec);
+    const enforceAudioTrackForOutput = enforceAudioTrack || Boolean(separateAudioTo);
     const renderAudioEvaluation = (0, render_has_audio_1.getShouldRenderAudio)({
         assetsInfo,
         codec,
-        enforceAudioTrack,
+        enforceAudioTrack: enforceAudioTrackForOutput,
         muted,
     });
     if (renderAudioEvaluation === 'maybe') {
@@ -158,6 +159,7 @@ const innerStitchFramesToVideo = async ({ assetsInfo, audioBitrate, audioCodec:
             trimRightOffset: assetsInfo.trimRightOffset,
             forSeamlessAacConcatenation: assetsInfo.forSeamlessAacConcatenation,
             sampleRate,
+            enforceAudioTrack: enforceAudioTrackForOutput || !shouldRenderVideo,
         })
         : null;
     if (mediaSupport.audio && !mediaSupport.video) {
@@ -190,6 +192,9 @@ const innerStitchFramesToVideo = async ({ assetsInfo, audioBitrate, audioCodec:
         assetsInfo.downloadMap.allowCleanup();
         return Promise.resolve(file);
     }
+    if (separateAudioTo && !audio) {
+        throw new Error(`\`separateAudioTo\` was set to ${JSON.stringify(separateAudioTo)}, but this render included no audio. Audio output is disabled by the muted option or selected codec.`);
+    }
     // Parallel encoding already resolved the encoder in the pre-stitcher.
     const resolvedHardwareAcceleration = preEncodedFileLocation
         ? 'disable'
@@ -290,10 +295,7 @@ const innerStitchFramesToVideo = async ({ assetsInfo, audioBitrate, audioCodec:
             }
         }
     });
-    if (separateAudioTo) {
-        if (!audio) {
-            throw new Error(`\`separateAudioTo\` was set to ${JSON.stringify(separateAudioTo)}, but this render included no audio`);
-        }
+    if (separateAudioTo && audio) {
         const finalDestination = node_path_1.default.resolve(remotionRoot, separateAudioTo);
         (0, node_fs_1.cpSync)(audio, finalDestination);
         (0, node_fs_1.rmSync)(audio);

package/package.json

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