mcpField
C
cli-anything-audacity

cli-anything-audacity

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

cli-anything-audacity について

cli-anything-audacityは、Audacityのオーディオプロジェクトを操作するステートフルなコマンドラインツールです。オーディオ編集者やAIエージェント向けに、トラックやクリップ、エフェクトの管理とJSON出力を提供します。

主な機能

  1. 01プロジェクトとセッションの管理
  2. 02トラック、クリップ、エフェクトの編集
  3. 03選択範囲とラベルの管理
  4. 04オーディオプロジェクトのレンダリング
  5. 05元に戻す・やり直す
  6. 06対話型REPLとJSON出力

活用シーン

  1. 01コマンドラインでAudacityプロジェクトを作成・編集
  2. 02コマンドでトラック、クリップ、エフェクトを調整
  3. 03エージェント処理向けにJSONを出力

インストール

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

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

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

詳細

cli-anything-audacity

音声編集のためのステートフルなコマンドラインインターフェースで、このリポジトリの GIMP および Blender CLI と同じパターンに従っています。

インストール

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

pip install cli-anything-audacity

前提条件:

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

使用方法

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

# Start interactive REPL mode
cli-anything-audacity

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

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

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

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

コマンドグループ

Project

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

CommandDescription
new新しいプロジェクトを作成します
open既存のプロジェクトを開きます
save現在のプロジェクトを保存します
infoプロジェクト情報を表示します
settingsプロジェクト設定を表示または更新します
json生のプロジェクト JSON を出力します
Track

トラック管理コマンド。

CommandDescription
add新しいトラックを追加します
removeインデックスでトラックを削除します
listすべてのトラックを一覧表示します
setトラックのプロパティ (名前、ミュート、ソロ、音量、パン) を設定します
Clip

クリップ管理コマンド。

CommandDescription
import音声ファイルをプローブ/インポートします (メタデータを表示)
addトラックに音声クリップを追加します
removeトラックからクリップを削除します
trimクリップの開始および/または終了をトリムします
split指定した時間位置でクリップを分割します
moveクリップを新しい開始時間に移動します
listトラック上のクリップを一覧表示します
Effect Group

エフェクト管理コマンド。

CommandDescription
list-available利用可能なすべてのエフェクトを一覧表示します
infoエフェクトの詳細を表示します
addトラックにエフェクトを追加します
removeインデックスでエフェクトを削除します
setエフェクトのパラメーターを設定します
listトラック上のエフェクトを一覧表示します
Selection

選択範囲管理コマンド。

CommandDescription
set選択範囲を設定します
allすべて選択します (プロジェクト全体の長さ)
none選択範囲をクリアします
info現在の選択範囲を表示します
Label

ラベル/マーカー管理コマンド。

CommandDescription
add時間位置にラベルを追加します
removeインデックスでラベルを削除します
listすべてのラベルを一覧表示します
Media

メディアファイルの操作。

CommandDescription
probe音声ファイルを分析します
check参照されているすべての音声ファイルが存在することを確認します
Export Group

エクスポート/レンダリングコマンド。

CommandDescription
presetsエクスポートプリセットを一覧表示します
preset-infoプリセットの詳細を表示します
renderプロジェクトを音声ファイルにレンダリングします
Session Group

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

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

例

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

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

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

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

cli-anything-audacity
# Enter commands interactively
# Use 'help' to see available commands
# Use 'undo' and 'redo' for history navigation
プロジェクトのエクスポート

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

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

状態管理

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

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

出力形式

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

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

# JSON output for agents
cli-anything-audacity --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 対応