mcpField
E
edit-handoff

edit-handoff

github.com/scrollmarkクリエイティブ・メディア1644 回インストール1 日前に更新
リポジトリ

edit-handoff について

video-studioの編集内容をPremiere Pro、DaVinci Resolve、Final Cut Pro、CapCutへ引き渡すためのガイドです。書き出し形式ごとの保持内容と、編集側で再構築が必要な要素を説明します。

主な機能

  1. 01編集アプリに応じた形式選択
  2. 02カット、素材リンク、音声の保持
  3. 03エフェクトとタイトルの制約説明
  4. 04タイムラインと素材の同梱

活用シーン

  1. 01別の編集アプリ向けの準備
  2. 02Final Cut Pro用の引き渡し方法選択
  3. 03誤ったプロジェクト書き出しの回避

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/scrollmark/social-skills --skill edit-handoff

インストール後、Claude Code で/edit-handoffを入力して読み込まれたか確認します。

詳細

編集の引き継ぎ

「これをPremiereで仕上げられますか？」は、レンダリングではなく引き継ぎです。編集の面倒な半分、つまり40か所のカットを正確なフレームに置き、各クリップを実際のソースにリンクし、音声を同期させて渡します。そして、引き継がれない半分を正確に伝えることも重要です。曖昧なままでは、編集者の午後を無駄にしてしまいます。

必要なもの

pip install 'video-studio-engine[export] @ https://github.com/scrollmark/social-skills/archive/refs/heads/master.tar.gz' で3つのエクスポーター（export_fcpxml、export_capcut、export_edit）すべてを利用できます。[export]を指定する必要があるのは、OpenTimelineIOを使うexport_editだけです。どのエクスポーターもバンドルされていません。それぞれエンジンのタイムラインドキュメントとコンポーザーディレクトリを読み込みます。インストールしなければ、エクスポートもできません。引き継ぎ後も残るのは、以下の判断内容です。これはOTIOまたはFCPXMLによる引き継ぎ全般に当てはまります。キャプションも引き継がれません。コンポーザーがpropsから描画するためです。そのため、video-studio burn_captionsでピクセルとして焼き込むか、.assを書き出します。

エクスポート形式と対象アプリケーション

対象スクリプト方法
Premiere Pro、DaVinci Resolvevideo-studio export_edit.otioをネイティブに読み込みます。プラグインは不要です
Final Cut Provideo-studio export_fcpxml.fcpxml 1.9。実際のプロジェクトとして開きます
CapCutvideo-studio export_capcut --install既存プロジェクトのdraft_info.jsonを上書きします
いずれかを別のマシンで使う--bundleを追加タイムラインとともにメディアをコピーします
video-studio export_edit --project <dir>

必ず--projectを指定してください。 まず、そのプロジェクトのタイムラインを再構築します。コンポーザーのpropsドキュメントはグローバルなため、再構築せずにエクスポートすると、最後にレンダリングされた動画が気づかれないまま出力されます。完全に正しく見える間違ったファイルができてしまいます。

.prprojを書き出す機能はありませんし、作るべきでもありません。Premiereの形式は非公開で、アプリケーションのバージョンに依存します。リバースエンジニアリングで作られたライターは、ほかの人の編集作業で気づかれないまま壊れる可能性があります。Adobeがサポートする読み込み形式は、OTIO、FCP7 XML、AAF、EDLです。FCPXMLはその逆です。Appleが仕様を公開しているため、Final Cutには専用のライターがあります。

引き継がれるもの

すべての形式で引き継がれるもの： すべてのカットが正確なフレームに配置され、各クリップが実際のソースファイルにリンクされます。シーンごとのナレーション、音楽、サイドカーの.srtとしてのキャプションも引き継がれます（Premiereではキャプショントラックとして読み込まれます）。

汎用形式では引き継がれないもの： カメラの動き、フェード、画面上のカードです。これはエクスポーターの不備ではありません。交換形式にはエフェクトが含まれていないためです。OTIO独自の対応状況一覧でも、EDL、FCP7 XML、FCP X、AAFのいずれでもエフェクトは非対応とされています。そのため、カードは表示されたフレームに、テキストを含むタイムラインマーカーとして書き出され、カメラの動きも同様にマークされます。編集者にタイトルは渡りません。代わりに、そこに何があったかを示すラベル付きの位置情報が渡ります。

Final Cutは例外なので、明記する価値があります。 export_fcpxmlは、カードをFinal CutのBasic Titleジェネレーター上の実際の<title>要素として、カメラの動きをキーフレーム付きの<adjust-transform>として書き出します。どちらもインスペクターで編集できます。実際のプロジェクトで計測したところ、汎用OTIO→FCPXアダプターからはいずれも1つも出力されませんでした。カードが重要で、編集者がFinal Cutを使う場合は、この方法を使ってください。

CapCutでは最初に空のプロジェクトを用意します

CapCut自体で新しいプロジェクトを作成し（File > New Project、保存し、何も追加しない）、そのパスを渡すようユーザーに依頼してください。スクリプトはフォルダーを作成しません。実際のプロジェクトには、draft_meta_info.json、draft_settings、Resources/、matting/といった、仕様が非公開の関連ファイルが多数含まれています。これらを書き出せるのはCapCutだけです。ファイルが欠けたフォルダーは下書き一覧に表示されますが、クリックしても何も起こりません。ここでもカードは引き継がれません。

アンチパターン

  • --project を指定せずに書き出すこと。 失敗しても通知されず、誤った動画が納品されます。
  • 「動画全体を書き出す」と言うこと。 書き出されるのはカット部分です。エフェクトは再構築されます。
  • OTIO 経由でカードが引き継がれると約束すること。 カードはマーカーとして取り込まれます。カードを保持できるのは FCPXML だけです。
  • アプリでテスト済みだと主張すること。 FCPXML は Final Cut で開いて検証するのではなく、自身の出力を解析して検証します。どちらを指しているのか明記してください。

コメント

Markdown 対応