Crateforge 文件

從極速 iTunes 風格的音樂管理，到 DJ 解析、相似度選曲、AI 選曲。這一套全部搞定。

什麼是 Crateforge

Crateforge 是一款以 Tauri 2 + React 19 + Vite 6 + Rust 打造的極速 iTunes 風格音樂管理桌面應用程式。除了 iTunes Library.xml 的匯入 / 匯出、本機檔案匯入、CD 擷取、播放清單編輯、本機播放之外，還涵蓋了 DJ 取向的解析（BPM / Key (Camelot) / Energy）、相似度選曲、格式轉換、智慧型播放清單，只用這一個應用程式就能全部完成。

舊名為「iTunes Playlist Viewer」。以 crate（挖掘、蒐集）+ forge（鍛造、組建）重新命名，象徵透過解析來選曲、鍛造一套 set 的核心精神。

主要功能

極速音樂庫

SQLite (WAL) + 索引，即使有 10,000+ 曲目也順暢無比。清單採用虛擬化，捲動依然輕快。

iTunes XML 相容

匯入匯出皆採 Apple plist 格式。可匯出 rekordbox / Serato / Traktor 等軟體能讀取的 XML。

DJ 解析

以純 Rust 的 DSP 解析 BPM / Key (Camelot) / Energy / 響度與相似度。為你提議和聲銜接的「下一手」。

本機播放

以 rodio (symphonia) 直接解碼各種格式。支援 Up Next 佇列、隨機播放、重複播放。

智慧型播放清單

依條件自動決定內容的播放清單。每次開啟都是最新狀態。

行動裝置與遙控

透過內建 API 伺服器，從手機 / TV 進行播放與遙控操作。行動端還支援離線下載 / 瀏覽 / 播放。

格式轉換

以 ffmpeg 轉換為 MP3 / AAC / Opus / FLAC / ALAC / WAV，並沿用標籤與封面圖。

AI 選曲

內建本機 HTTP API。可透過 Claude Code 外掛 dj-curator 產生選曲初稿。

支援的作業系統

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 / 相似度