pyjianyingdraft

pyJianYingDraftは、軽量で柔軟かつ使いやすいPython製の剪映ドラフト生成・エクスポートツールであり、完全自動化された動画編集・ミックス編集パイプラインの構築を目的としています。このプロジェクトはpipでインストールでき（推奨はPython 3.8または3.11）、現在のバージョン0.3.0では大規模な更新が行われました。CapCut版は独立したリポジトリで開発されています。 中核機能 動画と画像：ローカルの動画・画像素材と時間制御、全体調整（回転、反転、スケール、透明度、位置）、キーフレーム、マスク、クロマキー合成、背景フィル、ブレンドモード（乗算、スクリーン、オーバーレイなど10種類）をサポート。 音声：ローカルの音声素材と時間制御、フェードイン・フェードアウトと音量、シーン音と音色エフェクトをサポート。サウンドを曲にするエフェクトは剪映5.9では動作せず、10.8では動作します。 テキストと字幕：テキストスタイル、フォント、キーフレーム、アニメーション、縁取り・背景・影、吹き出しと装飾文字エフェクト、自動折り返しをサポートし、SRT字幕ファイルのインポート、時間オフセットとスタイル参照にも対応。 エフェクト、フィルター、トランジション：ビデオクリップのアニメーション、クリップエフェクト、クリップフィルター、および独立したエフェクトトラックとフィルタートラックを提供。エフェクトタイプは列挙型クラスで命名され、パラメータのコメント付きで、from_nameによる曖昧一致も可能。 トラック管理：append_track/append_tracksとinsert_track/insert_tracksの2組のインターフェースを提供し、over_track、under_track、またはat_indexで階層を制御できます。 テンプレートモード：既存の剪映ドラフトをテンプレートとして読み込め、名前による素材置換、クリップ単位の素材置換（素材範囲の再選択とクリップの伸縮が可能）、テキスト内容の置換、テンプレート内の音声・動画・テキストトラックのインポート、およびステッカー・吹き出し・装飾文字などの素材メタデータの抽出に対応。新しい剪映のdraft_content.jsonは平文JSONではないことが多いため、fallback_loaderで追加のリーダーを接続する必要があります。 一括エクスポート：JianyingControllerで剪映のドラフトエクスポートを制御し、解像度とフレームレートを調整可能。この機能はuiautomationに依存し、Windowsのみ対応、かつ剪映6以下のバージョンにのみ適用されます（剪映7以降は関連コントロールが非表示）。 時間処理：内部はマイクロ秒単位で、文字列形式（例：「1.5s」、「1h3m12s」）もサポートし、tim、trange、trange_secondsなどの便利な関数を提供。 クロスプラットフォーム互換性：Windowsはドラフト生成、テンプレートモード、自動エクスポート（剪映のバージョン制限あり）をサポート。Linux/MacOSはドラフト生成とテンプレートモードをサポートしますが、自動エクスポートは不可で、生成したドラフトはWindows版の剪映でエクスポートする必要があります。 注意事項：剪映がドラフトを開く際、未キャッシュのアニメーション・エフェクト・トランジションを自動ダウンロードしようとし、タイムアウトして読み込み失敗と表示されることがあります。未キャッシュのフォントはドラフトを2回開く必要があります。自動エクスポートは剪映ウィンドウを最前面に表示し、カーソルのクリックを制御するため、アイドル時に実行し、エクスポート権限があることを確認する必要があります。