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 を閉じている必要があります。 開いているとツールは待機します(
--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(translate / scale / rotate)および opacity | 位置 / スケール / 回転 / 不透明度キーフレーム |
public/ 内のファイルを使用した <OffthreadVideo> / <Video> | 生クリップ(Remotion でトリミングされた箇所をトリミング、速度付き) |
public/ 内の <Audio> | ボリュームカーブ付きの個別オーディオクリップ |
| その他すべて(カード、図形、ロゴ、画像、SVG、ライトリーク) | フッテージの上に1つの透明な「グラフィックス(アルファ)」ビデオレイヤー |
経験則:
- テキストは本当のテキストとして保つ。 SVG、キャンバス、画像内にテキストを入れないでください。要素ごとに1つのテキストブロックとし、その内部でのスタイルの混在(別の色や太さの
<span>)は問題ありません。 - Google Fonts(
@remotion/google-fonts)を使用してください。一致する TTF が自動的にダウンロードされます。その他のフォントは CapCut のデフォルトフォントにフォールバックします。 - transform と opacity でアニメーションさせる。 ブラーイン、クリップパスでの表示、文字単位のエフェクトは CapCut のキーフレームとして存在しません。テキストは移動・フェードのみ行います。カウントアップする数字は最終値が表示されます。
- フッテージとオーディオは
public/内のローカルファイルとし、staticFile()で参照してください。リモートURLはサポートされていません。 - ユーザーがフッテージを差し替え可能にしたい場合は、CSS でブラーをかけないでください。
filter: blur()が 1.5px を超えるクリップはグラフィックスレイヤーに焼き付けられます。 - 背景フッテージはギャップのない連続したシーケンスとして配置してください(CapCut のメイントラックはマグネット式です)。追加のクリップは上のトラックに配置します。
- 複雑なアニメーションタイトルなど、意図的にピクセルとして残したい要素は
<div data-capcut="bake">…</div>でラップしてください。
ユーザーに制限を伝える
- グラフィックスは1つのフラットなレイヤーです。テキストを長くしても、その背景のカードは連動して大きくなりません。
- トランジションフレームやぼかし背景はグラフィックスレイヤーに焼き付けられます。
- テキストメトリクスは CapCut 9.7 で調整されています。他のバージョンでは数ピクセルずれる場合があります。
- CapCut のドラフト形式は未公開のため、CapCut のアップデートでこのツールが使えなくなる可能性があります。