CLI コマンド

sonare CLI の解析・特徴・その他のコマンド群を、索引である CLI リファレンスから分けたページです。グローバルオプション、マスタリングのワークフロー、終了コード、対応形式は索引側にあります。

解析コマンド

analyze

BPM、キー、拍子、ビートを含む音楽解析。

bash

sonare analyze music.mp3
sonare analyze music.mp3 --json

オプション	既定値	説明
`--with-seventh`	無効	トライアドだけでなく、コードテンプレート全体を探索する
`--no-hpss`	無効	倍音／打撃成分分離を無効化する
`--chroma-highpass`	80.0	クロマ解析用のハイパスカットオフ周波数（Hz）
`--meter-candidates`	`3,4,6`	探索する拍子の分子。カンマ区切り
`--meter-denominator`	4	検出した拍子を報告するときの音符単位

--with-seventh を指定しない場合、コード認識はメジャー・マイナー・ディミニッシュ・オーギュメントのトライアドだけを照合します。指定すると、ルートごとに 24 種類のコードクオリティすべてが対象になります。セブンスやナインスに加えて、シックスス、 7sus4、イレブンス、サーティーンス、オルタードドミナントが含まれます。

拍子の探索は、指定された分子しか報告しません。既定の候補は 3,4,6 なので、 5/4 や 7/8、11/8 の曲もこの 3 つのいずれかとして返ってきます。--meter-candidates 3,4,5,7 のように候補を広げて初めて検出できます。候補リストは 1〜16 個で、各値は 2〜32 の範囲です。--meter-denominator は結果を報告するときの音符単位を決めるだけで、探索そのものには影響しません。2 つの数字の意味は拍子とグルーピングで説明しています。

出力:

  > Estimated BPM : 120.50 BPM  (conf 95.0%)
  > Estimated Key : C major  (conf 85.0%)
  > Time Signature: 4/4
  > Beats: 240

JSON 出力:

json

{
  "bpm": 120.5,
  "bpm_confidence": 0.95,
  "key": {
    "root": 0,
    "mode": 0,
    "confidence": 0.85,
    "name": "C major"
  },
  "time_signature": {
    "numerator": 4,
    "denominator": 4,
    "confidence": 0.91
  },
  "beats": [
    {"time": 0.52, "strength": 0.84},
    {"time": 1.02, "strength": 0.78}
  ],
  "downbeat_indices": [0, 4, 8],
  "downbeat_phase": 0,
  "chords": [
    {"name": "C", "start": 0.0, "end": 2.0, "confidence": 0.88}
  ],
  "sections": [
    {"type": "intro", "start": 0.0, "end": 8.0}
  ],
  "timbre": {
    "brightness": 0.61,
    "warmth": 0.47,
    "density": 0.72,
    "roughness": 0.18,
    "complexity": 0.56
  },
  "dynamics": {
    "dynamic_range_db": 9.4,
    "loudness_range_db": 6.8,
    "crest_factor": 7.2,
    "is_compressed": false
  },
  "rhythm": {
    "syncopation": 0.32,
    "groove_type": "straight",
    "pattern_regularity": 0.89
  },
  "form": "IAB"
}

上の配列は省略した例です。特に beats はビート数ではなく、検出したビートごとの {"time", "strength"} オブジェクトを保持します。

downbeat_indices は独自の時刻を持たず、beats のインデックスを保持します。つまりダウンビートかどうかは、この配列に含まれるかどうかで判定します（i が downbeat_indices にあれば beats[i] がダウンビートです）。downbeat_phase は最初のダウンビートが何番目のビートに来るかを表し、テイクが小節の途中から始まっている量を示します。

bpm

テンポ（BPM）のみを検出。

bash

sonare bpm music.mp3
sonare bpm music.wav --json

出力:

  BPM: 128.00

key

音楽キーを検出。

bash

sonare key music.mp3
sonare key music.mp3 --json
sonare key music.mp3 --candidates 5 --profile temperley --modes major-minor

出力:

  Key: A minor (confidence: 82.0%)

JSON 出力:

json

{"root": 9, "mode": 1, "confidence": 0.82, "name": "A minor"}

主なオプション:

オプション	用途
`--candidates N`	最上位だけでなく上位 `N` 個のキー候補を表示
`--use-hpss`	ドラムが強い素材で、倍音成分を使ってキーを見やすくする
`--loudness-weighted`	RMS でクロマフレームを重み付けし、静かな箇所の影響を下げる
`--high-pass-hz FREQ`	キー解析前に低域を無視する
`--modes NAME`	候補モードを制限する
`--profile NAME`	キープロファイルの系統を選ぶ
`--genre-hint HINT`	ジャンルヒントからプロファイルを選ばせる

キープロファイル・ジャンルヒント・--high-pass-hz とは？

キープロファイル — あるキーで 12 のピッチクラスがそれぞれどれくらい目立ちやすいかのテンプレートです。検出器は曲のクロマをこれらと比べ、最も一致するものを選びます。
系統（ks / krumhansl、temperley、shaath / keyfinder、Faraldo EDM 系、bellman / bellman-budge）はそれぞれ別の素材で調整されています。そのため、ジャンルによって相性が変わります。
ジャンルヒント — プロファイルを直接指定する代わりに、おおまかなスタイルを伝えると CLI が合うプロファイルを選びます（例: EDM ヒントなら EDM 向けに調整したプロファイル）。
--high-pass-hz — ハイパスフィルターで、キー解析の前に指定周波数より下のエネルギーを除きます。低域のランブルやサブキックがクロマを歪めるのを防ぎます。80〜120 Hz 程度が一般的です。

beats

ビート時刻を検出。

bash

sonare beats music.mp3
sonare beats music.mp3 --json

出力:

  Beat times (240 beats):
    1. 0.520s
    2. 1.020s
    3. 1.520s
    ... (237 more)

onsets

オンセット時刻（音の立ち上がり）を検出。

bash

sonare onsets music.mp3
sonare onsets music.mp3 --json

特徴コマンド

mel

メルスペクトログラムを計算し、その次元を表示。

bash

sonare mel music.mp3
sonare mel music.mp3 --n-mels 80
sonare mel music.mp3 --fmin 40 --fmax 16000 --htk

オプション	既定値	説明
`--fmin FREQ`	0	メルバンドの最低周波数（Hz）
`--fmax FREQ`	0	メルバンドの最高周波数（Hz）。0 ならナイキスト周波数を使う
`--htk`	無効	Slaney スケールではなく HTK メルスケールを使う

出力:

  Mel Spectrogram:
    Shape: 128 mels x 8520 frames

chroma

クロマグラム（ピッチクラス分布）を計算。

bash

sonare chroma music.mp3
sonare chroma music.mp3 --json

出力:

  Chromagram: 12 bins x 8520 frames
  Mean energy per pitch class:
    C  0.1250 #############
    C# 0.0450 #####
    D  0.0820 ########
    ...

spectral

スペクトル特徴を計算します。セントロイド、帯域幅、ロールオフ、フラットネス、ZCR（zero-crossing rate、ゼロ交差率）、RMS（root mean square、実効値レベル）を出力します。

bash

sonare spectral music.mp3
sonare spectral music.mp3 --json

出力:

  Spectral Features:
  Feature          Mean       Std        Min        Max
  centroid         2150.5     850.2      120.5      8500.0
  bandwidth        1850.2     520.8       50.2      4200.5
  rolloff          4520.8    1200.5      200.0     10000.0
  flatness         0.0250     0.0180     0.0010     0.1520
  zcr              0.0850     0.0420     0.0020     0.2500
  rms              0.0520     0.0280     0.0001     0.1850

pitch

YIN または pYIN の基本周波数推定器で、ピッチの時間変化を追跡します。

bash

sonare pitch music.mp3
sonare pitch music.mp3 --algorithm yin

オプション	既定値	説明
`--algorithm`	pyin	ピッチアルゴリズム: "yin" または "pyin"
`--threshold`	0.1	YIN のしきい値（0 より大きく 1 以下）
`--fmin`	65.0	追跡する最低周波数（Hz）
`--fmax`	2093.0	追跡する最高周波数（Hz）
`--hop-length`	512	ホップ長（サンプル数）。グローバルの `--hop-length` とは別に、範囲チェック付きでこのコマンド用に再定義されています

出力:

  Pitch Tracking (pyin):
    Frames:    8520
    Median F0: 285.5 Hz
    Mean F0:   302.8 Hz

hpss

HPSS（Harmonic / Percussive Source Separation）。倍音成分（ボーカル／メロディ）と打撃成分（ドラム）を分離します。

bash

sonare hpss music.mp3 -o separated
sonare hpss music.mp3 -o separated --json

オプション	既定値	説明
`--kernel-harmonic <int>`	31	倍音成分側のメディアンフィルターカーネルサイズ
`--kernel-percussive <int>`	31	打撃成分側のメディアンフィルターカーネルサイズ
`--harmonic-only`	無効	倍音成分のみを書き出す
`--percussive-only`	無効	打撃成分のみを書き出す
`--with-residual`	無効	残差成分も分離して書き出す
`--hard-mask`	無効	既定のソフトマスクの代わりにハードマスクを使う

--harmonic-only、--percussive-only、--with-residual は同時に指定できません。

出力:

  HPSS: 3980000 samples
  Harmonic energy:   0.025000
  Percussive energy: 0.018000
  Wrote: separated_harmonic.wav, separated_percussive.wav

decompose-stems

ミックスを非負値行列因子分解（NMF）の成分に分けます。hpss のように倍音／打撃という固定の分け方をするのではなく、繰り返し現れるスペクトルパターンをデータから見つけて分離します。

bash

sonare decompose-stems band.wav -o stems.wav
sonare decompose-stems band.wav -o stems.wav --n-components 6 --init nndsvd --json

オプション	既定値	説明
`--n-components <int>`	4	分解する成分の数
`--n-iter <int>`	100	NMF の更新反復回数
`--beta`	2.0	ベータダイバージェンス。2 は Frobenius、1 は Kullback-Leibler
`--init`	random	NMF の初期化方法。`random` または `nndsvd`
`--mask-power`	1.0	ソフトマスクの指数（1 以上）。2 は Wiener 型のパワー比になる

-o は 1 つのファイルではなく、ファイル群の名前として扱われます。どちらの CLI も <base>_component1.wav 〜 <base>_componentN.wav を書き出し、渡したパス末尾の .wav は取り除かれます。各成分は元音声の位相を保つため、すべて足し合わせると入力に戻り、成分単体でもそのまま聴けます。ここがライブラリの decompose との違いです。 decompose は振幅スペクトログラムの因子を返すだけなので、音として聴くには位相推定が必要になります。

出力:

  Stems: 4 components
     1. energy 0.031200  stems_component1.wav
     2. energy 0.018400  stems_component2.wav
     3. energy 0.009100  stems_component3.wav
     4. energy 0.004700  stems_component4.wav

その他のコマンド

Python CLI には、上記のコア以外にも多くのサブコマンドがあります。

音声ファイルを解析・特徴抽出するコマンドは、共通オプション（--json、--n-fft など）とファイル引数を取ります。

一覧表示やプリセット参照のコマンドは、より小さい専用のオプションセットを持ちます。編集系コマンドは -o/--output を渡すと WAV を書き出します。

その他の解析

ルーム音響コマンドの用語

等価ルーム は、音声から推定した実用上の部屋モデルで、正確な実寸ではありません。RIR は room impulse response（部屋のインパルス応答）の略です。ルームモーフィングは音作り向けのルーム効果であり、残響除去ではありません。

これらのコマンドが返す指標は、残響の減衰と明瞭度を表す値です。RT60 は残響時間、EDT は初期減衰時間、C50／C80 は明瞭度の比、DRR は直接音と残響音の比です。各フィールドの定義はルーム音響解析にあります。

コマンド	説明	主なオプション
`sonare downbeats music.mp3`	ダウンビート時刻（秒）	—
`sonare chords music.mp3`	コード進行	`--min-duration`, `--smoothing-window`, `--threshold`, `--triads-only`, `--nnls`, `--no-beat-sync`, `--use-hmm`, `--hmm-beam-width`, `--key-context`, `--key-root`, `--key-mode`, `--detect-inversions`
`sonare rhythm music.mp3`	リズム特性（シンコペーション、グルーヴ、規則性）	`--start-bpm`（120.0）, `--bpm-min`（60.0）, `--bpm-max`（200.0）
`sonare dynamics music.mp3`	ダイナミクス／ラウドネスの要約	`--window-sec`（0.4）
`sonare timbre music.mp3`	音色／スペクトル形状の要約	—
`sonare lufs music.mp3`	EBU R128 ラウドネス。単位は LUFS（Loudness Units relative to Full Scale。聴感上の音量を表す標準単位。配信ターゲットを参照）	`--series`（momentary／short-term の系列も出力）
`sonare acoustic room.wav`	ルーム音響推定（RT60／EDT／C50／C80）	`--ir`（入力をインパルス応答として扱う）, `--n-bands`（6）, `--min-decay-db`（30.0）, `--noise-floor-margin-db`（10.0）
`sonare estimate-room room.wav`	等価ルーム推定（体積、寸法、吸音率、DRR、信頼度）	`--json`, `--aspect-lw`, `--aspect-lh`, `--reference-absorption`, `--sabine`, `--n-octave-bands`
`sonare synthesize-rir --length 7 --width 5 --height 3 -o rir.wav`	シューボックス形状からモノラル RIR を合成	`--source-x`, `--source-y`, `--source-z`, `--listener-x`, `--listener-y`, `--listener-z`, `--absorption`, `--sample-rate`, `--ism-order`, `--seed`, `--max-seconds`
`sonare room-morph dry.wav --length 12 --width 9 --height 4 -o wet.wav`	目標ルームへ寄せる音作り向けのルームモーフィング	`--wet`, `--suppression`, 形状・配置オプション、`--max-seconds`
`sonare boundaries music.mp3`	構造の転換点と、それを拾い出した元のノヴェルティ曲線	ネイティブ CLI のみ。`--threshold`（0.3）, `--absolute-threshold`（0.005）, `--kernel-size`（64）, `--n-mfcc`（13）, `--n-chroma`（12）, `--peak-distance`（2.0）, `--no-mfcc`, `--no-chroma`, `--n-fft`（2048）, `--hop-length`（512）
`sonare melody music.mp3`	メロディ輪郭の要約。メロディの有無、音域（オクターブ）、平均周波数、ピッチの安定度、ビブラート速度、ピッチ点の数	ネイティブ CLI のみ。`--threshold`（0.1）, `--hop-length`（512）, `--fmin`（80.0）, `--fmax`（1000.0）
`sonare meter music.wav`	ピーク、RMS、クレスト、True Peak、クリッピング率、無音率、DC オフセット	ネイティブ CLI のみ。`--clip-threshold`, `--oversample`
`sonare clipping music.wav`	クリップしたサンプルと区間を検出	ネイティブ CLI のみ。`--threshold`, `--min-region`
`sonare dynamic-range music.wav`	percentile RMS ベースのダイナミックレンジ	ネイティブ CLI のみ。`--window-sec`, `--hop-sec`, `--low-percentile`, `--high-percentile`
`sonare stereo left.wav --reference right.wav`	左右ファイルからステレオ相関と幅を測定	ネイティブ CLI のみ
`sonare phase left.wav --reference right.wav`	左右ファイルからフェーズスコープ要約を測定	ネイティブ CLI のみ

boundaries は検出器の全パラメータを公開しており、2 つのしきい値は役割が違います。--threshold はノヴェルティ曲線自身の最大値に対する相対値なので、「そもそも変化があったのか」を問えません。それを問えるのが下限の --absolute-threshold です。両者の関係と、下限を下げても何が拾えて何が拾えないかは detectBoundaries(request) で説明しています。--no-mfcc と --no-chroma はそれぞれ特徴量ストリームを 1 つ落としますが、両方の指定は拒否されます。2 つはフレーム単位で結合されるため、どちらも無効では結合する対象がなくなるからです。

その他の特徴量

コマンド	Python CLI	ネイティブ CLI	説明
`sonare onset-envelope music.mp3`	対応	対応	オンセット強度の包絡線（音の立ち上がりの強さの時間変化）。ネイティブ CLI の `--json` は `values` 配列全体と mean/std/min/max を返す
`sonare onset-env music.mp3`	非対応	対応	同じ包絡線の要約のみ。フレーム数・ピーク時刻・ピーク強度・平均で、配列は返さない
`sonare tempogram music.mp3`	対応	対応	自己相関テンポグラム
`sonare plp music.mp3`	対応	対応	主要局所パルス
`sonare nnls-chroma music.mp3`	対応	対応	NNLS クロマグラム
`sonare cqt music.mp3`	非対応	対応	Constant-Q 変換のサマリー
`sonare vqt music.mp3`	非対応	対応	Variable-Q 変換のサマリー
`sonare mel-to-audio music.mp3 -o recon.wav`	非対応	対応	計算したメルスペクトログラムから Griffin-Lim で音声を再構成
`sonare mfcc-to-audio music.mp3 -o recon.wav`	非対応	対応	計算した MFCC からメル、Griffin-Lim 経由で音声を再構成
`sonare tonnetz music.mp3`	非対応	対応	Tonal centroid 特徴
`sonare pcen --values ... --n-bins 128 --n-frames 10`	非対応	対応	平坦化した行列への per-channel energy normalization
`sonare fourier-tempogram music.mp3`	非対応	対応	Fourier tempogram
`sonare tempogram-ratio music.mp3`	非対応	対応	テンポ比特徴量

Python CLI は行列特徴量の全データをそのまま出力せず、サマリーを表示します。完全な特徴量行列が必要な場合は Python API または JavaScript API を使ってください。

編集

音声を変換し、-o で WAV を書き出します。

コマンド	説明	オプション
`sonare pitch-correct vocal.wav -o out.wav`	目標 MIDI ノートへピッチ補正	`--current-midi`（69.0）, `--target-midi`（69.0）
`sonare pitch-correct-timevarying vocal.wav -o out.wav`	pYIN 輪郭を追跡し、1 音または音階へ補正	`--mode midi\|scale`, `--target-midi`, `--scale-root`, `--scale-mode-mask`, `--reference-midi`, `--hop-length`
`sonare note-move take.wav --target-onset 48000 -o out.wav`	ノート区間を指定サンプル位置へ移動	`--onset`, `--offset`, `--target-onset`（サンプル位置）
`sonare note-stretch take.wav -o out.wav`	単一ノート区間をストレッチ	`--onset`, `--offset`（サンプル位置）, `--ratio`（1.0）
`sonare scale-quantize 68.7`	MIDI 値を音階へ量子化	`--root`, `--mode-mask`, `--reference-midi`
`sonare voice-change vocal.wav -o out.wav`	ボイスチェンジ（ピッチ＋フォルマント）	`--pitch-semitones`（0.0）, `--formant-factor`（1.0）
`sonare pitch-shift vocal.wav --semitones 3 -o out.wav`	長さを変えずに移調	`--semitones`（必須）
`sonare time-stretch take.wav --rate 1.2 -o out.wav`	ピッチを変えずに長さを変更	`--rate`（必須）
`sonare normalize mix.wav -o out.wav`	ピークまたは RMS ノーマライズ	`--mode peak\|rms`, `--target-db`
`sonare trim-silence take.wav -o out.wav`	前後の無音をトリム	`--top-db`, `--threshold-db`（-60）
`sonare resample music.wav --target-sr 44100 -o out.wav`	リサンプリング	`--target-sr`
`sonare polyphonic-notes chord.wav`	ポリフォニー解析が見つけたノートを一覧表示	—
`sonare polyphonic-render chord.wav -o out.wav`	その解析結果をノート単位で編集して再レンダリング	`--edit NOTE.FIELD=VALUE`（繰り返し可）
`sonare project align-takes --in project.json --reference-source 1 -o aligned.json`	プロジェクト内のすべてのテイクを 1 つの参照ソースに揃え、テイクごとのワープマップを付けてプロジェクトを書き戻す。ソースファイルを直接読むため、参照とレートが異なるテイクは名前付きで拒否される（録音とテイクを参照）	`--in`, `--reference-source`（必須）, `--audio SOURCE_ID=WAV`（繰り返し可）, `--resolve-audio`, `--hop-length`, `--bins-per-octave`

--top-db と --threshold-db は同時に指定できない、択一の無音判定方式です。どちらも省略すると --threshold-db が -60 として扱われ、--top-db を指定するとピーク相対のトップ dB 方式に切り替わります。

Python CLI は、上のファイル書き出し編集コマンドを提供します。hpss も -o が必須で、エネルギー要約を表示しながら <base>_harmonic.wav と <base>_percussive.wav を書き出します。

ノート単位の編集

polyphonic-notes と polyphonic-render は対で使います。前者はポリフォニー解析が見つけたノートを 0 から番号付きで表示し、後者はその番号を使って編集を指定し、テイクを再レンダリングします。どちらも解析を同じ既定値で実行し、フレーミングを変えるオプションを持たないため、一方で読んだ番号がそのまま他方の対象になります。

bash

sonare polyphonic-notes chord.wav --json
sonare polyphonic-render chord.wav -o out.wav \
  --edit 0.pitch_shift_semitones=2 --edit 3.muted=1

--edit は 1 回につき 1 つの NOTE.FIELD=VALUE を指定し、繰り返し渡せます。指定できるフィールドは pitch_shift_semitones、gain_db、time_offset_samples、time_stretch_ratio、formant_shift_semitones、vibrato_depth_change、drift_change、muted です。未知のフィールドは無視されるのではなくエラーになります。polyphonic-render は -o が必須で、polyphonic-notes は標準出力に表示するだけなので出力ファイルを取りません。

何もしない既定値はありません

--semitones と --rate に既定値はありません。既定値があると、省略したときにコマンドが何もしない状態になるためです。どちらも必須です。また、ピッチシフトの未知の --algorithm やピッチ補正の未知の --mode も、既定値へフォールバックせずエラーになります。

ネイティブ CLI では、共通の編集コマンドに加えて、低レベルの処理コマンドも使えます。

ネイティブコマンド	必須または主なオプション
`sonare gain music.wav -o out.wav`	`-o`, `--gain-db`（必須）
`sonare fade music.wav -o out.wav`	`-o`, `--fade-in` または `--fade-out`（秒）
`sonare filter music.wav -o out.wav`	`-o`, `--type hp\|lp\|bp\|notch`; hp/lp は `--cutoff`、bp/notch は `--center` + `--bandwidth`; `--order`（2）, `--zero-phase`
`sonare preemphasis speech.wav -o out.wav`, `sonare deemphasis speech.wav -o out.wav`	`-o`; `--coef`（0.97）

filter --order は 2 か 4 を取り、4 は hp／lp でのみ使えます（bp や notch に 4 を指定するとエラーになります）。--zero-phase はフィルターを順方向と逆方向に 1 回ずつかけ（filtfilt）、位相のずれをなくします。その代わり実効的な傾きが 2 倍になり、ファイル全体が揃っている必要があります。

split-silence

split-silence はテイクを変更せず、どこが無音かを調べるコマンドです。非無音区間をサンプル範囲として表示するだけで、区間で切り出すよう指定したときだけ音声を書き出します。両方の CLI にあり、オプションも共通です。

bash

sonare split-silence take1.wav
sonare split-silence take1.wav --json

出力:

Non-silent intervals: 3
  28160 - 116224
  153088 - 241152
  287232 - 394752

JSON 出力:

json

[{"start_sample": 28160, "end_sample": 116224}, {"start_sample": 153088, "end_sample": 241152}, {"start_sample": 287232, "end_sample": 394752}]

オプション	既定値	説明
`--input WAV`	—	同じパートの別テイク。繰り返し指定可
`--top-db`	60.0	ピークからの無音しきい値（dB）
`--write-takes PREFIX`	—	各テイクを各区間で切り出して書き出す

テイクを複数渡すと、区間はテイクごとの区間の和集合になり、接する区間は結合されます。つまりカットが入るのは、すべてのテイクが無音になっている場所だけです。

bash

sonare split-silence take1.wav --input take2.wav --input take3.wav

Non-silent intervals: 3
  23040 - 121344
  147968 - 246272
  282624 - 399872

--write-takes PREFIX は、各テイクを各区間で切り出して PREFIX{take:02d}_{interval:03d}.wav（どちらも 1 始まり）として書き出します。テイク 3 つ・区間 3 つなら 9 ファイルです。

bash

sonare split-silence take1.wav --input take2.wav --input take3.wav \
  --write-takes cut_

Wrote 9 take files with prefix cut_

他より早く終わるテイクは短縮されず、パディングされます。そのため 1 つの区間のファイルはどのテイクでも同じ長さになり、そのまま比較できます。先頭のテイクとサンプルレートが異なるテイクは、リサンプルされずに名前付きで拒否されます。

Error: take sample rate differs: t3_44.wav is 44100 Hz, the first take is 48000 Hz

-o／--output は今も使用方法エラー（終了コード 2）です。このコマンドの結果は区間の一覧か切り出したテイクファイルであり、単一のレンダリング済み出力ファイルではありません。

リアルタイムボイスプリセット

リアルタイムボイスチェンジャープリセットの参照、検証、レンダリングを行うコマンドです。

コマンド	説明	オプション
`sonare voice-change vocal.wav -o out.wav`	`--preset`、`--preset-json`、`--preset-pack`、`--set` を渡した場合はリアルタイム音声プリセットチェーンでレンダリング	`--preset`、`--preset-json`、`--preset-pack`、`--set PATH=VALUE`
`sonare voice-presets`	リアルタイムボイスチェンジャーのプリセット ID を一覧表示	`--json`
`sonare voice-preset`	1 つのプリセット設定を JSON で出力	`--preset`（既定: `neutral-monitor`）、`--json`
`sonare voice-preset-validate preset.json`	プリセット JSON ファイルまたはプリセットパックを検証・正規化	パック検証時は `--preset`、`--set PATH=VALUE`、`--json`

リアルタイムプリセット系のオプションを渡さない場合、voice-change は --pitch-semitones と --formant-factor で制御する単純なピッチ／フォルマント変換を使います。プリセット系のオプションを渡した場合はリアルタイム音声チェーンを使い、単純なピッチ／フォルマント指定との併用は無効パラメータとして拒否されます。

プリセットの選択は明示的に行います。組み込みの --preset ID、--preset-json FILE、または --preset-pack FILE --preset ID の組み合わせから 1 つを選びます。パックファイルとエントリ ID はセットで 1 つの指定として扱われるため、--preset-pack だけを渡すと拒否されます（先頭エントリへのフォールバックはありません）。--preset-json とパックは併用できません。--set PATH=VALUE を使うには、いずれかのプリセット指定が必要です。

合成

ネイティブ CLI では簡単なテスト信号を生成でき、MIDI プロジェクトを内蔵シンセでレンダリングするコマンドは両方の CLI にあります。

コマンド	必須または主なオプション
`sonare tone -o tone.wav`	`--frequency`; 任意で `--sr`（22050）, `--duration`（1.0）, `--phase`（0.0）, `--amplitude`（1.0）
`sonare chirp -o sweep.wav`	`--fmax`; 任意で `--fmin`, `--exponential`, `--sr`（22050）, `--duration`（1.0）
`sonare clicks -o clicks.wav`	秒単位のカンマ区切り `--times`; 任意で `--sr`（22050）, `--length`, `--frequency`（1000.0）, `--click-duration`（0.1）
`sonare midi-render --in project.json -o render.wav`	`--in`, `-o`; `--synth PRESET`（省略時は GM プログラムに追従）, `--sample-rate`, `--frames`, `--block-size`, `--channels`（正の出力幅は `1`、`2`、`6`、`8`; 既定は `2`）, `--instrument-latency`。両方の CLI にあり、常にシンセ経路を使う `project bounce` なので、`--audio` と `--resolve-audio` は受け付けない

project bounce とその短縮形 midi-render で指定できる正の出力幅は 1、2、6、8 です。--channels を省略するか 0 以下を渡すと、既定の 2 チャンネルになります。要求した出力幅はシーンのマスターのレイアウト幅を超えられません。ただしモノラル／ステレオのマスターと、マスターを持たないシーンは最大 2 チャンネルまで許容します。"5.1" は 6 チャンネルまで、"7.1" は 8 チャンネルまでです。

使用例

ブラウザ / WASM

JavaScript API

Python API

CLIリファレンス

Node.js ネイティブ API

C++ API

用語集

基礎

解析ガイド

ミキシングガイド

編集ガイド

楽器と MIDI

アレンジとプロジェクト

リアルタイムガイド

室内音響

マスタリング概念

マスタリングガイド

CLI コマンド

解析コマンド

analyze

bpm

key

beats

onsets

特徴コマンド

mel

chroma

spectral

pitch

hpss

decompose-stems

その他のコマンド

その他の解析

その他の特徴量

編集

ノート単位の編集

split-silence

リアルタイムボイスプリセット

合成

CLI コマンド ​

解析コマンド ​

analyze ​

bpm ​

key ​

beats ​

onsets ​

特徴コマンド ​

mel ​

chroma ​

spectral ​

pitch ​

hpss ​

decompose-stems ​

その他のコマンド ​

その他の解析 ​

その他の特徴量 ​

編集 ​

ノート単位の編集 ​

split-silence ​

リアルタイムボイスプリセット ​

合成 ​

CLI コマンド

解析コマンド

analyze

bpm

key

beats

onsets

特徴コマンド

mel

chroma

spectral

pitch

hpss

decompose-stems

その他のコマンド

その他の解析

その他の特徴量

編集

ノート単位の編集

split-silence

リアルタイムボイスプリセット

合成