CLI 基本操作

サブコマンド一覧

a9a CLI では、次の 4 つのコマンドを使えます。

• probe
  • 入力音声のメタ情報とラウドネス情報を表示します。
• render
  • operation を順番に適用して、1 件または複数件の出力を書き出します。
• play
  • 入力音声を再生します。
• version
  • バージョン情報を表示します。

probe

a9a_cli probe input.wav

probe は、入力ファイルの状態確認に使います。表示対象には次のような情報が含まれます。

• ファイルパス
• sample rate
• bit depth
• channels
• duration
• integrated LUFS
• true peak
• LRA
• crest factor
• loop 情報
• Vorbis Comments
• warnings

主なオプション

• --no-indicator
  • 互換性のために受け付けますが、probe では進捗表示は行いません。
• -q, --quiet
  • warning 行のみ抑制し、計測結果は表示します。

render

単一ファイルを出力する基本形です。

a9a_cli render input.wav \
  --out output.flac \
  --op gain db=-3 \
  --op fade-in duration=100ms curve=linear

複数入力をまとめて処理する場合は、--out-dir を使います。

a9a_cli render a.wav b.wav \
  --out-dir out \
  --same-format \
  --op loudness target=-16LUFS max-true-peak=-1dBTP

主な入出力オプション

• -o, --out <PATH>
  • 単一出力ファイルを指定します。
• --out-dir <DIR>
  • 複数入力向けの出力ディレクトリを指定します。
• --force
  • 既存出力を上書きします。
• --same-format
  • 入力形式を維持します。
• --format <wav|flac|aiff|ogg>
  • 出力形式を明示します。
• --sample-rate <HZ>
  • 出力 sample rate を指定します。
• --bits-per-sample <BITS>
  • WAV / FLAC / AIFF の bit depth を指定します。
• --sample-format <int|float>
  • WAV の sample format を指定します。
• --flac-compression-level <0..8>
  • FLAC の圧縮レベルを指定します。
• --vorbis-quality <-1..10>
  • Ogg Vorbis の品質を指定します。
• --comment KEY=VALUE
  • Vorbis Comment を追加します。
• --no-indicator
  • progress bar と operation ごとの進捗出力を無効化します。
• -q, --quiet
  • warnings と途中経過の表示を抑制し、indicator も無効化します。
• --job <JOB>
  • TOML 形式の job file を読み込みます。

operation の指定

CLI の --op では、次の operation を指定できます。

• gain
  • 必須: db=...
• loudness
  • 必須: target=...
  • 任意: max-true-peak=...
• fade-in
  • 必須: duration=...
  • 任意: curve=linear|equal_power|s_curve|log|exp
• fade-out
  • 必須: duration=...
  • 任意: curve=linear|equal_power|s_curve|log|exp
• loop
  • 必須: start=..., end=...
  • 制約: start < end

値の書き方

• db, target, max-true-peak
  • 数値、または suffix 付き文字列で指定します。
  • 例: -3, -3dB, -16LUFS, -1dBTP
• duration
  • 100ms, 1s, またはサフィックスなしのミリ秒整数で指定します。
• curve
  • linear, equal_power, s_curve, log, exp が使えます。

play

a9a_cli play input.wav

play は入力音声を再生し、端末には再生位置の progress を表示します。

version

a9a_cli version

CLI のバージョンやアプリケーション情報を確認したいときに使います。

third-party license を含める場合は次を使います。

a9a_cli version --third-party-licenses

代表例

単一ファイルを FLAC に書き出す例です。

a9a_cli render input.wav \
  --out output.flac \
  --format flac \
  --sample-rate 48000 \
  --bits-per-sample 24 \
  --op loudness target=-16LUFS max-true-peak=-1dBTP

job file に処理内容を寄せ、CLI 側で出力先だけ差し替える例です。

a9a_cli render \
  --job jobs/master.toml \
  --out-dir build/mastered \
  --comment REVISION=2025-08-28