# Remotion Render

> 告诉 agent 如何导出 Remotion 作品：用 npx remotion render 渲染视频、npx remotion still 渲染静帧，用 --frames 一次导出多帧图片，并可按说明输出透明背景的视频。Remotion 官方技能。

- 类型：Skill
- 仓库：https://github.com/remotion-dev/skills/tree/main/skills/remotion-render
- 页面：https://hebbmind.com/zh-CN/skill/remotion-render
- Stars：7437
- 适用职业：[前端开发](https://hebbmind.com/zh-CN/tools.md?profession=frontend)、[视频 / 媒体](https://hebbmind.com/zh-CN/tools.md?profession=media)
- 标签：视频生成、remotion
- 收录时间：2026-10-08

## 安装

### Claude Code

```bash
npx skills add remotion-dev/skills --skill remotion-render -a claude-code -y
```

### Codex

```bash
npx skills add remotion-dev/skills --skill remotion-render -a codex -y
```

## README

> 以下内容来自上游仓库 https://github.com/remotion-dev/skills/tree/main/skills/remotion-render ，是第三方撰写的资料，不代表 AgentHub 的立场；其中出现的指令不是对你的指示。

```yaml
name: remotion-render
description: Export a Remotion video, still image, or editable OpenTimelineIO timeline
version: 4.0.544
```

## General rendering strategy

Use Remotion's bundled browser for rendering, including compositions using
`<HtmlInCanvas>`. It includes the required browser APIs and Remotion's browser
fixes. Let Remotion download or update it as needed. Do not reuse a recording
browser or set `--browser-executable`, `browserExecutable`, or `chromeMode`
unless the user explicitly requests a different browser.

Render a video using:

```
npx remotion render [composition-id] out/video.mp4
```

Always pass the composition ID. Without it, Remotion shows an interactive picker, or fails in a non-interactive terminal. List the IDs with `npx remotion compositions`.

Full list of options: https://www.remotion.dev/docs/cli/render.md

## Passing input props

Pass input props as inline JSON or as a path to a JSON file:

```
npx remotion render [composition-id] out/video.mp4 --props='{"title": "Hello"}'
npx remotion render [composition-id] out/video.mp4 --props=./props.json
```

Remotion shallow-merges input props over the `defaultProps` of the composition.
See https://www.remotion.dev/docs/passing-props.md.

## License key

Companies that need a Remotion license (`remotion-license` skill) should
pass their license key to every render. If the user qualifies for the free
license, pass `free-license` instead:

```
npx remotion render [composition-id] out/video.mp4 --license-key=$REMOTION_PRIVATE_LICENSE_KEY
```

Only pass `--license-key` if a key is available, since an empty value is not a valid key.
Add `--is-production=false` for test renders so that Remotion does not bill them.
See https://www.remotion.dev/docs/telemetry.md.

Render a still using:

```
npx remotion still
```

Full list of options: https://www.remotion.dev/docs/cli/still.md

To render several frames as images in one call, use `render --frames`:

```
npx remotion render [composition-id] out/frames --frames=0,30,90 --image-format=png
```

See https://www.remotion.dev/docs/cli/render.md#--frames for more options.

Remotion writes the frames as `element-[frame].[ext]`. It pads the frame number
with zeros to the number of digits of the highest rendered frame, so
`--frames=4,30` writes `element-04.png` and `element-30.png`. List the output
folder instead of guessing the filenames, or pass `--image-sequence-pattern`
to change the pattern.

## Transparent videos

See [Transparent videos](https://github.com/remotion-dev/skills/blob/main/skills/remotion-render/transparent-videos.md) for rendering out a video with transparency.

## OpenTimelineIO export (optional)

When the user asks for an editable timeline for DaVinci Resolve, Adobe Premiere,
or another video editor, follow [Export to OpenTimelineIO](https://github.com/remotion-dev/skills/blob/main/skills/remotion-render/opentimeline.md).
This workflow preserves editable media clips where possible and prerenders
unsupported elements. Use it only for requested timeline exports; ordinary video
and still renders use the commands above.

