整理音乐

设置

把磁盘上的音乐收进 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（音乐）只看专辑。手机日历订阅源里它们是全天事件。
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，每个匹配上的文件都会成为对应曲目的文件。