MIDI Sketch

日本語

English

日本語

English

Appearance

CLI リファレンス ​

MIDI Sketch には生成、分析、デバッグ用のコマンドラインツールが含まれています。バッチ処理、CI/CDパイプライン、MIDIの品質調査に便利です。

インストール ​

ソースからCLIをビルド：

bash
cd midi-sketch
mkdir build && cd build
cmake .. -DCMAKE_BUILD_TYPE=Release
make midisketch_cli

バイナリは build/midisketch_cli に生成されます。

基本的な使い方 ​

bash
# デフォルト設定で生成
./midisketch_cli

# スタイルとムードを指定して生成
./midisketch_cli --style 5 --mood 3 --bpm 128

# 生成して不協和音を分析
./midisketch_cli --style 5 --analyze

# 既存のMIDIファイルを分析
./midisketch_cli --input existing.mid --analyze

コマンドリファレンス ​

生成パラメータ ​

フラグ説明デフォルト
--seed Nランダムシード（0 = 自動ランダム）0
--style NスタイルプリセットID（0-16）0
--mood NムードID（0-23）、スタイルマッピングを上書き-
--chord Nコード進行ID（0-21）-
--bpm NBPM（40-240）スタイルプリセット
--key Nキー（0-11: C, C#, D, Eb, E, F, F#, G, Ab, A, Bb, B）0
--form Nフォーム/構成パターンID（0-17）-
--duration N目標再生時間（秒）（0 = パターン使用）0
--blueprint NProduction Blueprint ID または名前（0-9, 255=自動）0
--guitar / --no-guitarギタートラックの有効化/無効化有効
--drive-feel Nドライブ感（0=レイドバック, 50=ニュートラル, 100=アグレッシブ）50
--energy-curve Nエネルギーカーブ（0=GradualBuild, 1=FrontLoaded, 2=WavePattern, 3=SteadyState）0
--enable-syncopation / --no-syncopationシンコペーション効果の有効化/無効化無効
--mora-rhythm-mode Nモーラリズム（0=Standard, 1=MoraTimed, 2=Auto）2
--addictive-modeBehavioral Loop モードを有効化無効

ボーカルパラメータ ​

フラグ説明デフォルト
--skip-vocal初期生成でボーカルをスキップ（BGM先行ワークフロー）-
--regenerate-vocal初期生成後にボーカルを再生成-
--vocal-seed Nボーカル再生成用シード-
--vocal-attitude Nボーカル態度（0=Clean, 1=Expressive, 2=Raw）0
--vocal-low Nボーカル音域下限（MIDIノート）60
--vocal-high Nボーカル音域上限（MIDIノート）79
--vocal-style Nボーカルスタイルプリセット0（自動）

ボーカルスタイルオプション（14プリセット）：

  • 0: Auto（スタイルプリセットに基づいて自動選択）
  • 1: Standard
  • 2: Vocaloid（高速、広い跳躍）
  • 3: UltraVocaloid（超高速、32分音符）
  • 4: Idol（キャッチー、フック重視）
  • 5: Ballad（スロー、持続音）
  • 6: Rock（パワフル、音域シフト）
  • 7: CityPop（ジャジー、シンコペーション）
  • 8: Anime（ダイナミック、表現豊か）
  • 9: BrightKira（高音域、キラキラ）
  • 10: CoolSynth（エレクトロニック、正確）
  • 11: CuteAffected（プレイフル）
  • 12: PowerfulShout（激しい、シャウト系）
  • 13: KPop（タイトなリズム、ダンス志向）

メロディオーバーライド ​

フラグ説明デフォルト
--melody-max-leap Nメロディの最大跳躍（半音数、0-12、0=プリセット）0
--melody-syncopation-prob Nシンコペーション確率（0-100、255=プリセット）255
--melody-phrase-length Nフレーズ長（0-8、0=プリセット）0
--melody-long-note-ratio N長音比率（0-100、255=プリセット）255
--melody-chorus-register-shift Nサビの音域シフト（-12〜12、-128=プリセット）-128
--melody-hook-repetition Nフック繰り返し（0=プリセット, 1=オフ, 2=オン）0
--melody-use-leading-tone N導音（0=プリセット, 1=オフ, 2=オン）0

モチーフオーバーライド ​

フラグ説明デフォルト
--motif-length Nモチーフ長（拍数、0=デフォルト, 1, 2, 4）0
--motif-note-count Nモチーフ音数（0=デフォルト, 3-8）0
--motif-motion Nモチーフの動き（0=Stepwise, 1=GentleLeap, 2=WideLeap, 3=NarrowStep, 4=Disjunct, 255=プリセット）255
--motif-register-high Nモチーフ音域（0=デフォルト, 1=低, 2=高）0
--motif-rhythm-density Nモチーフリズム密度（0=Sparse, 1=Medium, 2=Driving, 255=プリセット）255

ファイル操作 ​

フラグ説明
--input FILE既存のMIDIファイルを分析
--validate FILEMIDIファイル構造を検証
--regenerate FILE埋め込みメタデータから再生成
--new-seed N再生成時に新しいシードを使用
--format FMTMIDIフォーマット：smf1 または smf2（デフォルト）

分析＆デバッグ ​

フラグ説明
--analyze生成/入力MIDIの不協和音を分析
--json分析結果をJSON形式でstdoutに出力
--bar NバーN（1始まり）のノートを検査

不協和音分析 ​

--analyze フラグは音楽理論に基づいた分析を行い、潜在的な問題を検出します。

問題タイプ ​

タイプ説明重大度
SimultaneousClash不協和音程（短2度、長7度）の同時発音高
NonChordToneコード構成音以外のノート低〜中
SustainedOverChordChangeコードチェンジをまたいで保持されたノート中
NonDiatonicNoteキーのスケール外のノート高

重大度レベル ​

  • CRITICAL（高）：確実に問題あり、修正が必要
  • WARNING（中）：確認を推奨
  • INFO（低）：通常の音楽的テンション（経過音、刺繍音）

出力例 ​

=== Dissonance Analysis ===

Action Summary:
  CRITICAL: 2 issues require fixing
  WARNING:  5 issues worth reviewing
  INFO:     12 normal musical tensions (no action needed)

Technical Breakdown:
  Simultaneous clashes:      2
  Non-chord tones:           8 (usually acceptable)
  Sustained over chord:      3
  Non-diatonic notes:        1

=== CRITICAL Issues (require fixing) ===

Bar 4, beat 2.0 (tick 7680):
  Clash: minor 2nd between Vocal(E4) vs Chord(F4)
  Chord: Dm7
  Playing: Vocal(E4), Chord(D3,F4,A4,C5), Bass(D2)

JSON出力 ​

機械可読な出力には --json を使用：

bash
./midisketch_cli --input song.mid --analyze --json > analysis.json

JSON構造：

json
{
  "summary": {
    "total_issues": 19,
    "simultaneous_clashes": 2,
    "non_chord_tones": 8,
    "sustained_over_chord_change": 3,
    "non_diatonic_notes": 1,
    "high_severity": 2,
    "medium_severity": 5,
    "low_severity": 12
  },
  "issues": [
    {
      "type": "simultaneous_clash",
      "severity": "high",
      "tick": 7680,
      "bar": 4,
      "beat": 2.0,
      "interval_semitones": 1,
      "interval_name": "minor 2nd",
      "notes": [
        { "track": "Vocal", "pitch": 64, "name": "E4" },
        { "track": "Chord", "pitch": 65, "name": "F4" }
      ]
    }
  ]
}

バー検査 ​

--bar N フラグで特定のバーの全ノートをトラック別に表示：

bash
./midisketch_cli --input song.mid --bar 8

出力フォーマット：

=== Bar 8 (tick 13440-15360) ===

Vocal:
  beat 1.0: G4 (2 beats)
  beat 3.0: E4 (1 beat)

Chord:
  beat 1.0: C4,E4,G4,B4 (4 beats)

Bass:
  beat 1.0: C2 (2 beats)
  beat 3.0: G2 (2 beats)

Drums:
  beat 1.0: kick
  beat 2.0: snare
  beat 3.0: kick
  beat 4.0: snare

前のバーから持続しているノートは (sustained) と表示：

Vocal:
  → A4 (sustained from bar 7)
  beat 2.5: G4 (1 beat)

MIDI再生成 ​

埋め込みメタデータから曲を再生成：

bash
# オリジナルシードで再生成
./midisketch_cli --regenerate song.mid

# 新しいシードで再生成
./midisketch_cli --regenerate song.mid --new-seed 54321

CLIはMIDIフォーマット（SMF1、SMF2/ktmidi、SMF2/Clip）を自動検出し、ファイルに埋め込まれた生成パラメータを抽出します。

Blueprint パラメータ ​

フラグ説明デフォルト
--blueprint NProduction Blueprint（ID 0-9 または名前で指定）0

Blueprint オプション（10プリセット）：

  • 0: Traditional（クラシックなポップ生成）
  • 1: RhythmLock（ドラム＆ベースがメロディに同期）
  • 2: StoryPop（メロディ主導、徐々に盛り上がる）
  • 3: Ballad（静かに始まり、徐々に楽器が増える）
  • 4: IdolStandard（パートが徐々に増え、ラストサビで最高潮）
  • 5: IdolHyper（最初からサビ感、高密度）
  • 6: IdolKawaii（控えめで可愛らしい弾む感じ）
  • 7: IdolCoolPop（四つ打ちでダンスブレイクあり）
  • 8: IdolEmo（静かな始まりから感情的に爆発）
  • 9: BehavioralLoop（中毒性のあるループモード、明示的選択のみ）
  • 255: Auto（重み付きランダム選択）

名前での指定も可能（大文字小文字区別なし）：

bash
./midisketch_cli --blueprint rhythmlock
./midisketch_cli --blueprint ballad

ワークフロー例 ​

BGM先行ワークフロー ​

まず伴奏を生成し、後からボーカルを追加：

bash
# BGMのみ生成
./midisketch_cli --style 5 --skip-vocal -o bgm.mid

# 試聴してボーカルスタイルを決定、ボーカル付きで再生成
./midisketch_cli --regenerate bgm.mid --regenerate-vocal --vocal-attitude 2

高度な生成 ​

新機能を使用した詳細なコントロール：

bash
# ギター有効、アグレッシブなドライブ感、フロントロード型エネルギーで生成
./midisketch_cli --style 6 --guitar --drive-feel 80 --energy-curve 1

# K-Popスタイルでシンコペーションとビヘイビアループを有効化
./midisketch_cli --style 0 --vocal-style 13 --enable-syncopation --addictive-mode

# メロディオーバーライドとモチーフ制御のカスタマイズ
./midisketch_cli --style 3 --melody-max-leap 7 --melody-chorus-register-shift 4 \
  --motif-motion 2 --motif-rhythm-density 2

# ギターを無効化し、モーラタイミングリズムを設定
./midisketch_cli --style 0 --no-guitar --mora-rhythm-mode 1

品質イテレーション ​

生成、分析、critical issueがなくなるまで反復：

bash
# 生成して分析
./midisketch_cli --seed 12345 --analyze

# 問題があれば別のシードを試す
./midisketch_cli --seed 12346 --analyze

# またはパラメータを調整
./midisketch_cli --seed 12345 --vocal-attitude 0 --analyze

バッチ分析 ​

複数ファイルを分析：

bash
for f in *.mid; do
  echo "=== $f ==="
  ./midisketch_cli --input "$f" --json | jq '.summary'
done

出力ファイル ​

標準生成で作成されるファイル：

ファイル説明
output.mid生成されたMIDI（SMF Type 1 or 2）
output.json生成イベントとメタデータ

--analyze 使用時：

ファイル説明
analysis.json不協和音分析レポート

音程リファレンス ​

衝突分析で検出される音程：

半音名称リスク
1短2度 (minor 2nd)高（衝突）
2長2度 (major 2nd)低
3短3度 (minor 3rd)安全
4長3度 (major 3rd)安全
5完全4度 (perfect 4th)安全
6トライトーン (tritone)中
7完全5度 (perfect 5th)安全
8短6度 (minor 6th)安全
9長6度 (major 6th)安全
10短7度 (minor 7th)低
11長7度 (major 7th)高（衝突）

Released under the MIT License.

Copyright © 2024-present libraz