Communitygithub.com

remotion-to-capcut

将Remotion合成导出为可编辑的CapCut桌面草稿(原生文本图层、带关键帧的原始片段、音频轨道、透明图形图层)。

remotion-to-capcut 是什么?

remotion-to-capcut 是一个工具,用于将 Remotion 合成的视频转换为 CapCut 桌面版(Windows)可以直接打开并继续编辑的工程草稿。它通过逐帧检查渲染的 DOM,尽量将 Remotion 中的文本、视频片段、音频、变换动画等映射为 CapCut 的原生图层和关键帧,而无法映射的图形元素则会合并为一个透明的“图形(alpha)”视频层。该工具支持通过 npx 一键运行,提供检查依赖、列出合成、导出草稿等命令,并允许用户指定帧范围、传入 props,以及控制等待 CapCut 关闭的超时行为。用户导出后可打开 CapCut 查看摘要信息,了解哪些内容成功转为原生文本或片段。需要注意的是,该工具依赖 CapCut 桌面版、Python 3.8+,且 CapCut 的草稿格式未公开,版本更新可能造成兼容性问题。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/OybekWeb1/remotion-to-capcut/tree/HEAD/skills/remotion-to-capcut

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

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)”视频层

经验法则:

  1. 保持文本为真实文本。不要将文本放在 SVG、Canvas 或图片中。每个元素一个文本块;文本内部的样式变化(例如 <span> 使用另一种颜色/字重)可以保留。
  2. 使用 Google Fonts(@remotion/google-fonts)。匹配的 TTF 字体会自动下载;其他字体将回退为 CapCut 的默认字体。
  3. 使用 transform + opacity 制作动画。模糊进入、clip-path 揭示和逐字效果无法作为 CapCut 关键帧存在:文本只会移动/淡入。数字变化将显示最终值。
  4. 素材和音频必须是 public/ 中的本地文件,通过 staticFile() 引用。不支持远程 URL。
  5. 如果用户需要替换素材,不要使用 CSS 对素材进行模糊:filter: blur() 超过 1.5px 的片段会被烘焙到图形层中。
  6. 将背景素材放置为一个无间隙的连续序列(CapCut 主轨道是磁性的);额外的片段放在上层轨道。
  7. 若想刻意将某些内容保留为像素(例如复杂的动态标题),请将其包裹:<div data-capcut="bake">…</div>。

告知用户限制

  • 图形是一个扁平层:如果用户拉长一段文本,其背后的卡片不会随之增长。
  • 转场帧和模糊背景会被烘焙到图形层中。
  • 文本度量基于 CapCut 9.7 校准;其他版本可能有几个像素的偏差。
  • CapCut 的草稿格式未公开;CapCut 更新可能会导致本工具失效。

相关技能