@remotion/renderer 4.0.136 → 4.0.138

package/dist/open-browser.js

@@ -1,7 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.openBrowser = exports.internalOpenBrowser = exports.killAllBrowsers = void 0;
+const browser_download_progress_bar_1 = require("./browser/browser-download-progress-bar");
 const node_1 = require("./browser/node");
+const ensure_browser_1 = require("./ensure-browser");
 const get_local_browser_executable_1 = require("./get-local-browser-executable");
 const get_video_threads_flag_1 = require("./get-video-threads-flag");
 const log_level_1 = require("./log-level");
@@ -40,20 +42,22 @@ const killAllBrowsers = async () => {
     }
 };
 exports.killAllBrowsers = killAllBrowsers;
-const internalOpenBrowser = async ({ browser, browserExecutable, chromiumOptions, forceDeviceScaleFactor, indent, viewport, logLevel, }) => {
+const internalOpenBrowser = async ({ browser, browserExecutable, chromiumOptions, forceDeviceScaleFactor, indent, viewport, logLevel, onBrowserDownload, }) => {
     var _a, _b, _c;
     // @ts-expect-error Firefox
     if (browser === 'firefox') {
         throw new TypeError('Firefox supported is not yet turned on. Stay tuned for the future.');
     }
-    await (0, get_local_browser_executable_1.ensureLocalBrowser)({
-        preferredBrowserExecutable: browserExecutable,
+    await (0, ensure_browser_1.internalEnsureBrowser)({
+        browserExecutable,
         logLevel,
         indent,
+        onBrowserDownload,
     });
     const executablePath = (0, get_local_browser_executable_1.getLocalBrowserExecutable)(browserExecutable);
     const customGlRenderer = getOpenGlRenderer((_a = chromiumOptions.gl) !== null && _a !== void 0 ? _a : null);
-    logger_1.Log.verbose({ indent, logLevel, tag: 'openBrowser()' }, `Opening browser: gl = ${chromiumOptions.gl}, executable = ${executablePath}, enableMultiProcessOnLinux = ${(_b = chromiumOptions.enableMultiProcessOnLinux) !== null && _b !== void 0 ? _b : false}`);
+    const enableMultiProcessOnLinux = (_b = chromiumOptions.enableMultiProcessOnLinux) !== null && _b !== void 0 ? _b : true;
+    logger_1.Log.verbose({ indent, logLevel, tag: 'openBrowser()' }, `Opening browser: gl = ${chromiumOptions.gl}, executable = ${executablePath}, enableMultiProcessOnLinux = ${enableMultiProcessOnLinux}`);
     if (chromiumOptions.userAgent) {
         logger_1.Log.verbose({ indent, logLevel: 'verbose', tag: 'openBrowser()' }, `Using custom user agent: ${chromiumOptions.userAgent}`);
     }
@@ -101,21 +105,21 @@ const internalOpenBrowser = async ({ browser, browserExecutable, chromiumOptions
             '--disable-background-media-suspend',
             process.platform === 'linux' &&
                 chromiumOptions.gl !== 'vulkan' &&
-                !chromiumOptions.enableMultiProcessOnLinux
+                !enableMultiProcessOnLinux
                 ? '--single-process'
                 : null,
-            '--allow-running-insecure-content',
-            '--disable-component-update',
-            '--disable-domain-reliability',
-            '--disable-features=AudioServiceOutOfProcess,IsolateOrigins,site-per-process,Translate,BackForwardCache,AvoidUnnecessaryBeforeUnloadCheckSync,IntensiveWakeUpThrottling',
-            '--disable-print-preview',
-            '--disable-site-isolation-trials',
-            '--disk-cache-size=268435456',
-            '--hide-scrollbars',
-            '--no-default-browser-check',
-            '--no-pings',
+            '--allow-running-insecure-content', // https://source.chromium.org/search?q=lang:cpp+symbol:kAllowRunningInsecureContent&ss=chromium
+            '--disable-component-update', // https://source.chromium.org/search?q=lang:cpp+symbol:kDisableComponentUpdate&ss=chromium
+            '--disable-domain-reliability', // https://source.chromium.org/search?q=lang:cpp+symbol:kDisableDomainReliability&ss=chromium
+            '--disable-features=AudioServiceOutOfProcess,IsolateOrigins,site-per-process,Translate,BackForwardCache,AvoidUnnecessaryBeforeUnloadCheckSync,IntensiveWakeUpThrottling', // https://source.chromium.org/search?q=file:content_features.cc&ss=chromium
+            '--disable-print-preview', // https://source.chromium.org/search?q=lang:cpp+symbol:kDisablePrintPreview&ss=chromium
+            '--disable-site-isolation-trials', // https://source.chromium.org/search?q=lang:cpp+symbol:kDisableSiteIsolation&ss=chromium
+            '--disk-cache-size=268435456', // https://source.chromium.org/search?q=lang:cpp+symbol:kDiskCacheSize&ss=chromium
+            '--hide-scrollbars', // https://source.chromium.org/search?q=lang:cpp+symbol:kHideScrollbars&ss=chromium
+            '--no-default-browser-check', // https://source.chromium.org/search?q=lang:cpp+symbol:kNoDefaultBrowserCheck&ss=chromium
+            '--no-pings', // https://source.chromium.org/search?q=lang:cpp+symbol:kNoPings&ss=chromium
             '--font-render-hinting=none',
-            '--no-zygote',
+            '--no-zygote', // https://source.chromium.org/search?q=lang:cpp+symbol:kNoZygote&ss=chromium,
             typeof forceDeviceScaleFactor === 'undefined'
                 ? null
                 : `--force-device-scale-factor=${forceDeviceScaleFactor}`,
@@ -147,14 +151,21 @@ exports.internalOpenBrowser = internalOpenBrowser;
  */
 const openBrowser = (browser, options) => {
     const { browserExecutable, chromiumOptions, forceDeviceScaleFactor, shouldDumpIo, } = options !== null && options !== void 0 ? options : {};
+    const indent = false;
+    const logLevel = shouldDumpIo ? 'verbose' : 'info';
     return (0, exports.internalOpenBrowser)({
         browser,
         browserExecutable: browserExecutable !== null && browserExecutable !== void 0 ? browserExecutable : null,
         chromiumOptions: chromiumOptions !== null && chromiumOptions !== void 0 ? chromiumOptions : {},
         forceDeviceScaleFactor,
-        indent: false,
+        indent,
         viewport: null,
-        logLevel: shouldDumpIo ? 'verbose' : 'info',
+        logLevel,
+        onBrowserDownload: (0, browser_download_progress_bar_1.defaultBrowserDownloadProgress)({
+            indent,
+            logLevel,
+            api: 'openBrowser()',
+        }),
     });
 };
 exports.openBrowser = openBrowser;

package/dist/options/enable-multiprocess-on-linux.js

@@ -2,12 +2,12 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.enableMultiprocessOnLinuxOption = void 0;
 const jsx_runtime_1 = require("react/jsx-runtime");
-let multiProcessOnLinux = false;
+let multiProcessOnLinux = true;
 const cliFlag = 'enable-multiprocess-on-linux';
 exports.enableMultiprocessOnLinuxOption = {
     name: 'Enable Multiprocess on Linux',
     cliFlag,
-    description: () => ((0, jsx_runtime_1.jsxs)(jsx_runtime_1.Fragment, { children: ["Removes the ", (0, jsx_runtime_1.jsx)("code", { children: '--single-process' }), " flag that gets passed to Chromium on Linux by default. This will make the render faster because multiple processes can be used, but may cause issues with some Linux distributions or if window server libraries are missing."] })),
+    description: () => ((0, jsx_runtime_1.jsxs)(jsx_runtime_1.Fragment, { children: ["Removes the ", (0, jsx_runtime_1.jsx)("code", { children: '--single-process' }), " flag that gets passed to Chromium on Linux by default. This will make the render faster because multiple processes can be used, but may cause issues with some Linux distributions or if window server libraries are missing.", (0, jsx_runtime_1.jsx)("br", {}), "Default: ", (0, jsx_runtime_1.jsx)("code", { children: "false" }), " until v4.0.136, then ", (0, jsx_runtime_1.jsx)("code", { children: "true" }), " from v4.0.137 on because newer Chrome versions ", "don't", " allow rendering with the ", (0, jsx_runtime_1.jsx)("code", { children: "--single-process" }), " flag. ", (0, jsx_runtime_1.jsx)("br", {}), "This flag will be removed in Remotion v5.0."] })),
     ssrName: 'chromiumOptions.enableMultiprocessOnLinux',
     docLink: 'https://www.remotion.dev/docs/chromium-flags',
     type: false,

package/dist/options/gl.d.ts

@@ -1,19 +1,19 @@
 export declare const validOpenGlRenderers: readonly ["swangle", "angle", "egl", "swiftshader", "vulkan", "angle-egl"];
 export type OpenGlRenderer = (typeof validOpenGlRenderers)[number];
 export declare const DEFAULT_OPENGL_RENDERER: OpenGlRenderer | null;
-export declare const getChromiumOpenGlRenderer: () => "swangle" | "angle" | "egl" | "swiftshader" | "vulkan" | "angle-egl" | null;
+export declare const getChromiumOpenGlRenderer: () => "angle" | "swangle" | "egl" | "swiftshader" | "vulkan" | "angle-egl" | null;
 export declare const setChromiumOpenGlRenderer: (renderer: OpenGlRenderer) => void;
 export declare const glOption: {
     cliFlag: "gl";
     docLink: string;
     name: string;
-    type: "swangle" | "angle" | "egl" | "swiftshader" | "vulkan" | "angle-egl" | null;
+    type: "angle" | "swangle" | "egl" | "swiftshader" | "vulkan" | "angle-egl" | null;
     ssrName: string;
     description: () => import("react/jsx-runtime").JSX.Element;
     getValue: ({ commandLine }: {
         commandLine: Record<string, unknown>;
     }) => {
-        value: "swangle" | "angle" | "egl" | "swiftshader" | "vulkan" | "angle-egl";
+        value: "angle" | "swangle" | "egl" | "swiftshader" | "vulkan" | "angle-egl";
         source: string;
     } | {
         value: null;

package/dist/options/index.d.ts

@@ -245,19 +245,19 @@ export declare const allOptions: {
         cliFlag: "gl";
         docLink: string;
         name: string;
-        type: "swangle" | "angle" | "egl" | "swiftshader" | "vulkan" | "angle-egl" | null;
+        type: "angle" | "swangle" | "egl" | "swiftshader" | "vulkan" | "angle-egl" | null;
         ssrName: string;
         description: () => import("react/jsx-runtime").JSX.Element;
         getValue: ({ commandLine }: {
             commandLine: Record<string, unknown>;
         }) => {
-            value: "swangle" | "angle" | "egl" | "swiftshader" | "vulkan" | "angle-egl";
+            value: "angle" | "swangle" | "egl" | "swiftshader" | "vulkan" | "angle-egl";
             source: string;
         } | {
             value: null;
             source: string;
         };
-        setConfig: (value: "swangle" | "angle" | "egl" | "swiftshader" | "vulkan" | "angle-egl" | null) => void;
+        setConfig: (value: "angle" | "swangle" | "egl" | "swiftshader" | "vulkan" | "angle-egl" | null) => void;
     };
     enableLambdaInsights: {
         name: string;
@@ -382,17 +382,17 @@ export declare const allOptions: {
         description: () => import("react/jsx-runtime").JSX.Element;
         ssrName: "x264Preset";
         docLink: string;
-        type: "ultrafast" | "superfast" | "veryfast" | "faster" | "fast" | "medium" | "slow" | "slower" | "veryslow" | "placebo" | null;
+        type: "medium" | "ultrafast" | "superfast" | "veryfast" | "faster" | "fast" | "slow" | "slower" | "veryslow" | "placebo" | null;
         getValue: ({ commandLine }: {
             commandLine: Record<string, unknown>;
         }) => {
-            value: "ultrafast" | "superfast" | "veryfast" | "faster" | "fast" | "medium" | "slow" | "slower" | "veryslow" | "placebo";
+            value: "medium" | "ultrafast" | "superfast" | "veryfast" | "faster" | "fast" | "slow" | "slower" | "veryslow" | "placebo";
             source: string;
         } | {
             value: null;
             source: string;
         };
-        setConfig: (profile: "ultrafast" | "superfast" | "veryfast" | "faster" | "fast" | "medium" | "slow" | "slower" | "veryslow" | "placebo" | null) => void;
+        setConfig: (profile: "medium" | "ultrafast" | "superfast" | "veryfast" | "faster" | "fast" | "slow" | "slower" | "veryslow" | "placebo" | null) => void;
     };
     logLevelOption: {
         cliFlag: "log";
@@ -541,6 +541,16 @@ export declare const allOptions: {
         setConfig: (value: string | null) => void;
         type: string | null;
     };
+    onBrowserDownloadOption: {
+        name: string;
+        cliFlag: "on-browser-download";
+        description: () => import("react/jsx-runtime").JSX.Element;
+        ssrName: "onBrowserDownload";
+        docLink: string;
+        type: import("./on-browser-download").OnBrowserDownload;
+        getValue: () => never;
+        setConfig: () => never;
+    };
 };
 export type AvailableOptions = keyof typeof allOptions;
 export type TypeOfOption<Type> = Type extends AnyRemotionOption<infer X> ? X : never;

package/dist/options/index.js

@@ -22,6 +22,7 @@ const log_level_1 = require("./log-level");
 const mute_1 = require("./mute");
 const number_of_gif_loops_1 = require("./number-of-gif-loops");
 const offthreadvideo_cache_size_1 = require("./offthreadvideo-cache-size");
+const on_browser_download_1 = require("./on-browser-download");
 const overwrite_1 = require("./overwrite");
 const prefer_lossless_1 = require("./prefer-lossless");
 const public_dir_1 = require("./public-dir");
@@ -68,4 +69,5 @@ exports.allOptions = {
     separateAudioOption: separate_audio_1.separateAudioOption,
     publicPathOption: public_path_1.publicPathOption,
     publicDirOption: public_dir_1.publicDirOption,
+    onBrowserDownloadOption: on_browser_download_1.onBrowserDownloadOption,
 };

package/dist/options/log-level.js

@@ -9,7 +9,7 @@ exports.logLevelOption = {
     cliFlag,
     name: 'Log Level',
     ssrName: 'logLevel',
-    description: () => ((0, jsx_runtime_1.jsxs)(jsx_runtime_1.Fragment, { children: ["One of ", (0, jsx_runtime_1.jsx)("code", { children: "verbose" }), ", ", (0, jsx_runtime_1.jsx)("code", { children: "info" }), ", ", (0, jsx_runtime_1.jsx)("code", { children: "warn" }), ",", ' ', (0, jsx_runtime_1.jsx)("code", { children: "error" }), ". Determines how much is being logged to the console.", ' ', (0, jsx_runtime_1.jsx)("code", { children: "verbose" }), " will also log ", (0, jsx_runtime_1.jsx)("code", { children: "console.log" }), "'", "s from the browser. Default ", (0, jsx_runtime_1.jsx)("code", { children: "info" }), "."] })),
+    description: () => ((0, jsx_runtime_1.jsxs)(jsx_runtime_1.Fragment, { children: ["One of ", (0, jsx_runtime_1.jsx)("code", { children: "verbose" }), ", ", (0, jsx_runtime_1.jsx)("code", { children: "info" }), ", ", (0, jsx_runtime_1.jsx)("code", { children: "warn" }), ",", ' ', (0, jsx_runtime_1.jsx)("code", { children: "error" }), ".", (0, jsx_runtime_1.jsx)("br", {}), " Determines how much is being logged to the console.", (0, jsx_runtime_1.jsx)("br", {}), " ", (0, jsx_runtime_1.jsx)("code", { children: "verbose" }), " will also log ", (0, jsx_runtime_1.jsx)("code", { children: "console.log" }), "'", "s from the browser.", (0, jsx_runtime_1.jsx)("br", {}), " Default ", (0, jsx_runtime_1.jsx)("code", { children: "info" }), "."] })),
     docLink: 'https://www.remotion.dev/docs/troubleshooting/debug-failed-render',
     getValue: ({ commandLine }) => {
         if (commandLine[cliFlag]) {

package/dist/options/on-browser-download.d.ts

@@ -0,0 +1,19 @@
+export type DownloadBrowserProgressFn = (progress: {
+    percent: number;
+    downloadedBytes: number;
+    totalSizeInBytes: number;
+}) => void;
+export type OnBrowserDownload = () => {
+    onProgress: DownloadBrowserProgressFn;
+    version: string | null;
+};
+export declare const onBrowserDownloadOption: {
+    name: string;
+    cliFlag: "on-browser-download";
+    description: () => import("react/jsx-runtime").JSX.Element;
+    ssrName: "onBrowserDownload";
+    docLink: string;
+    type: OnBrowserDownload;
+    getValue: () => never;
+    setConfig: () => never;
+};

package/dist/options/on-browser-download.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.onBrowserDownloadOption = void 0;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const cliFlag = 'on-browser-download';
+exports.onBrowserDownloadOption = {
+    name: 'Browser download callback function',
+    cliFlag,
+    description: () => ((0, jsx_runtime_1.jsxs)(jsx_runtime_1.Fragment, { 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.", ' ', (0, jsx_runtime_1.jsx)("a", { href: "/docs/renderer/ensure-browser#onbrowserdownload", children: "See here for how to use this option." })] })),
+    ssrName: 'onBrowserDownload',
+    docLink: 'https://www.remotion.dev/docs/renderer/ensure-browser',
+    type: undefined,
+    getValue: () => {
+        throw new Error('does not support config file');
+    },
+    setConfig: () => {
+        throw new Error('does not support config file');
+    },
+};

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

@@ -72,17 +72,17 @@ export declare const optionsMap: {
             description: () => import("react/jsx-runtime").JSX.Element;
             ssrName: "x264Preset";
             docLink: string;
-            type: "ultrafast" | "superfast" | "veryfast" | "faster" | "fast" | "medium" | "slow" | "slower" | "veryslow" | "placebo" | null;
+            type: "medium" | "ultrafast" | "superfast" | "veryfast" | "faster" | "fast" | "slow" | "slower" | "veryslow" | "placebo" | null;
             getValue: ({ commandLine }: {
                 commandLine: Record<string, unknown>;
             }) => {
-                value: "ultrafast" | "superfast" | "veryfast" | "faster" | "fast" | "medium" | "slow" | "slower" | "veryslow" | "placebo";
+                value: "medium" | "ultrafast" | "superfast" | "veryfast" | "faster" | "fast" | "slow" | "slower" | "veryslow" | "placebo";
                 source: string;
             } | {
                 value: null;
                 source: string;
             };
-            setConfig: (profile: "ultrafast" | "superfast" | "veryfast" | "faster" | "fast" | "medium" | "slow" | "slower" | "veryslow" | "placebo" | null) => void;
+            setConfig: (profile: "medium" | "ultrafast" | "superfast" | "veryfast" | "faster" | "fast" | "slow" | "slower" | "veryslow" | "placebo" | null) => void;
         };
         readonly audioBitrate: {
             name: string;
@@ -303,6 +303,16 @@ export declare const optionsMap: {
             ssrName: "audioCodec";
             type: "mp3" | "aac" | "pcm-16" | "opus";
         };
+        readonly onBrowserDownload: {
+            name: string;
+            cliFlag: "on-browser-download";
+            description: () => import("react/jsx-runtime").JSX.Element;
+            ssrName: "onBrowserDownload";
+            docLink: string;
+            type: import("./on-browser-download").OnBrowserDownload;
+            getValue: () => never;
+            setConfig: () => never;
+        };
     };
     readonly stitchFramesToVideo: {
         readonly separateAudioTo: {
@@ -403,6 +413,16 @@ export declare const optionsMap: {
             };
             setConfig: (value: string | null) => void;
         };
+        readonly onBrowserDownload: {
+            name: string;
+            cliFlag: "on-browser-download";
+            description: () => import("react/jsx-runtime").JSX.Element;
+            ssrName: "onBrowserDownload";
+            docLink: string;
+            type: import("./on-browser-download").OnBrowserDownload;
+            getValue: () => never;
+            setConfig: () => never;
+        };
     };
     readonly getCompositions: {
         readonly offthreadVideoCacheSizeInBytes: {
@@ -468,6 +488,16 @@ export declare const optionsMap: {
             };
             setConfig: (value: string | null) => void;
         };
+        readonly onBrowserDownload: {
+            name: string;
+            cliFlag: "on-browser-download";
+            description: () => import("react/jsx-runtime").JSX.Element;
+            ssrName: "onBrowserDownload";
+            docLink: string;
+            type: import("./on-browser-download").OnBrowserDownload;
+            getValue: () => never;
+            setConfig: () => never;
+        };
     };
     readonly selectComposition: {
         readonly offthreadVideoCacheSizeInBytes: {
@@ -533,6 +563,16 @@ export declare const optionsMap: {
             };
             setConfig: (value: string | null) => void;
         };
+        readonly onBrowserDownload: {
+            name: string;
+            cliFlag: "on-browser-download";
+            description: () => import("react/jsx-runtime").JSX.Element;
+            ssrName: "onBrowserDownload";
+            docLink: string;
+            type: import("./on-browser-download").OnBrowserDownload;
+            getValue: () => never;
+            setConfig: () => never;
+        };
     };
     readonly renderFrames: {
         readonly forSeamlessAacConcatenation: {
@@ -631,6 +671,16 @@ export declare const optionsMap: {
             };
             setConfig: (value: string | null) => void;
         };
+        readonly onBrowserDownload: {
+            name: string;
+            cliFlag: "on-browser-download";
+            description: () => import("react/jsx-runtime").JSX.Element;
+            ssrName: "onBrowserDownload";
+            docLink: string;
+            type: import("./on-browser-download").OnBrowserDownload;
+            getValue: () => never;
+            setConfig: () => never;
+        };
     };
     readonly renderMediaOnLambda: {
         readonly offthreadVideoCacheSizeInBytes: {
@@ -744,17 +794,17 @@ export declare const optionsMap: {
             description: () => import("react/jsx-runtime").JSX.Element;
             ssrName: "x264Preset";
             docLink: string;
-            type: "ultrafast" | "superfast" | "veryfast" | "faster" | "fast" | "medium" | "slow" | "slower" | "veryslow" | "placebo" | null;
+            type: "medium" | "ultrafast" | "superfast" | "veryfast" | "faster" | "fast" | "slow" | "slower" | "veryslow" | "placebo" | null;
             getValue: ({ commandLine }: {
                 commandLine: Record<string, unknown>;
             }) => {
-                value: "ultrafast" | "superfast" | "veryfast" | "faster" | "fast" | "medium" | "slow" | "slower" | "veryslow" | "placebo";
+                value: "medium" | "ultrafast" | "superfast" | "veryfast" | "faster" | "fast" | "slow" | "slower" | "veryslow" | "placebo";
                 source: string;
             } | {
                 value: null;
                 source: string;
             };
-            setConfig: (profile: "ultrafast" | "superfast" | "veryfast" | "faster" | "fast" | "medium" | "slow" | "slower" | "veryslow" | "placebo" | null) => void;
+            setConfig: (profile: "medium" | "ultrafast" | "superfast" | "veryfast" | "faster" | "fast" | "slow" | "slower" | "veryslow" | "placebo" | null) => void;
         };
         readonly encodingMaxRate: {
             name: string;
@@ -1110,17 +1160,17 @@ export declare const optionsMap: {
             description: () => import("react/jsx-runtime").JSX.Element;
             ssrName: "x264Preset";
             docLink: string;
-            type: "ultrafast" | "superfast" | "veryfast" | "faster" | "fast" | "medium" | "slow" | "slower" | "veryslow" | "placebo" | null;
+            type: "medium" | "ultrafast" | "superfast" | "veryfast" | "faster" | "fast" | "slow" | "slower" | "veryslow" | "placebo" | null;
             getValue: ({ commandLine }: {
                 commandLine: Record<string, unknown>;
             }) => {
-                value: "ultrafast" | "superfast" | "veryfast" | "faster" | "fast" | "medium" | "slow" | "slower" | "veryslow" | "placebo";
+                value: "medium" | "ultrafast" | "superfast" | "veryfast" | "faster" | "fast" | "slow" | "slower" | "veryslow" | "placebo";
                 source: string;
             } | {
                 value: null;
                 source: string;
             };
-            setConfig: (profile: "ultrafast" | "superfast" | "veryfast" | "faster" | "fast" | "medium" | "slow" | "slower" | "veryslow" | "placebo" | null) => void;
+            setConfig: (profile: "medium" | "ultrafast" | "superfast" | "veryfast" | "faster" | "fast" | "slow" | "slower" | "veryslow" | "placebo" | null) => void;
         };
         readonly encodingMaxRate: {
             name: string;
@@ -1347,4 +1397,31 @@ export declare const optionsMap: {
             setConfig: (value: number) => void;
         };
     };
+    readonly ensureBrowser: {
+        readonly logLevel: {
+            cliFlag: "log";
+            name: string;
+            ssrName: string;
+            description: () => import("react/jsx-runtime").JSX.Element;
+            docLink: string;
+            getValue: ({ commandLine }: {
+                commandLine: Record<string, unknown>;
+            }) => {
+                value: "verbose" | "info" | "warn" | "error";
+                source: string;
+            };
+            setConfig: (newLogLevel: "verbose" | "info" | "warn" | "error") => void;
+            type: "verbose" | "info" | "warn" | "error";
+        };
+        readonly onBrowserDownload: {
+            name: string;
+            cliFlag: "on-browser-download";
+            description: () => import("react/jsx-runtime").JSX.Element;
+            ssrName: "onBrowserDownload";
+            docLink: string;
+            type: import("./on-browser-download").OnBrowserDownload;
+            getValue: () => never;
+            setConfig: () => never;
+        };
+    };
 };

package/dist/options/options-map.js

@@ -16,6 +16,7 @@ const log_level_1 = require("./log-level");
 const mute_1 = require("./mute");
 const number_of_gif_loops_1 = require("./number-of-gif-loops");
 const offthreadvideo_cache_size_1 = require("./offthreadvideo-cache-size");
+const on_browser_download_1 = require("./on-browser-download");
 const prefer_lossless_1 = require("./prefer-lossless");
 const repro_1 = require("./repro");
 const scale_1 = require("./scale");
@@ -44,6 +45,7 @@ exports.optionsMap = {
         forSeamlessAacConcatenation: for_seamless_aac_concatenation_1.forSeamlessAacConcatenationOption,
         separateAudioTo: separate_audio_1.separateAudioOption,
         audioCodec: audio_codec_1.audioCodecOption,
+        onBrowserDownload: on_browser_download_1.onBrowserDownloadOption,
     },
     stitchFramesToVideo: {
         separateAudioTo: separate_audio_1.separateAudioOption,
@@ -54,18 +56,21 @@ exports.optionsMap = {
         logLevel: log_level_1.logLevelOption,
         timeoutInMilliseconds: timeout_1.delayRenderTimeoutInMillisecondsOption,
         binariesDirectory: binaries_directory_1.binariesDirectoryOption,
+        onBrowserDownload: on_browser_download_1.onBrowserDownloadOption,
     },
     getCompositions: {
         offthreadVideoCacheSizeInBytes: offthreadvideo_cache_size_1.offthreadVideoCacheSizeInBytesOption,
         logLevel: log_level_1.logLevelOption,
         timeoutInMilliseconds: timeout_1.delayRenderTimeoutInMillisecondsOption,
         binariesDirectory: binaries_directory_1.binariesDirectoryOption,
+        onBrowserDownload: on_browser_download_1.onBrowserDownloadOption,
     },
     selectComposition: {
         offthreadVideoCacheSizeInBytes: offthreadvideo_cache_size_1.offthreadVideoCacheSizeInBytesOption,
         logLevel: log_level_1.logLevelOption,
         timeoutInMilliseconds: timeout_1.delayRenderTimeoutInMillisecondsOption,
         binariesDirectory: binaries_directory_1.binariesDirectoryOption,
+        onBrowserDownload: on_browser_download_1.onBrowserDownloadOption,
     },
     renderFrames: {
         forSeamlessAacConcatenation: for_seamless_aac_concatenation_1.forSeamlessAacConcatenationOption,
@@ -74,6 +79,7 @@ exports.optionsMap = {
         logLevel: log_level_1.logLevelOption,
         timeoutInMilliseconds: timeout_1.delayRenderTimeoutInMillisecondsOption,
         binariesDirectory: binaries_directory_1.binariesDirectoryOption,
+        onBrowserDownload: on_browser_download_1.onBrowserDownloadOption,
     },
     renderMediaOnLambda: {
         offthreadVideoCacheSizeInBytes: offthreadvideo_cache_size_1.offthreadVideoCacheSizeInBytesOption,
@@ -128,4 +134,8 @@ exports.optionsMap = {
         jpegQuality: jpeg_quality_1.jpegQualityOption,
         delayRenderTimeoutInMilliseconds: timeout_1.delayRenderTimeoutInMillisecondsOption,
     },
+    ensureBrowser: {
+        logLevel: log_level_1.logLevelOption,
+        onBrowserDownload: on_browser_download_1.onBrowserDownloadOption,
+    },
 };

package/dist/options/x264-preset.d.ts

@@ -11,11 +11,11 @@ export declare const x264Option: {
     description: () => import("react/jsx-runtime").JSX.Element;
     ssrName: "x264Preset";
     docLink: string;
-    type: "ultrafast" | "superfast" | "veryfast" | "faster" | "fast" | "medium" | "slow" | "slower" | "veryslow" | "placebo" | null;
+    type: "medium" | "ultrafast" | "superfast" | "veryfast" | "faster" | "fast" | "slow" | "slower" | "veryslow" | "placebo" | null;
     getValue: ({ commandLine }: {
         commandLine: Record<string, unknown>;
     }) => {
-        value: "ultrafast" | "superfast" | "veryfast" | "faster" | "fast" | "medium" | "slow" | "slower" | "veryslow" | "placebo";
+        value: "medium" | "ultrafast" | "superfast" | "veryfast" | "faster" | "fast" | "slow" | "slower" | "veryslow" | "placebo";
         source: string;
     } | {
         value: null;

package/dist/port-config.d.ts

@@ -2,6 +2,7 @@
 /// <reference types="node" />
 /// <reference types="node" />
 /// <reference types="node" />
+/// <reference types="node" />
 import type { NetworkInterfaceInfo } from 'os';
 import os from 'os';
 type PortConfig = {

package/dist/render-frames.js

@@ -10,8 +10,9 @@ const perf_hooks_1 = require("perf_hooks");
 const no_react_1 = require("remotion/no-react");
 const download_and_map_assets_to_file_1 = require("./assets/download-and-map-assets-to-file");
 const browser_1 = require("./browser");
-const is_target_closed_err_1 = require("./browser/is-target-closed-err");
 const TimeoutSettings_1 = require("./browser/TimeoutSettings");
+const browser_download_progress_bar_1 = require("./browser/browser-download-progress-bar");
+const is_target_closed_err_1 = require("./browser/is-target-closed-err");
 const compress_assets_1 = require("./compress-assets");
 const cycle_browser_tabs_1 = require("./cycle-browser-tabs");
 const handle_javascript_exception_1 = require("./error-handling/handle-javascript-exception");
@@ -356,7 +357,7 @@ const innerRenderFrames = async ({ onFrameUpdate, outputDir, onStart, serialized
         frameCount: framesToRender.length,
     };
 };
-const internalRenderFramesRaw = ({ browserExecutable, cancelSignal, chromiumOptions, composition, concurrency, envVariables, everyNthFrame, frameRange, imageFormat, indent, jpegQuality, muted, onBrowserLog, onDownload, onFrameBuffer, onFrameUpdate, onStart, outputDir, port, puppeteerInstance, scale, server, timeoutInMilliseconds, logLevel, webpackBundleOrServeUrl, serializedInputPropsWithCustomSchema, serializedResolvedPropsWithCustomSchema, offthreadVideoCacheSizeInBytes, parallelEncodingEnabled, binariesDirectory, forSeamlessAacConcatenation, compositionStart, }) => {
+const internalRenderFramesRaw = ({ browserExecutable, cancelSignal, chromiumOptions, composition, concurrency, envVariables, everyNthFrame, frameRange, imageFormat, indent, jpegQuality, muted, onBrowserLog, onDownload, onFrameBuffer, onFrameUpdate, onStart, outputDir, port, puppeteerInstance, scale, server, timeoutInMilliseconds, logLevel, webpackBundleOrServeUrl, serializedInputPropsWithCustomSchema, serializedResolvedPropsWithCustomSchema, offthreadVideoCacheSizeInBytes, parallelEncodingEnabled, binariesDirectory, forSeamlessAacConcatenation, compositionStart, onBrowserDownload, }) => {
     (0, validate_1.validateDimension)(composition.height, 'height', 'in the `config` object passed to `renderFrames()`');
     (0, validate_1.validateDimension)(composition.width, 'width', 'in the `config` object passed to `renderFrames()`');
     (0, validate_1.validateFps)(composition.fps, 'in the `config` object of `renderFrames()`', false);
@@ -374,6 +375,7 @@ const internalRenderFramesRaw = ({ browserExecutable, cancelSignal, chromiumOpti
         indent,
         viewport: null,
         logLevel,
+        onBrowserDownload,
     });
     const browserInstance = puppeteerInstance !== null && puppeteerInstance !== void 0 ? puppeteerInstance : makeBrowser();
     const actualConcurrency = (0, get_concurrency_1.getActualConcurrency)(concurrency);
@@ -449,6 +451,7 @@ const internalRenderFramesRaw = ({ browserExecutable, cancelSignal, chromiumOpti
                     binariesDirectory,
                     forSeamlessAacConcatenation,
                     compositionStart,
+                    onBrowserDownload,
                 });
             }),
         ])
@@ -492,7 +495,7 @@ exports.internalRenderFrames = (0, wrap_with_error_handling_1.wrapWithErrorHandl
  * @see [Documentation](https://www.remotion.dev/docs/renderer/render-frames)
  */
 const renderFrames = (options) => {
-    const { composition, inputProps, onFrameUpdate, onStart, outputDir, serveUrl, browserExecutable, cancelSignal, chromiumOptions, concurrency, dumpBrowserLogs, envVariables, everyNthFrame, frameRange, imageFormat, jpegQuality, muted, onBrowserLog, onDownload, onFrameBuffer, port, puppeteerInstance, scale, timeoutInMilliseconds, verbose, quality, logLevel, offthreadVideoCacheSizeInBytes, binariesDirectory, } = options;
+    const { composition, inputProps, onFrameUpdate, onStart, outputDir, serveUrl, browserExecutable, cancelSignal, chromiumOptions, concurrency, dumpBrowserLogs, envVariables, everyNthFrame, frameRange, imageFormat, jpegQuality, muted, onBrowserLog, onDownload, onFrameBuffer, port, puppeteerInstance, scale, timeoutInMilliseconds, verbose, quality, logLevel: passedLogLevel, offthreadVideoCacheSizeInBytes, binariesDirectory, onBrowserDownload, } = options;
     if (!composition) {
         throw new Error('No `composition` option has been specified for renderFrames()');
     }
@@ -502,6 +505,8 @@ const renderFrames = (options) => {
     if (quality) {
         console.warn('Passing `quality()` to `renderStill` is deprecated. Use `jpegQuality` instead.');
     }
+    const logLevel = verbose || dumpBrowserLogs ? 'verbose' : passedLogLevel !== null && passedLogLevel !== void 0 ? passedLogLevel : 'info';
+    const indent = false;
     return (0, exports.internalRenderFrames)({
         browserExecutable: browserExecutable !== null && browserExecutable !== void 0 ? browserExecutable : null,
         cancelSignal,
@@ -512,7 +517,7 @@ const renderFrames = (options) => {
         everyNthFrame: everyNthFrame !== null && everyNthFrame !== void 0 ? everyNthFrame : 1,
         frameRange: frameRange !== null && frameRange !== void 0 ? frameRange : null,
         imageFormat: imageFormat !== null && imageFormat !== void 0 ? imageFormat : 'jpeg',
-        indent: false,
+        indent,
         jpegQuality: jpegQuality !== null && jpegQuality !== void 0 ? jpegQuality : jpeg_quality_1.DEFAULT_JPEG_QUALITY,
         onDownload: onDownload !== null && onDownload !== void 0 ? onDownload : null,
         serializedInputPropsWithCustomSchema: no_react_1.NoReactInternals.serializeJSONWithDate({
@@ -534,7 +539,7 @@ const renderFrames = (options) => {
         outputDir,
         port: port !== null && port !== void 0 ? port : null,
         scale: scale !== null && scale !== void 0 ? scale : 1,
-        logLevel: verbose || dumpBrowserLogs ? 'verbose' : logLevel !== null && logLevel !== void 0 ? logLevel : 'info',
+        logLevel,
         timeoutInMilliseconds: timeoutInMilliseconds !== null && timeoutInMilliseconds !== void 0 ? timeoutInMilliseconds : TimeoutSettings_1.DEFAULT_TIMEOUT,
         webpackBundleOrServeUrl: serveUrl,
         server: undefined,
@@ -543,6 +548,7 @@ const renderFrames = (options) => {
         binariesDirectory: binariesDirectory !== null && binariesDirectory !== void 0 ? binariesDirectory : null,
         compositionStart: 0,
         forSeamlessAacConcatenation: false,
+        onBrowserDownload: onBrowserDownload !== null && onBrowserDownload !== void 0 ? onBrowserDownload : (0, browser_download_progress_bar_1.defaultBrowserDownloadProgress)({ indent, logLevel, api: 'renderFrames()' }),
     });
 };
 exports.renderFrames = renderFrames;

package/dist/render-media.d.ts

@@ -129,5 +129,5 @@ export declare const internalRenderMedia: (args_0: InternalRenderMediaOptions) =
  * @description Render a video from a composition
  * @see [Documentation](https://www.remotion.dev/docs/renderer/render-media)
  */
-export declare const renderMedia: ({ proResProfile, x264Preset, crf, composition, inputProps, pixelFormat, codec, envVariables, frameRange, puppeteerInstance, outputLocation, onProgress, overwrite, onDownload, onBrowserLog, onStart, timeoutInMilliseconds, chromiumOptions, scale, browserExecutable, port, cancelSignal, muted, enforceAudioTrack, ffmpegOverride, audioBitrate, videoBitrate, encodingMaxRate, encodingBufferSize, audioCodec, jpegQuality, concurrency, serveUrl, disallowParallelEncoding, everyNthFrame, imageFormat, numberOfGifLoops, dumpBrowserLogs, preferLossless, verbose, quality, logLevel, offthreadVideoCacheSizeInBytes, colorSpace, repro, binariesDirectory, separateAudioTo, forSeamlessAacConcatenation, }: RenderMediaOptions) => Promise<RenderMediaResult>;
+export declare const renderMedia: ({ proResProfile, x264Preset, crf, composition, inputProps, pixelFormat, codec, envVariables, frameRange, puppeteerInstance, outputLocation, onProgress, overwrite, onDownload, onBrowserLog, onStart, timeoutInMilliseconds, chromiumOptions, scale, browserExecutable, port, cancelSignal, muted, enforceAudioTrack, ffmpegOverride, audioBitrate, videoBitrate, encodingMaxRate, encodingBufferSize, audioCodec, jpegQuality, concurrency, serveUrl, disallowParallelEncoding, everyNthFrame, imageFormat, numberOfGifLoops, dumpBrowserLogs, preferLossless, verbose, quality, logLevel: passedLogLevel, offthreadVideoCacheSizeInBytes, colorSpace, repro, binariesDirectory, separateAudioTo, forSeamlessAacConcatenation, onBrowserDownload, }: RenderMediaOptions) => Promise<RenderMediaResult>;
 export {};