@remotion/renderer 4.0.122 → 4.0.123

package/dist/index.d.ts

@@ -1,10 +1,11 @@
+/// <reference types="node" />
+/// <reference types="node" />
 import execa from 'execa';
 import { HeadlessBrowser } from './browser/Browser';
 import { SymbolicateableError } from './error-handling/symbolicateable-error';
 import { mimeContentType, mimeLookup } from './mime-types';
 import * as perf from './perf';
 export type { RenderMediaOnDownload } from './assets/download-and-map-assets-to-file';
-export { AudioCodec } from './audio-codec';
 export { Browser } from './browser';
 export { BrowserExecutable } from './browser-executable';
 export { BrowserLog } from './browser-log';
@@ -42,6 +43,8 @@ export { stitchFramesToVideo, StitchFramesToVideoOptions, } from './stitch-frame
 export { SymbolicatedStackFrame } from './symbolicate-stacktrace';
 export { OnStartData, RenderFramesOutput } from './types';
 export { validateOutputFilename } from './validate-output-filename';
+export type { AudioCodec };
+import type { AudioCodec } from './options/audio-codec';
 export declare const RenderInternals: {
     ensureLocalBrowser: ({ indent, logLevel, preferredBrowserExecutable, }: {
         preferredBrowserExecutable: import("./browser-executable").BrowserExecutable;
@@ -67,10 +70,10 @@ export declare const RenderInternals: {
         width: number;
         height: number;
         scale: number;
-        codec: "h264" | "h265" | "vp8" | "vp9" | "mp3" | "aac" | "wav" | "prores" | "h264-mkv" | "gif";
+        codec: "h264" | "h265" | "vp8" | "vp9" | "mp3" | "aac" | "wav" | "prores" | "h264-mkv" | "h264-ts" | "gif";
         wantsImageSequence: boolean;
     }) => void;
-    getFileExtensionFromCodec: <T extends "h264" | "h265" | "vp8" | "vp9" | "mp3" | "aac" | "wav" | "prores" | "h264-mkv" | "gif">(codec: T, audioCodec: "mp3" | "aac" | "pcm-16" | "opus" | null) => import("./file-extensions").FileExtension;
+    getFileExtensionFromCodec: <T extends "h264" | "h265" | "vp8" | "vp9" | "mp3" | "aac" | "wav" | "prores" | "h264-mkv" | "h264-ts" | "gif">(codec: T, audioCodec: "mp3" | "aac" | "pcm-16" | "opus" | null) => import("./file-extensions").FileExtension;
     tmpDir: (str: string) => string;
     deleteDirectory: (directory: string) => void;
     isServeUrl: (potentialUrl: string) => boolean;
@@ -127,7 +130,7 @@ export declare const RenderInternals: {
     };
     registerErrorSymbolicationLock: () => number;
     unlockErrorSymbolicationLock: (id: number) => void;
-    canUseParallelEncoding: (codec: "h264" | "h265" | "vp8" | "vp9" | "mp3" | "aac" | "wav" | "prores" | "h264-mkv" | "gif") => boolean;
+    canUseParallelEncoding: (codec: "h264" | "h265" | "vp8" | "vp9" | "mp3" | "aac" | "wav" | "prores" | "h264-mkv" | "h264-ts" | "gif") => boolean;
     mimeContentType: typeof mimeContentType;
     mimeLookup: typeof mimeLookup;
     validateConcurrency: ({ setting, value, checkIfValidForCurrentMachine, }: {
@@ -138,14 +141,14 @@ export declare const RenderInternals: {
     validPixelFormats: readonly ["yuv420p", "yuva420p", "yuv422p", "yuv444p", "yuv420p10le", "yuv422p10le", "yuv444p10le", "yuva444p10le"];
     DEFAULT_BROWSER: "chrome";
     validateFrameRange: (frameRange: import("./frame-range").FrameRange | null) => void;
-    DEFAULT_OPENGL_RENDERER: "swangle" | "angle" | "egl" | "swiftshader" | "vulkan" | "angle-egl" | null;
-    validateOpenGlRenderer: (option: unknown) => "swangle" | "angle" | "egl" | "swiftshader" | "vulkan" | "angle-egl" | null;
-    validCodecs: readonly ["h264", "h265", "vp8", "vp9", "mp3", "aac", "wav", "prores", "h264-mkv", "gif"];
+    DEFAULT_OPENGL_RENDERER: "angle" | "swangle" | "egl" | "swiftshader" | "vulkan" | "angle-egl" | null;
+    validateOpenGlRenderer: (option: unknown) => "angle" | "swangle" | "egl" | "swiftshader" | "vulkan" | "angle-egl" | null;
+    validCodecs: readonly ["h264", "h265", "vp8", "vp9", "mp3", "aac", "wav", "prores", "h264-mkv", "h264-ts", "gif"];
     DEFAULT_PIXEL_FORMAT: "yuv420p" | "yuva420p" | "yuv422p" | "yuv444p" | "yuv420p10le" | "yuv422p10le" | "yuv444p10le" | "yuva444p10le";
     validateJpegQuality: (q: unknown) => void;
     DEFAULT_TIMEOUT: number;
-    DEFAULT_CODEC: "h264" | "h265" | "vp8" | "vp9" | "mp3" | "aac" | "wav" | "prores" | "h264-mkv" | "gif";
-    isAudioCodec: (codec: "h264" | "h265" | "vp8" | "vp9" | "mp3" | "aac" | "wav" | "prores" | "h264-mkv" | "gif" | null | undefined) => boolean;
+    DEFAULT_CODEC: "h264" | "h265" | "vp8" | "vp9" | "mp3" | "aac" | "wav" | "prores" | "h264-mkv" | "h264-ts" | "gif";
+    isAudioCodec: (codec: "h264" | "h265" | "vp8" | "vp9" | "mp3" | "aac" | "wav" | "prores" | "h264-mkv" | "h264-ts" | "gif" | null | undefined) => boolean;
     logLevels: readonly ["verbose", "info", "warn", "error"];
     isEqualOrBelowLogLevel: (currentLevel: "verbose" | "info" | "warn" | "error", level: "verbose" | "info" | "warn" | "error") => boolean;
     isValidLogLevel: (level: string) => boolean;
@@ -156,28 +159,31 @@ export declare const RenderInternals: {
     }) => number;
     findRemotionRoot: () => string;
     validateBitrate: (bitrate: unknown, name: string) => void;
-    combineVideos: (options: {
+    combineVideos: ({ files, filelistDir, output, onProgress, numberOfFrames, codec, fps, numberOfGifLoops, resolvedAudioCodec, audioBitrate, indent, logLevel, chunkDurationInSeconds, binariesDirectory, cancelSignal, seamlessAudio, seamlessVideo, }: {
         files: string[];
         filelistDir: string;
         output: string;
         onProgress: (p: number) => void;
         numberOfFrames: number;
-        codec: "h264" | "h265" | "vp8" | "vp9" | "mp3" | "aac" | "wav" | "prores" | "h264-mkv" | "gif";
+        codec: "h264" | "h265" | "vp8" | "vp9" | "mp3" | "aac" | "wav" | "prores" | "h264-mkv" | "h264-ts" | "gif";
         fps: number;
         numberOfGifLoops: number | null;
-        audioCodec: "mp3" | "aac" | "pcm-16" | "opus" | null;
+        resolvedAudioCodec: "mp3" | "aac" | "pcm-16" | "opus" | null;
         audioBitrate: string | null;
         indent: boolean;
         logLevel: "verbose" | "info" | "warn" | "error";
+        chunkDurationInSeconds: number;
         binariesDirectory: string | null;
+        cancelSignal: import("./make-cancel-signal").CancelSignal | undefined;
+        seamlessAudio: boolean;
+        seamlessVideo: boolean;
     }) => Promise<void>;
     getMinConcurrency: () => number;
     getMaxConcurrency: () => number;
     getDefaultAudioCodec: ({ codec, preferLossless, }: {
-        codec: "h264" | "h265" | "vp8" | "vp9" | "mp3" | "aac" | "wav" | "prores" | "h264-mkv" | "gif";
+        codec: "h264" | "h265" | "vp8" | "vp9" | "mp3" | "aac" | "wav" | "prores" | "h264-mkv" | "h264-ts" | "gif";
         preferLossless: boolean;
     }) => "mp3" | "aac" | "pcm-16" | "opus" | null;
-    validAudioCodecs: readonly ["pcm-16", "aac", "mp3", "opus"];
     defaultFileExtensionMap: {
         h264: {
             default: import("./file-extensions").FileExtension;
@@ -296,6 +302,19 @@ export declare const RenderInternals: {
                 };
             };
         };
+        "h264-ts": {
+            default: import("./file-extensions").FileExtension;
+            forAudioCodec: {
+                aac: {
+                    possible: import("./file-extensions").FileExtension[];
+                    default: import("./file-extensions").FileExtension;
+                };
+                "pcm-16": {
+                    possible: import("./file-extensions").FileExtension[];
+                    default: import("./file-extensions").FileExtension;
+                };
+            };
+        };
         gif: {
             default: import("./file-extensions").FileExtension;
             forAudioCodec: {};
@@ -304,6 +323,7 @@ export declare const RenderInternals: {
     supportedAudioCodecs: {
         readonly h264: readonly ["aac", "pcm-16", "mp3"];
         readonly 'h264-mkv': readonly ["pcm-16", "mp3"];
+        readonly 'h264-ts': readonly ["pcm-16", "aac"];
         readonly aac: readonly ["aac", "pcm-16"];
         readonly gif: readonly [];
         readonly h265: readonly ["aac", "pcm-16"];
@@ -313,26 +333,27 @@ export declare const RenderInternals: {
         readonly vp9: readonly ["opus", "pcm-16"];
         readonly wav: readonly ["pcm-16"];
     };
-    makeFileExtensionMap: () => Record<string, ("h264" | "h265" | "vp8" | "vp9" | "mp3" | "aac" | "wav" | "prores" | "h264-mkv" | "gif")[]>;
-    defaultCodecsForFileExtension: Record<import("./file-extensions").FileExtension, "h264" | "h265" | "vp8" | "vp9" | "mp3" | "aac" | "wav" | "prores" | "h264-mkv" | "gif">;
+    makeFileExtensionMap: () => Record<string, ("h264" | "h265" | "vp8" | "vp9" | "mp3" | "aac" | "wav" | "prores" | "h264-mkv" | "h264-ts" | "gif")[]>;
+    defaultCodecsForFileExtension: Record<import("./file-extensions").FileExtension, "h264" | "h265" | "vp8" | "vp9" | "mp3" | "aac" | "wav" | "prores" | "h264-mkv" | "h264-ts" | "gif">;
     getExecutablePath: ({ indent, logLevel, type, binariesDirectory, }: {
-        type: "compositor" | "ffmpeg" | "ffprobe";
+        type: "ffmpeg" | "ffprobe" | "compositor";
         indent: boolean;
         logLevel: "verbose" | "info" | "warn" | "error";
         binariesDirectory: string | null;
     }) => string;
-    callFf: ({ args, bin, indent, logLevel, options, binariesDirectory, }: {
+    callFf: ({ args, bin, indent, logLevel, options, binariesDirectory, cancelSignal, }: {
         bin: "ffmpeg" | "ffprobe";
         args: (string | null)[];
         indent: boolean;
         logLevel: "verbose" | "info" | "warn" | "error";
         binariesDirectory: string | null;
+        cancelSignal: import("./make-cancel-signal").CancelSignal | undefined;
         options?: execa.Options<string> | undefined;
     }) => execa.ExecaChildProcess<string>;
     validStillImageFormats: readonly ["png", "jpeg", "pdf", "webp"];
     validVideoImageFormats: readonly ["png", "jpeg", "none"];
-    DEFAULT_STILL_IMAGE_FORMAT: "png" | "jpeg" | "pdf" | "webp";
-    DEFAULT_VIDEO_IMAGE_FORMAT: "png" | "jpeg" | "none";
+    DEFAULT_STILL_IMAGE_FORMAT: "jpeg" | "png" | "webp" | "pdf";
+    DEFAULT_VIDEO_IMAGE_FORMAT: "jpeg" | "png" | "none";
     DEFAULT_JPEG_QUALITY: number;
     chalk: {
         enabled: () => boolean;
@@ -429,7 +450,7 @@ export declare const RenderInternals: {
         frame: number;
         serializedInputPropsWithCustomSchema: string;
         serializedResolvedPropsWithCustomSchema: string;
-        imageFormat: "png" | "jpeg" | "pdf" | "webp";
+        imageFormat: "jpeg" | "png" | "webp" | "pdf";
         jpegQuality: number;
         puppeteerInstance: HeadlessBrowser | null;
         envVariables: Record<string, string>;
@@ -715,5 +736,12 @@ export declare const RenderInternals: {
         hostsToTry: string[];
     };
     makeDownloadMap: () => import("./assets/download-map").DownloadMap;
+    getExtensionFromAudioCodec: (audioCodec: "mp3" | "aac" | "pcm-16" | "opus") => "mp3" | "aac" | "wav" | "opus";
     makeFileExecutableIfItIsNot: (path: string) => void;
+    resolveAudioCodec: ({ codec, setting, preferLossless, separateAudioTo, }: {
+        setting: "mp3" | "aac" | "pcm-16" | "opus" | null;
+        codec: "h264" | "h265" | "vp8" | "vp9" | "mp3" | "aac" | "wav" | "prores" | "h264-mkv" | "h264-ts" | "gif";
+        preferLossless: boolean;
+        separateAudioTo: string | null;
+    }) => "mp3" | "aac" | "pcm-16" | "opus" | null;
 };

package/dist/index.js

@@ -29,7 +29,6 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.RenderInternals = exports.validateOutputFilename = exports.stitchFramesToVideo = exports.selectComposition = exports.renderStill = exports.renderMedia = exports.renderFrames = exports.openBrowser = exports.makeCancelSignal = exports.validateSelectedPixelFormatAndImageFormatCombination = exports.getVideoMetadata = exports.getSilentParts = exports.getCompositions = exports.extractAudio = exports.ErrorWithStackFrame = void 0;
 const execa_1 = __importDefault(require("execa"));
 const download_file_1 = require("./assets/download-file");
-const audio_codec_1 = require("./audio-codec");
 const browser_1 = require("./browser");
 const Browser_1 = require("./browser/Browser");
 const TimeoutSettings_1 = require("./browser/TimeoutSettings");
@@ -59,7 +58,6 @@ const get_frame_to_render_1 = require("./get-frame-to-render");
 const get_local_browser_executable_1 = require("./get-local-browser-executable");
 const get_port_1 = require("./get-port");
 const image_format_1 = require("./image-format");
-const is_audio_codec_1 = require("./is-audio-codec");
 const is_serve_url_1 = require("./is-serve-url");
 const jpeg_quality_1 = require("./jpeg-quality");
 const log_level_1 = require("./log-level");
@@ -112,6 +110,7 @@ var validate_output_filename_1 = require("./validate-output-filename");
 Object.defineProperty(exports, "validateOutputFilename", { enumerable: true, get: function () { return validate_output_filename_1.validateOutputFilename; } });
 const download_map_1 = require("./assets/download-map");
 const make_file_executable_1 = require("./compositor/make-file-executable");
+const audio_codec_1 = require("./options/audio-codec");
 const validate_puppeteer_timeout_1 = require("./validate-puppeteer-timeout");
 const validate_videobitrate_1 = require("./validate-videobitrate");
 const wait_for_symbolication_error_to_be_done_1 = require("./wait-for-symbolication-error-to-be-done");
@@ -153,7 +152,7 @@ exports.RenderInternals = {
     validateJpegQuality: jpeg_quality_1.validateJpegQuality,
     DEFAULT_TIMEOUT: TimeoutSettings_1.DEFAULT_TIMEOUT,
     DEFAULT_CODEC: codec_1.DEFAULT_CODEC,
-    isAudioCodec: is_audio_codec_1.isAudioCodec,
+    isAudioCodec: audio_codec_1.isAudioCodec,
     logLevels: log_level_1.logLevels,
     isEqualOrBelowLogLevel: log_level_1.isEqualOrBelowLogLevel,
     isValidLogLevel: log_level_1.isValidLogLevel,
@@ -165,7 +164,6 @@ exports.RenderInternals = {
     getMinConcurrency: validate_concurrency_1.getMinConcurrency,
     getMaxConcurrency: validate_concurrency_1.getMaxConcurrency,
     getDefaultAudioCodec: audio_codec_1.getDefaultAudioCodec,
-    validAudioCodecs: audio_codec_1.validAudioCodecs,
     defaultFileExtensionMap: file_extensions_1.defaultFileExtensionMap,
     supportedAudioCodecs: audio_codec_1.supportedAudioCodecs,
     makeFileExtensionMap: get_extension_from_codec_1.makeFileExtensionMap,
@@ -196,7 +194,9 @@ exports.RenderInternals = {
     getChromiumGpuInformation: test_gpu_1.getChromiumGpuInformation,
     getPortConfig: port_config_1.getPortConfig,
     makeDownloadMap: download_map_1.makeDownloadMap,
+    getExtensionFromAudioCodec: audio_codec_1.getExtensionFromAudioCodec,
     makeFileExecutableIfItIsNot: make_file_executable_1.makeFileExecutableIfItIsNot,
+    resolveAudioCodec: audio_codec_1.resolveAudioCodec,
 };
 // Warn of potential performance issues with Apple Silicon (M1 chip under Rosetta)
 (0, check_version_requirements_1.checkNodeVersionAndWarnAboutRosetta)('info', false);

package/dist/merge-audio-track.d.ts

@@ -1,15 +1,19 @@
 import type { DownloadMap } from './assets/download-map';
 import type { LogLevel } from './log-level';
+import type { CancelSignal } from './make-cancel-signal';
 import type { PreprocessedAudioTrack } from './preprocess-audio-track';
 type Options = {
     files: PreprocessedAudioTrack[];
     outName: string;
-    numberOfSeconds: number;
     downloadMap: DownloadMap;
     remotionRoot: string;
     indent: boolean;
     logLevel: LogLevel;
     binariesDirectory: string | null;
+    cancelSignal: CancelSignal | undefined;
+    onProgress: (progress: number) => void;
+    fps: number;
+    expectedFrames: number;
 };
 export declare const mergeAudioTrack: (options: Options) => Promise<void>;
 export {};

package/dist/merge-audio-track.js

@@ -11,10 +11,14 @@ const create_ffmpeg_complex_filter_1 = require("./create-ffmpeg-complex-filter")
 const create_ffmpeg_merge_filter_1 = require("./create-ffmpeg-merge-filter");
 const create_silent_audio_1 = require("./create-silent-audio");
 const delete_directory_1 = require("./delete-directory");
+const logger_1 = require("./logger");
 const p_limit_1 = require("./p-limit");
+const parse_ffmpeg_progress_1 = require("./parse-ffmpeg-progress");
 const tmp_dir_1 = require("./tmp-dir");
 const truthy_1 = require("./truthy");
-const mergeAudioTrackUnlimited = async ({ outName, files, numberOfSeconds, downloadMap, remotionRoot, indent, logLevel, binariesDirectory, }) => {
+const mergeAudioTrackUnlimited = async ({ outName, files, downloadMap, remotionRoot, indent, logLevel, binariesDirectory, cancelSignal, onProgress, fps, expectedFrames, }) => {
+    var _a;
+    const numberOfSeconds = Number((expectedFrames / fps).toFixed(3));
     if (files.length === 0) {
         await (0, create_silent_audio_1.createSilentAudio)({
             outName,
@@ -22,7 +26,9 @@ const mergeAudioTrackUnlimited = async ({ outName, files, numberOfSeconds, downl
             indent,
             logLevel,
             binariesDirectory,
+            cancelSignal,
         });
+        onProgress(1);
         return;
     }
     // Previously a bug: We cannot optimize for files.length === 1 because we need to pad the audio
@@ -31,17 +37,30 @@ const mergeAudioTrackUnlimited = async ({ outName, files, numberOfSeconds, downl
         const chunked = (0, chunk_1.chunk)(files, 10);
         const tempPath = (0, tmp_dir_1.tmpDir)('remotion-large-audio-mixing');
         try {
+            const partialProgress = new Array(chunked.length).fill(0);
+            let finalProgress = 0;
+            const callProgress = () => {
+                const totalProgress = partialProgress.reduce((a, b) => a + b, 0) / chunked.length;
+                const combinedProgress = totalProgress * 0.8 + finalProgress * 0.2;
+                onProgress(combinedProgress);
+            };
             const chunkNames = await Promise.all(chunked.map(async (chunkFiles, i) => {
                 const chunkOutname = node_path_1.default.join(tempPath, `chunk-${i}.wav`);
                 await (0, exports.mergeAudioTrack)({
                     files: chunkFiles,
-                    numberOfSeconds,
+                    expectedFrames,
                     outName: chunkOutname,
                     downloadMap,
                     remotionRoot,
                     indent,
                     logLevel,
                     binariesDirectory,
+                    cancelSignal,
+                    onProgress: (progress) => {
+                        partialProgress[i] = progress;
+                        callProgress();
+                    },
+                    fps,
                 });
                 return chunkOutname;
             }));
@@ -53,13 +72,19 @@ const mergeAudioTrackUnlimited = async ({ outName, files, numberOfSeconds, downl
                     },
                     outName: c,
                 })),
-                numberOfSeconds,
                 outName,
                 downloadMap,
                 remotionRoot,
                 indent,
                 logLevel,
                 binariesDirectory,
+                cancelSignal,
+                onProgress: (progress) => {
+                    finalProgress = progress;
+                    callProgress();
+                },
+                fps,
+                expectedFrames,
             });
             return;
         }
@@ -86,8 +111,20 @@ const mergeAudioTrackUnlimited = async ({ outName, files, numberOfSeconds, downl
         indent,
         logLevel,
         binariesDirectory,
+        cancelSignal,
+    });
+    (_a = task.stderr) === null || _a === void 0 ? void 0 : _a.on('data', (data) => {
+        const utf8 = data.toString('utf8');
+        const parsed = (0, parse_ffmpeg_progress_1.parseFfmpegProgress)(utf8, fps);
+        if (parsed === undefined) {
+            logger_1.Log.verbose({ indent, logLevel }, utf8);
+        }
+        else {
+            onProgress(parsed / expectedFrames);
+        }
     });
     await task;
+    onProgress(1);
     cleanup();
 };
 // Must be at least 3 because recursively called twice in mergeAudioTrack

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

@@ -0,0 +1,55 @@
+import type { Codec } from '../codec';
+export declare const validAudioCodecs: readonly ["pcm-16", "aac", "mp3", "opus"];
+export type AudioCodec = (typeof validAudioCodecs)[number];
+export declare const isAudioCodec: (codec: Codec | undefined | null) => boolean;
+export declare const supportedAudioCodecs: {
+    readonly h264: readonly ["aac", "pcm-16", "mp3"];
+    readonly 'h264-mkv': readonly ["pcm-16", "mp3"];
+    readonly 'h264-ts': readonly ["pcm-16", "aac"];
+    readonly aac: readonly ["aac", "pcm-16"];
+    readonly gif: readonly [];
+    readonly h265: readonly ["aac", "pcm-16"];
+    readonly mp3: readonly ["mp3", "pcm-16"];
+    readonly prores: readonly ["aac", "pcm-16"];
+    readonly vp8: readonly ["opus", "pcm-16"];
+    readonly vp9: readonly ["opus", "pcm-16"];
+    readonly wav: readonly ["pcm-16"];
+};
+declare const audioCodecNames: readonly ["pcm_s16le", "libfdk_aac", "libmp3lame", "libopus"];
+type FfmpegAudioCodecName = (typeof audioCodecNames)[number];
+export declare const mapAudioCodecToFfmpegAudioCodecName: (audioCodec: AudioCodec) => FfmpegAudioCodecName;
+export declare const defaultAudioCodecs: {
+    [key in Codec]: {
+        [k in 'compressed' | 'lossless']: (typeof supportedAudioCodecs)[key][number] | null;
+    };
+};
+export declare const getExtensionFromAudioCodec: (audioCodec: AudioCodec) => "mp3" | "aac" | "wav" | "opus";
+export declare const resolveAudioCodec: ({ codec, setting, preferLossless, separateAudioTo, }: {
+    setting: AudioCodec | null;
+    codec: Codec;
+    preferLossless: boolean;
+    separateAudioTo: string | null;
+}) => "mp3" | "aac" | "pcm-16" | "opus" | null;
+export declare const getDefaultAudioCodec: ({ codec, preferLossless, }: {
+    codec: Codec;
+    preferLossless: boolean;
+}) => AudioCodec | null;
+export declare const audioCodecOption: {
+    cliFlag: "audio-codec";
+    setConfig: (audioCodec: "mp3" | "aac" | "pcm-16" | "opus" | null) => void;
+    getValue: ({ commandLine }: {
+        commandLine: Record<string, unknown>;
+    }) => {
+        source: string;
+        value: "mp3" | "aac" | "pcm-16" | "opus";
+    } | {
+        source: string;
+        value: null;
+    };
+    description: () => string;
+    docLink: string;
+    name: string;
+    ssrName: "audioCodec";
+    type: "mp3" | "aac" | "pcm-16" | "opus";
+};
+export {};

package/dist/options/audio-codec.js

@@ -0,0 +1,190 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.audioCodecOption = exports.getDefaultAudioCodec = exports.resolveAudioCodec = exports.getExtensionFromAudioCodec = exports.defaultAudioCodecs = exports.mapAudioCodecToFfmpegAudioCodecName = exports.supportedAudioCodecs = exports.isAudioCodec = exports.validAudioCodecs = void 0;
+const separate_audio_1 = require("./separate-audio");
+exports.validAudioCodecs = ['pcm-16', 'aac', 'mp3', 'opus'];
+const isAudioCodec = (codec) => {
+    return codec === 'mp3' || codec === 'aac' || codec === 'wav';
+};
+exports.isAudioCodec = isAudioCodec;
+exports.supportedAudioCodecs = {
+    h264: ['aac', 'pcm-16', 'mp3'],
+    'h264-mkv': ['pcm-16', 'mp3'],
+    'h264-ts': ['pcm-16', 'aac'],
+    aac: ['aac', 'pcm-16'],
+    gif: [],
+    h265: ['aac', 'pcm-16'],
+    mp3: ['mp3', 'pcm-16'],
+    prores: ['aac', 'pcm-16'],
+    vp8: ['opus', 'pcm-16'],
+    vp9: ['opus', 'pcm-16'],
+    wav: ['pcm-16'],
+};
+const _satisfies = exports.supportedAudioCodecs;
+if (_satisfies) {
+    // Just for type checking
+}
+const audioCodecNames = [
+    'pcm_s16le',
+    'libfdk_aac',
+    'libmp3lame',
+    'libopus',
+];
+const mapAudioCodecToFfmpegAudioCodecName = (audioCodec) => {
+    if (audioCodec === 'aac') {
+        return 'libfdk_aac';
+    }
+    if (audioCodec === 'mp3') {
+        return 'libmp3lame';
+    }
+    if (audioCodec === 'opus') {
+        return 'libopus';
+    }
+    if (audioCodec === 'pcm-16') {
+        return 'pcm_s16le';
+    }
+    throw new Error('unknown audio codec: ' + audioCodec);
+};
+exports.mapAudioCodecToFfmpegAudioCodecName = mapAudioCodecToFfmpegAudioCodecName;
+const cliFlag = 'audio-codec';
+const ssrName = 'audioCodec';
+exports.defaultAudioCodecs = {
+    'h264-mkv': {
+        lossless: 'pcm-16',
+        compressed: 'pcm-16',
+    },
+    'h264-ts': {
+        lossless: 'pcm-16',
+        compressed: 'aac',
+    },
+    aac: {
+        lossless: 'pcm-16',
+        compressed: 'aac',
+    },
+    gif: {
+        lossless: null,
+        compressed: null,
+    },
+    h264: {
+        lossless: 'pcm-16',
+        compressed: 'aac',
+    },
+    h265: {
+        lossless: 'pcm-16',
+        compressed: 'aac',
+    },
+    mp3: {
+        lossless: 'pcm-16',
+        compressed: 'mp3',
+    },
+    prores: {
+        lossless: 'pcm-16',
+        compressed: 'pcm-16',
+    },
+    vp8: {
+        lossless: 'pcm-16',
+        compressed: 'opus',
+    },
+    vp9: {
+        lossless: 'pcm-16',
+        compressed: 'opus',
+    },
+    wav: {
+        lossless: 'pcm-16',
+        compressed: 'pcm-16',
+    },
+};
+const extensionMap = {
+    aac: 'aac',
+    mp3: 'mp3',
+    opus: 'opus',
+    'pcm-16': 'wav',
+};
+const getExtensionFromAudioCodec = (audioCodec) => {
+    if (extensionMap[audioCodec]) {
+        return extensionMap[audioCodec];
+    }
+    throw new Error(`Unsupported audio codec: ${audioCodec}`);
+};
+exports.getExtensionFromAudioCodec = getExtensionFromAudioCodec;
+const resolveAudioCodec = ({ codec, setting, preferLossless, separateAudioTo, }) => {
+    let derivedFromSeparateAudioToExtension = null;
+    if (separateAudioTo) {
+        const extension = separateAudioTo.split('.').pop();
+        for (const [key, value] of Object.entries(extensionMap)) {
+            if (value === extension) {
+                derivedFromSeparateAudioToExtension = key;
+                if (!exports.supportedAudioCodecs[codec].includes(derivedFromSeparateAudioToExtension) &&
+                    derivedFromSeparateAudioToExtension) {
+                    throw new Error(`The codec is ${codec} but the audio codec derived from --${separate_audio_1.separateAudioOption.cliFlag} is ${derivedFromSeparateAudioToExtension}. The only supported codecs are: ${exports.supportedAudioCodecs[codec].join(', ')}`);
+                }
+            }
+        }
+    }
+    // Explanation: https://github.com/remotion-dev/remotion/issues/1647
+    if (preferLossless) {
+        const selected = (0, exports.getDefaultAudioCodec)({ codec, preferLossless });
+        if (derivedFromSeparateAudioToExtension &&
+            selected !== derivedFromSeparateAudioToExtension) {
+            throw new Error(`The audio codec derived from --${separate_audio_1.separateAudioOption.cliFlag} is ${derivedFromSeparateAudioToExtension}, but does not match the audio codec derived from the "Prefer lossless" option (${selected}). Remove any conflicting options.`);
+        }
+        return selected;
+    }
+    if (setting === null) {
+        if (derivedFromSeparateAudioToExtension) {
+            return derivedFromSeparateAudioToExtension;
+        }
+        return (0, exports.getDefaultAudioCodec)({ codec, preferLossless });
+    }
+    if (derivedFromSeparateAudioToExtension !== setting &&
+        derivedFromSeparateAudioToExtension) {
+        throw new Error(`The audio codec derived from --${separate_audio_1.separateAudioOption.cliFlag} is ${derivedFromSeparateAudioToExtension}, but does not match the audio codec derived from your ${exports.audioCodecOption.name} setting (${setting}). Remove any conflicting options.`);
+    }
+    return setting;
+};
+exports.resolveAudioCodec = resolveAudioCodec;
+const getDefaultAudioCodec = ({ codec, preferLossless, }) => {
+    return exports.defaultAudioCodecs[codec][preferLossless ? 'lossless' : 'compressed'];
+};
+exports.getDefaultAudioCodec = getDefaultAudioCodec;
+let _audioCodec = null;
+exports.audioCodecOption = {
+    cliFlag,
+    setConfig: (audioCodec) => {
+        if (audioCodec === null) {
+            _audioCodec = null;
+            return;
+        }
+        if (!exports.validAudioCodecs.includes(audioCodec)) {
+            throw new Error(`Audio codec must be one of the following: ${exports.validAudioCodecs.join(', ')}, but got ${audioCodec}`);
+        }
+        _audioCodec = audioCodec;
+    },
+    getValue: ({ commandLine }) => {
+        if (commandLine[cliFlag]) {
+            const codec = commandLine[cliFlag];
+            if (!exports.validAudioCodecs.includes(commandLine[cliFlag])) {
+                throw new Error(`Audio codec must be one of the following: ${exports.validAudioCodecs.join(', ')}, but got ${codec}`);
+            }
+            return {
+                source: 'cli',
+                value: commandLine[cliFlag],
+            };
+        }
+        if (_audioCodec !== null) {
+            return {
+                source: 'config',
+                value: _audioCodec,
+            };
+        }
+        return {
+            source: 'default',
+            value: null,
+        };
+    },
+    description: () => `Set the format of the audio that is embedded in the video. Not all codec and audio codec combinations are supported and certain combinations require a certain file extension and container format. See the table in the docs to see possible combinations.`,
+    docLink: 'https://www.remotion.dev/docs/encoding/#audio-codec',
+    name: 'Audio Codec',
+    ssrName,
+    type: 'aac',
+};

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

@@ -9,7 +9,10 @@ export declare const enforceAudioOption: {
         commandLine: Record<string, unknown>;
     }) => {
         source: string;
-        value: boolean;
+        value: true;
+    } | {
+        source: string;
+        value: false;
     };
     setConfig: (value: boolean) => void;
 };

package/dist/options/enforce-audio.js

@@ -2,7 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.enforceAudioOption = void 0;
 const jsx_runtime_1 = require("react/jsx-runtime");
-const DEFAULT_ENFORCE_AUDIO_TRACK = true;
+const DEFAULT_ENFORCE_AUDIO_TRACK = false;
 let enforceAudioTrackState = DEFAULT_ENFORCE_AUDIO_TRACK;
 const cliFlag = 'enforce-audio-track';
 exports.enforceAudioOption = {
@@ -13,10 +13,10 @@ exports.enforceAudioOption = {
     docLink: 'https://www.remotion.dev/docs/config#setenforceaudiotrack-',
     type: false,
     getValue: ({ commandLine }) => {
-        if (commandLine[cliFlag] !== undefined) {
+        if (commandLine[cliFlag]) {
             return {
                 source: 'cli',
-                value: commandLine[cliFlag],
+                value: true,
             };
         }
         if (enforceAudioTrackState !== DEFAULT_ENFORCE_AUDIO_TRACK) {

package/dist/options/for-seamless-aac-concatenation.js

@@ -12,7 +12,7 @@ const cliFlag = 'for-seamless-aac-concatenation';
 exports.forSeamlessAacConcatenationOption = {
     name: 'For seamless AAC concatenation',
     cliFlag,
-    description: () => ((0, jsx_runtime_1.jsx)(jsx_runtime_1.Fragment, { 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." })),
+    description: () => ((0, jsx_runtime_1.jsxs)(jsx_runtime_1.Fragment, { 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.", (0, jsx_runtime_1.jsx)("br", {}), (0, jsx_runtime_1.jsx)("br", {}), " This option is used internally. There is currently no documentation yet for to concatenate the audio chunks."] })),
     docLink: 'https://remotion.dev/docs/renderer',
     getValue: ({ commandLine }) => {
         if (commandLine[cliFlag]) {