安裝
Crateforge 支援 Windows / macOS / Linux。最新版可從 GitHub 的 Releases 取得。
截圖稍後補上
下載與發佈形式
Section titled “下載與發佈形式”| OS | 發佈形式 | 備註 |
|---|---|---|
| Windows | 單一 .exe / 可攜式 .zip / .msi / 安裝程式 .exe |
支援應用程式內自動更新 |
| macOS | .dmg（Apple Silicon 原生） |
未簽署。首次需繞過 Gatekeeper |
| Linux | .AppImage（單一檔案） / .deb |
Windows
Section titled “Windows”- 安裝版（安裝程式
.exe/.msi） — 一般安裝方式。 從安裝程式 建立桌面捷徑的選項預設為關閉（如有需要，請於安裝時啟用）。 - 可攜版（
.zip） — 解壓縮後直接執行crateforge.exe即可，無需安裝。
無論哪一種版本，應用程式內更新通常都 只需就地替換 exe 並重新啟動，所以速度很快， 也不會跳出 SmartScreen 警告（v0.6.3 起）。
由於未簽署，首次啟動時會出現 Gatekeeper 警告。請以下列任一方式繞過。
- 在 Finder 中 右鍵點選
.app→「開啟」 - 或在終端機執行
xattr -cr /Applications/Crateforge.app
.AppImage需賦予執行權限後啟動（chmod +x ./Crateforge*.AppImage && ./Crateforge*.AppImage）。.deb以套件管理員安裝。
- 啟動應用程式後會開啟一個空的音樂庫。
- 若你已有既有的
iTunes Library.xml，請用工具列的 「📥 Import XML」 匯入（音樂庫匯入）。 - 若沒有 XML，也可用 「🎵 Add Files」 直接匯入手邊的音樂檔案。
由於音樂庫的真實資料常駐於 SQLite (WAL)，首次匯入後，往後再開啟都會很快。
應用程式內自動更新
Section titled “應用程式內自動更新”當有新的 GitHub Release 發佈時，會在視窗上方以 非阻斷式橫幅 通知你。 發行說明（日英對照）可用摺疊方式檢視。
套用更新時有以下選擇。
- 立即更新 — 下載後就地套用並重新啟動。
- 關閉時更新 — 現在繼續使用，並 在關閉視窗時自動套用（啟動時不會中斷你的工作）。
解析結果、略過次數、智慧型播放清單的條件、同步狀態等，都不包含在 iTunes 相容 XML 之中。
包含這些資料的音樂庫本體（library.db），可在設定的
「一般」→「ライブラリのバックアップ」（音樂庫備份） 中操作。
- 今すぐバックアップ（立即備份） — 保存整個
library.db（可指定保存位置）。 - バックアップから復元…（從備份還原…） — 以選取的備份檔取代目前的音樂庫。 還原前會自動進行完整性檢查，損壞的檔案不會覆蓋現有音樂庫。
- 整合性チェック（完整性檢查） — 檢查
library.db是否損壞（PRAGMA integrity_check）。 - 最適化 (VACUUM)（最佳化） — 回收已刪除資料佔用的磁碟空間並重新整理檔案。 曲目數量很多時可能需要數秒到數十秒。
- 技術情報を再読み取り（重新讀取技術資訊） — 僅針對尚未取得位元率、取樣率、檔案大小與編碼格式的曲目， 從檔案重新讀取（適用於舊版本匯入的曲目）。不會變更您編輯過的曲名等資訊。
- 自動エクスポート時にあわせてバックアップ（自動匯出時一併備份）（預設開啟）— 在 iTunes 相容 XML 的
自動匯出成功時，一併備份
library.db。 自動備份會保留 最近 5 筆，且距離上次未滿 30 分鐘時會略過。
捷徑（桌面）
Section titled “捷徑（桌面）”Windows 的安裝程式 預設不會建立桌面捷徑。 如有需要，請於安裝時的選項中啟用。