Remotion → CapCut
remotion-to-capcut 将 Remotion 合成转换为真实的 CapCut 草稿,让用户可以在你通过代码构建的内容基础上继续手工编辑。目前仅支持 Windows + CapCut 桌面版。
导出
在 Remotion 项目目录中运行:
npx github:OybekWeb1/remotion-to-capcut doctor
先修复所有标有 ✗ 的问题(CapCut 必须已安装并至少打开过一次;Python 3.8+ 必须在 PATH 中)。
npx github:OybekWeb1/remotion-to-capcut list
npx github:OybekWeb1/remotion-to-capcut <CompositionId> --name "<CapCut 中显示的名称>"
- 大约每 6 秒视频需要 1 分钟。对于长视频,请在后台运行。
- 写入草稿时必须关闭 CapCut。如果 CapCut 处于打开状态,工具会等待(
--wait <秒>,默认 600);请用户关闭 CapCut —— 切勿自行杀死进程(用户可能有未保存的工作)。如果等待超时,在 CapCut 关闭后使用--skip-capture重新运行;这会复用之前的捕获,仅需几秒钟。 - 完成后,读取
out/capcut/<CompositionId>/summary.txt并告知用户哪些内容变成了原生文本和片段,然后:打开 CapCut → 项目 → 该草稿名称。 - 迭代导出部分片段:
--frames 0-299。合成参数:--props props.json。
编写可良好转换的 Remotion 代码
转换器会逐帧检查渲染后的 DOM。以下 Remotion 内容可转换为可编辑的 CapCut 元素:
| 在 Remotion 中 | 在 CapCut 中 |
|---|---|
普通 DOM 元素中的文本(<div>、<span>、<h1>……) | 原生文本图层:字体、大小、颜色、渐变、阴影、描边、字间距/行间距 |
文本或素材上的 transform(平移/缩放/旋转)和 opacity | 位置/缩放/旋转/透明度关键帧 |
public/ 中的文件通过 <OffthreadVideo> / <Video> 引入 | 原始片段,按 Remotion 裁剪位置裁剪,保留速度 |
public/ 中的 <Audio> | 带有音量曲线的独立音频片段 |
| 其他所有内容(卡片、形状、Logo、图片、SVG、漏光效果) | 位于素材上方的一个透明“图形(alpha)”视频层 |
经验法则:
- 保持文本为真实文本。不要将文本放在 SVG、Canvas 或图片中。每个元素一个文本块;文本内部的样式变化(例如
<span>使用另一种颜色/字重)可以保留。 - 使用 Google Fonts(
@remotion/google-fonts)。匹配的 TTF 字体会自动下载;其他字体将回退为 CapCut 的默认字体。 - 使用 transform + opacity 制作动画。模糊进入、clip-path 揭示和逐字效果无法作为 CapCut 关键帧存在:文本只会移动/淡入。数字变化将显示最终值。
- 素材和音频必须是
public/中的本地文件,通过staticFile()引用。不支持远程 URL。 - 如果用户需要替换素材,不要使用 CSS 对素材进行模糊:
filter: blur()超过 1.5px 的片段会被烘焙到图形层中。 - 将背景素材放置为一个无间隙的连续序列(CapCut 主轨道是磁性的);额外的片段放在上层轨道。
- 若想刻意将某些内容保留为像素(例如复杂的动态标题),请将其包裹:
<div data-capcut="bake">…</div>。
告知用户限制
- 图形是一个扁平层:如果用户拉长一段文本,其背后的卡片不会随之增长。
- 转场帧和模糊背景会被烘焙到图形层中。
- 文本度量基于 CapCut 9.7 校准;其他版本可能有几个像素的偏差。
- CapCut 的草稿格式未公开;CapCut 更新可能会导致本工具失效。