GuanYixuan/pyCapCut

解決する課題

このプロジェクトは、Pythonを使用してCapCutのドラフトファイルをプログラムで生成および編集する方法を提供します。メディア、テキスト、エフェクト、トランジション、キーフレームの追加を含む動画プロジェクトの作成を自動化でき、作成されたプロジェクトはデスクトップ版CapCutアプリケーションで開いてエクスポート可能です。

仕組み

CapCutが使用する draft_content.json ファイルと直接やり取りします。ユーザーはライブラリのPythonクラスを使用して、トラック、セグメント、エフェクトなどの動画構造を定義します。このツールはCapCutドラフトの複雑な内部データ構造を処理し、テンプレートベースの編集、素材の置き換え、マイクロ秒単位または人間が読みやすい時間文字列を使用した正確なタイミング制御を可能にします。

対象ユーザー

このツールは、反復的な動画編集タスクを自動化したい、動画コンテンツをバッチ作成したい、あるいはCapCutのレンダリングエンジンを活用したカスタム動画生成パイプラインを構築したいコンテンツクリエイター、開発者、編集者向けに設計されています。

主な特徴

• プログラムによる編集: Pythonを通じてトラック、セグメント、メディアプロパティを完全に制御。
• テンプレートサポート: 既存のドラフトをテンプレートとして読み込み、複雑なスタイルを維持したままメディア、テキスト、特定のセグメントを入れ替え可能。
• 豊富な機能セット: キーフレーム、マスク、クロマキー、ブレンドモード、アニメーション、フィルターをサポート。
• 柔軟なタイミング: マイクロ秒単位の精度と便利な時間文字列（例: "1.5s", "1m"）の両方をサポート。
• SRT統合: 字幕ファイルを専用のテキストトラックに簡単にインポート可能。