Communitygithub.com

remotion-to-capcut

Remotion コンポジションを編集可能な CapCut デスクトップ用ドラフトにエクスポートします(ネイティブテキストレイヤー、キーフレーム付き生クリップ、オーディオトラック、透明グラフィックスレイヤー)。

remotion-to-capcut とは?

このツール(remotion-to-capcut)は、コードで作成された Remotion コンポジションを、CapCut デスクトップアプリで開いて編集可能なドラフト形式に変換します。Windows + CapCut デスクトップのみ対応。`npx github:OybekWeb1/remotion-to-capcut` で実行でき、テキストはネイティブテキストレイヤー(フォント、サイズ、色、グラデーション、影、ストローク、文字間・行間など)として、動画や音声は生クリップとして変換されます。変換プロセスは DOM をフレームごとに解析し、transform/opacity のアニメーションはキーフレームに変換、その他の要素は透明なグラフィックス(アルファ)レイヤーに焼き付けられます。動画が長い場合はバックグラウンド実行を推奨(6秒あたり約1分)。制限として、グラフィックスは単一レイヤーで、テキスト時間を伸ばしても背景のカードは連動しない、CapCut のバージョンによりテキストメトリクスがずれる可能性がある、CapCut のアップデートでフォーマットが壊れるリスクがある、といった注意点があります。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/OybekWeb1/remotion-to-capcut/tree/HEAD/skills/remotion-to-capcut

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

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 アイテムに変換できるもの:

RemotionCapCut
通常の DOM 要素内のテキスト(<div>, <span>, <h1>…)ネイティブテキストレイヤー: フォント、サイズ、色、グラデーション、影、ストローク、文字間隔・行間隔
テキストやフッテージの transform(translate / scale / rotate)および opacity位置 / スケール / 回転 / 不透明度キーフレーム
public/ 内のファイルを使用した <OffthreadVideo> / <Video>生クリップ(Remotion でトリミングされた箇所をトリミング、速度付き)
public/ 内の <Audio>ボリュームカーブ付きの個別オーディオクリップ
その他すべて(カード、図形、ロゴ、画像、SVG、ライトリーク)フッテージの上に1つの透明な「グラフィックス(アルファ)」ビデオレイヤー

経験則:

  1. テキストは本当のテキストとして保つ。 SVG、キャンバス、画像内にテキストを入れないでください。要素ごとに1つのテキストブロックとし、その内部でのスタイルの混在(別の色や太さの <span>)は問題ありません。
  2. Google Fonts(@remotion/google-fonts)を使用してください。一致する TTF が自動的にダウンロードされます。その他のフォントは CapCut のデフォルトフォントにフォールバックします。
  3. transform と opacity でアニメーションさせる。 ブラーイン、クリップパスでの表示、文字単位のエフェクトは CapCut のキーフレームとして存在しません。テキストは移動・フェードのみ行います。カウントアップする数字は最終値が表示されます。
  4. フッテージとオーディオは public/ 内のローカルファイルとし、staticFile() で参照してください。リモートURLはサポートされていません。
  5. ユーザーがフッテージを差し替え可能にしたい場合は、CSS でブラーをかけないでください。 filter: blur() が 1.5px を超えるクリップはグラフィックスレイヤーに焼き付けられます。
  6. 背景フッテージはギャップのない連続したシーケンスとして配置してください(CapCut のメイントラックはマグネット式です)。追加のクリップは上のトラックに配置します。
  7. 複雑なアニメーションタイトルなど、意図的にピクセルとして残したい要素は <div data-capcut="bake">…</div> でラップしてください。

ユーザーに制限を伝える

  • グラフィックスは1つのフラットなレイヤーです。テキストを長くしても、その背景のカードは連動して大きくなりません。
  • トランジションフレームやぼかし背景はグラフィックスレイヤーに焼き付けられます。
  • テキストメトリクスは CapCut 9.7 で調整されています。他のバージョンでは数ピクセルずれる場合があります。
  • CapCut のドラフト形式は未公開のため、CapCut のアップデートでこのツールが使えなくなる可能性があります。

関連スキル