npx remotion still

v2.3

根据入口点和组合 ID 渲染一帧静态画面，并保存到输出位置。

🌐 Render a still frame based on the entry point, the composition ID and save it to the output location.

npx remotion still <serve-url|entry-point>? [<composition-id>] [<output-location>]

你可以将 Serve URL 或 入口点 作为第一个参数传入，否则入口点将会被 确定 。

🌐 You may pass a Serve URL or an entry point as the first argument, otherwise the entry point will be determined.

如果未传递 output-location，still 将被渲染到 out 文件夹中。 如果 composition-id 也未传递，Remotion 将让你选择一个组合。

🌐 If output-location is not passed, the still will be rendered into the out folder.
If composition-id is also not passed, Remotion will let you select a composition.

标志

🌐 Flags

--props

Input Props to pass to the selected composition of your video. Must be a serialized JSON string (--props='{"hello": "world"}') or a path to a JSON file (./path/to/props.json).

note

Windows 终端不支持内联 JSON 字符串，因为它会移除 " 字符，请改用文件名。

--image-format

The image format to use when rendering a still. Must be one of "png", "jpeg", "pdf", "webp". Default: "png".

--config

Specify a location for the Remotion config file.

--env-file

Specify a location for a dotenv file. Default .env.

--jpeg-quality v4.0.0

用于 JPEG 渲染质量的 0 到 100 之间的值 (/docs/config#setjpegquality)。在渲染 PNG 帧时不起作用。

--quality v1.4.0

在 v4.0.0 中重命名为 --jpeg-quality

🌐 Renamed to --jpeg-quality in v4.0.0

--output v4.0.0

设置输出文件路径，作为 output-location 位置参数的替代方式。

🌐 Sets the output file path, as an alternative to the output-location positional argument.

--overwrite

即使文件已存在也要写入输出。。此标志默认启用，使用 --overwrite=false 可将其禁用。

--browser-executable

Set a custom Chrome or Chromium executable path. By default Remotion will try to find an existing version of Chrome on your system and if not found, it will download one. This flag is useful if you don't have Chrome installed in a standard location and you want to prevent downloading an additional browser or need support for the H264 codec.

--scale

按你传入的因子缩放输出帧。 例如，一个 1280x720 像素的帧在缩放因子为 1.5 时将变为 1920x1080 像素的帧。矢量元素，如字体和 HTML 标记，将以更高的细节渲染。scale 必须大于 0 且小于等于 16。默认值：1。

--frame

Which frame should be rendered when rendering a still. Default 0. From v3.2.27, negative values are allowed, with -1 being the last frame.

--bundle-cache

Enable or disable Webpack caching. This flag is enabled by default, use --bundle-cache=false to disable caching.

--log

设置日志级别。增加或减少输出量。可接受的值：error、warn、info（默认）、verbose

--port

Set a custom HTTP server port for the Studio or the render process. If not defined, Remotion will try to find a free port.

--public-dirv3.2.13

The path of the URL where the bundle is going to be hosted. By default it is /, meaning that the bundle is going to be hosted at the root of the domain (e.g. https://localhost:3000/). If you are deploying to a subdirectory (e.g. /sites/my-site/), you should set this to the subdirectory.

--timeout

定义单个帧最多可以花多长时间来处理所有 delayRender() 调用 在超时之前，单位为毫秒。默认值：30000。

🌐 Define how long a single frame may take to resolve all delayRender() calls before it times out in milliseconds. Default: 30000.

info

不要将其与部署 Lambda 函数时的 --timeout 标志 混淆。

--ignore-certificate-errorsv2.6.5

Results in invalid SSL certificates in Chrome, such as self-signed ones, being ignored.

--disable-web-securityv2.6.5

This will most notably disable CORS in Chrome among other security features.

--disable-headlessv2.6.5

Deprecated - will be removed in 5.0.0. With the migration to Chrome Headless Shell, this option is not functional anymore.

If disabled, the render will open an actual Chrome window where you can see the render happen. The default is headless mode.

--dark-modev4.0.381

Whether Chromium should pretend to be in dark mode by emulating the media feature 'prefers-color-scheme: dark'. Default is false.

--chrome-modev4.0.248

One of headless-shell, chrome-for-testing. Default headless-shell. Use chrome-for-testing to take advantage of GPU drivers on Linux.

--gl

Changelog

• From Remotion v2.6.7 until v3.0.7, the default for Remotion Lambda was swiftshader, but from v3.0.8 the default is swangle (Swiftshader on Angle) since Chrome 101 added support for it.
• From Remotion v2.4.3 until v2.6.6, the default was angle, however it turns out to have a small memory leak that could crash long Remotion renders.

Select the OpenGL renderer backend for Chromium.
Accepted values:

• "angle"
• "egl"
• "swiftshader"
• "swangle"
• "vulkan" (from Remotion v4.0.41)
• "angle-egl" (from Remotion v4.0.51)

The default is null, letting Chrome decide, except on Lambda where the default is "swangle"

--user-agentv3.3.83

Lets you set a custom user agent that the headless Chrome browser assumes.

--media-cache-size-in-bytesv4.0.352

Specify the maximum size of the cache that <Video> and <Audio> from @remotion/media may use combined, in bytes.
The default is half of the available system memory when the render starts.

--offthreadvideo-cache-size-in-bytesv4.0.23

From v4.0, Remotion has a cache for <OffthreadVideo> frames. The default is null, corresponding to half of the system memory available when the render starts.
This option allows to override the size of the cache. The higher it is, the faster the render will be, but the more memory will be used.
The used value will be printed when running in verbose mode.
Default: null

--offthreadvideo-video-threadsv4.0.261

The number of threads that<OffthreadVideo> can start to extract frames. The default is 2. Increase carefully, as too many threads may cause instability.

--enable-multiprocess-on-linuxv4.0.42

Removes the --single-process flag that gets passed to Chromium on Linux by default. This will make the render faster because multiple processes can be used, but may cause issues with some Linux distributions or if window server libraries are missing.
Default: false until v4.0.136, then true from v4.0.137 on because newer Chrome versions don't allow rendering with the --single-process flag.
This flag will be removed in Remotion v5.0.

--binaries-directoryv4.0.120

The directory where the platform-specific binaries and libraries that Remotion needs are located. Those include an ffmpeg and ffprobe binary, a Rust binary for various tasks, and various shared libraries. If the value is set to null, which is the default, then the path of a platform-specific package located at node_modules/@remotion/compositor-* is selected.
This option is useful in environments where Remotion is not officially supported to run like bundled serverless functions or Electron.

--experimental-rspackv4.0.426

Uses Rspack instead of Webpack as the bundler for the Studio or bundle.

--ffmpeg-executable

在 v4.0 中移除

🌐 removed in v4.0

设置自定义 ffmpeg 可执行文件。如果未定义，将在 PATH 中搜索 ffmpeg 可执行文件。

--ffprobe-executable

在 v4.0 中移除

🌐 removed in v4.0

设置自定义 ffprobe 可执行文件。如果未定义，将在 PATH 中搜索 ffprobe 可执行文件。