cli-anything-kdenlive は何をしますか？
ビデオ編集のためのステートフルなコマンドラインインターフェースです。Blender CLIハーネスと同じパターンに従います。JSONプロジェクト形式とKdenlive/melt用のMLT XML生成を使用します。
インストール
このCLIは、cli-anything-kdenliveパッケージの一部としてインストールされます。
pip install cli-anything-kdenlive
前提条件:
- Python 3.10+
- システムにkdenliveがインストールされていること
使用方法
基本的なコマンド
# ヘルプの表示
cli-anything-kdenlive --help
# 対話型REPLモードの開始
cli-anything-kdenlive
# 新しいプロジェクトの作成
cli-anything-kdenlive project new -o project.json
# JSON出力で実行（エージェント消費用）
cli-anything-kdenlive --json project info -p project.json
REPLモード
サブコマンドなしで呼び出すと、対話型REPLセッションが開始されます。
cli-anything-kdenlive
# タブ補完と履歴を使用して対話的にコマンドを入力します
コマンドグループ
プロジェクト
プロジェクト管理コマンド。
| コマンド | 説明 |
|---|---|
new | 新しいプロジェクトを作成 |
open | 既存のプロジェクトを開く |
save | 現在のプロジェクトを保存 |
info | プロジェクト情報を表示 |
profiles | 利用可能なビデオプロファイルを一覧表示 |
json | プロジェクトの生JSONを表示 |
ビングループ
メディアビン管理コマンド。
| コマンド | 説明 |
|---|---|
import | クリップをメディアビンにインポート |
remove | ビンからクリップを削除 |
list | ビン内のすべてのクリップを一覧表示 |
get | クリップの詳細情報を取得 |
タイムライン
タイムライン管理コマンド。
| コマンド | 説明 |
|---|---|
add-track | タイムラインにトラックを追加 |
remove-track | トラックを削除 |
add-clip | トラックにクリップを追加 |
remove-clip | トラックからクリップを削除 |
trim | クリップのイン/アウトポイントをトリミング |
split | クリップを指定時間オフセットで分割 |
move | クリップを新しい位置に移動 |
list | すべてのトラックを一覧表示 |
フィルターグループ
フィルター/エフェクト管理コマンド。
| コマンド | 説明 |
|---|---|
add | クリップにフィルターを追加 |
remove | クリップからフィルターを削除 |
set | フィルターパラメータを設定 |
list | クリップ上のフィルターを一覧表示 |
available | 利用可能なすべてのフィルターを一覧表示 |
トランジション
トランジション管理コマンド。
| コマンド | 説明 |
|---|---|
add | トラック間にトランジションを追加 |
remove | トランジションを削除 |
set | トランジションパラメータを設定 |
list | すべてのトランジションを一覧表示 |
ガイド
ガイド/マーカー管理コマンド。
| コマンド | 説明 |
|---|---|
add | 指定位置（秒）にガイドを追加 |
remove | ガイドを削除 |
list | すべてのガイドを一覧表示 |
エクスポート
エクスポートおよびレンダリングコマンド。
| コマンド | 説明 |
|---|---|
xml | Kdenlive/MLT XMLを生成 |
presets | 利用可能なレンダープリセットを一覧表示 |
セッション
セッション管理コマンド。
| コマンド | 説明 |
|---|---|
status | セッションステータスを表示 |
undo | 最後の操作を元に戻す |
redo | 最後に元に戻した操作をやり直す |
history | アンドゥ履歴を表示 |
例
新しいプロジェクトの作成
新しいkdenliveプロジェクトファイルを作成します。
cli-anything-kdenlive project new -o myproject.json
# またはプログラム的な使用のためにJSON出力
cli-anything-kdenlive --json project new -o myproject.json
対話型REPLセッション
アンドゥ/リドゥをサポートした対話型セッションを開始します。
cli-anything-kdenlive
# 対話的にコマンドを入力
# 'help' で利用可能なコマンドを表示
# 'undo' と 'redo' で履歴ナビゲーション
プロジェクトのエクスポート
プロジェクトを最終出力形式にエクスポートします。
cli-anything-kdenlive --project myproject.json export render output.pdf --overwrite
状態管理
CLIはセッション状態を維持します。
- アンドゥ/リドゥ: 最大50レベルの履歴
- プロジェクト永続化: JSONとしてプロジェクト状態の保存/読み込み
- セッション追跡: 変更と修正を追跡
出力形式
すべてのコマンドは2つの出力モードをサポートします。
- 人間可読（デフォルト）: テーブル、色、フォーマット済みテキスト
- 機械可読（
--jsonフラグ）: エージェント消費用の構造化JSON
# 人間向け出力
cli-anything-kdenlive project info -p project.json
# エージェント向けJSON出力
cli-anything-kdenlive --json project info -p project.json
AIエージェント向け
このCLIをプログラム的に使用する場合:
- 常に
--jsonフラグ を使用してパース可能な出力を取得 - リターンコードを確認 - 0は成功、非0はエラー
- stderrをパースしてエラー時のメッセージを取得
- 絶対パス をすべてのファイル操作で使用
- エクスポート操作後に出力の存在を確認
詳細情報
- 完全なドキュメント: パッケージ内のREADME.mdを参照
- テストカバレッジ: パッケージ内のTEST.mdを参照
- 方法論: cli-anything-plugin内のHARNESS.mdを参照
バージョン
1.0.0