@remotion/renderer 4.0.26 → 4.0.28

package/dist/client.d.ts

@@ -275,7 +275,16 @@ export declare const BrowserSafeApis: {
             docLink: string;
             type: Record<string, unknown> | null;
         };
+        colorSpaceOption: {
+            name: string;
+            cliFlag: "color-space";
+            description: () => JSX.Element;
+            docLink: string;
+            ssrName: string;
+            type: "default" | "bt709";
+        };
     };
+    validColorSpaces: readonly ["default", "bt709"];
     optionsMap: {
         readonly renderMedia: readonly [{
             name: string;

package/dist/client.js

@@ -9,6 +9,7 @@ const file_extensions_1 = require("./file-extensions");
 const get_extension_from_codec_1 = require("./get-extension-from-codec");
 const is_audio_codec_1 = require("./is-audio-codec");
 const audio_bitrate_1 = require("./options/audio-bitrate");
+const color_space_1 = require("./options/color-space");
 const crf_2 = require("./options/crf");
 const enforce_audio_1 = require("./options/enforce-audio");
 const jpeg_quality_1 = require("./options/jpeg-quality");
@@ -50,7 +51,9 @@ exports.BrowserSafeApis = {
         videoCodecOption: video_codec_1.videoCodecOption,
         offthreadVideoCacheSizeInBytesOption: offthreadvideo_cache_size_1.offthreadVideoCacheSizeInBytesOption,
         webhookCustomDataOption: webhook_custom_data_1.webhookCustomDataOption,
+        colorSpaceOption: color_space_1.colorSpaceOption,
     },
+    validColorSpaces: color_space_1.validColorSpaces,
     optionsMap: options_map_1.optionsMap,
     codecSupportsCrf: codec_supports_media_1.codecSupportsCrf,
     codecSupportsVideoBitrate: codec_supports_media_1.codecSupportsVideoBitrate,

package/dist/compositor/payloads.d.ts

@@ -35,6 +35,7 @@ export type VideoMetadata = {
     codec: 'h264' | 'h265' | 'vp8' | 'vp9' | 'av1' | 'prores' | 'unknown';
     canPlayInVideoTag: boolean;
     supportsSeeking: boolean;
+    colorSpace: 'rgb' | 'bt601' | 'bt709' | 'bt2020-ncl' | 'bt2020-cl' | 'fcc' | 'bt470bg' | 'smpte170m' | 'smpte240m' | 'ycgco' | 'smpte2085' | 'chroma-derived-ncl' | 'chroma-derived-cl' | 'ictcp' | 'unknown';
 };
 type SilentPart = {
     startInSeconds: number;

package/dist/ffmpeg-args.d.ts

@@ -0,0 +1,14 @@
+import type { Codec } from './codec';
+import type { ColorSpace } from './options/color-space';
+import type { PixelFormat } from './pixel-format';
+import type { X264Preset } from './x264-preset';
+export declare const generateFfmpegArgs: ({ hasPreencoded, proResProfileName, pixelFormat, x264Preset, codec, crf, videoBitrate, colorSpace, }: {
+    hasPreencoded: boolean;
+    proResProfileName: string | null;
+    pixelFormat: PixelFormat;
+    x264Preset: X264Preset | null;
+    crf: unknown;
+    codec: Codec;
+    videoBitrate: string | null | undefined;
+    colorSpace: ColorSpace;
+}) => string[][];

package/dist/ffmpeg-args.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateFfmpegArgs = void 0;
+const crf_1 = require("./crf");
+const get_codec_name_1 = require("./get-codec-name");
+const truthy_1 = require("./truthy");
+const firstEncodingStepOnly = ({ hasPreencoded, proResProfileName, pixelFormat, x264Preset, codec, crf, videoBitrate, }) => {
+    if (hasPreencoded) {
+        return [];
+    }
+    return [
+        proResProfileName ? ['-profile:v', proResProfileName] : null,
+        ['-pix_fmt', pixelFormat],
+        // Without explicitly disabling auto-alt-ref,
+        // transparent WebM generation doesn't work
+        pixelFormat === 'yuva420p' ? ['-auto-alt-ref', '0'] : null,
+        x264Preset ? ['-preset', x264Preset] : null,
+        (0, crf_1.validateQualitySettings)({
+            crf,
+            videoBitrate,
+            codec,
+        }),
+    ].filter(truthy_1.truthy);
+};
+const generateFfmpegArgs = ({ hasPreencoded, proResProfileName, pixelFormat, x264Preset, codec, crf, videoBitrate, colorSpace, }) => {
+    const encoderName = (0, get_codec_name_1.getCodecName)(codec);
+    if (encoderName === null) {
+        throw new TypeError('encoderName is null: ' + JSON.stringify(codec));
+    }
+    const colorSpaceOptions = colorSpace === 'bt709'
+        ? [
+            ['-colorspace:v', 'bt709'],
+            ['-color_primaries:v', 'bt709'],
+            ['-color_trc:v', 'bt709'],
+            ['-color_range:v', 'tv'],
+        ]
+        : [];
+    return [
+        ['-c:v', hasPreencoded ? 'copy' : encoderName],
+        // -c:v is the same as -vcodec as -codec:video
+        // and specified the video codec.
+        ...colorSpaceOptions,
+        ...firstEncodingStepOnly({
+            codec,
+            crf,
+            hasPreencoded,
+            pixelFormat,
+            proResProfileName,
+            videoBitrate,
+            x264Preset,
+        }),
+    ].filter(truthy_1.truthy);
+};
+exports.generateFfmpegArgs = generateFfmpegArgs;

package/dist/get-silent-parts.d.ts

@@ -3,6 +3,6 @@ import type { LogLevel } from './log-level';
 export declare const getSilentParts: ({ src, noiseThresholdInDecibels: passedNoiseThresholdInDecibels, minDurationInSeconds: passedMinDuration, logLevel, }: {
     src: string;
     minDurationInSeconds?: number | undefined;
-    logLevel?: "error" | "verbose" | "info" | "warn" | undefined;
+    logLevel?: "verbose" | "info" | "warn" | "error" | undefined;
     noiseThresholdInDecibels?: number | undefined;
 }) => Promise<GetSilentPartsResponse>;

package/dist/get-video-metadata.d.ts

@@ -1,2 +1,5 @@
 import type { VideoMetadata } from './compositor/payloads';
-export declare const getVideoMetadata: (videoSource: string) => Promise<VideoMetadata>;
+import type { LogLevel } from './log-level';
+export declare const getVideoMetadata: (videoSource: string, options?: {
+    logLevel?: LogLevel;
+}) => Promise<VideoMetadata>;

package/dist/get-video-metadata.js

@@ -2,8 +2,9 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getVideoMetadata = void 0;
 const compositor_1 = require("./compositor/compositor");
-const getVideoMetadata = async (videoSource) => {
-    const compositor = (0, compositor_1.startLongRunningCompositor)((0, compositor_1.getIdealMaximumFrameCacheSizeInBytes)(), 'info', false);
+const getVideoMetadata = async (videoSource, options) => {
+    var _a;
+    const compositor = (0, compositor_1.startLongRunningCompositor)((0, compositor_1.getIdealMaximumFrameCacheSizeInBytes)(), (_a = options === null || options === void 0 ? void 0 : options.logLevel) !== null && _a !== void 0 ? _a : 'info', false);
     const metadataResponse = await compositor.executeCommand('GetVideoMetadata', {
         src: videoSource,
     });

package/dist/index.d.ts

@@ -25,6 +25,7 @@ export type { LogLevel } from './log-level';
 export { CancelSignal, makeCancelSignal } from './make-cancel-signal';
 export { openBrowser } from './open-browser';
 export type { ChromiumOptions } from './open-browser';
+export { ColorSpace } from './options/color-space';
 export { AnyRemotionOption, RemotionOption, ToOptions } from './options/option';
 export { PixelFormat } from './pixel-format';
 export { RemotionServer } from './prepare-server';
@@ -47,7 +48,7 @@ export declare const RenderInternals: {
         downloadMap: import("./assets/download-map").DownloadMap;
         remotionRoot: string;
         concurrency: number;
-        logLevel: "error" | "verbose" | "info" | "warn";
+        logLevel: "verbose" | "info" | "warn" | "error";
         indent: boolean;
         offthreadVideoCacheSizeInBytes: number | null;
     }) => Promise<{
@@ -114,7 +115,11 @@ export declare const RenderInternals: {
     canUseParallelEncoding: (codec: "h264" | "h265" | "vp8" | "vp9" | "mp3" | "aac" | "wav" | "prores" | "h264-mkv" | "gif") => boolean;
     mimeContentType: typeof mimeContentType;
     mimeLookup: typeof mimeLookup;
-    validateConcurrency: (value: unknown, setting: string) => void;
+    validateConcurrency: ({ setting, value, checkIfValidForCurrentMachine, }: {
+        value: unknown;
+        setting: string;
+        checkIfValidForCurrentMachine: boolean;
+    }) => void;
     validPixelFormats: readonly ["yuv420p", "yuva420p", "yuv422p", "yuv444p", "yuv420p10le", "yuv422p10le", "yuv444p10le", "yuva444p10le"];
     DEFAULT_BROWSER: "chrome";
     validateFrameRange: (frameRange: import("./frame-range").FrameRange | null) => void;
@@ -127,7 +132,7 @@ export declare const RenderInternals: {
     DEFAULT_CODEC: "h264" | "h265" | "vp8" | "vp9" | "mp3" | "aac" | "wav" | "prores" | "h264-mkv" | "gif";
     isAudioCodec: (codec: "h264" | "h265" | "vp8" | "vp9" | "mp3" | "aac" | "wav" | "prores" | "h264-mkv" | "gif" | undefined) => boolean;
     logLevels: readonly ["verbose", "info", "warn", "error"];
-    isEqualOrBelowLogLevel: (currentLevel: "error" | "verbose" | "info" | "warn", level: "error" | "verbose" | "info" | "warn") => boolean;
+    isEqualOrBelowLogLevel: (currentLevel: "verbose" | "info" | "warn" | "error", level: "verbose" | "info" | "warn" | "error") => boolean;
     isValidLogLevel: (level: string) => boolean;
     perf: typeof perf;
     convertToPositiveFrameIndex: ({ frame, durationInFrames, }: {
@@ -364,30 +369,30 @@ export declare const RenderInternals: {
         verbose: (message?: any, ...optionalParams: any[]) => void;
         verboseAdvanced: (options: {
             indent: boolean;
-            logLevel: "error" | "verbose" | "info" | "warn";
+            logLevel: "verbose" | "info" | "warn" | "error";
         } & {
             tag?: string | undefined;
         }, message?: any, ...optionalParams: any[]) => void;
         info: (message?: any, ...optionalParams: any[]) => void;
         infoAdvanced: (options: {
             indent: boolean;
-            logLevel: "error" | "verbose" | "info" | "warn";
+            logLevel: "verbose" | "info" | "warn" | "error";
         }, message?: any, ...optionalParams: any[]) => void;
         warn: (message?: any, ...optionalParams: any[]) => void;
         warnAdvanced: (options: {
             indent: boolean;
-            logLevel: "error" | "verbose" | "info" | "warn";
+            logLevel: "verbose" | "info" | "warn" | "error";
         }, message?: any, ...optionalParams: any[]) => void;
         error: (message?: any, ...optionalParams: any[]) => void;
         errorAdvanced: (options: {
             indent: boolean;
-            logLevel: "error" | "verbose" | "info" | "warn";
+            logLevel: "verbose" | "info" | "warn" | "error";
         } & {
             tag?: string | undefined;
         }, message?: any, ...optionalParams: any[]) => void;
     };
-    getLogLevel: () => "error" | "verbose" | "info" | "warn";
-    setLogLevel: (newLogLevel: "error" | "verbose" | "info" | "warn") => void;
+    getLogLevel: () => "verbose" | "info" | "warn" | "error";
+    setLogLevel: (newLogLevel: "verbose" | "info" | "warn" | "error") => void;
     INDENT_TOKEN: string;
     isColorSupported: () => boolean;
     HeadlessBrowser: typeof HeadlessBrowser;
@@ -396,7 +401,7 @@ export declare const RenderInternals: {
         port: number | null;
         remotionRoot: string;
         concurrency: number;
-        logLevel: "error" | "verbose" | "info" | "warn";
+        logLevel: "verbose" | "info" | "warn" | "error";
         indent: boolean;
         offthreadVideoCacheSizeInBytes: number | null;
     }) => Promise<import("./prepare-server").RemotionServer>;
@@ -405,7 +410,7 @@ export declare const RenderInternals: {
         port: number | null;
         remotionRoot: string;
         concurrency: number;
-        logLevel: "error" | "verbose" | "info" | "warn";
+        logLevel: "verbose" | "info" | "warn" | "error";
         indent: boolean;
         offthreadVideoCacheSizeInBytes: number | null;
     }, { onDownload, onError, }: {
@@ -435,7 +440,7 @@ export declare const RenderInternals: {
         cancelSignal: import("./make-cancel-signal").CancelSignal | null;
         indent: boolean;
         server: import("./prepare-server").RemotionServer | undefined;
-        logLevel: "error" | "verbose" | "info" | "warn";
+        logLevel: "verbose" | "info" | "warn" | "error";
         serveUrl: string;
         port: number | null;
         offthreadVideoCacheSizeInBytes: number | null;
@@ -456,7 +461,7 @@ export declare const RenderInternals: {
         viewport: import("./browser/PuppeteerViewport").Viewport | null;
         indent: boolean;
         browser: "chrome";
-        logLevel: "error" | "verbose" | "info" | "warn";
+        logLevel: "verbose" | "info" | "warn" | "error";
     }) => Promise<HeadlessBrowser>;
     internalSelectComposition: (options: {
         serializedInputPropsWithCustomSchema: string;
@@ -469,7 +474,7 @@ export declare const RenderInternals: {
         port: number | null;
         indent: boolean;
         server: import("./prepare-server").RemotionServer | undefined;
-        logLevel: "error" | "verbose" | "info" | "warn";
+        logLevel: "verbose" | "info" | "warn" | "error";
         serveUrl: string;
         id: string;
     } & import("./options/option").ToOptions<readonly [{
@@ -494,7 +499,7 @@ export declare const RenderInternals: {
         port: number | null;
         server: import("./prepare-server").RemotionServer | undefined;
         indent: boolean;
-        logLevel: "error" | "verbose" | "info" | "warn";
+        logLevel: "verbose" | "info" | "warn" | "error";
         serveUrlOrWebpackUrl: string;
     } & import("./options/option").ToOptions<readonly [{
         name: string;
@@ -510,5 +515,5 @@ export declare const RenderInternals: {
         slowestFrames: import("./render-media").SlowFrame[];
     }>;
     validOpenGlRenderers: readonly ["swangle", "angle", "egl", "swiftshader"];
-    copyImageToClipboard: (src: string, logLevel: "error" | "verbose" | "info" | "warn") => Promise<void>;
+    copyImageToClipboard: (src: string, logLevel: "verbose" | "info" | "warn" | "error") => Promise<void>;
 };

package/dist/logger.d.ts

@@ -19,6 +19,6 @@ export declare const Log: {
     error: (message?: any, ...optionalParams: any[]) => void;
     errorAdvanced: (options: VerboseLogOptions, message?: any, ...optionalParams: any[]) => void;
 };
-export declare const getLogLevel: () => "error" | "verbose" | "info" | "warn";
+export declare const getLogLevel: () => "verbose" | "info" | "warn" | "error";
 export declare const setLogLevel: (newLogLevel: LogLevel) => void;
 export {};

package/dist/options/audio-bitrate.js

@@ -4,7 +4,7 @@ exports.audioBitrateOption = void 0;
 const jsx_runtime_1 = require("react/jsx-runtime");
 exports.audioBitrateOption = {
     name: 'Audio Bitrate',
-    cliFlag: '--audio-bitrate',
+    cliFlag: 'audio-bitrate',
     description: () => ((0, jsx_runtime_1.jsxs)(jsx_runtime_1.Fragment, { children: ["Specify the target bitrate for the generated video. The syntax for FFMPEGs", (0, jsx_runtime_1.jsx)("code", { children: "-b:a" }), " parameter should be used. FFMPEG may encode the video in a way that will not result in the exact audio bitrate specified. Example values: ", (0, jsx_runtime_1.jsx)("code", { children: "512K" }), " for 512 kbps, ", (0, jsx_runtime_1.jsx)("code", { children: "1M" }), " for 1 Mbps. Default: ", (0, jsx_runtime_1.jsx)("code", { children: "320k" })] })),
     ssrName: 'audioBitrate',
     docLink: 'https://www.remotion.dev/docs/renderer/render-media#audiobitrate-',

package/dist/options/color-space.d.ts

@@ -0,0 +1,12 @@
+/// <reference types="react" />
+export declare const validColorSpaces: readonly ["default", "bt709"];
+export type ColorSpace = (typeof validColorSpaces)[number];
+export declare const colorSpaceOption: {
+    name: string;
+    cliFlag: "color-space";
+    description: () => JSX.Element;
+    docLink: string;
+    ssrName: string;
+    type: "default" | "bt709";
+};
+export declare const validateColorSpace: (option: unknown) => void;

package/dist/options/color-space.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateColorSpace = exports.colorSpaceOption = exports.validColorSpaces = void 0;
+const jsx_runtime_1 = require("react/jsx-runtime");
+exports.validColorSpaces = ['default', 'bt709'];
+exports.colorSpaceOption = {
+    name: 'Color space',
+    cliFlag: 'color-space',
+    description: () => ((0, jsx_runtime_1.jsxs)(jsx_runtime_1.Fragment, { children: ["Color space to use for the video. Acceptable values:", ' ', (0, jsx_runtime_1.jsxs)("code", { children: ['"', "default", '"'] }), ",", ' ', (0, jsx_runtime_1.jsxs)("code", { children: ['"', "bt709", '"'] })] })),
+    docLink: 'https://www.remotion.dev/docs/renderer/render-media#colorspace',
+    ssrName: 'colorSpace',
+    type: 'default',
+};
+const validateColorSpace = (option) => {
+    if (exports.validColorSpaces.includes(option)) {
+        return;
+    }
+    throw new Error(`Expected one of ${exports.validColorSpaces.map((c) => `"${c}"`).join(', ')} for ${exports.colorSpaceOption.ssrName} but got "${option}"`);
+};
+exports.validateColorSpace = validateColorSpace;

package/dist/options/crf.js

@@ -4,7 +4,7 @@ exports.crfOption = void 0;
 const jsx_runtime_1 = require("react/jsx-runtime");
 exports.crfOption = {
     name: 'CRF',
-    cliFlag: '--crf',
+    cliFlag: 'crf',
     description: () => ((0, jsx_runtime_1.jsx)(jsx_runtime_1.Fragment, { children: "No matter which codec you end up using, there's always a tradeoff between file size and video quality. You can control it by setting the CRF (Constant Rate Factor). The lower the number, the better the quality, the higher the number, the smaller the file is \u2013 of course at the cost of quality." })),
     ssrName: 'crf',
     docLink: 'https://www.remotion.dev/docs/encoding/#controlling-quality-using-the-crf-setting',

package/dist/options/enforce-audio.js

@@ -4,7 +4,7 @@ exports.enforceAudioOption = void 0;
 const jsx_runtime_1 = require("react/jsx-runtime");
 exports.enforceAudioOption = {
     name: 'Enforce Audio Track',
-    cliFlag: '--enforce-audio-track',
+    cliFlag: 'enforce-audio-track',
     description: () => ((0, jsx_runtime_1.jsx)(jsx_runtime_1.Fragment, { children: "Render a silent audio track if there would be none otherwise." })),
     ssrName: 'enforceAudioTrack',
     docLink: 'https://www.remotion.dev/docs/config#setenforceaudiotrack-',

package/dist/options/jpeg-quality.js

@@ -4,7 +4,7 @@ exports.jpegQualityOption = void 0;
 const jsx_runtime_1 = require("react/jsx-runtime");
 exports.jpegQualityOption = {
     name: 'JPEG Quality',
-    cliFlag: '--jpeg-quality',
+    cliFlag: 'jpeg-quality',
     description: () => ((0, jsx_runtime_1.jsx)(jsx_runtime_1.Fragment, { children: "Sets the quality of the generated JPEG images. Must be an integer between 0 and 100. Default: 80." })),
     ssrName: 'jpegQuality',
     docLink: 'https://www.remotion.dev/docs/renderer/render-media#jpeg-quality',

package/dist/options/mute.js

@@ -4,7 +4,7 @@ exports.muteOption = void 0;
 const jsx_runtime_1 = require("react/jsx-runtime");
 exports.muteOption = {
     name: 'Muted',
-    cliFlag: '--muted',
+    cliFlag: 'muted',
     description: () => (0, jsx_runtime_1.jsx)(jsx_runtime_1.Fragment, { children: "The Audio of the video will be omitted." }),
     ssrName: 'muted',
     docLink: 'https://www.remotion.dev/docs/using-audio/#muted-property',

package/dist/options/scale.js

@@ -4,7 +4,7 @@ exports.scaleOption = void 0;
 const jsx_runtime_1 = require("react/jsx-runtime");
 exports.scaleOption = {
     name: 'Scale',
-    cliFlag: '--scale',
+    cliFlag: 'scale',
     description: () => ((0, jsx_runtime_1.jsxs)(jsx_runtime_1.Fragment, { children: ["Scales the output by a factor. For example, a 1280x720px frame will become a 1920x1080px frame with a scale factor of ", (0, jsx_runtime_1.jsx)("code", { children: "1.5" }), ". Vector elements like fonts and HTML markups will be rendered with extra details."] })),
     ssrName: 'scale',
     docLink: 'https://www.remotion.dev/docs/scaling',

package/dist/options/video-bitrate.js

@@ -4,7 +4,7 @@ exports.videoBitrate = void 0;
 const jsx_runtime_1 = require("react/jsx-runtime");
 exports.videoBitrate = {
     name: 'Video Bitrate',
-    cliFlag: '--video-bitrate',
+    cliFlag: 'video-bitrate',
     description: () => ((0, jsx_runtime_1.jsxs)(jsx_runtime_1.Fragment, { children: ["Specify the target bitrate for the generated video. The syntax for FFMPEGs", (0, jsx_runtime_1.jsx)("code", { children: "-b:v" }), " parameter should be used. FFMPEG may encode the video in a way that will not result in the exact video bitrate specified. Example values: ", (0, jsx_runtime_1.jsx)("code", { children: "512K" }), " for 512 kbps, ", (0, jsx_runtime_1.jsx)("code", { children: "1M" }), " for 1 Mbps."] })),
     ssrName: 'videoBitrate',
     docLink: 'https://www.remotion.dev/docs/renderer/render-media#videobitrate-',

package/dist/options/video-codec.js

@@ -4,7 +4,7 @@ exports.videoCodecOption = void 0;
 const jsx_runtime_1 = require("react/jsx-runtime");
 exports.videoCodecOption = {
     name: 'Codec',
-    cliFlag: '--codec',
+    cliFlag: 'codec',
     description: () => ((0, jsx_runtime_1.jsx)(jsx_runtime_1.Fragment, { children: "H264 works well in most cases, but sometimes it's worth going for a different codec. WebM achieves higher compression but is slower to render. WebM and ProRes support transparency." })),
     ssrName: 'codec',
     docLink: 'https://www.remotion.dev/docs/encoding/#choosing-a-codec',

package/dist/prespawn-ffmpeg.d.ts

@@ -3,8 +3,10 @@ import type { FfmpegOverrideFn } from './ffmpeg-override';
 import type { VideoImageFormat } from './image-format';
 import type { LogLevel } from './log-level';
 import type { CancelSignal } from './make-cancel-signal';
+import type { ColorSpace } from './options/color-space';
 import type { PixelFormat } from './pixel-format';
 import type { ProResProfile } from './prores-profile';
+import type { X264Preset } from './x264-preset';
 type RunningStatus = {
     type: 'running';
 } | {
@@ -23,6 +25,7 @@ type PreStitcherOptions = {
     pixelFormat: PixelFormat | undefined;
     codec: Codec | undefined;
     crf: number | null | undefined;
+    x264Preset: X264Preset | null;
     onProgress: (progress: number) => void;
     proResProfile: ProResProfile | undefined;
     logLevel: LogLevel;
@@ -31,6 +34,7 @@ type PreStitcherOptions = {
     signal: CancelSignal;
     videoBitrate: string | null;
     indent: boolean;
+    colorSpace: ColorSpace;
 };
 export declare const prespawnFfmpeg: (options: PreStitcherOptions) => {
     task: import("execa").ExecaChildProcess<string>;

package/dist/prespawn-ffmpeg.js

@@ -3,8 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.prespawnFfmpeg = void 0;
 const call_ffmpeg_1 = require("./call-ffmpeg");
 const codec_1 = require("./codec");
-const crf_1 = require("./crf");
-const get_codec_name_1 = require("./get-codec-name");
+const ffmpeg_args_1 = require("./ffmpeg-args");
 const get_prores_profile_name_1 = require("./get-prores-profile-name");
 const logger_1 = require("./logger");
 const parse_ffmpeg_progress_1 = require("./parse-ffmpeg-progress");
@@ -24,11 +23,7 @@ const prespawnFfmpeg = (options) => {
         scale: 1,
     });
     const pixelFormat = (_b = options.pixelFormat) !== null && _b !== void 0 ? _b : pixel_format_1.DEFAULT_PIXEL_FORMAT;
-    const encoderName = (0, get_codec_name_1.getCodecName)(codec);
     const proResProfileName = (0, get_prores_profile_name_1.getProResProfileName)(codec, options.proResProfile);
-    if (encoderName === null) {
-        throw new TypeError('encoderName is null: ' + JSON.stringify(options));
-    }
     (0, pixel_format_1.validateSelectedPixelFormatAndCodecCombination)(pixelFormat, codec);
     const ffmpegArgs = [
         ['-r', options.fps],
@@ -40,18 +35,15 @@ const prespawnFfmpeg = (options) => {
             ['-vcodec', options.imageFormat === 'jpeg' ? 'mjpeg' : 'png'],
             ['-i', '-'],
         ],
-        // -c:v is the same as -vcodec as -codec:video
-        // and specified the video codec.
-        ['-c:v', encoderName],
-        proResProfileName ? ['-profile:v', proResProfileName] : null,
-        ['-pix_fmt', pixelFormat],
-        // Without explicitly disabling auto-alt-ref,
-        // transparent WebM generation doesn't work
-        pixelFormat === 'yuva420p' ? ['-auto-alt-ref', '0'] : null,
-        ...(0, crf_1.validateQualitySettings)({
+        ...(0, ffmpeg_args_1.generateFfmpegArgs)({
+            hasPreencoded: false,
+            proResProfileName,
+            pixelFormat,
+            x264Preset: options.x264Preset,
+            codec,
             crf: options.crf,
             videoBitrate: options.videoBitrate,
-            codec,
+            colorSpace: options.colorSpace,
         }),
         '-y',
         options.outputLocation,

package/dist/render-media.d.ts

@@ -12,6 +12,7 @@ import type { VideoImageFormat } from './image-format';
 import { type LogLevel } from './log-level';
 import type { CancelSignal } from './make-cancel-signal';
 import type { ChromiumOptions } from './open-browser';
+import type { ColorSpace } from './options/color-space';
 import type { ToOptions } from './options/option';
 import type { optionsMap } from './options/options-map';
 import type { PixelFormat } from './pixel-format';
@@ -74,6 +75,7 @@ export type InternalRenderMediaOptions = {
     audioCodec: AudioCodec | null;
     serveUrl: string;
     concurrency: number | string | null;
+    colorSpace: ColorSpace;
 } & ToOptions<typeof optionsMap.renderMedia>;
 export type RenderMediaOptions = {
     outputLocation?: string | null;
@@ -126,6 +128,7 @@ export type RenderMediaOptions = {
     concurrency?: number | string | null;
     logLevel?: LogLevel;
     offthreadVideoCacheSizeInBytes?: number | null;
+    colorSpace?: ColorSpace;
 };
 type RenderMediaResult = {
     buffer: Buffer | null;
@@ -137,5 +140,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, audioCodec, jpegQuality, concurrency, serveUrl, disallowParallelEncoding, everyNthFrame, imageFormat, numberOfGifLoops, dumpBrowserLogs, preferLossless, verbose, quality, logLevel, offthreadVideoCacheSizeInBytes, }: 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, offthreadVideoCacheSizeInBytes, colorSpace, }: RenderMediaOptions) => Promise<RenderMediaResult>;
 export {};

package/dist/render-media.js

@@ -46,7 +46,7 @@ const validate_videobitrate_1 = require("./validate-videobitrate");
 const wrap_with_error_handling_1 = require("./wrap-with-error-handling");
 const x264_preset_1 = require("./x264-preset");
 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, audioCodec, concurrency, disallowParallelEncoding, everyNthFrame, imageFormat: provisionalImageFormat, indent, jpegQuality, numberOfGifLoops, onCtrlCExit, preferLossless, serveUrl, server: reusedServer, logLevel, serializedResolvedPropsWithCustomSchema, offthreadVideoCacheSizeInBytes, }) => {
+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, audioCodec, concurrency, disallowParallelEncoding, everyNthFrame, imageFormat: provisionalImageFormat, indent, jpegQuality, numberOfGifLoops, onCtrlCExit, preferLossless, serveUrl, server: reusedServer, logLevel, serializedResolvedPropsWithCustomSchema, offthreadVideoCacheSizeInBytes, colorSpace, }) => {
     (0, jpeg_quality_1.validateJpegQuality)(jpegQuality);
     (0, crf_1.validateQualitySettings)({ crf, codec, videoBitrate });
     (0, validate_videobitrate_1.validateBitrate)(audioBitrate, 'audioBitrate');
@@ -183,6 +183,8 @@ const internalRenderMediaRaw = ({ proResProfile, x264Preset, crf, composition, s
                 ffmpegOverride: ffmpegOverride !== null && ffmpegOverride !== void 0 ? ffmpegOverride : (({ args }) => args),
                 videoBitrate,
                 indent,
+                x264Preset: x264Preset !== null && x264Preset !== void 0 ? x264Preset : null,
+                colorSpace,
             });
             stitcherFfmpeg = preStitcher.task;
         }
@@ -356,6 +358,7 @@ const internalRenderMediaRaw = ({ proResProfile, x264Preset, crf, composition, s
                     videoBitrate,
                     audioCodec,
                     x264Preset: x264Preset !== null && x264Preset !== void 0 ? x264Preset : null,
+                    colorSpace,
                 }),
                 stitchStart,
             ]);
@@ -421,7 +424,7 @@ exports.internalRenderMedia = (0, wrap_with_error_handling_1.wrapWithErrorHandli
  * @description Render a video from a composition
  * @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, audioCodec, jpegQuality, concurrency, serveUrl, disallowParallelEncoding, everyNthFrame, imageFormat, numberOfGifLoops, dumpBrowserLogs, preferLossless, verbose, quality, logLevel, offthreadVideoCacheSizeInBytes, }) => {
+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, offthreadVideoCacheSizeInBytes, colorSpace, }) => {
     var _a, _b;
     if (quality !== undefined) {
         console.warn(`The "quality" option has been renamed. Please use "jpegQuality" instead.`);
@@ -477,6 +480,7 @@ const renderMedia = ({ proResProfile, x264Preset, crf, composition, inputProps,
             data: (_b = composition.props) !== null && _b !== void 0 ? _b : {},
         }).serializedString,
         offthreadVideoCacheSizeInBytes: offthreadVideoCacheSizeInBytes !== null && offthreadVideoCacheSizeInBytes !== void 0 ? offthreadVideoCacheSizeInBytes : null,
+        colorSpace: colorSpace !== null && colorSpace !== void 0 ? colorSpace : 'default',
     });
 };
 exports.renderMedia = renderMedia;

package/dist/set-props-and-env.js

@@ -42,9 +42,7 @@ const innerSetPropsAndEnv = async ({ serializedInputPropsWithCustomSchema, envVa
         throw new Error(`Visited "${urlToVisit}" but got no response.`);
     }
     const status = pageRes.status();
-    // S3 in rare occasions returns a 500 or 503 error code for GET operations.
-    // Usually it is fixed by retrying.
-    if (status >= 500 && status <= 504 && retriesRemaining > 0) {
+    const retry = async () => {
         await new Promise((resolve) => {
             setTimeout(() => {
                 resolve();
@@ -64,6 +62,11 @@ const innerSetPropsAndEnv = async ({ serializedInputPropsWithCustomSchema, envVa
             indent,
             logLevel,
         });
+    };
+    // S3 in rare occasions returns a 500 or 503 error code for GET operations.
+    // Usually it is fixed by retrying.
+    if (status >= 500 && status <= 504 && retriesRemaining > 0) {
+        return retry();
     }
     if (!redirect_status_codes_1.redirectStatusCodes.every((code) => code !== status)) {
         throw new Error(`Error while getting compositions: Tried to go to ${urlToVisit} but the status code was ${status} instead of 200. Does the site you specified exist?`);
@@ -85,6 +88,10 @@ const innerSetPropsAndEnv = async ({ serializedInputPropsWithCustomSchema, envVa
             frame: null,
             page,
         });
+        // AWS shakyness
+        if (body.includes('We encountered an internal error.')) {
+            return retry();
+        }
         const errorMessage = [
             `Error while getting compositions: Tried to go to ${urlToVisit} and verify that it is a Remotion project by checking if window.getStaticCompositions is defined.`,
             'However, the function was undefined, which indicates that this is not a valid Remotion project. Please check the URL you passed.',

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

@@ -6,6 +6,7 @@ import type { Codec } from './codec';
 import type { FfmpegOverrideFn } from './ffmpeg-override';
 import type { LogLevel } from './log-level';
 import type { CancelSignal } from './make-cancel-signal';
+import type { ColorSpace } from './options/color-space';
 import type { PixelFormat } from './pixel-format';
 import type { ProResProfile } from './prores-profile';
 import type { X264Preset } from './x264-preset';
@@ -36,6 +37,7 @@ type InternalStitchFramesToVideoOptions = {
     x264Preset: X264Preset | null;
     enforceAudioTrack: boolean;
     ffmpegOverride: null | FfmpegOverrideFn;
+    colorSpace: ColorSpace;
 };
 export type StitchFramesToVideoOptions = {
     audioBitrate?: string | null;
@@ -61,11 +63,12 @@ export type StitchFramesToVideoOptions = {
     enforceAudioTrack?: boolean;
     ffmpegOverride?: FfmpegOverrideFn;
     x264Preset?: X264Preset | null;
+    colorSpace?: ColorSpace;
 };
 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, x264Preset, }: 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, colorSpace, }: StitchFramesToVideoOptions) => Promise<Buffer | null>;
 export {};

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

@@ -41,8 +41,8 @@ const convert_number_of_gif_loops_to_ffmpeg_1 = require("./convert-number-of-gif
 const crf_1 = require("./crf");
 const delete_directory_1 = require("./delete-directory");
 const does_have_m2_bug_1 = require("./does-have-m2-bug");
+const ffmpeg_args_1 = require("./ffmpeg-args");
 const find_closest_package_json_1 = require("./find-closest-package-json");
-const get_codec_name_1 = require("./get-codec-name");
 const get_extension_from_codec_1 = require("./get-extension-from-codec");
 const get_prores_profile_name_1 = require("./get-prores-profile-name");
 const logger_1 = require("./logger");
@@ -101,7 +101,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, x264Preset, }, 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, colorSpace, }, remotionRoot) => {
     var _a;
     (0, validate_1.validateDimension)(height, 'height', 'passed to `stitchFramesToVideo()`');
     (0, validate_1.validateDimension)(width, 'width', 'passed to `stitchFramesToVideo()`');
@@ -118,7 +118,6 @@ const innerStitchFramesToVideo = async ({ assetsInfo, audioBitrate, audioCodec,
     (0, validate_videobitrate_1.validateBitrate)(audioBitrate, 'audioBitrate');
     (0, validate_videobitrate_1.validateBitrate)(videoBitrate, 'videoBitrate');
     (0, validate_1.validateFps)(fps, 'in `stitchFramesToVideo()`', false);
-    const encoderName = (0, get_codec_name_1.getCodecName)(codec);
     const proResProfileName = (0, get_prores_profile_name_1.getProResProfileName)(codec, proResProfile);
     const mediaSupport = (0, codec_supports_media_1.codecSupportsMedia)(codec);
     const shouldRenderAudio = mediaSupport.audio &&
@@ -240,24 +239,16 @@ const innerStitchFramesToVideo = async ({ assetsInfo, audioBitrate, audioCodec,
         numberOfGifLoops === null
             ? null
             : ['-loop', (0, convert_number_of_gif_loops_to_ffmpeg_1.convertNumberOfGifLoopsToFfmpegSyntax)(numberOfGifLoops)],
-        // -c:v is the same as -vcodec as -codec:video
-        // and specified the video codec.
-        ['-c:v', encoderName],
-        ...(preEncodedFileLocation
-            ? []
-            : [
-                proResProfileName ? ['-profile:v', proResProfileName] : null,
-                ['-pix_fmt', pixelFormat],
-                // Without explicitly disabling auto-alt-ref,
-                // transparent WebM generation doesn't work
-                pixelFormat === 'yuva420p' ? ['-auto-alt-ref', '0'] : null,
-                ...(0, crf_1.validateQualitySettings)({
-                    crf,
-                    videoBitrate,
-                    codec,
-                }),
-            ]),
-        x264Preset ? ['-preset', x264Preset] : null,
+        ...(0, ffmpeg_args_1.generateFfmpegArgs)({
+            codec,
+            crf,
+            videoBitrate,
+            hasPreencoded: Boolean(preEncodedFileLocation),
+            proResProfileName,
+            pixelFormat,
+            x264Preset,
+            colorSpace,
+        }),
         codec === 'h264' ? ['-movflags', 'faststart'] : null,
         resolvedAudioCodec
             ? ['-c:a', (0, audio_codec_1.mapAudioCodecToFfmpegAudioCodecName)(resolvedAudioCodec)]
@@ -361,7 +352,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, x264Preset, }) => {
+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, colorSpace, }) => {
     return (0, exports.internalStitchFramesToVideo)({
         assetsInfo,
         audioBitrate: audioBitrate !== null && audioBitrate !== void 0 ? audioBitrate : null,
@@ -389,6 +380,7 @@ const stitchFramesToVideo = ({ assetsInfo, force, fps, height, width, audioBitra
         preEncodedFileLocation: null,
         preferLossless: false,
         x264Preset: x264Preset !== null && x264Preset !== void 0 ? x264Preset : null,
+        colorSpace: colorSpace !== null && colorSpace !== void 0 ? colorSpace : 'default',
     });
 };
 exports.stitchFramesToVideo = stitchFramesToVideo;

package/dist/validate-concurrency.d.ts

@@ -1,3 +1,7 @@
-export declare const validateConcurrency: (value: unknown, setting: string) => void;
+export declare const validateConcurrency: ({ setting, value, checkIfValidForCurrentMachine, }: {
+    value: unknown;
+    setting: string;
+    checkIfValidForCurrentMachine: boolean;
+}) => void;
 export declare const getMaxConcurrency: () => any;
 export declare const getMinConcurrency: () => number;

package/dist/validate-concurrency.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getMinConcurrency = exports.getMaxConcurrency = exports.validateConcurrency = void 0;
-const validateConcurrency = (value, setting) => {
+const validateConcurrency = ({ setting, value, checkIfValidForCurrentMachine, }) => {
     if (typeof value === 'undefined') {
         return;
     }
@@ -15,11 +15,13 @@ const validateConcurrency = (value, setting) => {
         if (value % 1 !== 0) {
             throw new Error(setting + ' must be an integer, but is ' + value);
         }
-        if (value < (0, exports.getMinConcurrency)()) {
-            throw new Error(`${setting} must be at least ${(0, exports.getMinConcurrency)()}, but is ${JSON.stringify(value)}`);
-        }
-        if (value > (0, exports.getMaxConcurrency)()) {
-            throw new Error(`${setting} is set higher than the amount of CPU cores available. Available CPU cores: ${(0, exports.getMaxConcurrency)()}, value set: ${value}`);
+        if (checkIfValidForCurrentMachine) {
+            if (value < (0, exports.getMinConcurrency)()) {
+                throw new Error(`${setting} must be at least ${(0, exports.getMinConcurrency)()}, but is ${JSON.stringify(value)}`);
+            }
+            if (value > (0, exports.getMaxConcurrency)()) {
+                throw new Error(`${setting} is set higher than the amount of CPU cores available. Available CPU cores: ${(0, exports.getMaxConcurrency)()}, value set: ${value}`);
+            }
         }
     }
     else if (!/^\d+(\.\d+)?%$/.test(value)) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@remotion/renderer",
-  "version": "4.0.26",
+  "version": "4.0.28",
   "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.26"
+    "remotion": "4.0.28"
   },
   "peerDependencies": {
     "react": ">=16.8.0",
@@ -40,13 +40,13 @@
     "vitest": "0.31.1"
   },
   "optionalDependencies": {
-    "@remotion/compositor-darwin-x64": "4.0.26",
-    "@remotion/compositor-linux-arm64-gnu": "4.0.26",
-    "@remotion/compositor-linux-x64-gnu": "4.0.26",
-    "@remotion/compositor-linux-arm64-musl": "4.0.26",
-    "@remotion/compositor-linux-x64-musl": "4.0.26",
-    "@remotion/compositor-darwin-arm64": "4.0.26",
-    "@remotion/compositor-win32-x64-msvc": "4.0.26"
+    "@remotion/compositor-darwin-arm64": "4.0.28",
+    "@remotion/compositor-linux-arm64-gnu": "4.0.28",
+    "@remotion/compositor-darwin-x64": "4.0.28",
+    "@remotion/compositor-linux-arm64-musl": "4.0.28",
+    "@remotion/compositor-linux-x64-gnu": "4.0.28",
+    "@remotion/compositor-linux-x64-musl": "4.0.28",
+    "@remotion/compositor-win32-x64-msvc": "4.0.28"
   },
   "keywords": [
     "remotion",