Crateforge ドキュメント

Crateforge とは

Crateforge は Tauri 2 + React 19 + Vite 6 + Rust 製の、爆速 iTunes 風 音楽管理デスクトップアプリです。 iTunes Library.xml の取り込み / 書き出し、ローカルファイル取り込み、CD リッピング、プレイリスト編集、ローカル再生に加え、 DJ 向けの解析（BPM / Key (Camelot) / Energy）・類似度選曲・フォーマット変換・スマートプレイリストまで、このアプリ単体で完結します。

旧名は「iTunes Playlist Viewer」です。crate（掘る・集める）+ forge（鍛える・組み上げる）で、解析して選曲しセットを鍛えるという中身を表す名前にリブランドしました。

主要機能

爆速ライブラリ

SQLite (WAL) + 索引で 10,000+ トラックでも快適。リストは仮想化で軽快にスクロールできます。

iTunes XML 互換

入出力とも Apple plist 形式。rekordbox / Serato / Traktor などが読み取れる XML を書き出せます。

DJ 解析

純 Rust の DSP で BPM / Key (Camelot) / Energy / ラウドネスと類似度を解析。Harmonic な「次の一手」を提案します。

ローカル再生

rodio (symphonia) で各種フォーマットを直接デコード。Up Next キュー・シャッフル・リピートに対応。

スマートプレイリスト

条件で中身が自動的に決まるプレイリスト。開くたびに最新の状態へ。

モバイル & リモコン

内蔵 API サーバーでスマホ/TV から再生・リモコン操作。モバイルはオフライン DL / 閲覧 / 再生にも対応。

フォーマット変換

ffmpeg で MP3 / AAC / Opus / FLAC / ALAC / WAV に変換。タグとカバーアートを引き継ぎます。

AI 選曲

ローカル HTTP API を内蔵。Claude Code プラグイン dj-curator から選曲の叩き台を生成できます。

対応 OS

• Windows — .exe / ポータブル .zip / .msi / セットアップ .exe。アプリ内の自動更新に対応（exe をその場で差し替え）。
• macOS — 未署名 の .dmg（Apple Silicon ネイティブ）。初回起動は Gatekeeper を回避する必要があります。
• Linux — .AppImage（単一ファイル）と .deb。

アプリ内の自動更新は Windows 専用 です。macOS / Linux は手動更新になります。

次のステップ

• インストール — ダウンロードから初回起動・自動アップデートまで
• ライブラリ取り込み — iTunes XML / フォルダ取り込み
• 再生・キュー・Crate — Up Next と DJ 選曲の使い方
• DJ 解析 — BPM / Key / Energy / 類似度