cli-anything-kdenlive

cli-anything-kdenlive

動画編集向けのステートフルなコマンドラインインターフェースで、Blender CLI ハーネスと同じパターンに従っています。JSON プロジェクト形式を使用し、Kdenlive/melt 用の MLT XML を生成します。

インストール

この CLI は cli-anything-kdenlive パッケージの一部としてインストールされます:

pip install cli-anything-kdenlive

前提条件:

• Python 3.10 以上
• kdenlive がシステムにインストールされている必要があります

使用方法

基本的なコマンド

# Show help
cli-anything-kdenlive --help

# Start interactive REPL mode
cli-anything-kdenlive

# Create a new project
cli-anything-kdenlive project new -o project.json

# Run with JSON output (for agent consumption)
cli-anything-kdenlive --json project info -p project.json

REPL モード

サブコマンドを指定せずに起動すると、CLI は対話型の REPL セッションに入ります:

cli-anything-kdenlive
# Enter commands interactively with tab-completion and history

コマンドグループ

Project

プロジェクト管理コマンドです。

コマンド	説明
new	新しいプロジェクトを作成します
open	既存のプロジェクトを開きます
save	現在のプロジェクトを保存します
info	プロジェクト情報を表示します
profiles	利用可能なビデオプロファイルを一覧表示します
json	生のプロジェクト JSON を出力します

Bin グループ

メディアビン管理コマンドです。

コマンド	説明
import	クリップをメディアビンにインポートします
remove	ビンからクリップを削除します
list	ビン内のすべてのクリップを一覧表示します
get	クリップの詳細情報を取得します

Timeline

タイムライン管理コマンドです。

コマンド	説明
add-track	タイムラインにトラックを追加します
remove-track	トラックを削除します
add-clip	トラックにクリップを追加します
remove-clip	トラックからクリップを削除します
trim	クリップのイン/アウト点をトリミングします
split	指定した時間オフセットでクリップを分割します
move	クリップを新しい位置に移動します
list	すべてのトラックを一覧表示します

Filter グループ

フィルター/エフェクト管理コマンドです。

コマンド	説明
add	クリップにフィルターを追加します
remove	クリップからフィルターを削除します
set	フィルターのパラメーターを設定します
list	クリップ上のフィルターを一覧表示します
available	利用可能なすべてのフィルターを一覧表示します

Transition

トランジション管理コマンドです。

コマンド	説明
add	トラック間にトランジションを追加します
remove	トランジションを削除します
set	トランジションのパラメーターを設定します
list	すべてのトランジションを一覧表示します

Guide

ガイド/マーカー管理コマンドです。

コマンド	説明
add	指定した位置 (秒) にガイドを追加します
remove	ガイドを削除します
list	すべてのガイドを一覧表示します

Export

エクスポートおよびレンダリングのコマンドです。

コマンド	説明
xml	Kdenlive/MLT XML を生成します
presets	利用可能なレンダープリセットを一覧表示します

Session

セッション管理コマンドです。

コマンド	説明
status	セッションの状態を表示します
undo	最後の操作を元に戻します
redo	最後に元に戻した操作をやり直します
history	元に戻す履歴を表示します

例

新しいプロジェクトの作成

新しい kdenlive プロジェクトファイルを作成します。

cli-anything-kdenlive project new -o myproject.json
# Or with JSON output for programmatic use
cli-anything-kdenlive --json project new -o myproject.json

対話型 REPL セッション

元に戻す/やり直しをサポートする対話型セッションを開始します。

cli-anything-kdenlive
# Enter commands interactively
# Use 'help' to see available commands
# Use 'undo' and 'redo' for history navigation

プロジェクトのエクスポート

プロジェクトを最終出力形式にエクスポートします。

cli-anything-kdenlive --project myproject.json export render output.pdf --overwrite

状態管理

CLI は次の要素でセッション状態を維持します:

• 元に戻す/やり直し: 最大 50 レベルの履歴
• プロジェクトの永続化: プロジェクト状態を JSON として保存/読み込み
• セッションの追跡: 変更と修正を追跡

出力形式

すべてのコマンドは 2 つの出力モードをサポートします:

• 人間が読みやすい形式 (デフォルト): テーブル、色、整形されたテキスト
• 機械可読形式 (--json フラグ): エージェントが利用するための構造化 JSON

# Human output
cli-anything-kdenlive project info -p project.json

# JSON output for agents
cli-anything-kdenlive --json project info -p project.json

AI エージェント向け

この CLI をプログラムから使用する場合:

1. 常に --json フラグを使用する - 解析可能な出力のため
2. リターンコードを確認する - 成功なら 0、エラーなら非ゼロ
3. 失敗時は stderr を解析する - エラーメッセージのため
4. すべてのファイル操作に絶対パスを使用する
5. エクスポート操作後に出力が存在することを確認する

詳細情報

• 完全なドキュメント: パッケージ内の README.md を参照してください
• テストカバレッジ: パッケージ内の TEST.md を参照してください
• 方法論: cli-anything-plugin 内の HARNESS.md を参照してください

バージョン

1.0.0