# Music Analyzer

Windows 10 / 11専用のローカル音楽解析アプリです。ユーザー向け対応形式はMP3のみです。音源は外部へ送信せず、外部APIやクラウド処理を使用しません。

MP3のデコードにはWindows標準のWindows Media Foundationを使用し、22,050Hz・モノラル・16bit PCMの一時WAVへ変換して既存Python解析へ渡します。一時WAVは正常終了・失敗・キャンセル時に削除します。

Windows Nエディションでメディア機能を利用できない場合は、MicrosoftのMedia Feature Packをインストールしてください。

## 開発とビルド

```powershell
npm install
python -m pytest
npm run build
cargo check --manifest-path src-tauri/Cargo.toml
npm run tauri build
```

Python sidecarは`src-tauri/binaries/music-analyzer-sidecar-x86_64-pc-windows-msvc.exe`です。配布版の利用者にPython環境は不要です。

## 解析と保存

BPM、拍位置、キー、メジャー/マイナー三和音、波形、拍コード、主要コード、代表コード進行を推定します。結果は推定であり、正確性を保証しません。拍子は現在4/4のみです。

BPMは自己相関方式で推定するため、自己相関ピークが曖昧な音源や複雑なリズムでは半テンポ／倍テンポになる場合があります。その場合はアプリの設定から補正できます。

TXTはUTF-8 BOM付き、JSONと`.musicana`はschemaVersion 3のUTF-8 JSONです。解析、再生、保存はローカルで完結します。