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。可轉換為可編輯 CapCut 項目的內容:
| 在 Remotion 中 | 在 CapCut 中 |
|---|---|
一般 DOM 元素(<div>、<span>、<h1>…)中的文字 | 原生文字圖層:字體、大小、顏色、漸層、陰影、描邊、字元/行距 |
文字或素材上的 transform(平移/縮放/旋轉)和 opacity | 位置 / 縮放 / 旋轉 / 不透明度關鍵影格 |
使用 public/ 中檔案的 <OffthreadVideo> / <Video> | 原始片段,修剪至 Remotion 的修剪範圍,並保留速度 |
來自 public/ 的 <Audio> | 具有音量曲線的獨立音訊片段 |
| 其他所有內容(卡片、形狀、標誌、圖片、SVG、光漏) | 一個位於素材上方、帶有透明度的「圖形(alpha)」影片圖層 |
規則提要:
- 保持文字為真實文字。 請勿將文字放在 SVG、canvas 或圖片內。每個文字區塊對應一個元素;其中的樣式範圍(例如帶有不同顏色/字重的
<span>)是允許的。 - 使用 Google Fonts(
@remotion/google-fonts)。工具會自動下載對應的 TTF 字型檔案;其他字型會回退為 CapCut 的預設字型。 - 使用 transform + opacity 製作動畫。 模糊淡入、clip-path 揭示以及逐字效果無法對應至 CapCut 關鍵影格:對應的文字只會移動/淡入。數字計數會顯示最終值。
- 素材與音訊必須是
public/中的本機檔案,並使用staticFile()引用。不支援遠端網址。 - 如果使用者應該能夠替換素材,請勿使用 CSS 模糊素材:
filter: blur()超過 1.5px 的片段會直接烘焙至圖形圖層。 - 將背景素材放在一個無間隙的序列中(CapCut 的主軌道具有磁性);額外片段放在上方軌道。
- 若要刻意將某些內容保留為像素形式(例如複雜的動畫標題),請使用包裝:
<div data-capcut="bake">…</div>。
告知使用者限制
- 圖形是單一平面圖層:如果延長文字,後方的卡片不會隨之增長。
- 過渡影格與模糊背景會烘焙至圖形圖層。
- 文字測量是基於 CapCut 9.7 校準;其他版本可能會有數像素的偏移。
- CapCut 草稿格式無官方文件;CapCut 更新可能導致不相容。