@remotion/renderer 4.0.20 → 4.0.22

package/dist/browser/BrowserRunner.js

@@ -56,6 +56,7 @@ const fs = __importStar(require("node:fs"));
 const readline = __importStar(require("readline"));
 const delete_directory_1 = require("../delete-directory");
 const logger_1 = require("../logger");
+const truthy_1 = require("../truthy");
 const assert_1 = require("./assert");
 const Connection_1 = require("./Connection");
 const Errors_1 = require("./Errors");
@@ -230,17 +231,19 @@ function waitForWSEndpoint(browserProcess, timeout) {
         function onClose(error) {
             cleanup();
             reject(new Error([
-                'Failed to launch the browser process!' +
-                    (error ? ' ' + error.message : ''),
+                'Failed to launch the browser process!',
+                error ? error.message : null,
                 stderr,
                 '',
                 'TROUBLESHOOTING: https://github.com/puppeteer/puppeteer/blob/main/docs/troubleshooting.md',
                 '',
-            ].join('\n')));
+            ]
+                .filter(truthy_1.truthy)
+                .join('\n')));
         }
         function onTimeout() {
             cleanup();
-            reject(new Errors_1.TimeoutError(`Timed out after ${timeout} ms while trying to connect to the browser!`));
+            reject(new Errors_1.TimeoutError(`Timed out after ${timeout} ms while trying to connect to the browser! Chrome logged the following: ${stderr}`));
         }
         function onLine(line) {
             stderr += line + '\n';

package/dist/client.d.ts

@@ -6,6 +6,7 @@ export declare const BrowserSafeApis: {
     getValidCrfRanges: (codec: "h264" | "h265" | "vp8" | "vp9" | "mp3" | "aac" | "wav" | "prores" | "h264-mkv" | "gif") => [number, number];
     isAudioCodec: (codec: "h264" | "h265" | "vp8" | "vp9" | "mp3" | "aac" | "wav" | "prores" | "h264-mkv" | "gif" | undefined) => boolean;
     proResProfileOptions: readonly ["4444-xq", "4444", "hq", "standard", "light", "proxy"];
+    x264PresetOptions: readonly ["ultrafast", "superfast", "veryfast", "faster", "fast", "medium", "slow", "slower", "veryslow", "placebo"];
     validPixelFormats: readonly ["yuv420p", "yuva420p", "yuv422p", "yuv444p", "yuv420p10le", "yuv422p10le", "yuv444p10le", "yuva444p10le"];
     DEFAULT_PIXEL_FORMAT: "yuv420p" | "yuva420p" | "yuv422p" | "yuv444p" | "yuv420p10le" | "yuv422p10le" | "yuv444p10le" | "yuva444p10le";
     supportedAudioCodecs: {

package/dist/client.js

@@ -19,6 +19,7 @@ const video_codec_1 = require("./options/video-codec");
 const pixel_format_1 = require("./pixel-format");
 const prores_profile_1 = require("./prores-profile");
 const validate_output_filename_1 = require("./validate-output-filename");
+const x264_preset_1 = require("./x264-preset");
 exports.BrowserSafeApis = {
     getFileExtensionFromCodec: get_extension_from_codec_1.getFileExtensionFromCodec,
     validCodecs: codec_1.validCodecs,
@@ -27,6 +28,7 @@ exports.BrowserSafeApis = {
     getValidCrfRanges: crf_1.getValidCrfRanges,
     isAudioCodec: is_audio_codec_1.isAudioCodec,
     proResProfileOptions: prores_profile_1.proResProfileOptions,
+    x264PresetOptions: x264_preset_1.x264PresetOptions,
     validPixelFormats: pixel_format_1.validPixelFormats,
     DEFAULT_PIXEL_FORMAT: pixel_format_1.DEFAULT_PIXEL_FORMAT,
     supportedAudioCodecs: audio_codec_1.supportedAudioCodecs,

package/dist/compositor/payloads.d.ts

@@ -75,6 +75,9 @@ export type CompositorCommand = {
         maximum_frame_cache_items: number;
         verbose: boolean;
     };
+    CopyImageToClipboard: {
+        src: string;
+    };
     GetOpenVideoStats: {};
     DeliberatePanic: {};
     CloseAllVideos: {};

package/dist/copy-to-clipboard.d.ts

@@ -0,0 +1,2 @@
+import type { LogLevel } from './log-level';
+export declare const copyImageToClipboard: (src: string, logLevel: LogLevel) => Promise<void>;

package/dist/copy-to-clipboard.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.copyImageToClipboard = void 0;
+const compositor_1 = require("./compositor/compositor");
+const copyImageToClipboard = async (src, logLevel) => {
+    const compositor = (0, compositor_1.startLongRunningCompositor)((0, compositor_1.getIdealMaximumFrameCacheItems)(), logLevel, false);
+    await compositor.executeCommand('CopyImageToClipboard', {
+        src,
+    });
+    compositor.finishCommands();
+    await compositor.waitForDone();
+};
+exports.copyImageToClipboard = copyImageToClipboard;

package/dist/index.d.ts

@@ -37,6 +37,7 @@ export { SymbolicatedStackFrame } from './symbolicate-stacktrace';
 export { OnStartData, RenderFramesOutput } from './types';
 export { OpenGlRenderer } from './validate-opengl-renderer';
 export { validateOutputFilename } from './validate-output-filename';
+export { X264Preset } from './x264-preset';
 export declare const RenderInternals: {
     ensureLocalBrowser: (preferredBrowserExecutable: import("./browser-executable").BrowserExecutable) => Promise<void>;
     getActualConcurrency: (userPreference: string | number | null) => number;
@@ -115,8 +116,8 @@ 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" | null;
-    validateOpenGlRenderer: (option: "swangle" | "angle" | "egl" | "swiftshader" | null) => "swangle" | "angle" | "egl" | "swiftshader" | null;
+    DEFAULT_OPENGL_RENDERER: "angle" | "swangle" | "egl" | "swiftshader" | null;
+    validateOpenGlRenderer: (option: "angle" | "swangle" | "egl" | "swiftshader" | null) => "angle" | "swangle" | "egl" | "swiftshader" | null;
     validCodecs: readonly ["h264", "h265", "vp8", "vp9", "mp3", "aac", "wav", "prores", "h264-mkv", "gif"];
     DEFAULT_PIXEL_FORMAT: "yuv420p" | "yuva420p" | "yuv422p" | "yuv444p" | "yuv420p10le" | "yuv422p10le" | "yuv444p10le" | "yuva444p10le";
     validateJpegQuality: (q: number | undefined) => void;
@@ -304,8 +305,8 @@ export declare const RenderInternals: {
     };
     validStillImageFormats: readonly ["png", "jpeg", "pdf", "webp"];
     validVideoImageFormats: readonly ["png", "jpeg", "none"];
-    DEFAULT_STILL_IMAGE_FORMAT: "png" | "jpeg" | "pdf" | "webp";
-    DEFAULT_VIDEO_IMAGE_FORMAT: "none" | "png" | "jpeg";
+    DEFAULT_STILL_IMAGE_FORMAT: "jpeg" | "png" | "webp" | "pdf";
+    DEFAULT_VIDEO_IMAGE_FORMAT: "jpeg" | "png" | "none";
     DEFAULT_JPEG_QUALITY: number;
     chalk: {
         enabled: () => boolean;
@@ -416,7 +417,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>;
@@ -478,9 +479,10 @@ export declare const RenderInternals: {
         serveUrlOrWebpackUrl: string;
     }) => Promise<import("remotion").VideoConfig[]>;
     internalRenderFrames: ({ 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, }: import("./render-frames").InternalRenderFramesOptions) => Promise<import("./types").RenderFramesOutput>;
-    internalRenderMedia: ({ proResProfile, 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, audioCodec, concurrency, disallowParallelEncoding, everyNthFrame, imageFormat: provisionalImageFormat, indent, jpegQuality, numberOfGifLoops, onCtrlCExit, preferLossless, serveUrl, server: reusedServer, logLevel, serializedResolvedPropsWithCustomSchema, }: import("./render-media").InternalRenderMediaOptions) => Promise<{
+    internalRenderMedia: ({ 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, audioCodec, concurrency, disallowParallelEncoding, everyNthFrame, imageFormat: provisionalImageFormat, indent, jpegQuality, numberOfGifLoops, onCtrlCExit, preferLossless, serveUrl, server: reusedServer, logLevel, serializedResolvedPropsWithCustomSchema, }: import("./render-media").InternalRenderMediaOptions) => Promise<{
         buffer: Buffer | null;
         slowestFrames: import("./render-media").SlowFrame[];
     }>;
     validOpenGlRenderers: readonly ["swangle", "angle", "egl", "swiftshader"];
+    copyImageToClipboard: (src: string, logLevel: "verbose" | "info" | "warn" | "error") => Promise<void>;
 };

package/dist/index.js

@@ -42,6 +42,7 @@ const codec_1 = require("./codec");
 const combine_videos_1 = require("./combine-videos");
 const get_executable_path_1 = require("./compositor/get-executable-path");
 const convert_to_positive_frame_index_1 = require("./convert-to-positive-frame-index");
+const copy_to_clipboard_1 = require("./copy-to-clipboard");
 const delete_directory_1 = require("./delete-directory");
 const ensure_output_directory_1 = require("./ensure-output-directory");
 const symbolicate_error_1 = require("./error-handling/symbolicate-error");
@@ -187,6 +188,7 @@ exports.RenderInternals = {
     internalRenderFrames: render_frames_1.internalRenderFrames,
     internalRenderMedia: render_media_1.internalRenderMedia,
     validOpenGlRenderers: validate_opengl_renderer_1.validOpenGlRenderers,
+    copyImageToClipboard: copy_to_clipboard_1.copyImageToClipboard,
 };
 // Warn of potential performance issues with Apple Silicon (M1 chip under Rosetta)
 (0, check_apple_silicon_1.checkNodeVersionAndWarnAboutRosetta)();

package/dist/offthread-video-server.js

@@ -67,6 +67,9 @@ const startOffthreadVideoServer = ({ downloadMap, concurrency, logLevel, indent,
             else {
                 response.setHeader('content-type', `image/bmp`);
             }
+            // Prevent caching of the response and excessive disk writes
+            // https://github.com/remotion-dev/remotion/issues/2760
+            response.setHeader('cache-control', 'no-cache, no-store, must-revalidate');
             // Handling this case on Lambda:
             // https://support.google.com/chrome/a/answer/7679408?hl=en
             // Chrome sends Private Network Access preflights for subresources

package/dist/presets-profile.d.ts

@@ -0,0 +1,7 @@
+import type { Codec } from './codec';
+export declare const presetsProfileOptions: readonly ["ultrafast", "superfast", "veryfast", "faster", "fast", "medium", "slow", "slower", "veryslow", "placebo"];
+export type PresetsProfile = typeof presetsProfileOptions[number];
+export declare const validateSelectedCodecAndPresetCombination: ({ codec, presetsProfile, }: {
+    codec: Codec;
+    presetsProfile: PresetsProfile | undefined;
+}) => void;

package/dist/presets-profile.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateSelectedCodecAndPresetCombination = exports.presetsProfileOptions = void 0;
+exports.presetsProfileOptions = [
+    'ultrafast',
+    'superfast',
+    'veryfast',
+    'faster',
+    'fast',
+    'medium',
+    'slow',
+    'slower',
+    'veryslow',
+    'placebo',
+];
+const validateSelectedCodecAndPresetCombination = ({ codec, presetsProfile, }) => {
+    if (typeof presetsProfile !== 'undefined' && codec !== 'h264') {
+        throw new TypeError(`You have set a Preset profile but the codec is "${codec}". Set the codec to "h264" or remove the Preset profile.`);
+    }
+    if (presetsProfile !== undefined &&
+        !exports.presetsProfileOptions.includes(presetsProfile)) {
+        throw new TypeError(`The Preset profile "${presetsProfile}" is not valid. Valid options are ${exports.presetsProfileOptions
+            .map((p) => `"${p}"`)
+            .join(', ')}`);
+    }
+};
+exports.validateSelectedCodecAndPresetCombination = validateSelectedCodecAndPresetCombination;

package/dist/render-media.d.ts

@@ -16,6 +16,7 @@ import type { PixelFormat } from './pixel-format';
 import type { RemotionServer } from './prepare-server';
 import type { ProResProfile } from './prores-profile';
 import type { OnStartData } from './types';
+import type { X264Preset } from './x264-preset';
 export type StitchingState = 'encoding' | 'muxing';
 export type SlowFrame = {
     frame: number;
@@ -48,6 +49,7 @@ export type InternalRenderMediaOptions = {
     onProgress: RenderMediaOnProgress;
     onDownload: RenderMediaOnDownload;
     proResProfile: ProResProfile | undefined;
+    x264Preset: X264Preset | undefined;
     onBrowserLog: ((log: BrowserLog) => void) | null;
     onStart: (data: OnStartData) => void;
     timeoutInMilliseconds: number;
@@ -93,6 +95,7 @@ export type RenderMediaOptions = {
     onProgress?: RenderMediaOnProgress;
     onDownload?: RenderMediaOnDownload;
     proResProfile?: ProResProfile;
+    x264Preset?: X264Preset;
     /**
      * @deprecated Use "logLevel": "verbose" instead
      */
@@ -125,11 +128,11 @@ type RenderMediaResult = {
     buffer: Buffer | null;
     slowestFrames: SlowFrame[];
 };
-export declare const internalRenderMedia: ({ proResProfile, 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, audioCodec, concurrency, disallowParallelEncoding, everyNthFrame, imageFormat: provisionalImageFormat, indent, jpegQuality, numberOfGifLoops, onCtrlCExit, preferLossless, serveUrl, server: reusedServer, logLevel, serializedResolvedPropsWithCustomSchema, }: InternalRenderMediaOptions) => Promise<RenderMediaResult>;
+export declare const internalRenderMedia: ({ 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, audioCodec, concurrency, disallowParallelEncoding, everyNthFrame, imageFormat: provisionalImageFormat, indent, jpegQuality, numberOfGifLoops, onCtrlCExit, preferLossless, serveUrl, server: reusedServer, logLevel, serializedResolvedPropsWithCustomSchema, }: InternalRenderMediaOptions) => Promise<RenderMediaResult>;
 /**
  *
  * @description Render a video from a composition
  * @see [Documentation](https://www.remotion.dev/docs/renderer/render-media)
  */
-export declare const renderMedia: ({ proResProfile, 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, audioCodec, jpegQuality, concurrency, serveUrl, disallowParallelEncoding, everyNthFrame, imageFormat, numberOfGifLoops, dumpBrowserLogs, preferLossless, verbose, quality, logLevel, }: 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, audioCodec, jpegQuality, concurrency, serveUrl, disallowParallelEncoding, everyNthFrame, imageFormat, numberOfGifLoops, dumpBrowserLogs, preferLossless, verbose, quality, logLevel, }: RenderMediaOptions) => Promise<RenderMediaResult>;
 export {};

package/dist/render-media.js

@@ -42,8 +42,9 @@ const validate_number_of_gif_loops_1 = require("./validate-number-of-gif-loops")
 const validate_output_filename_1 = require("./validate-output-filename");
 const validate_scale_1 = require("./validate-scale");
 const validate_videobitrate_1 = require("./validate-videobitrate");
+const x264_preset_1 = require("./x264-preset");
 const SLOWEST_FRAME_COUNT = 10;
-const internalRenderMedia = ({ proResProfile, 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, audioCodec, concurrency, disallowParallelEncoding, everyNthFrame, imageFormat: provisionalImageFormat, indent, jpegQuality, numberOfGifLoops, onCtrlCExit, preferLossless, serveUrl, server: reusedServer, logLevel, serializedResolvedPropsWithCustomSchema, }) => {
+const internalRenderMedia = ({ 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, audioCodec, concurrency, disallowParallelEncoding, everyNthFrame, imageFormat: provisionalImageFormat, indent, jpegQuality, numberOfGifLoops, onCtrlCExit, preferLossless, serveUrl, server: reusedServer, logLevel, serializedResolvedPropsWithCustomSchema, }) => {
     (0, jpeg_quality_1.validateJpegQuality)(jpegQuality);
     (0, crf_1.validateQualitySettings)({ crf, codec, videoBitrate });
     (0, validate_videobitrate_1.validateBitrate)(audioBitrate, 'audioBitrate');
@@ -52,6 +53,10 @@ const internalRenderMedia = ({ proResProfile, crf, composition, serializedInputP
         codec,
         proResProfile,
     });
+    (0, x264_preset_1.validateSelectedCodecAndPresetCombination)({
+        codec,
+        x264Preset,
+    });
     (0, pixel_format_1.validateSelectedPixelFormatAndCodecCombination)(pixelFormat, codec);
     if (outputLocation) {
         (0, validate_output_filename_1.validateOutputFilename)({
@@ -346,6 +351,7 @@ const internalRenderMedia = ({ proResProfile, crf, composition, serializedInputP
                     audioBitrate,
                     videoBitrate,
                     audioCodec,
+                    x264Preset: x264Preset !== null && x264Preset !== void 0 ? x264Preset : null,
                 }),
                 stitchStart,
             ]);
@@ -411,13 +417,14 @@ exports.internalRenderMedia = internalRenderMedia;
  * @description Render a video from a composition
  * @see [Documentation](https://www.remotion.dev/docs/renderer/render-media)
  */
-const renderMedia = ({ proResProfile, 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, audioCodec, jpegQuality, concurrency, serveUrl, disallowParallelEncoding, everyNthFrame, imageFormat, numberOfGifLoops, dumpBrowserLogs, preferLossless, verbose, quality, logLevel, }) => {
+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, audioCodec, jpegQuality, concurrency, serveUrl, disallowParallelEncoding, everyNthFrame, imageFormat, numberOfGifLoops, dumpBrowserLogs, preferLossless, verbose, quality, logLevel, }) => {
     var _a, _b;
     if (quality !== undefined) {
         console.warn(`The "quality" option has been renamed. Please use "jpegQuality" instead.`);
     }
     return (0, exports.internalRenderMedia)({
         proResProfile: proResProfile !== null && proResProfile !== void 0 ? proResProfile : undefined,
+        x264Preset,
         codec,
         composition,
         serveUrl,

package/dist/stitch-frames-to-video.d.ts

@@ -8,6 +8,7 @@ import type { LogLevel } from './log-level';
 import type { CancelSignal } from './make-cancel-signal';
 import type { PixelFormat } from './pixel-format';
 import type { ProResProfile } from './prores-profile';
+import type { X264Preset } from './x264-preset';
 type InternalStitchFramesToVideoOptions = {
     audioBitrate: string | null;
     videoBitrate: string | null;
@@ -32,6 +33,7 @@ type InternalStitchFramesToVideoOptions = {
     preferLossless: boolean;
     indent: boolean;
     muted: boolean;
+    x264Preset: X264Preset | null;
     enforceAudioTrack: boolean;
     ffmpegOverride: null | FfmpegOverrideFn;
 };
@@ -58,11 +60,12 @@ export type StitchFramesToVideoOptions = {
     muted?: boolean;
     enforceAudioTrack?: boolean;
     ffmpegOverride?: FfmpegOverrideFn;
+    x264Preset?: X264Preset | null;
 };
 export declare const internalStitchFramesToVideo: (options: InternalStitchFramesToVideoOptions) => Promise<Buffer | null>;
 /**
  * @description Takes a series of images and audio information generated by renderFrames() and encodes it to a video.
  * @see [Documentation](https://www.remotion.dev/docs/renderer/stitch-frames-to-video)
  */
-export declare const stitchFramesToVideo: ({ assetsInfo, force, fps, height, width, audioBitrate, audioCodec, cancelSignal, codec, crf, dir, enforceAudioTrack, ffmpegOverride, muted, numberOfGifLoops, onDownload, onProgress, outputLocation, pixelFormat, proResProfile, verbose, videoBitrate, }: StitchFramesToVideoOptions) => Promise<Buffer | null>;
+export declare const stitchFramesToVideo: ({ assetsInfo, force, fps, height, width, audioBitrate, audioCodec, cancelSignal, codec, crf, dir, enforceAudioTrack, ffmpegOverride, muted, numberOfGifLoops, onDownload, onProgress, outputLocation, pixelFormat, proResProfile, verbose, videoBitrate, x264Preset, }: StitchFramesToVideoOptions) => Promise<Buffer | null>;
 export {};

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

@@ -100,7 +100,7 @@ const getAssetsData = async ({ assets, onDownload, fps, expectedFrames, logLevel
     });
     return outName;
 };
-const innerStitchFramesToVideo = async ({ assetsInfo, audioBitrate, audioCodec, cancelSignal, codec, crf, dir, enforceAudioTrack, ffmpegOverride, force, fps, height, indent, muted, onDownload, outputLocation, pixelFormat, preEncodedFileLocation, preferLossless, proResProfile, logLevel, videoBitrate, width, numberOfGifLoops, onProgress, }, remotionRoot) => {
+const innerStitchFramesToVideo = async ({ assetsInfo, audioBitrate, audioCodec, cancelSignal, codec, crf, dir, enforceAudioTrack, ffmpegOverride, force, fps, height, indent, muted, onDownload, outputLocation, pixelFormat, preEncodedFileLocation, preferLossless, proResProfile, logLevel, videoBitrate, width, numberOfGifLoops, onProgress, x264Preset, }, remotionRoot) => {
     var _a;
     remotion_1.Internals.validateDimension(height, 'height', 'passed to `stitchFramesToVideo()`');
     remotion_1.Internals.validateDimension(width, 'width', 'passed to `stitchFramesToVideo()`');
@@ -256,6 +256,7 @@ const innerStitchFramesToVideo = async ({ assetsInfo, audioBitrate, audioCodec,
                     codec,
                 }),
             ]),
+        x264Preset ? ['-preset', x264Preset] : null,
         codec === 'h264' ? ['-movflags', 'faststart'] : null,
         resolvedAudioCodec
             ? ['-c:a', (0, audio_codec_1.mapAudioCodecToFfmpegAudioCodecName)(resolvedAudioCodec)]
@@ -359,7 +360,7 @@ exports.internalStitchFramesToVideo = internalStitchFramesToVideo;
  * @description Takes a series of images and audio information generated by renderFrames() and encodes it to a video.
  * @see [Documentation](https://www.remotion.dev/docs/renderer/stitch-frames-to-video)
  */
-const stitchFramesToVideo = ({ assetsInfo, force, fps, height, width, audioBitrate, audioCodec, cancelSignal, codec, crf, dir, enforceAudioTrack, ffmpegOverride, muted, numberOfGifLoops, onDownload, onProgress, outputLocation, pixelFormat, proResProfile, verbose, videoBitrate, }) => {
+const stitchFramesToVideo = ({ assetsInfo, force, fps, height, width, audioBitrate, audioCodec, cancelSignal, codec, crf, dir, enforceAudioTrack, ffmpegOverride, muted, numberOfGifLoops, onDownload, onProgress, outputLocation, pixelFormat, proResProfile, verbose, videoBitrate, x264Preset, }) => {
     return (0, exports.internalStitchFramesToVideo)({
         assetsInfo,
         audioBitrate: audioBitrate !== null && audioBitrate !== void 0 ? audioBitrate : null,
@@ -386,6 +387,7 @@ const stitchFramesToVideo = ({ assetsInfo, force, fps, height, width, audioBitra
         width,
         preEncodedFileLocation: null,
         preferLossless: false,
+        x264Preset: x264Preset !== null && x264Preset !== void 0 ? x264Preset : null,
     });
 };
 exports.stitchFramesToVideo = stitchFramesToVideo;

package/dist/x264-preset.d.ts

@@ -0,0 +1,7 @@
+import type { Codec } from './codec';
+export declare const x264PresetOptions: readonly ["ultrafast", "superfast", "veryfast", "faster", "fast", "medium", "slow", "slower", "veryslow", "placebo"];
+export type X264Preset = typeof x264PresetOptions[number];
+export declare const validateSelectedCodecAndPresetCombination: ({ codec, x264Preset, }: {
+    codec: Codec;
+    x264Preset: X264Preset | undefined;
+}) => void;

package/dist/x264-preset.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateSelectedCodecAndPresetCombination = exports.x264PresetOptions = void 0;
+exports.x264PresetOptions = [
+    'ultrafast',
+    'superfast',
+    'veryfast',
+    'faster',
+    'fast',
+    'medium',
+    'slow',
+    'slower',
+    'veryslow',
+    'placebo',
+];
+const validateSelectedCodecAndPresetCombination = ({ codec, x264Preset, }) => {
+    if (typeof x264Preset !== 'undefined' &&
+        codec !== 'h264' &&
+        codec !== 'h264-mkv') {
+        throw new TypeError(`You have set a x264 preset but the codec is "${codec}". Set the codec to "h264" or remove the Preset profile.`);
+    }
+    if (x264Preset !== undefined &&
+        !exports.x264PresetOptions.includes(x264Preset)) {
+        throw new TypeError(`The Preset profile "${x264Preset}" is not valid. Valid options are ${exports.x264PresetOptions
+            .map((p) => `"${p}"`)
+            .join(', ')}`);
+    }
+};
+exports.validateSelectedCodecAndPresetCombination = validateSelectedCodecAndPresetCombination;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@remotion/renderer",
-  "version": "4.0.20",
+  "version": "4.0.22",
   "description": "Renderer for Remotion",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -18,7 +18,7 @@
     "extract-zip": "2.0.1",
     "source-map": "^0.8.0-beta.0",
     "ws": "8.7.0",
-    "remotion": "4.0.20"
+    "remotion": "4.0.22"
   },
   "peerDependencies": {
     "react": ">=16.8.0",
@@ -41,13 +41,13 @@
     "zod": "^3.21.4"
   },
   "optionalDependencies": {
-    "@remotion/compositor-darwin-arm64": "4.0.20",
-    "@remotion/compositor-linux-x64-gnu": "4.0.20",
-    "@remotion/compositor-linux-x64-musl": "4.0.20",
-    "@remotion/compositor-win32-x64-msvc": "4.0.20",
-    "@remotion/compositor-linux-arm64-musl": "4.0.20",
-    "@remotion/compositor-darwin-x64": "4.0.20",
-    "@remotion/compositor-linux-arm64-gnu": "4.0.20"
+    "@remotion/compositor-darwin-x64": "4.0.22",
+    "@remotion/compositor-linux-arm64-gnu": "4.0.22",
+    "@remotion/compositor-darwin-arm64": "4.0.22",
+    "@remotion/compositor-linux-arm64-musl": "4.0.22",
+    "@remotion/compositor-linux-x64-gnu": "4.0.22",
+    "@remotion/compositor-linux-x64-musl": "4.0.22",
+    "@remotion/compositor-win32-x64-msvc": "4.0.22"
   },
   "keywords": [
     "remotion",