整理音樂

設定

把磁碟上的音樂帶進 HolyArrs、用你的方式替曲目命名，並重新命名或刪除藝人、專輯和曲目。

只有擁有者和管理員看得到這些內容。電影和影集的運作方式大致相同，請見整理電影和整理影集。

匯入你已有的音樂

匯入只會讀取資料夾，不會移動或重新命名任何東西。HolyArrs 預期每位藝人一個資料夾，裡面每張專輯一個資料夾：

Lab Lanterns/Small Hours (2025)/01 - Tide.flac
Lab Lanterns/2019 - Harbour Songs/CD1/01 - Pier.mp3
Lab Lanterns/Lab Lanterns - Night Ferry (2022)/01 - Fog.mp3

開啟 Library > Import a library（媒體庫 > 匯入媒體庫），選擇一個音樂媒體庫資料夾（列為「Music: …」）。
按下 Scan（掃描）。你應該會看到每位藝人，附上信心分數和摘要，例如「12 tracks in 2 albums; 1 file left alone」。
開啟藝人的摘要，檢查每個專輯資料夾、它對應的專輯版本，以及每個檔案對應的曲目。任何被略過的項目都會顯示原因，而且絕不會被動到。
對於在 Unsure 或 Not matched 底下的藝人，按下 Look up（查詢），用名稱或 mbid:<MusicBrainz id> 搜尋。
勾選你要的藝人，按下 Adopt（納入）。你應該會在媒體庫看到每位藝人，檔案都已填好。

專輯資料夾名稱寫成「Album (Year)」、「Year - Album」和「Artist - Album (Year)」都能對應。HolyArrs 會挑曲目數與你的檔案相符的專輯版本。如果那不是常見的專輯版本，專輯的歷史記錄會說明。

變更曲目的命名方式

開啟 Settings > Naming and files > Music names。預設情況下，一張專輯長這樣：

Lab Lanterns/Small Hours (2025)/03 - Harbour Light.flac
Lab Lanterns/Long Night (2025)/2-04 - Second Wind.flac

第二行是兩張光碟的專輯：光碟編號放在前面。格式下方的範例會隨你輸入而變。所有格式和詞彙都在音樂命名參考。

如果 Rename files when they are imported 是關閉的，專輯資料夾仍會依格式命名，但每首曲目會保留原本的檔名。

重新命名檔案

選擇要重新命名的範圍：在專輯或藝人頁面按下 Rename files（重新命名檔案），或開啟 Library > Rename files 處理全部。
閱讀預覽。它會列出每個檔案目前的名稱和新名稱。被略過的檔案會說明原因。
按下 Rename（重新命名）。你應該會在專輯頁面看到新的名稱。

重新命名會完全照預覽所示執行。如果期間命名格式或檔案有變動，就不會重新命名任何東西，並顯示新的預覽。只有 HolyArrs 匯入或納入的檔案會被重新命名。

刪除藝人、專輯或曲目

在藝人頁面按下 Delete（刪除），在專輯頁面按下 Delete album（刪除專輯），或按曲目那一行的垃圾桶按鈕。
閱讀對話框。刪除會完全照它顯示的內容執行。
確認。

選擇	會發生什麼事
預設	檔案留在磁碟上。刪除的藝人會離開媒體庫。刪除的專輯或曲目會留在它的頁面上，且 Keep up to date（保持最新）為關閉。把它重新開啟就能恢復。
Also delete its files（整位藝人）或 Also delete their files（專輯或曲目）	HolyArrs 匯入或納入的檔案，會移到它們所在媒體庫資料夾內的保留資料夾。HolyArrs 只是發現的檔案絕不會被動到。
Add it to the Never-add list（加入永不加入清單）	刪除整位藝人時才會出現。外部清單就再也不能把它加回來。你自己仍然可以。

空的專輯與光碟資料夾會隨檔案一起移除。裡面還有其他東西的資料夾，例如封面或小冊子，會保留。

專輯會出現在哪裡

位置	你會看到什麼
History（歷史記錄）	藝人頁面顯示最新的幾列；All … rows（附數量）會開啟其餘部分。專輯頁面有自己的歷史記錄：搜尋、下載、匯入、重新命名、刪除與專輯版本變更。
Calendar（行事曆）	專輯的發行日，並附上你已有幾首曲目。按下 Music 只看專輯。手機的行事曆 feed 會把它們當成全天事件。
Alerts（通知）	每個專輯下載一則通知，曲目一行一首列出。若要每首曲目各一則，把 Settings > Alerts > Season packs 設成每個各一則通知：最多 25 則單獨通知，再加一則列出其餘的。

檔案被匯入、重新命名或刪除時，你的媒體伺服器只會重新掃描那張專輯的資料夾。

如果沒有成功

**症狀：**掃描在一個你確定有音樂的資料夾裡什麼都沒找到。 **原因：**磁碟機或網路共用資料夾沒有掛載。如果 HolyArrs 已經知道那裡有檔案，掃描時會告訴你。 **解決方式：**把它掛載起來，再掃描一次。

**症狀：**一個專輯資料夾被略過。 **原因：**它的名稱對不到這位藝人的任何專輯，或它屬於你排除的專輯類型，例如單曲或現場專輯。 **解決方式：**把資料夾重新命名為「Album (Year)」再掃描一次，或使用 Look up。

**症狀：**檔案被略過。 **原因：**它們的名稱和標籤沒有指向單一曲目。 **解決方式：**修正名稱或標籤，再掃描一次。

**症狀：**重新命名時又顯示預覽。 **原因：**預覽之後有東西變了。 **解決方式：**檢查新的預覽，再按一次 Rename。

給進階使用者

媒體庫的每日檢查

HolyArrs 每天會檢查一次磁碟上的媒體庫：

消失的曲目檔案會標示為遺失。歷史記錄會寫出藝人、專輯和曲目。
回來的檔案會重新標示為存在。
藝人資料夾裡新出現的音訊檔會記為已發現。它不會自動填入任何曲目，也絕不會被重新命名、移動或刪除。
如果整個媒體庫資料夾不見了，或所有檔案同時消失，HolyArrs 會警告你，而且不會把任何東西標示為遺失。

匯入分組與查詢

藝人會落在 6 個分組之一：Matched、Unsure、Not matched、Already in the Library、On the Never-add list、No audio file。每個藝人資料夾都會依名稱到 MusicBrainz 查詢。納入時，專輯和專輯版本來自 MusicBrainz，每個對應到的檔案都會成為該曲目的檔案。