mcpField
C
cli-anything-obs-studio

cli-anything-obs-studio

github.com/hkudsクリエイティブ・メディア57.6k515 回インストール5 週間前に更新
リポジトリ

cli-anything-obs-studio について

OBS StudioのシーンコレクションをJSON形式で編集する、ユーザーやエージェント向けのステートフルなコマンドラインツールです。セッション履歴と構造化出力に対応し、OBSをインストールせずに編集できます。

主な機能

  1. 01プロジェクトとシーンの作成・管理
  2. 02ソース、フィルター、音声の編集
  3. 03トランジションと出力の設定
  4. 04セッション変更の取り消しとやり直し
  5. 05人が読める形式とJSON出力

活用シーン

  1. 01JSONでシーンコレクションを作成・修正
  2. 02ソースの変換やフィルターパラメーターの調整
  3. 03配信または録画出力の設定

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/hkuds/cli-anything --skill cli-anything-obs-studio

インストール後、Claude Code で/cli-anything-obs-studioを入力して読み込まれたか確認します。

詳細

cli-anything-obs_studio

OBS Studio のシーンコレクション編集のためのステートフルなコマンドラインインターフェースで、Blender CLI ハーネスと同じパターンに従っています。JSON シーンコレクション形式を使用します。編集に OBS のインストールは不要です。

インストール

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

pip install cli-anything-obs_studio

前提条件：

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

使用方法

基本コマンド
# Show help
cli-anything-obs_studio --help

# Start interactive REPL mode
cli-anything-obs_studio

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

# Run with JSON output (for agent consumption)
cli-anything-obs_studio --json project info -p project.json
REPL モード

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

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

コマンドグループ

Project

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

コマンド説明
new新しい OBS シーンコレクションを作成します
open既存のプロジェクトを開きます
save現在のプロジェクトを保存します
infoプロジェクト情報を表示します
json生のプロジェクト JSON を出力します
Scene グループ

シーン管理コマンド。

コマンド説明
add新しいシーンを追加します
removeインデックスでシーンを削除します
duplicateシーンを複製します
set-activeアクティブなシーンを設定します
listすべてのシーンを一覧表示します
Source グループ

ソース管理コマンド。

コマンド説明
addシーンにソースを追加します
removeインデックスでソースを削除します
duplicateソースを複製します
setソースのプロパティ（名前、表示、ロック、不透明度、回転）を設定します
transformソースを変形します（位置、サイズ、クロップ、回転）
listシーン内のすべてのソースを一覧表示します
Filter グループ

フィルター管理コマンド。

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

音声管理コマンド。

コマンド説明
addグローバル音声ソースを追加します
removeグローバル音声ソースを削除します
volume音声ソースの音量を設定します（0.0～3.0）
mute音声ソースをミュートします
unmute音声ソースのミュートを解除します
monitor音声モニタリングタイプを設定します
listすべての音声ソースを一覧表示します
Transition グループ

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

コマンド説明
addトランジションを追加します
removeトランジションを削除します
set-activeアクティブなトランジションを設定します
durationトランジションの時間をミリ秒で設定します
listすべてのトランジションを一覧表示します
Output グループ

出力／ストリーミング／録画の設定。

コマンド説明
streamingストリーミング設定を構成します
recording録画設定を構成します
settings出力設定を構成します
info現在の出力構成を表示します
presets利用可能なエンコードプリセットを一覧表示します
Session

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

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

例

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

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

cli-anything-obs_studio project new -o myproject.json
# Or with JSON output for programmatic use
cli-anything-obs_studio --json project new -o myproject.json
対話型 REPL セッション

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

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

状態管理

CLI は以下の機能でセッション状態を維持します：

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

出力形式

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

  • 人間が読みやすい形式（デフォルト）：テーブル、色、整形されたテキスト
  • 機械が読み取り可能な形式（--json フラグ）：エージェントが利用するための構造化 JSON
# Human output
cli-anything-obs_studio project info -p project.json

# JSON output for agents
cli-anything-obs_studio --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

コメント

Markdown 対応