@remotion/renderer 4.0.246 → 4.0.248

package/dist/options/options-map.js

@@ -4,6 +4,7 @@ exports.optionsMap = void 0;
 const audio_bitrate_1 = require("./audio-bitrate");
 const audio_codec_1 = require("./audio-codec");
 const binaries_directory_1 = require("./binaries-directory");
+const chrome_mode_1 = require("./chrome-mode");
 const color_space_1 = require("./color-space");
 const crf_1 = require("./crf");
 const delete_after_1 = require("./delete-after");
@@ -49,6 +50,7 @@ exports.optionsMap = {
         audioCodec: audio_codec_1.audioCodecOption,
         onBrowserDownload: on_browser_download_1.onBrowserDownloadOption,
         hardwareAcceleration: hardware_acceleration_1.hardwareAccelerationOption,
+        chromeMode: chrome_mode_1.chromeModeOption,
     },
     stitchFramesToVideo: {
         separateAudioTo: separate_audio_1.separateAudioOption,
@@ -61,6 +63,7 @@ exports.optionsMap = {
         timeoutInMilliseconds: timeout_1.delayRenderTimeoutInMillisecondsOption,
         binariesDirectory: binaries_directory_1.binariesDirectoryOption,
         onBrowserDownload: on_browser_download_1.onBrowserDownloadOption,
+        chromeMode: chrome_mode_1.chromeModeOption,
     },
     getCompositions: {
         offthreadVideoCacheSizeInBytes: offthreadvideo_cache_size_1.offthreadVideoCacheSizeInBytesOption,
@@ -68,6 +71,7 @@ exports.optionsMap = {
         timeoutInMilliseconds: timeout_1.delayRenderTimeoutInMillisecondsOption,
         binariesDirectory: binaries_directory_1.binariesDirectoryOption,
         onBrowserDownload: on_browser_download_1.onBrowserDownloadOption,
+        chromeMode: chrome_mode_1.chromeModeOption,
     },
     selectComposition: {
         offthreadVideoCacheSizeInBytes: offthreadvideo_cache_size_1.offthreadVideoCacheSizeInBytesOption,
@@ -75,6 +79,7 @@ exports.optionsMap = {
         timeoutInMilliseconds: timeout_1.delayRenderTimeoutInMillisecondsOption,
         binariesDirectory: binaries_directory_1.binariesDirectoryOption,
         onBrowserDownload: on_browser_download_1.onBrowserDownloadOption,
+        chromeMode: chrome_mode_1.chromeModeOption,
     },
     renderFrames: {
         forSeamlessAacConcatenation: for_seamless_aac_concatenation_1.forSeamlessAacConcatenationOption,
@@ -84,6 +89,7 @@ exports.optionsMap = {
         timeoutInMilliseconds: timeout_1.delayRenderTimeoutInMillisecondsOption,
         binariesDirectory: binaries_directory_1.binariesDirectoryOption,
         onBrowserDownload: on_browser_download_1.onBrowserDownloadOption,
+        chromeMode: chrome_mode_1.chromeModeOption,
     },
     renderMediaOnLambda: {
         offthreadVideoCacheSizeInBytes: offthreadvideo_cache_size_1.offthreadVideoCacheSizeInBytesOption,
@@ -141,6 +147,12 @@ exports.optionsMap = {
     ensureBrowser: {
         logLevel: log_level_1.logLevelOption,
         onBrowserDownload: on_browser_download_1.onBrowserDownloadOption,
+        chromeMode: chrome_mode_1.chromeModeOption,
+    },
+    openBrowser: {
+        logLevel: log_level_1.logLevelOption,
+        onBrowserDownload: on_browser_download_1.onBrowserDownloadOption,
+        chromeMode: chrome_mode_1.chromeModeOption,
     },
     deploySiteLambda: {
         logLevel: log_level_1.logLevelOption,

package/dist/options/webhook-custom-data.d.ts

@@ -1,7 +1,7 @@
 export declare const webhookCustomDataOption: {
     name: string;
     cliFlag: "webhook-custom-data";
-    description: (type: "ssr" | "cli") => import("react/jsx-runtime").JSX.Element;
+    description: (type: "cli" | "ssr") => import("react/jsx-runtime").JSX.Element;
     ssrName: "customData";
     docLink: string;
     type: Record<string, unknown> | null;

package/dist/render-frames.js

@@ -413,7 +413,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, onBrowserDownload, onArtifact, }) => {
+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, onArtifact, chromeMode, }) => {
     (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);
@@ -432,6 +432,7 @@ const internalRenderFramesRaw = ({ browserExecutable, cancelSignal, chromiumOpti
         viewport: null,
         logLevel,
         onBrowserDownload,
+        chromeMode,
     });
     const browserInstance = puppeteerInstance !== null && puppeteerInstance !== void 0 ? puppeteerInstance : makeBrowser();
     const resolvedConcurrency = (0, get_concurrency_1.resolveConcurrency)(concurrency);
@@ -507,6 +508,7 @@ const internalRenderFramesRaw = ({ browserExecutable, cancelSignal, chromiumOpti
                     compositionStart,
                     onBrowserDownload,
                     onArtifact,
+                    chromeMode,
                 });
             }),
         ])
@@ -555,7 +557,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: passedLogLevel, offthreadVideoCacheSizeInBytes, binariesDirectory, onBrowserDownload, onArtifact, } = 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, onArtifact, chromeMode, } = options;
     if (!composition) {
         throw new Error('No `composition` option has been specified for renderFrames()');
     }
@@ -610,6 +612,7 @@ const renderFrames = (options) => {
         forSeamlessAacConcatenation: false,
         onBrowserDownload: onBrowserDownload !== null && onBrowserDownload !== void 0 ? onBrowserDownload : (0, browser_download_progress_bar_1.defaultBrowserDownloadProgress)({ indent, logLevel, api: 'renderFrames()' }),
         onArtifact: onArtifact !== null && onArtifact !== void 0 ? onArtifact : null,
+        chromeMode: chromeMode !== null && chromeMode !== void 0 ? chromeMode : 'headless-shell',
     });
 };
 exports.renderFrames = renderFrames;

package/dist/render-media.d.ts

@@ -128,5 +128,5 @@ type RenderMediaResult = {
     slowestFrames: SlowFrame[];
 };
 export declare const internalRenderMedia: (args_0: InternalRenderMediaOptions) => Promise<RenderMediaResult>;
-export declare const renderMedia: ({ proResProfile, x264Preset, crf, composition, inputProps, pixelFormat, codec, envVariables, frameRange, puppeteerInstance, outputLocation, onProgress, overwrite, onDownload, onBrowserLog, onStart, timeoutInMilliseconds, chromiumOptions, scale, browserExecutable, port, cancelSignal, muted, enforceAudioTrack, ffmpegOverride, audioBitrate, videoBitrate, encodingMaxRate, encodingBufferSize, audioCodec, jpegQuality, concurrency, serveUrl, disallowParallelEncoding, everyNthFrame, imageFormat, numberOfGifLoops, dumpBrowserLogs, preferLossless, verbose, quality, logLevel: passedLogLevel, offthreadVideoCacheSizeInBytes, colorSpace, repro, binariesDirectory, separateAudioTo, forSeamlessAacConcatenation, onBrowserDownload, onArtifact, metadata, hardwareAcceleration, }: 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, onArtifact, metadata, hardwareAcceleration, chromeMode, }: RenderMediaOptions) => Promise<RenderMediaResult>;
 export {};

package/dist/render-media.js

@@ -50,7 +50,7 @@ const validate_scale_1 = require("./validate-scale");
 const validate_videobitrate_1 = require("./validate-videobitrate");
 const wrap_with_error_handling_1 = require("./wrap-with-error-handling");
 const SLOWEST_FRAME_COUNT = 10;
-const internalRenderMediaRaw = ({ proResProfile, x264Preset, crf, composition, serializedInputPropsWithCustomSchema, 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, concurrency, disallowParallelEncoding, everyNthFrame, imageFormat: provisionalImageFormat, indent, jpegQuality, numberOfGifLoops, onCtrlCExit, preferLossless, serveUrl, server: reusedServer, logLevel, serializedResolvedPropsWithCustomSchema, offthreadVideoCacheSizeInBytes, colorSpace, repro, binariesDirectory, separateAudioTo, forSeamlessAacConcatenation, compositionStart, onBrowserDownload, onArtifact, metadata, hardwareAcceleration, }) => {
+const internalRenderMediaRaw = ({ proResProfile, x264Preset, crf, composition, serializedInputPropsWithCustomSchema, 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, concurrency, disallowParallelEncoding, everyNthFrame, imageFormat: provisionalImageFormat, indent, jpegQuality, numberOfGifLoops, onCtrlCExit, preferLossless, serveUrl, server: reusedServer, logLevel, serializedResolvedPropsWithCustomSchema, offthreadVideoCacheSizeInBytes, colorSpace, repro, binariesDirectory, separateAudioTo, forSeamlessAacConcatenation, compositionStart, onBrowserDownload, onArtifact, metadata, hardwareAcceleration, chromeMode, }) => {
     if (repro) {
         (0, repro_1.enableRepro)({
             serveUrl,
@@ -361,6 +361,7 @@ const internalRenderMediaRaw = ({ proResProfile, x264Preset, crf, composition, s
                 forSeamlessAacConcatenation,
                 onBrowserDownload,
                 onArtifact,
+                chromeMode,
             });
             return renderFramesProc;
         })
@@ -505,7 +506,7 @@ exports.internalRenderMedia = (0, wrap_with_error_handling_1.wrapWithErrorHandli
  * @description Render a video or an audio programmatically.
  * @see [Documentation](https://www.remotion.dev/docs/renderer/render-media)
  */
-const renderMedia = ({ proResProfile, x264Preset, crf, composition, inputProps, pixelFormat, codec, envVariables, frameRange, puppeteerInstance, outputLocation, onProgress, overwrite, onDownload, onBrowserLog, onStart, timeoutInMilliseconds, chromiumOptions, scale, browserExecutable, port, cancelSignal, muted, enforceAudioTrack, ffmpegOverride, audioBitrate, videoBitrate, encodingMaxRate, encodingBufferSize, audioCodec, jpegQuality, concurrency, serveUrl, disallowParallelEncoding, everyNthFrame, imageFormat, numberOfGifLoops, dumpBrowserLogs, preferLossless, verbose, quality, logLevel: passedLogLevel, offthreadVideoCacheSizeInBytes, colorSpace, repro, binariesDirectory, separateAudioTo, forSeamlessAacConcatenation, onBrowserDownload, onArtifact, metadata, hardwareAcceleration, }) => {
+const renderMedia = ({ proResProfile, x264Preset, crf, composition, inputProps, pixelFormat, codec, envVariables, frameRange, puppeteerInstance, outputLocation, onProgress, overwrite, onDownload, onBrowserLog, onStart, timeoutInMilliseconds, chromiumOptions, scale, browserExecutable, port, cancelSignal, muted, enforceAudioTrack, ffmpegOverride, audioBitrate, videoBitrate, encodingMaxRate, encodingBufferSize, audioCodec, jpegQuality, concurrency, serveUrl, disallowParallelEncoding, everyNthFrame, imageFormat, numberOfGifLoops, dumpBrowserLogs, preferLossless, verbose, quality, logLevel: passedLogLevel, offthreadVideoCacheSizeInBytes, colorSpace, repro, binariesDirectory, separateAudioTo, forSeamlessAacConcatenation, onBrowserDownload, onArtifact, metadata, hardwareAcceleration, chromeMode, }) => {
     var _a, _b;
     const indent = false;
     const logLevel = verbose || dumpBrowserLogs ? 'verbose' : (passedLogLevel !== null && passedLogLevel !== void 0 ? passedLogLevel : 'info');
@@ -570,12 +571,17 @@ const renderMedia = ({ proResProfile, x264Preset, crf, composition, inputProps,
         binariesDirectory: binariesDirectory !== null && binariesDirectory !== void 0 ? binariesDirectory : null,
         separateAudioTo: separateAudioTo !== null && separateAudioTo !== void 0 ? separateAudioTo : null,
         forSeamlessAacConcatenation: forSeamlessAacConcatenation !== null && forSeamlessAacConcatenation !== void 0 ? forSeamlessAacConcatenation : false,
-        onBrowserDownload: onBrowserDownload !== null && onBrowserDownload !== void 0 ? onBrowserDownload : (0, browser_download_progress_bar_1.defaultBrowserDownloadProgress)({ indent, logLevel, api: 'renderMedia()' }),
+        onBrowserDownload: onBrowserDownload !== null && onBrowserDownload !== void 0 ? onBrowserDownload : (0, browser_download_progress_bar_1.defaultBrowserDownloadProgress)({
+            indent,
+            logLevel,
+            api: 'renderMedia()',
+        }),
         onArtifact: onArtifact !== null && onArtifact !== void 0 ? onArtifact : null,
         metadata: metadata !== null && metadata !== void 0 ? metadata : null,
         // TODO: In the future, introduce this as a public API when launching the distributed rendering API
         compositionStart: 0,
         hardwareAcceleration: hardwareAcceleration !== null && hardwareAcceleration !== void 0 ? hardwareAcceleration : 'disable',
+        chromeMode: chromeMode !== null && chromeMode !== void 0 ? chromeMode : 'headless-shell',
     });
 };
 exports.renderMedia = renderMedia;

package/dist/render-still.js

@@ -53,7 +53,7 @@ const validate_1 = require("./validate");
 const validate_puppeteer_timeout_1 = require("./validate-puppeteer-timeout");
 const validate_scale_1 = require("./validate-scale");
 const wrap_with_error_handling_1 = require("./wrap-with-error-handling");
-const innerRenderStill = async ({ composition, imageFormat = image_format_1.DEFAULT_STILL_IMAGE_FORMAT, serveUrl, puppeteerInstance, onError, serializedInputPropsWithCustomSchema, envVariables, output, frame = 0, overwrite, browserExecutable, timeoutInMilliseconds, chromiumOptions, scale, proxyPort, cancelSignal, jpegQuality, onBrowserLog, sourceMapGetter, logLevel, indent, serializedResolvedPropsWithCustomSchema, onBrowserDownload, onArtifact, }) => {
+const innerRenderStill = async ({ composition, imageFormat = image_format_1.DEFAULT_STILL_IMAGE_FORMAT, serveUrl, puppeteerInstance, onError, serializedInputPropsWithCustomSchema, envVariables, output, frame = 0, overwrite, browserExecutable, timeoutInMilliseconds, chromiumOptions, scale, proxyPort, cancelSignal, jpegQuality, onBrowserLog, sourceMapGetter, logLevel, indent, serializedResolvedPropsWithCustomSchema, onBrowserDownload, onArtifact, chromeMode, }) => {
     (0, validate_1.validateDimension)(composition.height, 'height', 'in the `config` object passed to `renderStill()`');
     (0, validate_1.validateDimension)(composition.width, 'width', 'in the `config` object passed to `renderStill()`');
     (0, validate_1.validateFps)(composition.fps, 'in the `config` object of `renderStill()`', false);
@@ -97,6 +97,7 @@ const innerRenderStill = async ({ composition, imageFormat = image_format_1.DEFA
         viewport: null,
         logLevel,
         onBrowserDownload,
+        chromeMode,
     }));
     const page = await browserInstance.newPage(sourceMapGetter, logLevel, indent);
     await page.setViewport({
@@ -270,7 +271,7 @@ exports.internalRenderStill = (0, wrap_with_error_handling_1.wrapWithErrorHandli
  */
 const renderStill = (options) => {
     var _a, _b;
-    const { composition, serveUrl, browserExecutable, cancelSignal, chromiumOptions, dumpBrowserLogs, envVariables, frame, imageFormat, inputProps, jpegQuality, onBrowserLog, onDownload, output, overwrite, port, puppeteerInstance, scale, timeoutInMilliseconds, verbose, quality, offthreadVideoCacheSizeInBytes, logLevel: passedLogLevel, binariesDirectory, onBrowserDownload, onArtifact, } = options;
+    const { composition, serveUrl, browserExecutable, cancelSignal, chromiumOptions, dumpBrowserLogs, envVariables, frame, imageFormat, inputProps, jpegQuality, onBrowserLog, onDownload, output, overwrite, port, puppeteerInstance, scale, timeoutInMilliseconds, verbose, quality, offthreadVideoCacheSizeInBytes, logLevel: passedLogLevel, binariesDirectory, onBrowserDownload, onArtifact, chromeMode, } = options;
     if (typeof jpegQuality !== 'undefined' && imageFormat !== 'jpeg') {
         throw new Error("You can only pass the `quality` option if `imageFormat` is 'jpeg'.");
     }
@@ -312,8 +313,13 @@ const renderStill = (options) => {
         }).serializedString,
         offthreadVideoCacheSizeInBytes: offthreadVideoCacheSizeInBytes !== null && offthreadVideoCacheSizeInBytes !== void 0 ? offthreadVideoCacheSizeInBytes : null,
         binariesDirectory: binariesDirectory !== null && binariesDirectory !== void 0 ? binariesDirectory : null,
-        onBrowserDownload: onBrowserDownload !== null && onBrowserDownload !== void 0 ? onBrowserDownload : (0, browser_download_progress_bar_1.defaultBrowserDownloadProgress)({ indent, logLevel, api: 'renderStill()' }),
+        onBrowserDownload: onBrowserDownload !== null && onBrowserDownload !== void 0 ? onBrowserDownload : (0, browser_download_progress_bar_1.defaultBrowserDownloadProgress)({
+            indent,
+            logLevel,
+            api: 'renderStill()',
+        }),
         onArtifact: onArtifact !== null && onArtifact !== void 0 ? onArtifact : null,
+        chromeMode: chromeMode !== null && chromeMode !== void 0 ? chromeMode : 'headless-shell',
     });
 };
 exports.renderStill = renderStill;

package/dist/select-composition.js

@@ -96,7 +96,7 @@ const innerSelectComposition = async ({ page, onBrowserLog, serializedInputProps
 };
 const internalSelectCompositionRaw = async (options) => {
     const cleanup = [];
-    const { puppeteerInstance, browserExecutable, chromiumOptions, serveUrl: serveUrlOrWebpackUrl, logLevel, indent, port, envVariables, id, serializedInputPropsWithCustomSchema, onBrowserLog, server, timeoutInMilliseconds, offthreadVideoCacheSizeInBytes, binariesDirectory, onBrowserDownload, onServeUrlVisited, } = options;
+    const { puppeteerInstance, browserExecutable, chromiumOptions, serveUrl: serveUrlOrWebpackUrl, logLevel, indent, port, envVariables, id, serializedInputPropsWithCustomSchema, onBrowserLog, server, timeoutInMilliseconds, offthreadVideoCacheSizeInBytes, binariesDirectory, onBrowserDownload, onServeUrlVisited, chromeMode, } = options;
     const [{ page, cleanupPage }, serverUsed] = await Promise.all([
         (0, get_browser_instance_1.getPageAndCleanupFn)({
             passedInInstance: puppeteerInstance,
@@ -106,6 +106,7 @@ const internalSelectCompositionRaw = async (options) => {
             indent,
             logLevel,
             onBrowserDownload,
+            chromeMode,
         }),
         (0, prepare_server_1.makeOrReuseServer)(options.server, {
             webpackConfigOrServeUrl: serveUrlOrWebpackUrl,
@@ -152,6 +153,7 @@ const internalSelectCompositionRaw = async (options) => {
             binariesDirectory,
             onBrowserDownload,
             onServeUrlVisited,
+            chromeMode,
         })
             .then((data) => {
             return resolve(data);
@@ -177,7 +179,7 @@ exports.internalSelectComposition = (0, wrap_with_error_handling_1.wrapWithError
  * @see [Documentation](https://www.remotion.dev/docs/renderer/select-composition)
  */
 const selectComposition = async (options) => {
-    const { id, serveUrl, browserExecutable, chromiumOptions, envVariables, inputProps, onBrowserLog, port, puppeteerInstance, timeoutInMilliseconds, verbose, logLevel: passedLogLevel, offthreadVideoCacheSizeInBytes, binariesDirectory, onBrowserDownload, } = options;
+    const { id, serveUrl, browserExecutable, chromiumOptions, envVariables, inputProps, onBrowserLog, port, puppeteerInstance, timeoutInMilliseconds, verbose, logLevel: passedLogLevel, offthreadVideoCacheSizeInBytes, binariesDirectory, onBrowserDownload, chromeMode, } = options;
     const indent = false;
     const logLevel = (passedLogLevel !== null && passedLogLevel !== void 0 ? passedLogLevel : verbose) ? 'verbose' : 'info';
     const data = await (0, exports.internalSelectComposition)({
@@ -206,6 +208,7 @@ const selectComposition = async (options) => {
             api: 'selectComposition()',
         }),
         onServeUrlVisited: () => undefined,
+        chromeMode: chromeMode !== null && chromeMode !== void 0 ? chromeMode : 'headless-shell',
     });
     return data.metadata;
 };

package/dist/test-gpu.d.ts

@@ -1,17 +1,19 @@
 import type { BrowserExecutable } from './browser-executable';
 import type { LogLevel } from './log-level';
 import type { ChromiumOptions } from './open-browser';
+import type { ChromeMode } from './options/chrome-mode';
 import type { OnBrowserDownload } from './options/on-browser-download';
 type Item = {
     feature: string;
     status: string;
 };
-export declare const getChromiumGpuInformation: ({ browserExecutable, indent, logLevel, chromiumOptions, timeoutInMilliseconds, onBrowserDownload, }: {
+export declare const getChromiumGpuInformation: ({ browserExecutable, indent, logLevel, chromiumOptions, timeoutInMilliseconds, onBrowserDownload, chromeMode, }: {
     browserExecutable: BrowserExecutable;
     indent: boolean;
     logLevel: LogLevel;
     chromiumOptions: ChromiumOptions;
     timeoutInMilliseconds: number;
     onBrowserDownload: OnBrowserDownload;
+    chromeMode: ChromeMode;
 }) => Promise<Item[]>;
 export {};

package/dist/test-gpu.js

@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.getChromiumGpuInformation = void 0;
 const get_browser_instance_1 = require("./get-browser-instance");
 const puppeteer_evaluate_1 = require("./puppeteer-evaluate");
-const getChromiumGpuInformation = async ({ browserExecutable, indent, logLevel, chromiumOptions, timeoutInMilliseconds, onBrowserDownload, }) => {
+const getChromiumGpuInformation = async ({ browserExecutable, indent, logLevel, chromiumOptions, timeoutInMilliseconds, onBrowserDownload, chromeMode, }) => {
     const { page, cleanupPage: cleanup } = await (0, get_browser_instance_1.getPageAndCleanupFn)({
         passedInInstance: undefined,
         browserExecutable,
@@ -12,6 +12,7 @@ const getChromiumGpuInformation = async ({ browserExecutable, indent, logLevel,
         indent,
         logLevel,
         onBrowserDownload,
+        chromeMode,
     });
     await page.goto({ url: 'chrome://gpu', timeout: 12000 });
     const { value } = await (0, puppeteer_evaluate_1.puppeteerEvaluateWithCatch)({

package/ensure-browser.mjs

@@ -2545,7 +2545,7 @@ var require_extract_zip = __commonJS((exports, module) => {
 });
 
 // src/ensure-browser.ts
-import fs5 from "fs";
+import fs4 from "fs";
 
 // src/browser/BrowserFetcher.ts
 var import_extract_zip = __toESM(require_extract_zip(), 1);
@@ -3055,12 +3055,19 @@ var TESTED_VERSION = "123.0.6312.86";
 var PLAYWRIGHT_VERSION = "1105";
 function getChromeDownloadUrl({
   platform: platform2,
-  version
+  version,
+  chromeMode
 }) {
   if (platform2 === "linux-arm64") {
+    if (chromeMode === "chrome-for-testing") {
+      throw new Error(`chromeMode: 'chrome-for-testing' is not supported on platform linux-arm64`);
+    }
     return `https://playwright.azureedge.net/builds/chromium/${version ?? PLAYWRIGHT_VERSION}/chromium-linux-arm64.zip`;
   }
-  return `https://storage.googleapis.com/chrome-for-testing-public/${version ?? TESTED_VERSION}/${platform2}/chrome-headless-shell-${platform2}.zip`;
+  if (chromeMode === "headless-shell") {
+    return `https://storage.googleapis.com/chrome-for-testing-public/${version ?? TESTED_VERSION}/${platform2}/chrome-headless-shell-${platform2}.zip`;
+  }
+  return `https://storage.googleapis.com/chrome-for-testing-public/${version ?? TESTED_VERSION}/${platform2}/chrome-${platform2}.zip`;
 }
 var mkdirAsync = fs3.promises.mkdir;
 var unlinkAsync = promisify(fs3.unlink.bind(fs3));
@@ -3084,27 +3091,28 @@ var getPlatform = () => {
       throw new Error("Unsupported platform: " + platform2);
   }
 };
-var destination = "chrome-headless-shell";
-var getDownloadsFolder = () => {
+var getDownloadsFolder = (chromeMode) => {
+  const destination = chromeMode === "headless-shell" ? "chrome-headless-shell" : "chrome-for-testing";
   return path3.join(getDownloadsCacheDir(), destination);
 };
 var downloadBrowser = async ({
   logLevel,
   indent,
   onProgress,
-  version
+  version,
+  chromeMode
 }) => {
   const platform2 = getPlatform();
-  const downloadURL = getChromeDownloadUrl({ platform: platform2, version });
+  const downloadURL = getChromeDownloadUrl({ platform: platform2, version, chromeMode });
   const fileName = downloadURL.split("/").pop();
   if (!fileName) {
     throw new Error(`A malformed download URL was found: ${downloadURL}.`);
   }
-  const downloadsFolder = getDownloadsFolder();
+  const downloadsFolder = getDownloadsFolder(chromeMode);
   const archivePath = path3.join(downloadsFolder, fileName);
   const outputPath = getFolderPath(downloadsFolder, platform2);
   if (await existsAsync(outputPath)) {
-    return getRevisionInfo();
+    return getRevisionInfo(chromeMode);
   }
   if (!await existsAsync(downloadsFolder)) {
     await mkdirAsync(downloadsFolder, {
@@ -3149,25 +3157,40 @@ var downloadBrowser = async ({
       await unlinkAsync(archivePath);
     }
   }
-  const revisionInfo = getRevisionInfo();
+  const revisionInfo = getRevisionInfo(chromeMode);
   makeFileExecutableIfItIsNot(revisionInfo.executablePath);
   return revisionInfo;
 };
 var getFolderPath = (downloadsFolder, platform2) => {
   return path3.resolve(downloadsFolder, platform2);
 };
-var getExecutablePath = () => {
-  const downloadsFolder = getDownloadsFolder();
+var getExecutablePath = (chromeMode) => {
+  const downloadsFolder = getDownloadsFolder(chromeMode);
   const platform2 = getPlatform();
   const folderPath = getFolderPath(downloadsFolder, platform2);
-  return path3.join(folderPath, `chrome-headless-shell-${platform2}`, platform2 === "win64" ? "chrome-headless-shell.exe" : "chrome-headless-shell");
+  if (chromeMode === "chrome-for-testing") {
+    if (platform2 === "mac-arm64" || platform2 === "mac-x64") {
+      return path3.join(folderPath, `chrome-${platform2}`, "Google Chrome for Testing.app/Contents/MacOS/Google Chrome for Testing");
+    }
+    if (platform2 === "win64") {
+      return path3.join(folderPath, "chrome-win64", "chrome.exe");
+    }
+    if (platform2 === "linux64" || platform2 === "linux-arm64") {
+      return path3.join(folderPath, "chrome-linux64", "chrome");
+    }
+    throw new Error("unsupported platform" + platform2);
+  }
+  if (chromeMode === "headless-shell") {
+    return path3.join(folderPath, `chrome-headless-shell-${platform2}`, platform2 === "win64" ? "chrome-headless-shell.exe" : "chrome-headless-shell");
+  }
+  throw new Error("unsupported chrome mode" + chromeMode);
 };
-var getRevisionInfo = () => {
-  const executablePath = getExecutablePath();
-  const downloadsFolder = getDownloadsFolder();
+var getRevisionInfo = (chromeMode) => {
+  const executablePath = getExecutablePath(chromeMode);
+  const downloadsFolder = getDownloadsFolder(chromeMode);
   const platform2 = getPlatform();
   const folderPath = getFolderPath(downloadsFolder, platform2);
-  const url = getChromeDownloadUrl({ platform: platform2, version: null });
+  const url = getChromeDownloadUrl({ platform: platform2, version: null, chromeMode });
   const local = fs3.existsSync(folderPath);
   return {
     executablePath,
@@ -3188,68 +3211,62 @@ var defaultBrowserDownloadProgress = ({
   indent,
   logLevel,
   api
-}) => () => {
-  Log.info({ indent, logLevel }, "Downloading Chrome Headless Shell https://www.remotion.dev/docs/miscellaneous/chrome-headless-shell");
+}) => ({ chromeMode }) => {
+  if (chromeMode === "chrome-for-testing") {
+    Log.info({ indent, logLevel }, "Downloading Chrome for Testing https://www.remotion.dev/docs/miscellaneous/chrome-headless-shell");
+  } else {
+    Log.info({ indent, logLevel }, "Downloading Chrome Headless Shell https://www.remotion.dev/docs/miscellaneous/chrome-headless-shell");
+  }
   Log.info({ indent, logLevel }, `Customize this behavior by adding a onBrowserDownload function to ${api}.`);
   let lastProgress = 0;
   return {
     onProgress: (progress) => {
       if (progress.downloadedBytes > lastProgress + 1e7 || progress.percent === 1) {
         lastProgress = progress.downloadedBytes;
-        Log.info({ indent, logLevel }, `Downloading Chrome Headless Shell - ${toMegabytes(progress.downloadedBytes)}/${toMegabytes(progress.totalSizeInBytes)}`);
+        if (chromeMode === "chrome-for-testing") {
+          Log.info({ indent, logLevel }, `Downloading Chrome for Testing - ${toMegabytes(progress.downloadedBytes)}/${toMegabytes(progress.totalSizeInBytes)}`);
+        } else {
+          Log.info({ indent, logLevel }, `Downloading Chrome Headless Shell - ${toMegabytes(progress.downloadedBytes)}/${toMegabytes(progress.totalSizeInBytes)}`);
+        }
       }
     },
     version: null
   };
 };
 
-// src/get-local-browser.ts
-import fs4 from "fs";
-var getSearchPathsForProduct = () => {
-  return [];
-};
-var getLocalBrowser = () => {
-  for (const p of getSearchPathsForProduct()) {
-    if (fs4.existsSync(p)) {
-      return p;
-    }
-  }
-  return null;
-};
-
 // src/ensure-browser.ts
 var currentEnsureBrowserOperation = Promise.resolve();
 var internalEnsureBrowserUncapped = async ({
   indent,
   logLevel,
   browserExecutable,
-  onBrowserDownload
+  onBrowserDownload,
+  chromeMode
 }) => {
-  const status = getBrowserStatus(browserExecutable);
+  const status = getBrowserStatus({ browserExecutable, chromeMode });
   if (status.type === "no-browser") {
-    const { onProgress, version } = onBrowserDownload();
-    await downloadBrowser({ indent, logLevel, onProgress, version });
+    const { onProgress, version } = onBrowserDownload({ chromeMode });
+    await downloadBrowser({ indent, logLevel, onProgress, version, chromeMode });
   }
-  const newStatus = getBrowserStatus(browserExecutable);
+  const newStatus = getBrowserStatus({ browserExecutable, chromeMode });
   return newStatus;
 };
 var internalEnsureBrowser = (options) => {
   currentEnsureBrowserOperation = currentEnsureBrowserOperation.then(() => internalEnsureBrowserUncapped(options));
   return currentEnsureBrowserOperation;
 };
-var getBrowserStatus = (browserExecutable) => {
+var getBrowserStatus = ({
+  browserExecutable,
+  chromeMode
+}) => {
   if (browserExecutable) {
-    if (!fs5.existsSync(browserExecutable)) {
+    if (!fs4.existsSync(browserExecutable)) {
       throw new Error(`"browserExecutable" was specified as '${browserExecutable}' but the path doesn't exist. Pass "null" for "browserExecutable" to download a browser automatically.`);
     }
     return { path: browserExecutable, type: "user-defined-path" };
   }
-  const localBrowser = getLocalBrowser();
-  if (localBrowser !== null) {
-    return { path: localBrowser, type: "local-browser" };
-  }
-  const revision = getRevisionInfo();
-  if (revision.local && fs5.existsSync(revision.executablePath)) {
+  const revision = getRevisionInfo(chromeMode);
+  if (revision.local && fs4.existsSync(revision.executablePath)) {
     return { path: revision.executablePath, type: "local-puppeteer-browser" };
   }
   return { type: "no-browser" };
@@ -3265,7 +3282,8 @@ var ensureBrowser = (options) => {
       api: "ensureBrowser()",
       indent: false,
       logLevel
-    })
+    }),
+    chromeMode: options?.chromeMode ?? "headless-shell"
   });
 };
 export {

package/package.json

@@ -3,7 +3,7 @@
     "url": "https://github.com/remotion-dev/remotion/tree/main/packages/renderer"
   },
   "name": "@remotion/renderer",
-  "version": "4.0.246",
+  "version": "4.0.248",
   "description": "Render Remotion videos using Node.js or Bun",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -18,8 +18,8 @@
     "extract-zip": "2.0.1",
     "source-map": "^0.8.0-beta.0",
     "ws": "8.17.1",
-    "remotion": "4.0.246",
-    "@remotion/streaming": "4.0.246"
+    "remotion": "4.0.248",
+    "@remotion/streaming": "4.0.248"
   },
   "peerDependencies": {
     "react": ">=16.8.0",
@@ -33,17 +33,17 @@
     "react-dom": "19.0.0",
     "@types/ws": "8.5.10",
     "eslint": "9.14.0",
-    "@remotion/example-videos": "4.0.246",
-    "@remotion/eslint-config-internal": "4.0.246"
+    "@remotion/example-videos": "4.0.248",
+    "@remotion/eslint-config-internal": "4.0.248"
   },
   "optionalDependencies": {
-    "@remotion/compositor-darwin-arm64": "4.0.246",
-    "@remotion/compositor-linux-arm64-gnu": "4.0.246",
-    "@remotion/compositor-linux-x64-gnu": "4.0.246",
-    "@remotion/compositor-linux-arm64-musl": "4.0.246",
-    "@remotion/compositor-win32-x64-msvc": "4.0.246",
-    "@remotion/compositor-linux-x64-musl": "4.0.246",
-    "@remotion/compositor-darwin-x64": "4.0.246"
+    "@remotion/compositor-darwin-x64": "4.0.248",
+    "@remotion/compositor-darwin-arm64": "4.0.248",
+    "@remotion/compositor-linux-arm64-gnu": "4.0.248",
+    "@remotion/compositor-linux-arm64-musl": "4.0.248",
+    "@remotion/compositor-linux-x64-musl": "4.0.248",
+    "@remotion/compositor-win32-x64-msvc": "4.0.248",
+    "@remotion/compositor-linux-x64-gnu": "4.0.248"
   },
   "keywords": [
     "remotion",

package/dist/get-local-browser.d.ts

@@ -1 +0,0 @@
-export declare const getLocalBrowser: () => null;

package/dist/get-local-browser.js

@@ -1,19 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getLocalBrowser = void 0;
-const fs_1 = __importDefault(require("fs"));
-const getSearchPathsForProduct = () => {
-    return [];
-};
-const getLocalBrowser = () => {
-    for (const p of getSearchPathsForProduct()) {
-        if (fs_1.default.existsSync(p)) {
-            return p;
-        }
-    }
-    return null;
-};
-exports.getLocalBrowser = getLocalBrowser;