跳到內容
Crateforge Docs

音樂庫匯入

要將音樂庫匯入 Crateforge，可從 iTunes / Music 的 Library.xml 或 手邊的音樂檔案 任一方式進行。

截圖稍後補上

匯入 iTunes / Music 的 Library.xml

Section titled “匯入 iTunes / Music 的 Library.xml”

從工具列的 「📥 Import XML」 選取 iTunes Library.xml（Apple plist 格式）。

  • 採用串流 SAX 剖析器讀取，即使是大型音樂庫也很快。
  • 匯入透過串流解析進行，重現曲目、播放清單、資料夾階層（Persistent ID / Parent Persistent ID）。
  • 匯入會以 整個音樂庫的取代 方式進行（尚不支援對既有 XML 的差異合併）。

Library.xml 的位置

Section titled “Library.xml 的位置”
  • macOS — 在「音樂」應用程式的偏好設定中啟用「共享 XML」即可匯出（舊版 iTunes 為 ~/Music/iTunes/iTunes Library.xml）。
  • Windows — 通常位於 %USERPROFILE%\Music\iTunes\iTunes Library.xml。

匯入音樂檔案

Section titled “匯入音樂檔案”

從工具列的 「🎵 Add Files」，可直接匯入手邊的音樂檔案（可多選）。

  • 支援格式：FLAC / MP3 / M4A / WAV / Ogg / Opus / AIFF 等。
  • 以 lofty 讀取標籤（標題 / 演出者 / 專輯 / 類型 / 年份 等）。
  • 匯入時也會讀取 BPM 標籤（TBPM / tmpo / Vorbis BPM）。

整個資料夾匯入（Add Folder / 拖放）

Section titled “整個資料夾匯入（Add Folder / 拖放）”

從工具列的 「Add Folder」（視窗較窄時會在 ⋯ 選單中）選擇資料夾後，會 連子資料夾一併遞迴掃描， 把支援格式的檔案整批匯入。往視窗 拖放 也是同一條路徑，可以把檔案與資料夾混在一起丟進來。

  • 只會匯入支援副檔名的檔案（其餘會被忽略）。
  • 隱藏檔案 / 隱藏資料夾（以 . 開頭）會被略過（例如 .DS_Store）。 但你自己明確指定的檔案，即使是隱藏檔也會匯入。
  • 已經在音樂庫中的檔案（相同路徑）會被略過，同一個資料夾丟幾次都不會重複登錄。
  • 符號連結的迴圈會被偵測並中止；讀不到的資料夾會跳過並繼續。
  • 結果會以 toast 顯示「匯入的件數 / 因已匯入而略過的件數 / 失敗的件數」。
  • 匯入的曲目會累積在側邊欄的 Inbox，可以從那裡評分與加入 Crate。

整理目標資料夾（音樂庫根目錄）（自動整理）

Section titled “整理目標資料夾（音樂庫根目錄）（自動整理）”

在設定中指定「整理目標（音樂庫根目錄）」後，匯入與編輯時會將檔案以 iTunes 慣例的命名方式 放置到 <整理目標>/<專輯演出者>/<專輯>/。

使用設定中的 「自動偵測」，可從既有曲目的路徑推測並設定整理目標。

標籤寫回檔案

Section titled “標籤寫回檔案”

編輯曲目（Get Info / Ctrl + I）時，除了更新資料庫，也會 寫回實體檔案的標籤（ID3 / Vorbis / MP4）。 不需要設定整理目標資料夾，即使未設定也會寫回標籤（只有在有設定時才會另外進行資料夾搬移與重新命名）。

寫回的內容還包含以下項目。

  • BPM — 以整數寫入 TBPM（ID3v2）/ tmpo（MP4）/ BPM（Vorbis Comments）。 優先採用曲目自身的 BPM，未設定時則採用解析結果。
  • Key — 寫入 InitialKey（ID3v2 TKEY / MP4 initialkey / Vorbis INITIALKEY）， 使用的是音樂記法（Am / F#m / C 等）而非 Camelot，因為 rekordbox / Serato / Traktor 讀的正是這種記法。 若有手動覆寫的 Key 則優先使用，否則使用解析結果。

從音樂庫刪除曲目 / 開啟檔案位置

Section titled “從音樂庫刪除曲目 / 開啟檔案位置”

在曲目上按右鍵，可進行以下操作。

  • 「Finder / エクスプローラで表示」（在檔案管理員中顯示） — 以作業系統的檔案管理員開啟該曲目的檔案 （macOS 會在 Finder 中選取，Windows 會在檔案總管中選取，Linux 則開啟上層資料夾）。
  • 「ライブラリから削除…」（從音樂庫刪除…） — 將選取的曲目從音樂庫（資料庫）刪除。 在確認對話框中勾選 「連檔案一起刪除」，也可以刪除實體檔案。 正在播放或已排入佇列的曲目會停止播放並從佇列移除。

修復找不到的檔案（失效連結）

Section titled “修復找不到的檔案（失效連結）”

因外接硬碟或 NAS 未連接、或在 Finder 中移動了檔案等原因而找不到實體檔案的曲目，會顯示為「見つかりません」（找不到）。

  • 「リンク切れを再チェック」（重新檢查失效連結）（位於工具列右側；視窗較窄時在 ⋯ 選單內）— 重新確認 所有曲目的檔案是否仍然存在。檔案消失的曲目會標為找不到，重新連接硬碟等而恢復的曲目則會回到正常狀態。 進度與結果（「N 曲のファイルが見つかりません」— 有 N 首找不到檔案）會顯示在工具列下方。
  • 在搜尋框輸入 missing:yes，即可只列出找不到檔案的曲目（missing:no 為檔案存在的曲目）。
  • 在曲目上按右鍵 → 「ファイルの場所を指定…」（指定檔案位置…）（選取 1 首時）— 在檔案選擇對話框中 選取新位置的檔案，即可將該曲目改指向它。播放次數、評分、播放清單與解析結果都會保留。 檔案並未遺失的曲目也可以改指向其他檔案。

匯出 iTunes 相容 XML

Section titled “匯出 iTunes 相容 XML”

從工具列的 「📤 Export XML」，可匯出 iTunes Library.xml（Apple plist 格式）。 可交給 rekordbox / Serato / Traktor 等能讀取 iTunes XML 的 DJ 軟體。

匯出的 XML 包含以下內容。

  • Major/Minor Version / Date / Application Version / Library Persistent ID 標頭
  • Tracks 字典（Track ID 鍵，所有欄位）
  • Playlists 陣列（依 Persistent ID / Parent Persistent ID 的資料夾階層，以 Playlist Items 參照 trackId）
  • 字串會將 & < > 以數值字元參照跳脫，檔案路徑則 percent-encode 為 file:// URL

自動匯出

Section titled “自動匯出”

將工具列的 🕐 切換鈕 開啟後，會在 僅在有變更時、約每 30 分鐘一次＋結束時 自動匯出 Library XML。想要隨時把最新的音樂庫交給 DJ 軟體時很方便。

自動匯出成功時，也會一併自動備份 library.db （可在設定的音樂庫備份中切換）。

從 CD 匯入（擷取）

Section titled “從 CD 匯入（擷取）”

從工具列的 「💿 Rip CD」，可匯入實體 CD（以 MusicBrainz 取得曲目資訊、以 Cover Art Archive 自動取得封面）。

  1. 選擇 Drive 並按「🔍 Detect Disc」。會自動列出已連接的光碟機（Windows 如 E:，Linux 如 /dev/sr0 / /dev/cdrom），並記住上次成功讀取的光碟機作為下次的預設。若清單中沒有，可選「その他…」（其他）手動輸入（偵測不到時的預設為 Linux：/dev/cdrom、macOS：disk1、Windows：D:）

    應用程式執行中會自動監看光碟機：放入 CD 時會顯示「CD を検出しました」（偵測到 CD）對話框，按「取り込む」（匯入）即會以該光碟機開啟 Rip CD。

  2. 讀取 TOC 後，自動顯示 MusicBrainz 的候選專輯

  3. 視需要重新選擇發行版本，並選取曲目

  4. 指定 Format（FLAC / ALAC / MP3 / WAV）與 Output 資料夾後按「▶ Start Ripping」

  5. 擷取期間，畫面右下（播放列上方）會出現進度卡片，可查看整體進度條、「第幾首/總曲數」、目前曲目與階段（讀取中 / 編碼中）。點擊卡片（或按 Enter）可開啟記錄

  6. 完成後自動加入音樂庫（選項開啟時）。完成時會播放簡短提示音（失敗時為較低的音）。可在 設定 → 一般 →「CD 取り込みの完了音」 關閉

在 CDJ 上使用匯入的曲目

Section titled “在 CDJ 上使用匯入的曲目”

匯入曲目的播放清單可以匯出到 CDJ / XDJ 用的 USB，也可以一併匯出 Traktor 的 Cue / 格線。詳見 USB 匯出（CDJ / rekordbox 相容）。