ユーザーガイド

インストール

必要なもの

セットアップ手順

# リポジトリをクローン
git clone https://github.com/Czmirror/MimiLab.git
cd MimiLab

# 依存関係をインストール
npm install

# URL解析用ツール（オプション）
brew install yt-dlp ffmpeg

アプリの起動

npm start

基本的な使い方

ローカルファイルを解析する

  1. アプリを起動
  2. 「ファイルを選択」 ボタンをクリック
  3. MP3, WAV, FLAC などの音声ファイルを選択
  4. 解析結果が自動的に表示されます

URLから解析する

  1. YouTube等の動画URLをコピー
  2. URLフィールドに貼り付け
  3. 「URL解析」 ボタンをクリック
  4. 音声がダウンロードされ、自動的に解析されます

注意: URL解析には yt-dlp と ffmpeg のインストールが必要です。

解析結果の見方

項目 説明
キー 楽曲の調（例: C, A, F# など）。日本語名も表示されます（ハ長調 等）
スケール メジャー（長調）またはマイナー（短調）
信頼度 検出結果の確からしさ（0〜100%）。70%以上が目安です
BPM 楽曲のテンポ（1分あたりの拍数）
スケール構成音 そのキーのスケールに含まれる音名の一覧
ダイアトニックコード そのキーで自然に使えるコードの一覧

対応フォーマット

ローカルファイル

URL（yt-dlp対応サイト）

yt-dlpが対応しているサイトであれば利用可能です。

トラブルシューティング

「yt-dlpが見つかりません」と表示される

brew install yt-dlp ffmpeg

を実行してください。

解析結果の信頼度が低い

アプリが起動しない

# node_modules を削除して再インストール
rm -rf node_modules
npm install
npm start