cli-anything-openscreen

cli-anything-openscreen

画面収録を編集するためのステートフルなコマンドラインです。生のキャプチャを、ズーム効果、速度調整、トリミング、注釈、美しい背景を備えた洗練されたデモ動画に変換します。

インストール

pip install cli-anything-openscreen

前提条件:

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

使用方法

基本コマンド

cli-anything-openscreen --help
cli-anything-openscreen                     # REPL mode
cli-anything-openscreen project new -v recording.mp4 -o project.openscreen
cli-anything-openscreen --json project info

REPL モード

引数なしで cli-anything-openscreen を実行すると、対話モードに入ります。利用可能なコマンドを確認するには help、終了するには quit と入力してください。

コマンドグループ

project

プロジェクトの作成、オープン、保存、設定を行います。

コマンド	説明
project new [-v VIDEO] [-o PATH]	オプションの動画を指定して新しいプロジェクトを作成
project open <path>	既存の .openscreen プロジェクトを開く
project save [-o PATH]	プロジェクトをファイルに保存
project info	プロジェクトのメタデータとリージョン数を表示
project set-video <path>	ソース動画ファイルを設定
project set <key> <value>	エディター設定（パディング、壁紙など）を設定

zoom

ズームリージョンを管理します — タイムライン上の特定領域に滑らかなズーム効果を適用します。

コマンド	説明
zoom list	すべてのズームリージョンを一覧表示
zoom add --start MS --end MS [--depth 1-1] [--focus-x 0-1] [--focus-y 0-1]	ズームを追加
zoom remove <id>	ズームリージョンを削除

ズームの深さ: 1=1.25x, 2=1.5x, 3=1.8x, 4=2.2x, 5=3.5x, 6=5.0x

speed

速度リージョンを管理します — アイドル時間を速め、重要な瞬間を遅くします。

コマンド	説明
speed list	すべての速度リージョンを一覧表示
speed add --start MS --end MS [--speed 0.25-2.0]	速度変更を追加
speed remove <id>	速度リージョンを削除

有効な速度: 0.25, 0.5, 0.75, 1.25, 1.5, 1.75, 2.0

trim

トリムリージョンを管理します — 収録のセクションを切り出します。

コマンド	説明
trim list	すべてのトリムリージョンを一覧表示
trim add --start MS --end MS	セクションを切り出す
trim remove <id>	トリムリージョンを削除

crop

収録の表示領域を設定します。

コマンド	説明
crop get	現在のクロップリージョンを表示
crop set --x 0-1 --y 0-1 --width 0-1 --height 0-1	クロップを設定（正規化）

annotation

収録にテキストオーバーレイを追加します。

コマンド	説明
annotation list	すべての注釈を一覧表示
annotation add-text --start MS --end MS --text "..." [--x 0-1] [--y 0-1]	テキストを追加
annotation remove <id>	注釈を削除

media

メディアファイルを検査および検証します。

コマンド	説明
media probe <path>	動画のメタデータ（解像度、長さ、コーデック）を表示
media check <path>	動画ファイルを検証
media thumbnail <input> <output> [-t TIME]	フレームを抽出

export

最終的な洗練された動画をレンダリングします。

コマンド	説明
export presets	利用可能なエクスポートプリセットを一覧表示
export render <output_path>	プロジェクトを動画ファイルにレンダリング

preview

現在の Openscreen プロジェクトから忠実なレビューバンドルをキャプチャします。

コマンド	説明
preview recipes	利用可能なプレビューレシピを一覧表示
preview capture --recipe quick	低解像度のプレビューバンドルをレンダリング
preview latest [--recipe quick]	最新の既存バンドルを返す

現在のプレビューサポートはライブではなく静的です。quick バンドルには通常、次が含まれます:

• 低解像度のプレビュークリップ
• サンプリングされたフレーム
• すばやい確認用の hero フレーム
• トリム/ズーム/速度の事実を含む summary.json

バンドルのキャプチャは、エージェントが時間の経過とともにプレビュー履歴を再構築できるよう、プレビュールートの隣に安定したレシピレベルの trajectory.json も書き込みまたは更新します。

ビューアーコマンド:

cli-hub previews inspect /path/to/bundle
cli-hub previews html /path/to/bundle -o page.html
cli-hub previews open /path/to/bundle

session

セッション状態を undo/redo で管理します。

コマンド	説明
session status	セッション情報を表示
session undo	最後の操作を元に戻す
session redo	最後に元に戻した操作をやり直す
session save	セッション状態をディスクに保存
session list	保存されたすべてのセッションを一覧表示

状態管理

• Undo/Redo: 最大 50 レベルの Undo 履歴
• プロジェクトの永続化: JSON .openscreen ファイル
• セッションの追跡: 変更を自動的に追跡

出力フォーマット

• 人間が読みやすい形式（デフォルト）: 整形されたキーと値のペア
• 機械可読形式（--json）: 構造化された JSON 出力

エディター設定

設定	型	デフォルト	説明
aspectRatio	string	"16:9"	16:9、9:16、1:1、4:3、4:5
wallpaper	string	"gradient_dark"	背景プリセット
padding	int	50	0-100、動画の周囲の余白
borderRadius	int	12	角の半径（ピクセル単位）
shadowIntensity	float	0	0-1、ドロップシャドウの強さ
motionBlurAmount	float	0	0-1、ズーム時のモーションブラー
exportQuality	string	"good"	medium、good、source
exportFormat	string	"mp4"	mp4、gif

AI エージェント向け

1. 解析可能な出力を得るには常に --json を使用してください
2. リターンコードを確認してください — 0 = 成功、非ゼロ = エラー
3. 非 JSON モードではエラーメッセージを stderr から解析してください
4. 絶対ファイルパスを使用してください
5. export render の後は、出力が存在することを確認し、調査してください
6. すべての region コマンドで時間はミリ秒単位です
7. 座標（focus、crop、position）は正規化された 0-1 です
8. ズーム、トリム、アノテーション、タイミングを視覚的に検証するには preview capture --json を使用してください
9. 返されたバンドルのアーティファクトパスは JSON ペイロードから読み取ってください。画像とクリップはディスク上に存在します
10. cli-hub previews ... は既存のバンドルを調査・開く場合にのみ使用してください

バージョン

1.0.0