@remotion/cli 4.0.521 → 4.0.522

package/dist/cloudrun-command.d.ts

@@ -1 +1,2 @@
+export declare const tryPrintCloudrunHelp: (remotionRoot: string, args: string[], logLevel: "error" | "info" | "trace" | "verbose" | "warn") => boolean;
 export declare const cloudrunCommand: (remotionRoot: string, args: string[], logLevel: "error" | "info" | "trace" | "verbose" | "warn") => Promise<never>;

package/dist/cloudrun-command.js

@@ -1,8 +1,31 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.cloudrunCommand = void 0;
+exports.cloudrunCommand = exports.tryPrintCloudrunHelp = void 0;
 const studio_server_1 = require("@remotion/studio-server");
 const log_1 = require("./log");
+const tryPrintCloudrunHelp = (remotionRoot, args, logLevel) => {
+    let path;
+    try {
+        path = require.resolve('@remotion/cloudrun/internal/help', {
+            paths: [remotionRoot],
+        });
+    }
+    catch (_a) {
+        return false;
+    }
+    try {
+        const { printHelp } = require(path);
+        if (typeof printHelp !== 'function') {
+            return false;
+        }
+        printHelp(args, logLevel);
+        return true;
+    }
+    catch (_b) {
+        return false;
+    }
+};
+exports.tryPrintCloudrunHelp = tryPrintCloudrunHelp;
 const cloudrunCommand = async (remotionRoot, args, logLevel) => {
     try {
         const path = require.resolve('@remotion/cloudrun', {

package/dist/command-help.d.ts

@@ -0,0 +1,29 @@
+export type CommandHelpOption = {
+    flag: string;
+    description: string;
+};
+export type CommandHelpEntry = {
+    path: readonly string[];
+    args: string;
+    description: string;
+    documentation: string;
+    options: readonly CommandHelpOption[];
+    listed?: boolean;
+};
+type RemotionOptionForHelp = {
+    cliFlag: string;
+    name: string;
+    type: unknown;
+};
+export declare const makeCommandHelpOption: ({ option, description, value, }: {
+    option: RemotionOptionForHelp;
+    description?: string | undefined;
+    value?: string | null | undefined;
+}) => CommandHelpOption;
+export declare const getCommandHelp: ({ binaryName, commands, selectedPath, rootDocumentation, }: {
+    binaryName: string;
+    commands: readonly CommandHelpEntry[];
+    selectedPath: readonly string[];
+    rootDocumentation: string;
+}) => string[];
+export {};

package/dist/command-help.js

@@ -0,0 +1,64 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getCommandHelp = exports.makeCommandHelpOption = void 0;
+const chalk_1 = require("./chalk");
+const makeCommandHelpOption = ({ option, description, value, }) => {
+    const valueSuffix = value === null
+        ? ''
+        : ` ${value !== null && value !== void 0 ? value : (typeof option.type === 'boolean' ? '' : '<value>')}`;
+    return {
+        flag: `--${option.cliFlag}${valueSuffix}`.trimEnd(),
+        description: description !== null && description !== void 0 ? description : option.name,
+    };
+};
+exports.makeCommandHelpOption = makeCommandHelpOption;
+const commandMatches = (command, selectedPath) => command.path.every((part, index) => selectedPath[index] === part) &&
+    selectedPath.length >= command.path.length;
+const formatOption = (option, width) => {
+    return `  ${chalk_1.chalk.blue(option.flag.padEnd(width))}${option.description}`;
+};
+const getCommandHelp = ({ binaryName, commands, selectedPath, rootDocumentation, }) => {
+    const selectedCommand = commands
+        .filter((command) => commandMatches(command, selectedPath))
+        .sort((a, b) => b.path.length - a.path.length)[0];
+    if (selectedCommand) {
+        const displayPath = selectedPath
+            .slice(0, selectedCommand.path.length)
+            .join(' ');
+        const selectedBinaryName = displayPath
+            ? `${binaryName} ${displayPath}`
+            : binaryName;
+        const children = commands.filter((command) => command.listed !== false &&
+            command.path.length === selectedCommand.path.length + 1 &&
+            selectedCommand.path.every((part, index) => command.path[index] === part));
+        const options = [
+            ...selectedCommand.options,
+            { flag: '--help', description: 'Show this help.' },
+        ];
+        const optionWidth = Math.max(...options.map((option) => option.flag.length)) + 2;
+        const commandLines = [
+            '',
+            chalk_1.chalk.blue(selectedBinaryName) + chalk_1.chalk.gray(selectedCommand.args),
+            selectedCommand.description,
+        ];
+        if (children.length > 0) {
+            commandLines.push('', 'Commands:');
+            for (const child of children) {
+                commandLines.push('', chalk_1.chalk.blue(`${binaryName} ${child.path.join(' ')}`) +
+                    chalk_1.chalk.gray(child.args), child.description);
+            }
+        }
+        commandLines.push('', 'Options:', ...options.map((option) => formatOption(option, optionWidth)), '', chalk_1.chalk.gray(`Full documentation: ${selectedCommand.documentation}`));
+        return commandLines;
+    }
+    const lines = ['', 'Available commands:'];
+    for (const command of commands) {
+        if (command.path.length !== 1 || command.listed === false) {
+            continue;
+        }
+        lines.push('', chalk_1.chalk.blue(`${binaryName} ${command.path[0]}`) + chalk_1.chalk.gray(command.args), command.description, chalk_1.chalk.gray(command.documentation));
+    }
+    lines.push('', `Visit ${rootDocumentation} for browsable CLI documentation.`);
+    return lines;
+};
+exports.getCommandHelp = getCommandHelp;

package/dist/image-formats.d.ts

@@ -0,0 +1,4 @@
+export declare const getVideoImageFormat: ({ codec, uiImageFormat, }: {
+    codec: import("@remotion/renderer").CodecOrUndefined;
+    uiImageFormat: "jpeg" | "none" | "png" | null;
+}) => "jpeg" | "none" | "png";

package/dist/image-formats.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getVideoImageFormat = void 0;
+const client_1 = require("@remotion/renderer/client");
+const pure_1 = require("@remotion/renderer/pure");
+const parsed_cli_1 = require("./parsed-cli");
+const getVideoImageFormat = ({ codec, uiImageFormat, }) => {
+    if (uiImageFormat !== null) {
+        return uiImageFormat;
+    }
+    const configured = client_1.BrowserSafeApis.options.videoImageFormatOption.getValue({
+        commandLine: parsed_cli_1.parsedCli,
+    }).value;
+    if (configured !== null) {
+        return configured;
+    }
+    if (pure_1.NoReactAPIs.isAudioCodec(codec)) {
+        return 'none';
+    }
+    if (codec === 'h264' ||
+        codec === 'h264-mkv' ||
+        codec === 'h264-ts' ||
+        codec === 'h265' ||
+        codec === 'av1' ||
+        codec === 'vp8' ||
+        codec === 'vp9' ||
+        codec === 'prores' ||
+        codec === 'gif') {
+        return 'jpeg';
+    }
+    if (codec === undefined) {
+        return 'png';
+    }
+    throw new Error('Unrecognized codec ' + codec);
+};
+exports.getVideoImageFormat = getVideoImageFormat;

package/dist/index.d.ts

@@ -186,6 +186,21 @@ export declare const CliInternals: {
         disableGitSource: boolean;
         logLevel: "error" | "info" | "trace" | "verbose" | "warn";
     }) => import("@remotion/studio-shared").GitSource | null;
+    getCommandHelp: ({ binaryName, commands, selectedPath, rootDocumentation, }: {
+        binaryName: string;
+        commands: readonly import("./command-help").CommandHelpEntry[];
+        selectedPath: readonly string[];
+        rootDocumentation: string;
+    }) => string[];
+    makeCommandHelpOption: ({ option, description, value, }: {
+        option: {
+            cliFlag: string;
+            name: string;
+            type: unknown;
+        };
+        description?: string | undefined;
+        value?: string | null | undefined;
+    }) => import("./command-help").CommandHelpOption;
     handleCtrlC: ({ indent, logLevel, exit, }: {
         indent: boolean;
         logLevel: "error" | "info" | "trace" | "verbose" | "warn";

package/dist/index.js

@@ -17,6 +17,7 @@ const chalk_1 = require("./chalk");
 const check_for_npm_run_flag_pass_1 = require("./check-for-npm-run-flag-pass");
 const cleanup_before_quit_1 = require("./cleanup-before-quit");
 const cloudrun_command_1 = require("./cloudrun-command");
+const command_help_1 = require("./command-help");
 const compositions_1 = require("./compositions");
 const determine_image_format_1 = require("./determine-image-format");
 const download_progress_1 = require("./download-progress");
@@ -50,6 +51,23 @@ const { packageManagerOption, skipSkillsOption, versionFlagOption } = client_1.B
 const cli = async () => {
     var _a;
     const [command, ...args] = parsed_cli_1.parsedCli._;
+    const helpPath = command === 'help' && (args.length > 0 || !parsed_cli_1.parsedCli.help)
+        ? args
+        : parsed_cli_1.parsedCli._;
+    if (parsed_cli_1.parsedCli.help || command === 'help') {
+        const [helpCommand, ...helpArgs] = helpPath;
+        if (helpCommand === 'lambda' || helpCommand === 'cloudrun') {
+            const helpRemotionRoot = renderer_1.RenderInternals.findRemotionRoot();
+            const printed = helpCommand === 'lambda'
+                ? (0, lambda_command_1.tryPrintLambdaHelp)(helpRemotionRoot, helpArgs, 'info')
+                : (0, cloudrun_command_1.tryPrintCloudrunHelp)(helpRemotionRoot, helpArgs, 'info');
+            if (printed) {
+                return;
+            }
+        }
+        (0, print_help_1.printHelp)('info', helpPath);
+        return;
+    }
     const packageManager = packageManagerOption.getValue({
         commandLine: parsed_cli_1.parsedCli,
     }).value;
@@ -149,18 +167,11 @@ const cli = async () => {
         else if (command === 'benchmark') {
             await (0, benchmark_1.benchmarkCommand)(remotionRoot, args, logLevel);
         }
-        else if (command === 'help') {
-            (0, print_help_1.printHelp)(logLevel);
-            process.exit(0);
-        }
-        else if (parsed_cli_1.parsedCli.help) {
-            (0, print_help_1.printHelp)(logLevel);
-        }
         else {
             if (command) {
                 log_1.Log.error({ indent: false, logLevel }, `Command ${command} not found.`);
             }
-            (0, print_help_1.printHelp)(logLevel);
+            (0, print_help_1.printHelp)(logLevel, []);
             process.exit(1);
         }
     }
@@ -203,6 +214,8 @@ exports.CliInternals = {
     makeHyperlink: make_link_1.makeHyperlink,
     supportsHyperlink: is_supported_1.supportsHyperlink,
     getGitSource: get_github_repository_1.getGitSource,
+    getCommandHelp: command_help_1.getCommandHelp,
+    makeCommandHelpOption: command_help_1.makeCommandHelpOption,
     handleCtrlC: cleanup_before_quit_1.handleCtrlC,
     registerCtrlCHandler: cleanup_before_quit_1.registerCtrlCHandler,
 };

package/dist/lambda-command.d.ts

@@ -1 +1,2 @@
+export declare const tryPrintLambdaHelp: (remotionRoot: string, args: string[], logLevel: "error" | "info" | "trace" | "verbose" | "warn") => boolean;
 export declare const lambdaCommand: (remotionRoot: string, args: string[], logLevel: "error" | "info" | "trace" | "verbose" | "warn") => Promise<never>;

package/dist/lambda-command.js

@@ -1,8 +1,31 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.lambdaCommand = void 0;
+exports.lambdaCommand = exports.tryPrintLambdaHelp = void 0;
 const studio_server_1 = require("@remotion/studio-server");
 const log_1 = require("./log");
+const tryPrintLambdaHelp = (remotionRoot, args, logLevel) => {
+    let path;
+    try {
+        path = require.resolve('@remotion/lambda/internal/help', {
+            paths: [remotionRoot],
+        });
+    }
+    catch (_a) {
+        return false;
+    }
+    try {
+        const { printHelp } = require(path);
+        if (typeof printHelp !== 'function') {
+            return false;
+        }
+        printHelp(args, logLevel);
+        return true;
+    }
+    catch (_b) {
+        return false;
+    }
+};
+exports.tryPrintLambdaHelp = tryPrintLambdaHelp;
 const lambdaCommand = async (remotionRoot, args, logLevel) => {
     try {
         const path = require.resolve('@remotion/lambda', {

package/dist/print-help.d.ts

@@ -1 +1 @@
-export declare const printHelp: (logLevel: "error" | "info" | "trace" | "verbose" | "warn") => void;
+export declare const printHelp: (logLevel: "error" | "info" | "trace" | "verbose" | "warn", selectedPath: readonly string[]) => void;

package/dist/print-help.js

@@ -1,68 +1,491 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.printHelp = void 0;
+const client_1 = require("@remotion/renderer/client");
 const browser_1 = require("./browser");
-const chalk_1 = require("./chalk");
+const command_help_1 = require("./command-help");
 const gpu_1 = require("./gpu");
 const log_1 = require("./log");
 const versions_1 = require("./versions");
 const packagejson = require('../package.json');
-const printHelp = (logLevel) => {
-    log_1.Log.info({ indent: false, logLevel }, `@remotion/cli ${packagejson.version}`);
-    log_1.Log.info({ indent: false, logLevel }, `© ${new Date().getFullYear()} Remotion AG`);
-    log_1.Log.info({ indent: false, logLevel });
-    log_1.Log.info({ indent: false, logLevel }, 'Available commands:');
-    log_1.Log.info({ indent: false, logLevel });
-    log_1.Log.info({ indent: false, logLevel }, chalk_1.chalk.blue('remotion studio') + chalk_1.chalk.gray(' <entry-point.ts>'));
-    log_1.Log.info({ indent: false, logLevel }, 'Start the Remotion studio.');
-    log_1.Log.info({ indent: false, logLevel }, chalk_1.chalk.gray('https://www.remotion.dev/docs/cli/studio'));
-    log_1.Log.info({ indent: false, logLevel });
-    log_1.Log.info({ indent: false, logLevel }, chalk_1.chalk.blue('remotion render') +
-        chalk_1.chalk.gray(' <entry-point.ts> <comp-id> <output-file.mp4>'));
-    log_1.Log.info({ indent: false, logLevel }, 'Render video, audio or an image sequence.');
-    log_1.Log.info({ indent: false, logLevel }, chalk_1.chalk.gray('https://www.remotion.dev/docs/cli/render'));
-    log_1.Log.info({ indent: false, logLevel });
-    log_1.Log.info({ indent: false, logLevel }, chalk_1.chalk.blue('remotion still') +
-        chalk_1.chalk.gray(' <entry-point.ts> <comp-id> <still.png>'));
-    log_1.Log.info({ indent: false, logLevel }, 'Render a still frame and save it as an image.');
-    log_1.Log.info({ indent: false, logLevel }, chalk_1.chalk.gray('https://www.remotion.dev/docs/cli/still'));
-    log_1.Log.info({ indent: false, logLevel });
-    log_1.Log.info({ indent: false, logLevel }, chalk_1.chalk.blue('remotion bundle') + chalk_1.chalk.gray(' <entry-point.ts>'));
-    log_1.Log.info({ indent: false, logLevel }, 'Create a Remotion bundle to be deployed to the web.');
-    log_1.Log.info({ indent: false, logLevel }, chalk_1.chalk.gray('https://www.remotion.dev/docs/cli/bundle'));
-    log_1.Log.info({ indent: false, logLevel });
-    log_1.Log.info({ indent: false, logLevel }, chalk_1.chalk.blue('remotion compositions') + chalk_1.chalk.gray(' <index-file.ts>'));
-    log_1.Log.info({ indent: false, logLevel }, 'Prints the available compositions.');
-    log_1.Log.info({ indent: false, logLevel }, chalk_1.chalk.gray('https://www.remotion.dev/docs/cli/compositions'));
-    log_1.Log.info({ indent: false, logLevel });
-    log_1.Log.info({ indent: false, logLevel }, chalk_1.chalk.blue('remotion benchmark') +
-        chalk_1.chalk.gray(' <index-file.ts> <list-of-compositions>'));
-    log_1.Log.info({ indent: false, logLevel }, 'Benchmarks rendering a composition. Same options as for render.');
-    log_1.Log.info({ indent: false, logLevel }, chalk_1.chalk.gray('https://www.remotion.dev/docs/cli/benchmark'));
-    log_1.Log.info({ indent: false, logLevel });
-    log_1.Log.info({ indent: false, logLevel }, chalk_1.chalk.blue('remotion ' + versions_1.VERSIONS_COMMAND));
-    log_1.Log.info({ indent: false, logLevel }, 'Prints and validates versions of all Remotion packages.');
-    log_1.Log.info({ indent: false, logLevel }, chalk_1.chalk.gray('https://www.remotion.dev/docs/cli/versions'));
-    log_1.Log.info({ indent: false, logLevel });
-    log_1.Log.info({ indent: false, logLevel }, chalk_1.chalk.blue('remotion ' + gpu_1.GPU_COMMAND));
-    log_1.Log.info({ indent: false, logLevel }, 'Prints information about how Chrome uses the CPU.');
-    log_1.Log.info({ indent: false, logLevel }, chalk_1.chalk.gray('https://www.remotion.dev/docs/cli/gpu'));
-    log_1.Log.info({ indent: false, logLevel });
-    log_1.Log.info({ indent: false, logLevel }, chalk_1.chalk.blue('remotion upgrade'));
-    log_1.Log.info({ indent: false, logLevel }, 'Ensure Remotion is on the newest version.');
-    log_1.Log.info({ indent: false, logLevel }, chalk_1.chalk.gray('https://www.remotion.dev/docs/cli/upgrade'));
-    log_1.Log.info({ indent: false, logLevel });
-    log_1.Log.info({ indent: false, logLevel }, chalk_1.chalk.blue('remotion add') + chalk_1.chalk.gray(' <package-name...>'));
-    log_1.Log.info({ indent: false, logLevel }, 'Add Remotion packages with the correct version.');
-    log_1.Log.info({ indent: false, logLevel }, chalk_1.chalk.gray('https://www.remotion.dev/docs/cli/add'));
-    log_1.Log.info({ indent: false, logLevel });
-    log_1.Log.info({ indent: false, logLevel }, chalk_1.chalk.blue('remotion skills ') + chalk_1.chalk.gray('<add | update>'));
-    log_1.Log.info({ indent: false, logLevel }, 'Install or update skills from remotion-dev/skills.');
-    log_1.Log.info({ indent: false, logLevel });
-    log_1.Log.info({ indent: false, logLevel }, chalk_1.chalk.blue(`remotion ${browser_1.BROWSER_COMMAND}`));
-    log_1.Log.info({ indent: false, logLevel }, 'Ensure Remotion has a browser it can use for rendering.');
-    log_1.Log.info({ indent: false, logLevel }, chalk_1.chalk.gray('https://www.remotion.dev/docs/cli/browser'));
-    log_1.Log.info({ indent: false, logLevel });
-    log_1.Log.info({ indent: false, logLevel }, 'Visit https://www.remotion.dev/docs/cli for browsable CLI documentation.');
+const rendererOptions = Object.values(client_1.BrowserSafeApis.options);
+const cliOnlyOptions = {
+    output: {
+        flag: '--output <path>',
+        description: 'Set the output path instead of using a positional argument.',
+    },
+    'browser-args': {
+        flag: '--browser-args <arguments>',
+        description: 'Pass command line arguments to the browser.',
+    },
+    quiet: {
+        flag: '--quiet, -q',
+        description: 'Reduce console output.',
+    },
+};
+const options = (flags, descriptionOverrides = {}) => {
+    return flags.map((flag) => {
+        const cliOnlyOption = cliOnlyOptions[flag];
+        if (cliOnlyOption) {
+            return cliOnlyOption;
+        }
+        const rendererOption = rendererOptions.find((candidate) => candidate.cliFlag === flag);
+        if (!rendererOption) {
+            throw new Error(`No CLI help metadata exists for --${flag}`);
+        }
+        return (0, command_help_1.makeCommandHelpOption)({
+            option: rendererOption,
+            description: descriptionOverrides[flag],
+        });
+    });
+};
+const studioOptions = options([
+    'props',
+    'config',
+    'env-file',
+    'log',
+    'port',
+    'public-dir',
+    'binaries-directory',
+    'disable-git-source',
+    'audio-latency-hint',
+    'disable-keyboard-shortcuts',
+    'disable-interactivity',
+    'allow-html-in-canvas',
+    'editor',
+    'coding-agent',
+    'rspack',
+    'webpack-poll',
+    'no-open',
+    'browser',
+    'browser-args',
+    'browser-executable',
+    'bundle-cache',
+    'chrome-mode',
+    'concurrency',
+    'image-format',
+    'jpeg-quality',
+    'pixel-format',
+    'scale',
+    'crf',
+    'prores-profile',
+    'x264-preset',
+    'gop',
+    'audio-bitrate',
+    'video-bitrate',
+    'audio-codec',
+    'buffer-size',
+    'max-rate',
+    'every-nth-frame',
+    'muted',
+    'enforce-audio-track',
+    'number-of-gif-loops',
+    'color-space',
+    'hardware-acceleration',
+    'timeout',
+    'ignore-certificate-errors',
+    'disable-web-security',
+    'disable-headless',
+    'dark-mode',
+    'gl',
+    'user-agent',
+    'media-cache-size-in-bytes',
+    'offthreadvideo-cache-size-in-bytes',
+    'offthreadvideo-video-threads',
+    'enable-multiprocess-on-linux',
+    'repro',
+    'sample-rate',
+    'for-seamless-aac-concatenation',
+    'beep-on-finish',
+    'ipv4',
+    'number-of-shared-audio-tags',
+    'experimental-keep-audio-context-alive',
+    'preview-sample-rate',
+    'cross-site-isolation',
+    'disable-ask-ai',
+    'force-new',
+    'public-license-key',
+]);
+const commandHelp = [
+    {
+        path: ['studio'],
+        args: ' <entry-point>?',
+        description: 'Start the Remotion Studio.',
+        documentation: 'https://www.remotion.dev/docs/cli/studio',
+        options: studioOptions,
+    },
+    {
+        path: ['preview'],
+        args: ' <entry-point>?',
+        description: 'Start the Remotion Studio.',
+        documentation: 'https://www.remotion.dev/docs/cli/studio',
+        options: studioOptions,
+        listed: false,
+    },
+    {
+        path: ['render'],
+        args: ' [<entry-point|serve-url>] [<composition-id>] [<output-location>]',
+        description: 'Render video, audio or an image sequence.',
+        documentation: 'https://www.remotion.dev/docs/cli/render',
+        options: options([
+            'props',
+            'height',
+            'width',
+            'fps',
+            'duration',
+            'concurrency',
+            'pixel-format',
+            'image-format',
+            'image-sequence-pattern',
+            'config',
+            'env-file',
+            'jpeg-quality',
+            'output',
+            'overwrite',
+            'sequence',
+            'codec',
+            'audio-codec',
+            'audio-bitrate',
+            'video-bitrate',
+            'buffer-size',
+            'max-rate',
+            'prores-profile',
+            'x264-preset',
+            'gop',
+            'crf',
+            'browser-executable',
+            'chrome-mode',
+            'scale',
+            'frames',
+            'every-nth-frame',
+            'muted',
+            'enforce-audio-track',
+            'disallow-parallel-encoding',
+            'number-of-gif-loops',
+            'color-space',
+            'hardware-acceleration',
+            'bundle-cache',
+            'log',
+            'port',
+            'public-dir',
+            'public-path',
+            'audio-latency-hint',
+            'timeout',
+            'ignore-certificate-errors',
+            'disable-web-security',
+            'disable-headless',
+            'dark-mode',
+            'gl',
+            'user-agent',
+            'media-cache-size-in-bytes',
+            'offthreadvideo-cache-size-in-bytes',
+            'offthreadvideo-video-threads',
+            'enable-multiprocess-on-linux',
+            'repro',
+            'binaries-directory',
+            'rspack',
+            'disable-ask-ai',
+            'disable-keyboard-shortcuts',
+            'quiet',
+            'public-license-key',
+            'sample-rate',
+            'for-seamless-aac-concatenation',
+            'separate-audio-to',
+            'metadata',
+        ], { 'image-format': 'Video Image Format' }),
+    },
+    {
+        path: ['still'],
+        args: ' <serve-url|entry-point>? [<composition-id>] [<output-location>]',
+        description: 'Render a still frame and save it as an image.',
+        documentation: 'https://www.remotion.dev/docs/cli/still',
+        options: options([
+            'props',
+            'height',
+            'width',
+            'fps',
+            'duration',
+            'image-format',
+            'config',
+            'env-file',
+            'jpeg-quality',
+            'output',
+            'overwrite',
+            'browser-executable',
+            'scale',
+            'frame',
+            'bundle-cache',
+            'log',
+            'port',
+            'public-dir',
+            'public-path',
+            'audio-latency-hint',
+            'timeout',
+            'ignore-certificate-errors',
+            'disable-web-security',
+            'disable-headless',
+            'dark-mode',
+            'chrome-mode',
+            'gl',
+            'user-agent',
+            'media-cache-size-in-bytes',
+            'offthreadvideo-cache-size-in-bytes',
+            'offthreadvideo-video-threads',
+            'enable-multiprocess-on-linux',
+            'binaries-directory',
+            'rspack',
+            'disable-ask-ai',
+            'disable-keyboard-shortcuts',
+            'quiet',
+            'public-license-key',
+        ]),
+    },
+    {
+        path: ['compositions'],
+        args: ' <serve-url|entry-file>?',
+        description: 'Print the available compositions.',
+        documentation: 'https://www.remotion.dev/docs/cli/compositions',
+        options: options([
+            'props',
+            'browser-executable',
+            'config',
+            'env-file',
+            'bundle-cache',
+            'log',
+            'port',
+            'public-dir',
+            'public-path',
+            'audio-latency-hint',
+            'timeout',
+            'ignore-certificate-errors',
+            'disable-web-security',
+            'disable-headless',
+            'dark-mode',
+            'gl',
+            'enable-multiprocess-on-linux',
+            'user-agent',
+            'media-cache-size-in-bytes',
+            'offthreadvideo-cache-size-in-bytes',
+            'offthreadvideo-video-threads',
+            'binaries-directory',
+            'chrome-mode',
+            'quiet',
+            'rspack',
+            'disable-ask-ai',
+            'disable-keyboard-shortcuts',
+        ]),
+    },
+    {
+        path: ['lambda'],
+        args: ' <command>',
+        description: 'Control Remotion Lambda.',
+        documentation: 'https://www.remotion.dev/docs/lambda/cli',
+        options: [],
+    },
+    {
+        path: ['bundle'],
+        args: ' <serve-url|entry-file>?',
+        description: 'Create a Remotion bundle to be deployed to the web.',
+        documentation: 'https://www.remotion.dev/docs/cli/bundle',
+        options: options([
+            'config',
+            'log',
+            'public-dir',
+            'out-dir',
+            'public-path',
+            'disable-git-source',
+            'bundle-cache',
+            'audio-latency-hint',
+            'rspack',
+            'disable-ask-ai',
+            'disable-keyboard-shortcuts',
+            'quiet',
+        ]),
+    },
+    {
+        path: [browser_1.BROWSER_COMMAND],
+        args: ' <command>',
+        description: 'Ensure Remotion has a browser it can use for rendering.',
+        documentation: 'https://www.remotion.dev/docs/cli/browser',
+        options: [],
+    },
+    {
+        path: [browser_1.BROWSER_COMMAND, 'ensure'],
+        args: '',
+        description: 'Ensure Remotion has a browser it can use for rendering.',
+        documentation: 'https://www.remotion.dev/docs/cli/browser/ensure',
+        options: options(['browser-executable', 'log', 'quiet']),
+    },
+    {
+        path: ['cloudrun'],
+        args: ' <command>',
+        description: 'Control Remotion Cloud Run.',
+        documentation: 'https://www.remotion.dev/docs/cloudrun/cli',
+        options: [],
+    },
+    {
+        path: ['benchmark'],
+        args: ' [<entry-point>] [composition-ids]',
+        description: 'Benchmark rendering one or more compositions.',
+        documentation: 'https://www.remotion.dev/docs/cli/benchmark',
+        options: options([
+            'runs',
+            'concurrencies',
+            'concurrency',
+            'codec',
+            'crf',
+            'frames',
+            'height',
+            'width',
+            'fps',
+            'duration',
+            'image-format',
+            'pixel-format',
+            'props',
+            'prores-profile',
+            'x264-preset',
+            'gop',
+            'jpeg-quality',
+            'log',
+            'ignore-certificate-errors',
+            'disable-web-security',
+            'dark-mode',
+            'disable-headless',
+            'enable-multiprocess-on-linux',
+            'gl',
+            'chrome-mode',
+            'timeout',
+            'scale',
+            'port',
+            'number-of-gif-loops',
+            'every-nth-frame',
+            'muted',
+            'enforce-audio-track',
+            'disallow-parallel-encoding',
+            'browser-executable',
+            'user-agent',
+            'public-dir',
+            'public-path',
+            'config',
+            'env-file',
+            'bundle-cache',
+            'video-bitrate',
+            'audio-bitrate',
+            'buffer-size',
+            'max-rate',
+            'color-space',
+            'hardware-acceleration',
+            'offthreadvideo-cache-size-in-bytes',
+            'offthreadvideo-video-threads',
+            'media-cache-size-in-bytes',
+            'binaries-directory',
+            'rspack',
+            'overwrite',
+            'metadata',
+            'sample-rate',
+            'for-seamless-aac-concatenation',
+            'disable-ask-ai',
+            'disable-keyboard-shortcuts',
+            'quiet',
+        ], { 'image-format': 'Video Image Format' }),
+    },
+    {
+        path: ['skills'],
+        args: ' <add | update>',
+        description: 'Install or update skills from remotion-dev/skills.',
+        documentation: 'https://www.remotion.dev/docs/cli/skills',
+        options: [],
+    },
+    {
+        path: ['skills', 'add'],
+        args: ' [options]',
+        description: 'Install skills from remotion-dev/skills.',
+        documentation: 'https://www.remotion.dev/docs/cli/skills',
+        options: [],
+    },
+    {
+        path: ['skills', 'update'],
+        args: ' [options]',
+        description: 'Update skills from remotion-dev/skills.',
+        documentation: 'https://www.remotion.dev/docs/cli/skills',
+        options: [],
+    },
+    {
+        path: [versions_1.VERSIONS_COMMAND],
+        args: '',
+        description: 'Print and validate versions of all Remotion packages.',
+        documentation: 'https://www.remotion.dev/docs/cli/versions',
+        options: options(['log']),
+    },
+    {
+        path: ['upgrade'],
+        args: '',
+        description: 'Ensure Remotion is on the newest version.',
+        documentation: 'https://www.remotion.dev/docs/cli/upgrade',
+        options: options(['package-manager', 'version', 'skip-skills', 'log']),
+    },
+    {
+        path: ['add'],
+        args: ' <package-name...>',
+        description: 'Add Remotion packages with the correct version.',
+        documentation: 'https://www.remotion.dev/docs/cli/add',
+        options: options(['package-manager', 'log']),
+    },
+    {
+        path: [gpu_1.GPU_COMMAND],
+        args: '',
+        description: 'Print information about how Chrome uses the GPU.',
+        documentation: 'https://www.remotion.dev/docs/cli/gpu',
+        options: options([
+            'log',
+            'gl',
+            'chrome-mode',
+            'browser-executable',
+            'user-agent',
+            'disable-web-security',
+            'ignore-certificate-errors',
+            'enable-multiprocess-on-linux',
+            'timeout',
+            'disable-headless',
+            'dark-mode',
+            'quiet',
+        ]),
+    },
+    {
+        path: ['ffmpeg'],
+        args: ' <arguments...>',
+        description: 'Execute FFmpeg with all arguments forwarded.',
+        documentation: 'https://www.remotion.dev/docs/cli/ffmpeg',
+        options: [],
+    },
+    {
+        path: ['ffprobe'],
+        args: ' <arguments...>',
+        description: 'Execute FFprobe with all arguments forwarded.',
+        documentation: 'https://www.remotion.dev/docs/cli/ffprobe',
+        options: [],
+    },
+    {
+        path: ['help'],
+        args: ' <command...>',
+        description: 'Print available commands and flags for the Remotion CLI.',
+        documentation: 'https://www.remotion.dev/docs/cli/help',
+        options: [],
+    },
+];
+const printHelp = (logLevel, selectedPath) => {
+    if (selectedPath.length === 0) {
+        log_1.Log.info({ indent: false, logLevel }, `@remotion/cli ${packagejson.version}`);
+        log_1.Log.info({ indent: false, logLevel }, `© ${new Date().getFullYear()} Remotion AG`);
+    }
+    const lines = (0, command_help_1.getCommandHelp)({
+        binaryName: 'remotion',
+        commands: commandHelp,
+        selectedPath,
+        rootDocumentation: 'https://www.remotion.dev/docs/cli',
+    });
+    for (const line of selectedPath.length === 0 ? lines : lines.slice(1)) {
+        log_1.Log.info({ indent: false, logLevel }, line);
+    }
 };
 exports.printHelp = printHelp;

package/package.json

@@ -3,7 +3,7 @@
 		"url": "https://github.com/remotion-dev/remotion/tree/main/packages/cli"
 	},
 	"name": "@remotion/cli",
-	"version": "4.0.521",
+	"version": "4.0.522",
 	"description": "Control Remotion features using the `npx remotion` command",
 	"main": "dist/index.js",
 	"bin": {
@@ -37,18 +37,18 @@
 	"license": "SEE LICENSE IN LICENSE.md",
 	"dependencies": {
 		"@babel/parser": "7.24.1",
-		"@remotion/bundler": "4.0.521",
-		"@remotion/media-utils": "4.0.521",
-		"@remotion/player": "4.0.521",
-		"@remotion/renderer": "4.0.521",
-		"@remotion/studio-shared": "4.0.521",
-		"@remotion/studio-server": "4.0.521",
-		"@remotion/studio": "4.0.521",
+		"@remotion/bundler": "4.0.522",
+		"@remotion/media-utils": "4.0.522",
+		"@remotion/player": "4.0.522",
+		"@remotion/renderer": "4.0.522",
+		"@remotion/studio-shared": "4.0.522",
+		"@remotion/studio-server": "4.0.522",
+		"@remotion/studio": "4.0.522",
 		"dotenv": "17.3.1",
 		"minimist": "1.2.6",
 		"prompts": "2.4.2",
 		"semver": "7.5.3",
-		"remotion": "4.0.521"
+		"remotion": "4.0.522"
 	},
 	"peerDependencies": {
 		"react": ">=16.8.0",
@@ -60,14 +60,14 @@
 		"@types/prettier": "2.7.2",
 		"@types/semver": "7.5.3",
 		"@types/node": "20.12.14",
-		"@remotion/zod-types": "4.0.521",
-		"@remotion/tailwind-v4": "4.0.521",
-		"@remotion/enable-scss": "4.0.521",
-		"@remotion/skia": "4.0.521",
+		"@remotion/zod-types": "4.0.522",
+		"@remotion/tailwind-v4": "4.0.522",
+		"@remotion/enable-scss": "4.0.522",
+		"@remotion/skia": "4.0.522",
 		"react": "19.2.3",
 		"react-dom": "19.2.3",
 		"zod": "4.5.4",
-		"@remotion/eslint-config-internal": "4.0.521",
+		"@remotion/eslint-config-internal": "4.0.522",
 		"eslint": "9.19.0",
 		"@typescript/native-preview": "7.0.0-dev.20260217.1"
 	},