cli-anything-openscreen は何をしますか？
画面収録を編集するためのステートフルなコマンドラインインターフェース。生のキャプチャを、ズーム効果、速度調整、トリミング、注釈、美しい背景を使って洗練されたデモ動画に変換します。
インストール
pip install cli-anything-openscreen
前提条件:
- Python 3.10+
- システムに ffmpeg がインストールされている必要があります
使い方
基本コマンド
cli-anything-openscreen --help
cli-anything-openscreen # REPLモード
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-6] [--focus-x 0-1] [--focus-y 0-1] | ズームを追加 |
zoom remove <id> | ズーム領域を削除 |
ズーム段階: 1=1.25倍, 2=1.5倍, 3=1.8倍, 4=2.2倍, 5=3.5倍, 6=5.0倍
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
アンドゥ/リドゥでセッション状態を管理。
| コマンド | 説明 |
|---|---|
session status | セッション情報を表示 |
session undo | 最後の操作を元に戻す |
session redo | 元に戻した操作をやり直す |
session save | セッション状態をディスクに保存 |
session list | 保存済みセッションをすべて一覧表示 |
状態管理
- アンドゥ/リドゥ: 最大50レベルのアンドゥ履歴
- プロジェクト永続性: 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エージェント向け
- パース可能な出力には常に
--jsonを使用してください - リターンコードを確認してください — 0 = 成功、それ以外 = エラー
- 非JSONモードでは、エラーメッセージをstderrから解析してください
- 絶対ファイルパスを使用してください
export renderの後、出力が存在することを確認し、プローブ（確認）してください- すべてのリージョンコマンドで時間はミリ秒単位です
- 座標（フォーカス、クロップ、位置）は正規化された0-1の値です
preview capture --jsonを使用して、ズーム、トリミング、注釈、タイミングを視覚的に検証してください- バンドルアーティファクトのパスはJSONペイロードから読み取ってください；画像やクリップはディスク上にあります
cli-hub previews ...は既存のバンドルの検査/オープンにのみ使用してください
バージョン
1.0.0