开始使用

Ansuz 不浏览文件夹：它读取一次你音乐的标签，建立目录，然后在此基础上搜索、排序和播放。从 ⌘O 或文件 › 添加文件夹…开始，选择一个或多个文件夹，可以在本地、外置硬盘或已挂载的 NAS 上。每个文件夹是一个来源，在边栏中以一个卢恩符文图标显示，右键单击可以更换。边栏的每个部分（资料库、来源、播放列表、Apple Music、Spotify）都可以通过悬停时出现在标题右侧的箭头折叠；Ansuz 会记住你关闭了哪些。

Ansuz 从不擅自修改你的文件。它生成的一切（索引、缩略图、缓存）都存放在自己的文件夹中。

首次扫描先统计文件数，再读取每个文件，进度和剩余时间按该总数计算；之后的扫描只比较大小和日期，非常快。如果在扫描进行中退出 Ansuz，下次启动会重新统计并比较整个来源，但只读取尚未读取的标签；扫描完成后，打开应用不会再启动新的扫描。在扫描进行中退出时，Ansuz 会先提醒并让你选择。本地文件夹会被自动监视；网络文件夹从来源的菜单重新扫描。如果来源未挂载，其曲目会保持灰色直到它回来。如果你把收藏移到了另一块硬盘或 NAS，使用来源菜单中的重新定位…：评分、播放列表和历史都会保留。

需要服务器密码。Ansuz 会用钥匙串中的密码自动装载网络文件夹，不显示任何对话框。如果钥匙串里没有密码（例如你把 NAS 从 AFP 改成了 SMB），该来源会留在边栏中并标注需要服务器密码，把指针停在上面会有帮助标签说明该怎么做。右键点按该来源 › 在“访达”中连接…会打开连接并填好你的用户名：输入密码并勾选在我的钥匙串中记住此密码。之后 Ansuz 会自动装载它。如果服务器完全没有响应（你在另一个网络，或服务器已关机），该来源会像往常一样变为不可用。

来源信息。右键点按一个来源（在边栏中，或在文件夹视图最上层的图标上）› 来源信息…，会打开一个窗口，顶部是它的符文，并显示关于它的一切：资料库所知的信息（歌曲、缺失的文件、专辑、艺人、总时长、大小、在 Ansuz 中有歌词的歌曲，以及各种格式及其所占空间），文件夹中按类型划分的文件（歌曲、.lrc 歌词、图像和其他文件，数量和占用空间），它的位置（文件夹、是内置、外置还是网络磁盘以及哪台服务器、宗卷及其可用空间），以及存放它的磁盘（型号、SSD 或机械硬盘、连接方式和 SMART 状态）。统计文件需要遍历整个文件夹，在歌曲很多的 NAS 上要花几分钟，因此 Ansuz 会保存上次统计的结果和日期，只有在你点按重新统计时才会重新统计。不可用的来源会显示资料库所知的信息和上次统计的结果。

符文。每个来源的符文都按 Ansuz 标志的样式绘制：黑色方块上的金色符文。在文件夹视图中，来源以大图标显示，还带有金色边框，并在符号下方显示符文名称；右键点按 › 更换卢恩符文可选择其他符文。关闭显示不可用的来源时，不可用的来源会从所有地方消失：歌曲和专辑、流派列表及其计数，以及文件夹视图。

资料库

• 评分和喜欢。歌曲表格有一列评分，显示五颗星（单击一颗星评分，再次单击同一颗星清除）和一个喜欢的心形。两者也在行的右键菜单中，可同时用于多行，并且可以按评分排序。连接 Last.fm 后，喜欢一首歌也会在那里标记为喜欢。
• 歌曲显示表格。单击表头按该列排序；排序按钮提供最多四个层级（艺人，然后年份，然后专辑…）并会被记住。右键单击表头选择显示哪些列；BPM、调性和专辑艺人各有自己的列。
• 专辑显示封面网格，有自己的四层排序。单击一次打开专辑页面：大封面、详情、播放、随机播放、下一首播放和曲目列表。在那里双击封面可放大查看，呈现文件中图像的完整质量。双击艺人名称可查看其所有专辑（作为专辑艺人的专辑及其参与的专辑）；后退回到原来的位置。字段菜单选择每个封面下方显示什么：标题、专辑艺人、艺人、年份、歌曲数、时长、播放次数或添加日期。右键单击封面会出现一个菜单，包含播放、随机播放、下一首播放、添加到队列、编辑标签，以及限于该碟片的资料库任务：重新读取标签、重新扫描专辑文件夹（只扫描这些，几秒完成：添加新内容，标记缺失的内容，并合并服务器现在以另一个名称显示的歌曲）、查找封面、识别、分析 BPM 和调性、计算 ReplayGain。在专辑页面右键点按封面也会出现同样的菜单。多张光盘的专辑会像 Apple Music 一样按光盘分组显示歌曲。
• 搜索在两种视图中都会随着你的输入按标题、艺人、专辑和流派筛选。
• 播放列表：边栏的 + 创建一个；右键单击一首或多首曲目将其添加。
• 没有标签的曲目（WAV、DFF、只有部分标签的文件）会从文件夹和文件名中获取艺人、专辑、年份和曲目编号，例如 艺人 - 专辑 (年份)/01 - 标题；已有的标签总是优先。
• 边栏中的最近添加列出最近添加到资料库的 100 张专辑，最新的在前。
• 边栏第一项、也是 Ansuz 打开时显示的首页，把你每天听的东西放在手边：在整个收藏上方以书架显示收藏、最近播放和最常播放的专辑，全部在同一个滚动中。每排书架可以横向滚动；查看全部以网格打开。用专辑页面上的心形或封面菜单中的添加到收藏收藏专辑；这是资料库中的标记，不会修改文件。最常播放合计专辑中歌曲的播放次数；最近播放取其中任意一首最后播放的时间。
• 封面来自文件或文件夹中的 cover.jpg；如果都没有，则来自 Cover Art Archive 和 Last.fm。

重命名或移动的文件夹。在一个来源内重命名或移动文件夹时，Ansuz 会按文件名、大小和日期识别其中的歌曲：它们仍是同样的歌曲，评分、播放列表和播放记录都会保留。同一文件夹中以另一个名称出现的文件也是如此：通过 SMB 共享的 NAS 无法传送含有“?”或“:”的名称，会给它们一个短名称，例如 0HCQHK~2.M4A。下次扫描时（来源菜单中的重新扫描，或 ⇧⌘R），旧歌曲和新歌曲会重新合为一首，保留两者的一切。macOS 不允许读取的子文件夹（NAS 的 #recycle 回收站、其他用户的文件夹）会被跳过，其中的歌曲不会被标记为缺失。

艺人显示专辑艺人及其照片，照片载入前显示其专辑封面。右侧字母可跳到任意字母，工具栏搜索可筛选列表。艺人页面包含简短介绍、播放和随机播放、由新到旧的专辑，以及你资料库中的相关艺人。 专辑、EP、单曲、精选集和合辑分栏显示。类型根据标题和时长判断：不超过 3 首为单曲，不超过 6 首为 EP，且都短于 30 分钟。

同名艺人。两支同名的乐队在标签里是同一位艺人。Ansuz 用一个限定词把它们分开，限定词以灰色显示在名字旁边，绝不会随 scrobble 发送，也不会用于在线搜索，但资料库搜索会用到它：airbag argentina 只会找到这个 Airbag。在以下情况下会自动分开：文件带有 MusicBrainz 艺人 ID；艺人的文件夹名为“名字 (某某)”，例如“Airbag (argentina)”；或者与 MusicBrainz 匹配专辑时发现某张唱片属于另一位同名艺人。要手动操作，请右键点按专辑 › 拆分艺人…，或使用“艺人”面板中的 ⋯ 按钮：选择属于另一位艺人的专辑并填写限定词。你的选择会被记住，并优先于其他依据；把专辑移回没有限定词的艺人即可重新合并。此后每位艺人都有自己的简介、照片和近期演出。你的文件绝不会被更改。

断开来源。要出门，而 NAS 或外置硬盘留在家里？右键点按来源 › 断开连接。Ansuz 不会打扰已断开的来源：启动时不查找它，不尝试挂载共享（因此 macOS 不会弹出连接对话框），也不扫描或监视它。它的歌曲仍留在目录中，与任何不可用来源的歌曲一样，按你的设置隐藏或显示为灰色。来源仍在边栏中，标记为已断开；回来后，右键点按 › 连接，Ansuz 会检查并重新扫描它。

类型。歌曲的类型是一个列表。Ansuz 读取文件中所有的 GENRE 值，并会拆分写成一段文字的类型（“Chillout, Lounge, Downtempo”“Pop/Rock”“House|Deep House”），因此一首歌会计入它的每一个类型。边栏中的类型列出全部类型及其歌曲数量；搜索栏可以缩小列表，点按某个类型即可打开按该类型过滤的资料库。类型还会以按钮形式出现在专辑页面和曲目信息窗口中；歌曲表格有流派一栏（右键点按表头即可显示），专辑网格有流派字段，搜索也能按任一类型找到歌曲。在智能播放列表中，“流派 是 Rock”会匹配标签为“Pop, Rock”的歌曲。在标签编辑器中，专辑的流派栏会填入所有曲目，每首曲目也有自己的一栏；用逗号分隔写入多个类型，保存时会写成各自独立的值。

发行日期。只要知道完整的发行日期，专辑就会带上它，而不只是年份：专辑页面标题下方显示“1995年3月12日”，专辑网格中每张封面下方也可以显示发行日期字段。Ansuz 从文件的 DATE 标签读取（RELEASEDATE 或 ORIGINALDATE 落在同一年时也会采用）；当标签里只有年份时，与 MusicBrainz 匹配专辑会补上月份和日期；其他年份的日期绝不会替换你的。按年份排序时，同一年内的专辑按发行先后排列。在标签编辑器中，发行日期字段可以只填年份、年月或完整日期（1995、1995-03 或 1995-03-12），并写入每一首歌曲。专辑检查器会把 MusicBrainz 的日期列为可以接受的差异，“封面 - PDF”会把它印在歌本和背面插页上。

合辑。边栏中的合辑只显示标签标记为合辑的专辑：设置了合辑标记（COMPILATION = 1，即大多数标签工具中的“合辑的一部分”复选框），或专辑艺人为“Various Artists”、“Varios Artistas”或“Various”的专辑。Ansuz 不会根据内容猜测：以厂牌名称归档的厂牌精选集，除非你标记它，否则不会出现在这里。要标记一张专辑，请打开标签编辑器并启用合辑。

按专辑艺人组成专辑。Ansuz 按标签中的专辑艺人组成每张专辑，而不是按每首歌的艺人。标签中没有专辑艺人时，按文件夹判断：同一文件夹中专辑名相同的歌曲属于同一张专辑。只要其中有一首带专辑艺人，就用于全部歌曲；否则取多数歌曲的艺人（“feat.”计入主艺人），没有多数时专辑显示为群星。这不会把它加入合辑，那里仍只显示标签标记的专辑。

大型资料库。Ansuz 为多达一百万首曲目的收藏而设计。曲目表格、专辑网格、文件夹视图和搜索从不加载整个收藏：它们只向数据库请求屏幕上显示的内容，所以滚动到表格末尾和查看开头一样快。本地文件夹会被监视，文件发生变化时只重新读取它所在的文件夹。只输入一个字母或数字的搜索不会筛选（在一百万首曲目中几乎会全部匹配）；从第二个字符起才会筛选。播放列表很大时，iPhone 会分批同步，只取回有变化的内容。

文件夹视图

除了歌曲和专辑，文件夹视图按音乐的存放方式来浏览：每个来源就是一个文件夹，进入后看到的就是你在访达中看到的那些文件夹。它有访达的三种显示方式，在路径栏右侧选择：图标（文件夹显示其中音乐的封面）、列表（用三角形就地展开文件夹）和分栏（每一级一栏，并预览所选歌曲）。双击文件夹可打开，双击歌曲则连同该文件夹的其余歌曲一起播放。后退和前进箭头以及路径栏用来来回跳转，搜索栏按名称过滤当前文件夹。右键点按文件夹可播放、随机播放、加入队列、用它创建播放列表、对尚未完成的歌曲分析 BPM 和调性或计算 ReplayGain，或者在访达中显示；歌曲则有平常的菜单。任何歌曲的菜单和播放器的 ⋯ 菜单中的前往文件夹会跳转到包含它的文件夹。

文件夹视图来自资料库索引，而不是磁盘：磁盘或共享断开时它也能用，并且只显示 Ansuz 已索引的音频文件。在边栏中选中某个来源时，视图会停留在该来源内。

分栏浏览

窗口顶部栏中的第四种模式，排在歌曲、专辑和文件夹之后，是分栏：一步一步缩小资料库的范围。上方是并排的二到五栏，下方是所选内容的歌曲表格。每一栏列出某个字段的取值，范围是左边各栏筛选后剩下的歌曲，并显示每个取值有多少首歌曲。全部总在最上面，最下面的未知、未评分或群星汇集缺少该信息的歌曲。按住 ⌘ 点按可在同一栏中选择多个取值。连按一个取值会播放它筛选出的全部歌曲，右键点按则提供播放、随机播放、下一首播放和添加到队列；下方的表格保留平常的菜单。 要在不离开此视图的情况下更正错误的风格（或其他任何标签），请右键点按“专辑”栏中的专辑或表格中的歌曲，然后选取编辑标签…：专辑的标签编辑器会在上方打开，存储后各栏会重新计数。保存会把更改保留在资料库中；要写入文件，需要在设置 › 资料库中打开允许编辑文件中的标签。

共有十四个字段可选：流派、艺人、专辑艺人、作曲、专辑、年份、年代、格式、采样率、来源、评分（星级）、喜欢、调性和 BPM（每十为一档）。各栏保存在有名称的配置中：栏上方横条里的菜单可在配置之间切换，编辑栏…可以重命名当前配置、选择每一栏的字段、复制或删除它，或用恢复默认找回自带的配置。自带四种：流派（流派 → 专辑艺人 → 专辑）、作曲（作曲 → 年份 → 专辑）、年代（年代 → 专辑艺人 → 专辑）和音频质量（格式 → 采样率 → 专辑艺人 → 专辑）。

分栏浏览在边栏所选的范围（全部音乐、某个来源…）和搜索结果之内进行；如果资料库隐藏了重复版本，这里也会略过它们。所有计数都在资料库数据库中完成：即使有一百万首歌曲，第一栏也只需零点几秒，后面的栏几乎即时出现。

播放列表

通过边栏中的 +、文件 › 新建播放列表…（⌘N）或歌曲菜单中的从所选内容新建播放列表…创建播放列表。通过该菜单中的添加到播放列表或把行拖到边栏的播放列表上来添加歌曲；如果有些已经在里面，Ansuz 会询问是仍然添加还是跳过。在播放列表内，拖动行以重新排序，按 Delete 移除。右键单击播放列表可以播放、随机播放、下一首播放、添加到队列、重命名、复制、导出或删除它；拖动播放列表可以调整边栏顺序。标题栏显示歌曲数量和总时长。队列面板中的保存为播放列表…可以保留你即将收听的内容。

智能播放列表（+ › 新建智能播放列表…，⌥⌘N）根据规则自动填充并始终保持最新：匹配全部或任一条件，可基于标题、艺人、专辑、流派、年份、评分、喜欢、播放次数、最近播放、添加日期、时长、BPM、调性、格式、歌词、识别、封面、可用性或来源；还可以按歌曲数、分钟、小时或兆字节限制，随机选取或按某个字段选取，并选择顺序。编辑器会实时显示匹配的歌曲数量。编辑规则…在标题栏和菜单中。

文件：导出…以绝对路径写入 M3U8、PLS 或 XSPF（按扩展名选择）；导入播放列表…读取这些格式，在你的来源中按路径查找每首歌曲，找不到时按艺人和标题查找，并在创建播放列表前显示找到的内容。

播放列表的分析。在边栏中右键点按播放列表 › 分析 BPM 和调性或计算 ReplayGain，只对其中尚未分析的歌曲执行该分析，这样很长的列表不会重做已完成的工作。要重做某一项，请使用歌曲或专辑的菜单。

从“音乐”或 iTunes 迁移

多年积累的评分、播放次数和播放列表不必留在原地。在“音乐”中选取文件 › 资料库 › 导出资料库…并存储 XML；在 Ansuz 中，文件 › 从“音乐”导入…会读取它（iTunes 导出的也是同样的文件）。歌曲按文件路径匹配，所以请先添加这些音乐所在的文件夹。如果文件夹后来移动了位置（NAS 挂载到了别处，或收藏拷贝到了新磁盘），Ansuz 仍能通过路径的后半部分找到歌曲，磁盘未连接时也可以。不是磁盘文件的歌曲（Apple Music、流媒体）会被略过。

在写入任何内容之前，你会看到找到了多少首歌曲、未找到歌曲的示例，以及可以带过来的内容：评分（仅限你在 Ansuz 中还没有评分的歌曲，除非你要求替换；“音乐”根据专辑评分计算出的评分会被忽略）、喜欢、播放次数、跳过次数和上次播放日期，以及你的播放列表，每个列表都会标明找到了其中多少首歌曲。文件夹会成为名称的一部分（“聚会 / 婚礼”），智能播放列表会带着它今天包含的歌曲过来，而名称在 Ansuz 中已被使用的播放列表，只有在你勾选时才会被替换。

“音乐”中的播放次数会加到 Ansuz 的次数上，Ansuz 会记住每首歌曲已经取过多少次：以后导入更新的导出文件时，只会加上差额。不会向你的文件或“音乐”资料库写入任何内容。

统计

边栏中的统计显示你一直在听什么。选择一个时间段（7 天、30 天、90 天、12 个月或全部时间），就能看到播放次数及其相对上一时段的变化、收听时长，以及播放过多少不同的艺人、专辑和歌曲；一张播放次数随时间变化的图表；最常听的艺人、专辑、歌曲和类型（前 10、25 或 50 名），每项都带有条形；以及按年代、按一天中的时段和按星期统计的播放次数。点按专辑可打开它，点按歌曲可在资料库中找到它，点按类型可浏览它，点按艺人可搜索该艺人。你还能看到在该时间段内首次播放的艺人、当前和最长的连续听歌天数，以及艺人名字旁的照片；导出…会把所有内容存储为可用电子表格打开的 CSV 文件。

一次播放是指按 Last.fm 的规则完整听过：歌曲的一半或四分钟。一首歌曲会计入它的每一个类型。对于某个时间段，一切都来自 Ansuz 保存的带日期的历史记录。“全部时间”使用播放计数器，因此也包含你从“音乐”导入的内容；按日期、时段和星期的图表只统计在 Ansuz 中播放的内容。底部的资料库会告诉你收藏中有多少从未播放过，还有一个按钮可以创建恰好包含这些歌曲的智能播放列表。

播放

随机播放和重复。播放器栏中的两个按钮。随机播放保持当前歌曲在前并打乱其余歌曲；关闭它会恢复顺序，开启期间每个新队列都以随机顺序开始。重复循环于关闭 → 整个队列（播放列表或碟片）→ 单曲之间。两者都会被记住。

迷你播放器与菜单栏。 一个紧凑的浮动窗口（窗口 › 迷你播放器，⇧⌘M），显示封面、歌曲、控制按钮、进度和音量，始终位于其他窗口之上。菜单栏中也有 Ansuz：正在播放的歌曲，以及上一首、播放/暂停和下一首，一键可达。

载入时。歌曲需要一点时间才开始时（网络磁盘繁忙、磁盘正在唤醒），播放按钮会显示活动指示器，播放栏显示所请求的歌曲并在下方显示正在载入…，直到开始播放。无需再次点按：再次请求同一首歌不会让它重新开始。如果在载入时暂停，歌曲打开后会保持暂停、准备就绪（播放栏显示正在载入…（已暂停））。用进度条跳到歌曲的其他位置时，以及用 iPhone 控制 Mac 时，也是如此。

双击曲目播放它，并把可见列表的其余部分加入队列。底部栏有上一首、播放/暂停、下一首、进度（单击可跳转）和音量；单击扬声器静音。曲目之间无缝播放；在设置 › 通用中可以设置最多 12 秒的淡入淡出，让每首曲目的结尾淡入下一首的开头（来自同一碟片镜像的曲目之间从不淡入淡出）。

无缝播放，精确到采样。未开启淡入淡出时，如果相邻两首歌曲格式相同（采样率和声道数），第二首会从第一首最后一个采样之后的那个采样开始播放，并从第一个采样起就使用自己的 ReplayGain：现场专辑和连续混音可以一气呵成。如果文件在歌曲中途无法读取（例如 NAS 断开），播放会停止并给出提示，而不是把整个队列快速跳完；磁盘恢复后点按“播放”即可。

格式：MP3、AAC、ALAC、FLAC、WAV、AIFF、Ogg Vorbis、Opus 以及 DSD（DSF 和 DFF），Ansuz 会在播放时把 DSD 转换为高分辨率 PCM。另外还支持 APE（Monkey's Audio）、WavPack、Musepack、WMA、TTA、TAK、Shorten、RealAudio、ATRAC 和 TrueHD：macOS 无法解码的格式由 FFmpeg 解码，它作为可替换框架内置在应用中；无损格式听起来与原始文件完全相同，逐个采样一致。键盘媒体键、控制中心和耳机可以控制播放。DTS-CD（WAV 或 FLAC 中的 DTS 比特流）通过同步字识别，显示为“DTS”，并由 FFmpeg 的 DTS 解码器解码，该解码器作为可替换的框架随应用一起提供；除非输出设备有更多声道，5.1 碟片会缩混为立体声。

音量均衡（ReplayGain）。“设置 › 通用 › 音量均衡”读取文件中已有的 REPLAYGAIN 标签（来自 foobar2000、MusicBrainz Picard、mp3gain 等），让每首曲目以相近的响度播放。“曲目”把一切拉平；“专辑”保留同一张唱片内的音量差异；“自动”在队列中上一首或下一首来自同一专辑时使用专辑增益，否则使用曲目增益。前置放大在此基础上增减分贝，“防止削波”把增益限制在标签中记录的峰值。没有标签的曲目按原样播放。为缺少标签的文件计算数值是一项计划任务，见下文。

BPM 和调性。速度和调性从标签（BPM、INITIALKEY）读取，并显示在曲目信息窗口（⌘I）中；调性可以用传统写法（F♯m、B♭）或 Camelot 轮（11A、6B）显示，在“设置 › 通用”中选择。

⋯ 菜单。进度条旁边的 ⋯ 按钮集中了针对正在播放的歌曲的操作：曲目信息、添加到播放列表（或新建列表）、喜爱与评分、前往专辑、前往歌曲（在歌曲表格中显示它），以及只针对这首歌的资料库任务：补全标签、重新读取标签、分析 BPM 和调性和计算 ReplayGain。任何歌曲的右键菜单里也有同样的任务，在专辑页面里也一样。

音频输出

在设置 › 音频中，或使用音量滑块旁的输出按钮（它显示设备的图标），你可以选择 Ansuz 从哪里播放：系统输出跟随 Mac 当前使用的输出，或者选择一个设备（USB DAC、耳机、内建扬声器）。只有 Ansuz 从这里播放；其他所有应用继续使用系统输出。Ansuz 会在每次启动之间记住该设备。

• 让采样率匹配每个文件（默认开启）：设备切换到文件的采样率，44.1、48、96 kHz……，因此不做任何转换。如果设备不支持该采样率，Ansuz 使用最接近的整倍数采样率（例如 44.1 对应 88.2）。相同采样率的曲目之间保持无缝；两首曲目的采样率不同时，设备切换期间会有短暂的停顿。
• 独占模式（默认关闭）：只要 Ansuz 载入了曲目，其他应用就无法通过该设备播放，连系统声音也不行。播放停止时即释放。有些设备（例如聚集设备）不允许独占；设置中会注明。
• 音量：如果所选设备有自己的音量控制，Ansuz 的滑块会调节它，音频以满幅数字电平到达设备。切换到这类设备时，Ansuz 会沿用设备原有的音量。
• Bit-perfect：当设备原封不动地收到文件的采样时，音量旁的标签会变成绿色。标签为灰色时，其提示会说明是什么改变了采样：不同的采样率、Ansuz 音量低于最大值、ReplayGain、淡入淡出、DSD 或 DTS 转换为 PCM、多声道缩混为立体声、文件位深超过设备所能接受的位数，或 Bluetooth 和 AirPlay。
• 原生 DSD (DoP)：如果你的 DAC 接受 DSD over PCM (DoP)，请在“设置 › 音频”中为它打开以原生方式 (DoP) 将 DSD 发送到；设备支持 176.4 kHz 时才会出现此选项。这样 DSF、DFF 和 SACD 文件就会以原始的 1 位流送到 DAC，从 DSD64 到 DSD256，不经转换。以这种方式播放 DSD 时，Ansuz 会以独占模式使用设备，并且不改动采样：不使用 ReplayGain 和交叉淡入淡出，音量滑块只有在设备有自己的音量控制时才起作用。音量旁的标签显示 DSD · DoP。只为支持 DoP 的 DAC 打开：其他设备会把它播放成很响的噪声。
• 如果所选设备断开连接，Ansuz 会暂停、切换到系统输出并通知你；设备重新连接后，Ansuz 会询问是否切换回去。

Ansuz 退出时，每个设备都会恢复原来的采样率，独占模式也会释放。Ansuz 从不更改 Mac 其余部分使用的设备。

整张碟片存于一个文件

抓取为单个文件的整张 CD 会以其曲目的形式出现在资料库中，而不是一条一小时长的条目：每首曲目有自己的标题、时长、评分、历史和歌词，并依次无缝播放。整个文件本身不会另行列出。

音频镜像 + .cue 表。Ansuz 能播放的任何格式都可以作为镜像（FLAC、APE、WavPack、WAV、AIFF、ALAC、MP3，以及用于 DSD 黑胶抓取的 DSF/DFF）。.cue 表放在与镜像相同的文件夹中：

• 按表中 FILE 声明的名称匹配：完全一致，或去掉扩展名后相同（表写的是 .wav，镜像是 .flac）。文件夹中有多个表时，与镜像同名的那个优先。
• 一个表可以有多个 FILE 条目，例如每面黑胶一个文件。每首曲目从其 INDEX 01 延续到下一个；前间隙归上一首曲目，与 EAC 和 foobar2000 一致。
• 逐曲目的表（每首曲目一个文件，各自只有一个位于 00:00:00 的 TRACK）不会分割任何东西：这些文件照常索引。
• 表提供曲目标题和演奏者、专辑标题和艺人、REM DATE、REM GENRE 和 REM DISCNUMBER；它省略的内容来自镜像的标签（专辑、年份、流派、封面）。两者不同时，以表为准。编码为 UTF-8 或 Latin-1。
• 如果表被更改或删除，下次扫描会重建曲目。这些曲目不会出现在标签编辑器中：它们的数据在表里。

SACD ISO 镜像。Super Audio CD 的 .iso 可直接读取，无论是普通 DSD 还是 DST 压缩，常规镜像还是原始转储。曲目来自碟片的目录：每首曲目的标题、演奏者和作曲，专辑标题和艺人，年份。ISO 不含封面：请在文件夹中放一个 cover.jpg。默认使用立体声区域；在设置 › 资料库中，播放多声道区域会在存在环绕声区域时播放它，缩混为立体声，或在输出支持时以 5.1 播放。

不支持：指向其他文件夹的表、原始 BIN 镜像，以及内含文件的数据 ISO（它们不是 SACD）。

侧边栏

⌥⌘I 打开右侧面板，它跟随正在播放的曲目：

• 队列：正在播放的和接下来的内容。双击跳到某首曲目，拖动重新排序，⌫ 或右键移除，清空清空队列。
• 歌词：来自歌曲旁的 .lrc 文件、文件的标签，或 LRCLIB（按标题、艺人、专辑和时长精确匹配；如果有多个候选，由你选择一个）。同步歌词会高亮当前行，单击可跳转到该处。你自己带来的歌词优先于其他一切：导入歌词…接受 .txt 或 .lrc，粘贴歌词使用剪贴板，你也可以把文件拖到面板上。纯文本歌词随后可以在同步编辑器中同步：在每行被唱出时按空格或回车，↑↓ 移动，←→ 调整 ±100 毫秒（⇧ 10 毫秒，⌥ 1 秒），⌘↩ 从某行播放，⌫ 清除该行，⌘Z 撤销一切。保存会把同步结果保留在资料库中；“设置 › 资料库”还可以在文件旁写入 .lrc。发布到 LRCLIB在预览元数据后把同步歌词分享到公共数据库；Ansuz 会在后台解决 LRCLIB 的工作量证明并在完成时告知你。边栏中的已贡献的歌词列出你发布的内容。移除歌词删除已存储的内容，以便 Ansuz 下次重新查找。歌词上方的 A 按钮可缩小或放大歌词，⌘− 和 ⌘+（⌘0 恢复正常大小）以及触控板上的双指开合也可以；Ansuz 会记住大小。
• 艺人：照片、你所用语言的简介和官方网站，依次询问你文件的标签、MusicBrainz、Wikidata、Discogs（在设置 › Discogs中添加令牌后）和 Last.fm 获得；网站、Bandcamp、维基百科、Discogs 和社交资料的按钮，每个的工具提示中都标注了来源。如果找不到网站，搜索网页会打开浏览器；网站字段可以让你自己输入，Ansuz 会保留你写的内容。还有官方社交资料（Instagram、Facebook、X、YouTube、Bandcamp、Spotify、Apple Music、Discogs…凡是 MusicBrainz 记录的）、来自 Bandsintown 和 Ticketmaster 的即将举行的演出（含日期、城市、场馆和购票链接；Bandsintown 覆盖全球，Ticketmaster 只覆盖其售票地区）、流派和相似艺人。
• 相似：根据 Last.fm 的相似曲目，并标记你已拥有的。

⌘I 或显示 › 正在播放信息…打开一个窗口，显示 Ansuz 关于正在播放曲目的全部信息：封面、专辑详情、录音特性（格式、采样率、声道、比特率、时长，以及碟片镜像内曲目的片段，还有文件携带或 Ansuz 识别出的 ISRC 码和 MusicBrainz 录音 ID）、物理文件及其位置和在访达中显示的按钮、资料库使用情况和歌词。表格右键菜单中的曲目信息…对任何曲目打开同样的窗口。

首选版本

当同一曲目存在于多个来源（比如 MP3 和 FLAC）时，Ansuz 会把副本分组并选出一个首选版本：边栏中位置更高的来源获胜（拖动可更改优先级），同一来源内则选质量最好的。所有音乐只显示首选版本；每个来源显示它拥有的一切。有副本的曲目带有“N 个版本”标记，右键菜单中的显示所有版本会列出它们。右键单击所有音乐可以关闭重复项隐藏。

Last.fm 和 ListenBrainz

在设置 › Last.fm中，连接会打开浏览器授权 Ansuz；你一授权，Ansuz 会自行察觉并在几秒内连接。在设置 › ListenBrainz中没有需要授权的应用密钥：粘贴 ListenBrainz 个人资料（listenbrainz.org/settings）中的用户令牌并按连接。你可以使用其中一个服务或两个都用。从那时起，每次收听在超过曲目一半或四分钟后发送，并附带曲目编号、专辑艺人以及 Ansuz 已知的 MusicBrainz 录音 ID（发给 ListenBrainz 时还有 ISRC），这样服务可以匹配确切的录音而不是靠名称猜测。没有网络时，收听会被保存并稍后发送；每个服务有自己的队列和自己的立即重试。

Apple Music、Spotify 和 TIDAL

四者都在设置 › 平台中，各有自己的开关：关闭的平台会从边栏和发布到中消失，其账户保持连接。

在设置 › 平台 › Apple Music中，连接向 macOS 申请权限；除你的 Apple ID 外不需要账户或密钥。之后边栏中会出现 Apple Music 部分，列出你的 Apple Music 播放列表：每个显示其歌曲，标记已在你资料库中的（用播放从你的文件播放），有在“音乐”中打开，并且在订阅 Apple Music 后，在 Apple Music 播放可在 Ansuz 内串流播放。右键单击你自己的一个播放列表并选择发布到 Apple Music…：Ansuz 把每首歌与曲库匹配（文件携带 ISRC 时按 ISRC，否则按标题、艺人和时长），显示找到的内容并在你的 Apple Music 资料库中创建播放列表，这样它会跟随你到手机上。未找到的歌曲会被略过。

Spotify 在设置 › 平台 › Spotify中以同样方式工作：连接打开浏览器授权 Ansuz 并把你带回。你的 Spotify 播放列表出现在边栏中，你拥有的歌曲从你的文件播放，在 Spotify 中打开在 Spotify 应用中打开播放列表，发布到 › Spotify 在你的账户中创建它。Spotify 只共享你拥有或协作的播放列表中的歌曲：关注的播放列表会显示提示而不是歌曲。在 Spotify 中打开提供 Spotify 应用或网站，每首你不拥有的歌曲在收听列中也有同样的两个图标。Spotify 不允许其他 Mac 应用串流其曲库，所以这里没有播放按钮。

TIDAL 在设置 › 平台 › TIDAL中以同样方式工作：连接打开浏览器授权 Ansuz 并把你带回。你在 TIDAL 拥有的播放列表出现在边栏中，你拥有的歌曲从你的文件播放，在 TIDAL 中打开提供 TIDAL 应用或网站（也可按歌曲），发布到 › TIDAL 在你的账户中以不公开方式创建播放列表。TIDAL 只允许其他应用播放试听片段，所以这里同样没有播放按钮。YouTube Music 只能导入：设置 › 平台 › YouTube Music 以只读权限连接你的 Google 账户，你的 YouTube Music 播放列表（以及你喜欢的）出现在边栏中，你拥有的歌曲从你的文件播放，其余在 YouTube Music 网站打开。不提供发布到 YouTube Music：YouTube 的每日配额由所有 Ansuz 用户共享。若仍要把播放列表带过去，发布到 › YouTube Music（供 TuneMyMusic 使用的 CSV 文件）…会保存一个含每首歌曲标题、艺人、专辑和 ISRC 的 CSV 文件；把它上传到 TuneMyMusic（免费网络服务）并选择 YouTube Music 作为目标，它会在你的账户中重建播放列表。

封面 - PDF：为你的 CD 制作歌本和插页

在专辑页面，封面 - PDF…（⌘P）用 Ansuz 已知的专辑信息生成 PDF：封面、标签、歌词和技术细节。选择歌本（A4 或 Letter，浅色或深色，附上你勾选的技术细节、制作人员、标签和歌词：封面页、专辑数据和歌曲列表、文件中的所有标签（所有歌曲共有的只列一次，然后是每首歌自己的）、每页一首歌词），或盒装插页（带四面折页封面和含书脊的托盘卡的宝石盒、单页封面的宝石盒、薄盒封面或四面 digipak），以实际尺寸带裁切标记，仅在送印刷店时加 3 毫米出血。预览随选项变化即时更新；保存 PDF…把它保存到你选择的位置，打印…以 100% 打印以保证尺寸正确。如果最佳封面太小，Ansuz 会提醒你并可以在线查找更大的。你的选择按专辑记住。它的用途是把碟片保存在电脑上或替换破损的封面：一次一张专辑，不做碟标，不做条形码。

识别

右键单击 › 用 AcoustID 识别计算曲目的音频指纹并询问 AcoustID 和 MusicBrainz。它会存储标识符，如果文件没有标签，则在资料库中（而不是在文件中）填入标题、艺人和专辑。设置 › 识别可以识别整个资料库。

补全标签。在 MusicBrainz 上查找歌曲缺少的内容（标题、艺人、专辑、年份、类型、ISRC），必要时先通过声学指纹识别，然后添加到 Ansuz 资料库。它绝不会替换已有的值，也绝不会写入文件。对单首歌曲执行计算 ReplayGain会测量整张唱片，因为专辑增益需要所有曲目。

标签编辑

Ansuz 分两步编辑标签。编辑会立即更改资料库（搜索、播放列表、iPhone 和所有视图都会马上看到），并让更改处于等待写入状态；只有在你按下写入标签时才会改动你的文件。因此你可以在磁盘或 NAS 断开时编辑、撤销，并在任何文件改变之前检查一切。

标签编辑器（⌥⌘T，或对所选曲目使用在标签编辑器中打开）顶部有一个过滤器：与智能播放列表相同的规则，另有等待写入、有冲突、无法写入和光盘映像的一部分，以及过滤条件菜单中的现成过滤器，例如无流派或无作曲。编辑期间结果保持不变（你修正的曲目不会从列表中消失），直到你按下刷新。连按单元格或按下 Return 键即可编辑；Tab 键移到下一个字段，Return 键移到下一首曲目的同一字段。设定 … 应用到所选项或应用到全部可一次为多首曲目填入同一个值（值留空则清除该字段）。⌘Z 和 ⇧⌘Z 撤销和重做整次编辑。编辑过的单元格以颜色显示，圆点标记等待写入的曲目。

侧边栏分组显示所选曲目的所有字段：基本、制作人员（作曲、作词、编曲、演奏者、指挥）、发行、标识符和其他。选中多首曲目时，值不同的字段显示多个值：输入一个值会填入所有曲目，旁边的按钮提供使用第一首曲目的值或全部清除。专辑有而曲目为空的字段（专辑艺人、日期）显示为灰色：按下 Return 键即可在曲目中确认。输入时，Ansuz 会推荐资料库中已有的值，最常用的排在前面。

逐首浏览（⌘R）一次一首地走过结果，显示你在侧边栏中勾选的字段（默认为流派和作曲），歌曲从第 30 秒开始播放；你的播放队列会暂停，结束后继续。Return 键接受并前往下一首，⌘Return 将相同的值应用到专辑的其余曲目，⌘← 返回上一首，⌘D 复制你在上一首曲目中接受的内容，无歌词 (纯音乐)会标记曲目，使其不再出现在无歌词中。在字段之外，空格键暂停歌曲，方向键前后移动 5 秒。Ansuz 会记住你停在哪里。

模式与操作…可一次更改许多曲目，并在应用前预览每项更改：标签 → 标签按 Mp3tag 风格的模式填写字段（%artist%, %title%, %track%, %filename%…，以及 $title(), $num(%track%,2), $replace() 或 $regex() 等函数）；文件名 → 标签从文件名读取字段，使用“/”时还会从其所在文件夹读取（%artist%/%album% (%year%)/%track% %title%）；大小写按你的语言应用标题大小写（“of”或“de”等短词保持小写，罗马数字和缩写保持不变）、句子大小写、全部大写或全部小写；编号按网格顺序将曲目编号为 1、2、3…，按专辑和碟片分别编号，并填写总数。其中任何一项都可以保存为操作，操作可以以 JSON 格式导出和导入；内置两个：合辑（群星）和清理（空格、引号、破折号）。所有更改都应用于所选曲目或全部结果，并可用 ⌘Z 撤销。

来自外部：MusicBrainz… 查找所选曲目的专辑，并列出与之相似的发行版本；选择一个即可查看它会在每首曲目中填入什么（按碟片和编号配对）：日期、唱片公司、目录编号、条形码、标识符、编号和总数，以及作品的制作人员（作曲、作词、编曲、指挥）。只会应用你勾选的字段；标题、艺人和专辑默认不勾选。它的流派，以及侧边栏通过来自 MusicBrainz 的流派建议的流派，除非你点按其中一个，否则绝不会应用。网格的菜单还能查找歌词（已保存的、文件旁的 .lrc、标签或 LRCLIB），并将其标记为写入文件；将资料库中的值标记为待写入对 Ansuz 知道但文件中可能没有的内容（从文件夹名称推断或从 MusicBrainz 补全）做同样的事。当文件在 Ansuz 之外被更改时，显示更改…会显示每个冲突字段的三个值（之前、文件中、资料库中），你可以逐个字段保留自己的值或文件中的值。历史…列出每次更改以及已写入的曲目数，还原可撤销更改（如果已经写入，还原的内容将等待写入）。

图片与文件详情：侧边栏显示文件中嵌入的封面，并可为所选曲目按类型（正面封面、封底、碟、艺人、其他）设置图片：选择一张图片、从网上获取大图（Cover Art Archive、Last.fm）或拖入一张；缩小到 1200 像素可避免几 MB 的封面让专辑的每首曲目都变得臃肿。替换某一类型会保留文件中的其他图片。它的技术信息部分读取文件：文件带有哪些标签及其版本（ID3v2.3、ID3v2.4、ID3v1、APEv2、Vorbis、MP4…）、嵌入的图片以及所有原始键；自定义字段可添加你需要的任何键。网格的菜单可计算 ReplayGain 并将其标记为写入文件，写入时清理文件让 MP3 只保留 ID3v2.4（不含 ID3v1 或 APEv2），让 FLAC 不含 ID3。检查…在结果中查找常见问题（没有年份、曲目编号重复或缺失、多位艺人却没有专辑艺人、同一专辑中流派不同、没有封面、文字乱码），显示会把这些曲目放到网格中。

按文本搜索与快捷指令：在规则旁边，过滤条件还有文本模式，可以输入 genre:"" year<1990 或 album:contains Live NOT artist:"Various Artists" 这样的搜索：field:value（不区分大小写和重音）、field:"" 为空、field:* 不为空、field:contains x、year<1990, bpm>=120, is:pending, is:conflict, has:cover, no:lyrics、单独的词（标题、艺人或专辑）、AND、OR、NOT 和括号；字段名用英文书写。过滤条件 › 存储当前过滤条件…可将任一种过滤条件保存在该菜单中。在“快捷指令” App 中，Ansuz 提供待写入的标签、设置标签和应用标签模式（作用于文本搜索的歌曲）以及写入标签。在“设置 › 资料库 › 标签编辑器”中可以设定逐首浏览从每首歌的哪里开始播放、标题大小写所用的语言，以及新图片是否缩小到 1200 像素。

重命名和移动文件：模式与操作…中的重命名文件标签页根据每个文件的标签，在同一来源内生成它的新路径：%albumartist%/%album% (%year%)/$num(%track%,2) %title%（“/”会建立文件夹；扩展名保持不变；网络共享不接受的字符会被替换，而 AC/DC 这类值中的斜杠不会建立文件夹）。预览显示现在和之后的路径，并标出无法移动的内容：目标位置已有其他文件、两首曲目会得到相同的名称、带 cue 表的光盘映像中的曲目（文件名由 .cue 指定）。在按下写入标签之前不会移动任何东西，也绝不会替换已有的文件；Ansuz 写入的 .lrc 会随歌曲一起移动，变空的文件夹会被删除。你的播放列表、播放次数和评分仍然跟着歌曲。

底部的栏统计整个资料库中等待写入的内容。显示更改…列出每个字段的前后值；在那里你可以放弃更改、只写入你选择的内容，或解决冲突。写入标签需要在设置 › 资料库中打开允许编辑文件中的标签（默认关闭）。

Ansuz 的写入方式：复制文件，在副本中写入标签，检查音频与之前完全相同（仅针对音频的指纹，不含标签）且标签能按预期读回，然后才一步替换原文件。如果文件在 Ansuz 上次读取后发生了变化，则不写入任何内容，该字段显示为有冲突，由你在自己的值和文件中的值之间选择。正在播放的歌曲会等到下一轮。带 cue 表的光盘映像中的曲目，以及 Ansuz 无法检查其音频的格式，只在资料库中编辑。写入标签不会让 iPhone 重新下载歌曲：只传送新的标签。

专辑编辑器（在专辑上选择编辑标签…）的工作方式相同：保存把更改保留在资料库中，存储并写入标签还会把它们写入文件。专辑字段中的艺人（所有曲目）一次为所有曲目设定同一艺人；右键单击曲目可选择将此艺人 / 作曲 / 碟号应用到所有曲目，把该行的值复制到整列。

专辑检查器

专辑页面上的检查器（或专辑右键菜单中的专辑检查器…）逐个来源显示资料库对这张碟片的了解：是否已与 MusicBrainz 发行版和 Discogs 发行版匹配，多少首曲目有 MusicBrainz 录音、ISRC、音频指纹和歌词，条形码，以及封面及其尺寸。下方是缺失内容的列表。在线检查询问 MusicBrainz、Discogs（使用设置中的令牌）、Last.fm 和 Cover Art Archive，在条形码或艺人与标题能明确找到时关联 Discogs 发行版，在有更大封面可用时告知你，并列出你的资料库与这些来源之间的差异：专辑标题、年份、唱片公司、目录编号、条形码、国家/地区和曲目标题。

差异旁的使用此项只把该值写入 Ansuz 资料库：你的文件不会被触及。重新读取标签会恢复文件中的内容；要修改文件本身，请使用标签编辑器。专辑艺人只用于比较显示，绝不会从这里更改。

添加到 MusicBrainz…（在未匹配专辑的检查器中，或专辑右键菜单中）用于 MusicBrainz 尚未收录的碟片：Ansuz 在浏览器中打开 MusicBrainz 发行版编辑器，并用你的文件填好一切：标题、艺人、年份、国家/地区、唱片公司、目录编号、条形码，以及每张碟一个介质，含每首曲目的标题、编号、时长和已知的录音。你需要一个 MusicBrainz 账户；由你在那里检查、补全并提交，在你提交前不会添加任何内容。当 MusicBrainz 确认新发行版后，它会把你带回 Ansuz，Ansuz 会立即把专辑与之关联。发行版编辑器没有 ISRC 字段，所以它们只保留在你的资料库中。

准备 Discogs 草稿…（在没有 Discogs 发行版的专辑的检查器中，或专辑右键菜单中）为 Discogs 做同样的事，Discogs 没有可预填的编辑器：Ansuz 按 Discogs 的 CSV-to-Draft 工具的精确格式保存一个 CSV（艺人、标题、唱片公司、目录编号、格式、流派、曲目、日期、条形码），并在浏览器中打开该页面；你在那里上传文件，Discogs 会创建一份私人草稿，由你检查、补全并提交。该工具只接受一个唱片公司、一种格式和一个流派，曲目不含位置、时长或艺人，所以 Ansuz 把国家/地区、你标签中的流派以及含时长和艺人的完整曲目列表写进备注，方便复制到表单中。在你于 Discogs 提交草稿之前不会发布任何内容。

计划任务

在大资料库上有些工作要花好几天：重新读取 NAS 上 200,000 个文件的标签、逐张专辑查找封面、为没有标签的曲目计算指纹。“设置 › 任务”让它们在你选择的时段内自行运行，每周每天一个时段（比如周一到周五的 3:00 到 7:00）。Ansuz 必须保持打开：沙盒化的 App Store 应用不能在后台工作。任务运行期间 Mac 不会自行睡眠（显示器可能关闭）；请保持盖子打开并连接电源适配器。

在一个时段内没有完成的任务会在下一个时段继续，且不会重复劳动：每首曲目和每张专辑都会在资料库中记录已完成的工作（读取了哪个版本的标签、是否查找过封面、是否计算过指纹），下次运行会跳过它。任务在无事可做时会自行关闭；当本轮最后一个关闭时，全部任务会为下一轮重新开启。任务按列表顺序运行：把一个拖到你想要的行上。每个任务显示待处理数量、上次结果，并有一个忽略时段的立即运行按钮；停止在当前批次后停下。

• 查找新增和移除的文件：与 ⇧⌘R 相同的增量扫描，逐个来源进行（大小和日期；只读取更改过的文件）。
• 重新读取标签：在 Ansuz 开始存储 ReplayGain、BPM 和调性之前索引的曲目。
• 查找缺失的封面：内嵌、文件夹、Cover Art Archive、Last.fm。
• 识别无标签曲目：使用 AcoustID 和 MusicBrainz 的音频指纹。
• 将专辑与 MusicBrainz 匹配：每张专辑通过条形码、AcoustID 找到的发行组，或艺人、标题和曲目数与 MusicBrainz 发行版匹配，并逐曲目按时长验证。Ansuz 存储发行版、每首曲目的录音 ID 和 ISRC、唱片公司、目录编号和国家/地区，以及 MusicBrainz 链接的 Discogs 发行版；你标签中已有的内容不会被覆盖。没有匹配的专辑在 30 天后重试。专辑右键菜单中的与 MusicBrainz 匹配会立即匹配这张专辑，并把 MusicBrainz 的所有标签载入其歌曲，替换原有内容：标题、艺人、编号、日期、厂牌、目录号、条形码、ISRC、标识符、制作人员和得票最多的流派。只改变 Ansuz 资料库（写入标签会写进文件），并可在标签编辑器的历史中一次撤销。专辑中重复的歌曲（另一版本、另一文件夹）得到相同的标签。
• 分析 BPM 和调性：对于标签中缺少它们的曲目，Ansuz 解码最多三分钟并估算速度（起音包络和自相关）和调性（色度图对照 Krumhansl-Kessler 轮廓）。标签总是优先：分析只填补缺失的内容。
• 计算 ReplayGain：对于标签中缺少它的曲目，Ansuz 用 EBU R128（ITU-R BS.1770-4，含真峰值）测量整个文件的响度，并存储以 −18 LUFS 为参考的曲目和专辑增益。它一次处理一张碟片，因此专辑增益来自整张唱片；标签总是优先，重新读取标签会保留测量结果。曲目信息窗口会说明某个值是由 Ansuz 测量的。不会向你的文件写入任何内容。
• 查找歌词：歌曲旁的 .lrc、标签，然后是 LRCLIB，针对没有歌词的歌曲；没有歌词的歌曲在 30 天后重试。
• 将缺失的同步歌词发布到 LRCLIB：默认关闭；第一次开启时，Ansuz 会说明 LRCLIB 是公开的。它发布你导入、同步或来自 .lrc 文件和标签的同步歌词，每秒一首，跳过内容相同的已有歌词。

手动分析。从歌曲、专辑、播放列表或文件夹的菜单中运行的“分析 BPM 和调性”和“计算 ReplayGain”一次只执行一项：进度显示在工具栏中，并带有停止按钮；完成后，如有无法分析的歌曲，Ansuz 会告诉你有多少首。

iPhone 上的 Ansuz

iPhone 版 Ansuz 在一个应用中提供两种模式：遥控，浏览你 Mac 上的资料库并控制那里正在播放的内容；以及在此 iPhone 上播放，手机上有一个资料库，把 Mac 拷贝过来的播放列表和你自己的音乐合在一起。没有 Mac 也能使用 iPhone。iPhone 与 Mac 之间的一切都经由你的本地网络加密传输，中间没有账户，也没有服务器。用左上角的按钮切换模式。

两种模式下的第一个标签页首页以书架显示你的收藏、最近播放和最常播放的专辑；横向滑动书架，或轻点标题查看全部。专辑页面上的心形可将其收藏。控制 Mac 时，书架来自 Mac；在 iPhone 上则来自手机里的音乐，包括在任意一端收藏的专辑（每次同步都会带过去）以及这台 iPhone 的播放记录。

你的音乐，无需 Mac。Ansuz 在“文件”应用中有自己的文件夹（我的 iPhone › Ansuz）：拷贝到那里的内容会自动加入资料库，在“文件”中从那里删除的内容也会离开资料库。你也可以用线缆从电脑把音乐拷贝进去：在 Mac 上用访达（iPhone 的“文件”部分），在 Windows 上用“Apple 设备”应用。Ansuz 文件夹不包含在 iCloud 备份中：换 iPhone 时需要重新拷贝音乐。

导入和添加文件夹。在来源中，+ 按钮提供从“文件”导入…、从电脑发送…、连接服务器…和添加“音乐”资料库（见下文）。从“文件”导入…会打开一个选择器，可以同时勾选音频文件、zip 和文件夹：文件会被拷贝到 Ansuz 文件夹；对每个文件夹，Ansuz 都会询问：拷贝到 Ansuz 会把它留在 iPhone 上，即使原件不在了也不受影响；就地使用 不占空间，但只有在文件夹可用时才能播放：插着的 U 盘、iCloud 云盘、在“文件”中连接的网络服务器、Google Drive、Dropbox、OneDrive…… 就地使用的文件夹永远不会被修改。选择器不能同时勾选多个文件夹：要选择文件夹，请进入包含它们的文件夹，不勾选任何项目，直接轻点打开。如果其中有子文件夹，Ansuz 会显示选择要导入的内容，每个子文件夹都已勾选（取消勾选不需要的；该文件夹中散放的音乐也会列出）：将所选内容拷贝到 Ansuz 会拷贝勾选的内容，就地使用“文件夹” 则使用整个文件夹及其所有子文件夹。例如，打开“下载”，在其中勾选专辑。对于音频文件和 zip，Ansuz 也会出现在“打开方式”和共享菜单中：隔空投送、WhatsApp、邮件、Safari 浏览器下载；它们会被拷贝到 Ansuz 文件夹并自动加入。zip 绝不会未经询问就解压（要解压缩音乐吗？），而且只提取音乐、.lrc 歌词、.cue 表和封面。在 iPhone 上，Ansuz 可播放 FLAC、ALAC 和 AAC（M4A）、MP3、WAV 和 AIFF，并直接在手机上读取标签和封面（内嵌或 cover.jpg）。顶部的横条会显示导入进度，带有取消按钮，之后显示结果。

从电脑发送。在来源 › + › 从电脑发送…中，iPhone 会显示一个地址（例如 http://192.168.1.20:8080）、该地址的二维码和一个六位数 PIN。在连接同一 Wi-Fi 网络的电脑上（Windows、Mac 或 Linux，任何浏览器）打开该地址并输入 PIN，就会出现 Ansuz 页面：把文件或整个文件夹拖进去，或用选择文件或选择文件夹来选。每个文件都会显示进度，一次发送三个，保留文件夹结构，iPhone 上已有的不会重复发送，不是音乐的会被跳过；zip 会传到 iPhone 上，由 iPhone 询问是否解压。音乐边到达边加入 Ansuz 文件夹和资料库。这个界面打开期间 iPhone 不会自动锁定；请保持打开直到传输完成（如果离开 Ansuz，传输会中断，回来后用同一个 PIN 继续）。服务器只在这个界面打开时存在，只经过本地网络，不用互联网，也不经过任何云；PIN 保护访问（连续五次输错 PIN 会锁定 30 秒）。第一次使用时，iOS 会请求使用本地网络的权限。

音乐服务器。在来源 › + › 连接服务器…中添加 Subsonic 或 OpenSubsonic 服务器（Navidrome、Airsonic、Gonic 及其他兼容服务器）：地址（http:// 或 https://）、用户名和密码，或使用 API 密钥（OpenSubsonic）；可选的名称；以及下载质量（原始、MP3 320 kbps 或 MP3 192 kbps）。Ansuz 会在保存前测试连接。密码保存在 iPhone 的钥匙串中，不会传输：每个请求都带一个一次性令牌。服务器的曲库会并入 iPhone 资料库：它的专辑和其他专辑显示在一起（同一张专辑同时在服务器和 iPhone 上时只显示一次），搜索涵盖全部内容，它的播放列表以只读方式显示，在 CarPlay 中也能使用。每天重新读取一次，也可以点立即同步。每首歌在播放时下载到 iPhone 的缓存中（当前歌曲播放时，也会下载队列中接下来的几首）。要离线收听，在含有服务器歌曲的专辑或播放列表中点下载到 iPhone，歌曲会拷贝到 Ansuz 文件夹，成为 iPhone 上的音乐。在来源中轻点服务器，可以看到状态、地址、用户、上次同步时间和下载质量（MP3 更省蜂窝数据；“原始”保持无损文件原样），还有立即同步和从 Ansuz 中移除…：它会从资料库中移除该服务器的歌曲，不会改动服务器上的任何内容；已下载的歌曲会保留。服务器没有响应时（没有网络、不在家），它会显示为未连接：它的歌曲会隐藏，直到它恢复，已下载的歌曲照常播放。如果播放中网络中断，Ansuz 会停在这首歌，不会丢失队列。最上方的服务器类型可选Subsonic或DLNA / UPnP。DLNA 服务器是 NAS 或电脑上的媒体服务器（Twonky、MiniDLNA、Plex、Gerbera 等）：打开该标签页几秒后，Ansuz 会在在你的网络中列出自己找到的服务器（重新搜索可再搜一次），轻点一下即可添加。它会在 iPhone 所在的网络中搜索，也会在你已在使用的服务器和 NAS 所在的网络中搜索：在有两个网络的家庭中，媒体服务器常常位于 NAS 所在的网络。它只需要本地网络权限。对于位于其他网络的服务器，在其他服务器中只需输入它的 IP 地址或名称，无需用户名和密码，Ansuz 会自己找到服务器；如果找不到，请输入其描述文件的完整地址（例如 http://192.168.1.10:9000/dev0/desc.xml）。如果服务器提供按文件夹浏览的视图，Ansuz 会使用它；服务器在多个视图中显示的同一首歌只会出现一次。FLAC、ALAC、AAC、MP3、WAV 和 AIFF 按原样下载；其他格式如果服务器提供转换后的版本，就下载该版本，否则这首歌不会列出。DLNA 服务器的播放列表不会导入；如果服务器重建了它的数据库，它的歌曲可能会作为新歌曲重新加入。SMB 用于 NAS 或电脑的共享文件夹，通过“文件”应用连接。输入地址（例如 smb://192.168.1.10），然后轻点在“文件”中连接：“文件”会打开连接服务器并填好地址；轻点右上角的蓝色 ✓，然后用 NAS 用户登录（密码由“文件”保存，而不是 Ansuz）。通过◀ Ansuz返回 Ansuz 后，选择器会自动打开：轻点浏览，返回位置列表，在共享标题下打开 NAS，进入音乐文件夹，不选择任何项目，直接轻点打开。该文件夹会就地使用，不会被拷贝或更改。用过的服务器会显示在最近使用的服务器中，无需再次输入地址。当“文件”与 NAS 断开连接时，该来源显示未连接，但不会丢失歌曲；在它的页面中，在“文件”中连接会带你重新连接，返回后文件夹会自动恢复。

“音乐” App。在来源 › + › 添加“音乐”资料库中，Ansuz 会请求读取“音乐” App 资料库的权限（iOS 只会询问一次），并把它添加为“音乐” App来源：你购买的、从 CD 导入的或从电脑同步的歌曲会和其他歌曲一起并入 Ansuz 资料库（同一张专辑在两个来源中只显示一次），包括它们的播放列表（只读），在 CarPlay 中也能使用，并以 Ansuz 的无缝播放、ReplayGain 和淡入淡出播放。Ansuz 在原处读取这些歌曲：从不拷贝、修改或删除它们，也不占用空间。你在“音乐”中添加或移除的内容会自动出现或消失。带有拷贝保护的 Apple Music 歌曲，以及只在 iCloud 中、尚未下载的歌曲，只能在“音乐” App 中播放：它们不会列出，来源会显示有多少首。如果你在设置 › App › Ansuz › 媒体与 Apple Music中关闭权限，该来源会显示为未连接，直到你重新允许；从 Ansuz 中移除…会把它从资料库中移除，不会改动“音乐” App。

来源。来源标签页列出每个来源的歌曲数、占用空间和状态：正在索引（附进度）、未连接，或正在从 iCloud 下载（已下载几首，共几首）。从 Mac 同步是 Mac 拷贝过来的内容；轻点它会打开同步界面。Ansuz 文件夹界面有重新索引和删除此文件夹中的所有音乐…，后者会要求确认，也是 Ansuz 唯一会删除的东西。就地使用的文件夹不可用时显示为未连接，其中的歌曲在它恢复之前不会显示，但不会被删除；从 Ansuz 中移除… 会把它的歌曲移出资料库，文件则原地保留。如果 iCloud 云盘中的文件夹有不在手机上的歌曲，Ansuz 会向 iCloud 请求下载，并在读取前显示已下载多少。同一张专辑位于两个来源中时只显示一次（以 Mac 的拷贝为准）。播放设置（ReplayGain、淡入淡出）位于来源底部。

配对。在 Mac 上的设置 › 设备中，打开允许 iPhone 和 Apple TV 上的 Ansuz 连接。在同一网络中打开 iPhone 上的 Ansuz：它会自己找到 Mac。第一次时，Mac 会显示一个带代码的提醒；只有与 iPhone 上的代码一致时才配对。之后它会自动重新连接，不再询问。已配对的设备列出每台 iPhone，并可撤销其访问。

遥控。在整个资料库中浏览专辑、艺人、流派、播放列表并搜索，附带封面；播放、暂停、切换曲目和跳转；随机播放和重复；播放队列，可重新排序、移除或下一首播放；评分和喜欢；Ansuz 的音量和 Mac 的音频输出；正在播放的歌曲的同步歌词。iPhone 连接期间，Mac 不会因闲置而进入睡眠。在艺人中，每位专辑艺人都配有照片，右侧有字母栏：点按字母或沿字母栏滑动手指即可跳转。点按艺人打开其页面：照片、带阅读更多的简介、播放和随机播放，作品分为专辑、EP、单曲、精选集和合辑，以及资料库中的相关艺人。

把音乐带到 iPhone。在 Mac 上右键单击一个播放列表 › 带到 iPhone，然后选择格式：原始文件（iPhone 无法播放时会转换）、Apple Lossless 16 位 / 44.1 kHz，或最小的 AAC 256 kbps。DSD、SACD、DTS-CD 和附带 .cue 表的 CD 镜像总是会被转换；转换后的副本保存在 Ansuz 的缓存中。智能播放列表以已解析的形式传输。在 iPhone 上，来源 › 从 Mac 同步会显示每个播放列表占用多少空间、还剩多少要下载；立即同步在后台下载其余部分，即使手机已锁定也会继续，并移除 Mac 不再发送的内容。歌词、封面和 ReplayGain 随每首歌曲一起传输。在设置 › 设备中打开优先使用最小的版本后，你有多份拷贝的歌曲（例如 MP3 和 FLAC）会以生成文件最小的那份传输；评分和播放记录仍归于首选版本。

在 iPhone 上播放。在手机上的内容中浏览播放列表、专辑并搜索，无缝播放，支持淡入淡出、ReplayGain，并可在锁定屏幕和控制中心中控制。收听记录会从 iPhone 用 Mac 上的账户记录到 Last.fm 和 ListenBrainz（没有网络时先排队），Mac 不会重复发送。评分、喜欢和播放次数会在 iPhone 在网络上找到 Mac 后立即传回 Mac；如果一首歌在两边都评了分，以最新的更改为准。在普通播放列表中，编辑可以移除歌曲和重新排序，更改会应用到 Mac 上，而不会覆盖你在那里添加的内容；智能播放列表由 Mac 生成，在 iPhone 上为只读。在专辑标签中，顶部的切换可转到艺人：与控制 Mac 时相同的带照片列表、字母栏和艺人页面，包含 iPhone 上以及已连接服务器（Subsonic、DLNA）上的音乐。播放和随机播放在 iPhone 上播放。

CarPlay。在车上，Ansuz 显示 iPhone 上的音乐：你的播放列表、专辑和歌曲，每个都有“随机播放”，以及带随机播放和重复的标准“正在播放”屏幕。无需网络连接，也不需要 Mac。艺人标签侧边有字母索引（艺人很多时先选字母）；每位艺人显示“随机播放”以及分为专辑、EP、单曲、精选集和合辑的作品。没有信号时，就像流媒体应用一样，只在服务器上的内容会消失，iPhone 上的内容保留；信号恢复后会自动回来。

Siri。说“用 Ansuz App 播放 Coldplay”：可以是艺人、专辑、歌曲、播放列表或流派，也可以说“…接下来播放”“…稍后播放”或“随机播放…”。iPhone 锁定时和在 CarPlay 中都能用。音乐会在你点按屏幕时播放的地方播放：在遥控模式下且 Mac 已连接时，会在 Mac 的资料库中查找并在 Mac 上播放；否则使用 iPhone 的资料库。如果 iPhone 上没有，但已配对的 Mac 在网络上，Ansuz 会自动连接，在 Mac 的资料库（例如你的 NAS 上的）中查找，并在 Mac 上播放。名称比较时忽略大小写、重音符号和开头的“The”；歌曲会接着播放所在专辑的其余部分，艺人或流派则随机播放。只说“用 Ansuz 播放”会继续播放之前的内容。Siri 常把“用 Ansuz”当成标题的一部分：请改说“用 Ansuz App”，或只说“播放 Coldplay”，再从 Siri 显示的列表中选择 Ansuz。

Apple TV。打开来源 › Apple TV › 与 Apple TV 共享后，同一网络中装有 Ansuz 的 Apple TV 可以在 Ansuz 于此 iPhone 上打开期间浏览并播放这台 iPhone 上的音乐（参见Apple TV 上的 Ansuz）。第一次连接时，iPhone 会显示 Apple TV 的代码：只有一致时才接受。同一部分会列出已配对的 Apple TV；轻扫某一台即可移除。“音乐”App 中的歌曲不会共享。

没有 Ansuz 云，也没有 Ansuz 账户。iPhone 只通过你的本地网络与你的 Mac 通信（在你从电脑发送音乐时，也与那台电脑的浏览器通信），与你已在使用的记录播放服务通信，与你连接的音乐服务器通信，与你共享资料库的 Apple TV 通信（与 Apple TV 共享），并且只有在你选择了 iCloud 云盘或其他提供商的文件夹时，才会通过“文件”应用与该提供商通信。你 Mac 上的音乐只会传到你的手机（如果你选择共享，也会传到你的 Apple TV），不会去往任何其他地方。

Apple TV 上的 Ansuz

Apple TV 版 Ansuz 通过本地网络以加密串流的方式，在电视上播放你 Mac 上的资料库。Apple TV 上不存储任何音乐：每首歌都在播放时从 Mac 传来。其中有专辑、艺人、播放列表、正在播放和搜索（放大镜），可以使用屏幕键盘或听写。来源是最后一个标签页。在正在播放中按返回，会回到你选歌时所在的标签页。

专辑和艺人右侧的竖向字母栏可直接跳到某个字母：将焦点向右移到字母栏并选择。专辑按网格顺序，即专辑艺人排序。

播放歌曲不会离开当前页面，方便试听专辑中的多首歌曲。要打开正在播放，请使用其标签，或按住正在播放的歌曲并选择正在播放。

艺人以网格显示每位艺人的照片（照片载入前显示其专辑封面），并提供搜索栏。艺人页面包含照片、简短介绍、播放和随机播放、专辑，以及相关艺人：Last.fm 认为相似且在你资料库中的艺人。照片和介绍首次需要联网。

电视上的第一个栏目首页显示与 Mac 和 iPhone 相同的书架：收藏、最近播放和最常播放，来自所选的资料库（Mac 的或电视自己服务器的），每排都有查看全部。专辑页面上的心形可将其收藏。

如果歌曲有歌词，进度条下方会出现“歌词 · 按住即可显示”：按住触控板并选择显示歌词。同步歌词会跟着歌曲走，当前行为白色；未同步的歌词会随歌曲一起滚动。这个选择会保留到后面的歌曲，歌词显示在屏幕上时，电视不会进入待机画面。来自 Subsonic 或 Navidrome 服务器的歌曲会显示服务器上的歌词（嵌入在文件中或 .lrc 中），如有同步歌词则同步显示。

配对。在 Mac 上的设置 › 设备中，打开允许 iPhone 和 Apple TV 上的 Ansuz 连接。在同一网络中打开 Apple TV 上的 Ansuz，选择你的 Mac。Apple TV 会显示一个六位数代码，Mac 会显示一个带代码的提醒：只有两者一致时才点按配对。之后它会自动重新连接，Apple TV 会出现在已配对的设备中，你可以在那里撤销它。

格式。Mac 能播放的都可以。Apple TV 无法解码的格式（DSD、SACD、DTS-CD、APE、带 .cue 的映像中的歌曲、Ogg Vorbis 等），由 Mac 即时转换后发送：立即开始播放，无需等待整首歌转换完成，也可以跳到任意位置。

音乐服务器，无需 Mac。在来源标签页中选择 Apple TV 显示哪个资料库：你 Mac 上的资料库（实时），或音乐服务器。一次只能选一个，因为同样的音乐同时在 Mac 和服务器上会出现两次。添加 Subsonic 或 Navidrome 服务器…用于添加 Subsonic 或 OpenSubsonic 服务器（Navidrome、Airsonic、Gonic、LMS）：填写地址，以及用户名和密码，或使用 API 密钥（OpenSubsonic）。添加 DLNA 媒体服务器…用于添加 DLNA/UPnP 媒体服务器（Twonky、MiniDLNA、Plex、Serviio、Universal Media Server 以及许多 NAS 内置的服务器），它会自动出现在此网络上，也可以按地址输入。Apple TV 将每个服务器的曲库读取到自己的索引中，并直接从服务器播放，即使 Mac 已关机也可以；同一张专辑在两个服务器上只显示一次，没有响应的服务器会被隐藏，直到它恢复。Apple TV 无法解码的格式（Ogg Vorbis、APE 等）会向 Subsonic 服务器请求转换为 MP3；在 DLNA 服务器上则跳过该歌曲。服务器每天重新读取一次，也可以在服务器页面点重新读取。索引保存在缓存中：如果 tvOS 清除了它，会自动重建；服务器设置会保留，密码保存在钥匙串中。不支持共享文件夹（SMB）：tvOS 没有“文件”App。如果没有配对的 Mac，第一个屏幕还会提供改用音乐服务器。

长时间读取。读取大型服务器需要时间：通过 DLNA 读取 180,000 首歌曲要一个多小时。Apple TV 大约每 5,500 首歌曲记录一次进度，因此如果读取中断（你离开了 App、App 被关闭或网络断开），回到或打开 App 时会自动从那里继续。如果网络断开，它会在 5 秒、15 秒和 1 分钟后自动重试，期间来源会显示连接已中断。正在重试… 服务器页面会显示读取在 N 首歌曲处中断。，并提供继续读取（N 首歌曲）以继续，以及重新读取以从头开始。如果服务器拒绝某些文件夹（繁忙的 Plex 会这样），会重新请求；如果仍有文件夹未能读取，这次读取不会删除任何已有内容。Apple TV 不会每次启动都重新读取整个服务器：只有当服务器报告有歌曲增加或删除时才会读取，并且每周读取一次以获取标签更改；中断的读取会在三天内从中断处继续。

Scrobble 与播放记录。Apple TV 使用与其配对的 Mac（或 iPhone）上的账户向 Last.fm 和 ListenBrainz 提交 scrobble：无需在电视上登录。播放 Mac 上的歌曲会计入 Mac 的播放历史和计数，没有连接时先保存在 Apple TV 上。播放音乐服务器上的歌曲的记录保留在 Apple TV 上。

用 iPhone 作为来源。在 iPhone 上打开来源 › Apple TV › 与 Apple TV 共享（默认关闭）。Apple TV 会在列表中与 Mac 一起显示这台 iPhone，并带有 iPhone 图标；选择它，然后在 iPhone 上确认六位数代码。此后 Apple TV 即可浏览并播放 iPhone 的资料库。只要 Ansuz 在 iPhone 上保持打开就能使用（连接 Apple TV 时，iPhone 屏幕不会自动关闭）。iPhone 发送原始文件，不做转换：Apple TV 无法解码的歌曲会被跳过。“音乐”App 中的歌曲以及带 .cue 的映像中的歌曲不会共享。在电视上的播放会计入 iPhone 的播放历史。Apple TV 同一时间只与一台 Mac 或 iPhone 配对。

正在播放与 Siri Remote。播放画面专为在三米外观看而设计，背景取自封面。在点按式触控板上：按下可播放或暂停；向右或向左快速轻扫切换到下一首或上一首；缓慢拖动可在歌曲中移动（松开时跳转）；按下右侧或左侧边缘可前进或后退 10 秒；向下轻扫显示队列；按住打开歌曲菜单（前往专辑、前往艺人、待播清单）。

菜单与队列。在任意列表中按住一首歌或一张专辑，可以选择下一首播放、添加到队列、前往专辑和前往艺人；专辑还有播放和随机播放。在待播清单中，选择一首歌会跳到它；按住它可以选择立即播放、下一首播放、上移、下移和从队列移除。清除待播清单会清空后面的所有歌曲。对于来自 DLNA 服务器（如 Plex）的专辑，重新读取标签只会从服务器重新读取该专辑的文件夹：几秒钟内新歌曲会加入、标签得到更正、已不存在的会被移除。适合刚整理完一张专辑时使用；如果你重命名了它的文件夹，则会重新读取上一级文件夹。

休息模式。如果正在播放音乐且两分钟内没有人碰遥控器，Ansuz 会取代系统屏幕保护程序，全屏显示缓慢移动的封面和歌曲。按任意按钮即可返回。暂停时，系统屏幕保护程序照常工作。

连接中断时。如果网络断开或 Mac 关机，Apple TV 会暂停、提示并自动重新连接，然后从同一首歌的同一位置继续播放。如果断开超过 10 分钟，则保持暂停。Ansuz 也支持 Apple TV 的控制中心，以及 iPhone 控制中心里的遥控器。

Subsonic 服务器

Ansuz 可以把 Mac 上的资料库提供给兼容 Subsonic 的 App，例如 Amperfy、play:Sub、Symfonium、Feishin 或 Supersonic，在手机、平板或另一台电脑上使用。在设置 › 设备 › Subsonic 服务器中开启，默认关闭。

• 连接 App：用添加用户…创建一个用户，打开凭证，拷贝密码或 API 密钥。在 App 中输入设置里显示的地址（例如 http://192.168.0.20:4533）、用户名和密码。
• 配置文件：自己的设备可以看到所有来源（或你选择的来源），计入你的播放，并可以更改喜爱、评分和播放列表，除非你将其设为仅收听。访客用于他人：只能看到你选择的来源，不能更改任何内容，其播放也不计入你的统计。
• 播放记录：用自己的用户在 App 中播放的内容会进入历史记录和统计；开启将 Subsonic App 中的播放记录发送到 Last.fm 和 ListenBrainz 后，会从 Mac 进行 Scrobble。请关闭 App 自身的 Scrobble，否则每首歌会被计算两次。
• 音质与流量：不设限制时，App 收到原始文件（CD 音质的 FLAC 约 1 Mbit/s，24 位/96 kHz 约 3 Mbit/s）。DSD、带 cue 的映像和少见格式以 WAV 传送。如果 App 要求限制码率，Ansuz 会即时转换为 AAC（要求 MP3 时也是如此：Mac 没有 MP3 编码器）。
• 在外面：服务器只接受来自本地网络的连接。要在外面收听，请在 Mac 和手机上安装 Tailscale，并在 App 中使用 Mac 的 100.x 地址。使用“在外面 › 在路由器上打开端口”时，Ansuz 会请求路由器将一个端口转发到 Mac（UPnP 或 NAT-PMP），并显示是否成功。来自互联网的连接只通过带证书的 HTTPS 接受：在设置证书之前，外部的任何连接都无法进入。如果你的服务商使用 CGNAT（许多用户共用一个公网地址，在光纤和移动网络中很常见），就无法打开端口，此时请使用 Tailscale。 要载入证书，请使用导入证书和密钥…（tailscale cert 生成的两个文件，或 certbot 的 fullchain.pem 和 privkey.pem）或导入 .p12…。证书的名称必须指向这台 Mac：指向你公网地址的自有域名，或 Tailscale 名称。载入后，Ansuz 还会在 4534 端口通过 HTTPS 监听，App 使用 https://名称:端口。外部访问会列出从互联网连接的人和登录失败的记录。 使用自动证书，Ansuz 会自行向 Let’s Encrypt 获取并续期证书：输入名称，选择 ZoneEdit 或 Cloudflare 并保存凭据（ZoneEdit：用户和该区域的动态验证令牌；Cloudflare：具有 DNS 编辑权限的 API 令牌）。先用测试服务试一下，然后关闭它。开启动态 DNS 后，当服务商更换你的公网地址时，名称会随之更新。 → 在外收听，逐步设置
• 始终可用：关闭窗口不会停止服务器；菜单栏显示已连接的 App 数量，只要有 App 连接，Mac 就不会自行进入睡眠。开启设置 › 通用 › 登录时打开后，重新启动后服务器会再次可用。

在外收听：逐步设置

这样，你可以在任何地方用手机或另一台电脑收听你的资料库，连接经过加密，证书也能被 App 接受。第一次大约需要半小时；之后无需再做什么：Ansuz 会续期证书，并在你的公网地址变化时跟着更新。

重要：本指南使用其他公司的服务：ZoneEdit（你的域名的 DNS）、Let’s Encrypt（证书）、你的路由器和你的网络运营商。它们都可能不经通知就更改页面、菜单、名称或条款，届时你看到的内容可能与本指南不符。这不是 Ansuz 的错误：请在该服务的页面或帮助中寻找对应的选项。Ansuz 的提示总会说明是哪个服务出了问题。

你需要：

• Mac 保持开机，Ansuz 已打开，并已开启向 Subsonic App 提供资料库（见 Subsonic 服务器）。Mac 睡眠或关机时，在外面就听不到音乐。
• 能自动打开端口的路由器（UPnP 或 NAT-PMP）。大多数运营商的路由器都支持；有时需要在其设置中开启。
• 一个你自己的域名（例如 yourname.cn），在域名注册商处购买。Ansuz 不出售也不赠送域名。
• 一个 ZoneEdit 账户，用来管理该域名的 DNS。

第 1 步：路由器端口

1. 在设置 › 设备 › 在外面中，开启在路由器上打开端口。
2. 等几秒，查看路由器：
   • 显示端口已打开（通过 UPnP 或 NAT-PMP），并显示公网地址：继续第 2 步。
   • 路由器没有响应：打开路由器设置（通常在浏览器中，地址印在设备标签上），找到 UPnP 并开启。若没有此项，请手动把 Ansuz 显示的 TCP 端口转发到这台 Mac 的地址。
   • 提到 CGNAT 的警告：运营商让许多用户共用一个公网地址，任何端口都到不了你家。此时本指南无法使用；请使用 Tailscale（见 Subsonic 服务器），或向运营商申请独立的公网地址。

第 2 步：在 ZoneEdit 设置域名

1. 在 zoneedit.com 注册账户，并把你的域名添加为区域。ZoneEdit 会显示要使用的域名服务器。
2. 在你购买域名的注册商处，把域名的域名服务器换成 ZoneEdit 的（有的注册商称之为委派域名）。可能要几个小时，变更才会在互联网上生效。
3. 选一个要使用的名称，例如 music.yourname.cn。最好用子域名：域名本身可能已用于其他用途，比如网站。

第 3 步：ZoneEdit 的令牌

Ansuz 需要修改你 DNS 中两条记录的权限：一条临时记录，用来向 Let’s Encrypt 证明域名属于你；另一条是运营商更换地址时该名称的地址。这个权限就是动态验证令牌，它不是你的 ZoneEdit 密码。

1. 在 ZoneEdit 中打开你的域名的 DNS，找到 DYN RECORDS（动态记录），点按扳手图标。
2. 添加你选的名称（例如 music）并设置 TTL（使用 ZoneEdit 建议的值即可）。
3. 在 DYN AUTHENTICATION TOKEN 处点按 ENABLE，然后点按 NEXT 并确认。ZoneEdit 会显示令牌：将其拷贝。

如果找不到这些名称的选项，说明 ZoneEdit 改了网站：请在其帮助中搜索“dynamic authentication token”。

第 4 步：在 Ansuz 中获取证书

1. 在设置 › 设备 › 自动证书中，开启自动获取并续期证书。
2. 名称：你选的完整名称（music.yourname.cn）。
3. DNS 服务商：ZoneEdit。用户：你的 ZoneEdit 用户名（不是电子邮件）。动态验证令牌：第 3 步的令牌。区域：你的域名（yourname.cn）。点按保存凭据。Ansuz 会把它们存在 Mac 的钥匙串中。
4. 开启让名称始终指向这台 Mac（动态 DNS）。几秒后，名称指向会显示你的公网地址。
5. 在开启使用 Let’s Encrypt 测试服务的情况下，点按立即获取证书。需要半分钟到几分钟；状态会显示每一步，最后显示已于 … 获取证书。
6. 关闭测试服务，再次点按立即获取证书：这就是正式证书。申请证书即表示你接受 Let’s Encrypt 订户协议。

此后，Ansuz 会在证书到期前续期（大约每两个月一次），并在公网地址变化时更新名称。为此，Mac 需要不时保持开机。

第 5 步：用户和 App

1. 在Subsonic 用户中，为每部手机或每个人创建一个用户（添加用户…），并在凭证中拷贝其密码。
2. 在 App 中输入外部地址显示的地址（例如 https://music.yourname.cn:4534）、用户和密码。名称必须完全一致：换成其他名称，App 会拒绝证书。同一地址在家和在外都能用。
3. 在 iPhone 版 Ansuz 中：用模式按钮选择在此 iPhone 上播放，然后前往来源 › + › 连接服务器… › Subsonic 服务器。在服务器页面选择音质：转换后，192 kbps更省移动数据。

第 6 步：试一试

关闭手机的无线局域网，用移动数据播放点什么。在 Mac 上，外部访问会显示手机的地址、用户和 App。能用就大功告成了。

如果出了问题

路由器没有响应	路由器关闭了 UPnP：请开启，或手动转发端口（第 1 步）。
CGNAT	运营商没有给你独立地址：请使用 Tailscale，或申请公网地址。
DNS 服务商拒绝了用户或令牌。	确认用户是 ZoneEdit 用户名而不是电子邮件，且令牌属于该区域。如有疑问，在 ZoneEdit 中创建新令牌并重新保存凭据。
DNS 记录在 3 分钟内未生效。	ZoneEdit 比平时慢。稍后再试。
无法连接 Let’s Encrypt	Let’s Encrypt 可能正在维护（状态见 letsencrypt.status.io）。其测试服务有时停机比正式服务更久：遇到这种情况，可以直接获取正式证书。
Let’s Encrypt 无法验证名称	域名尚未委派给 ZoneEdit（第 2 步），或区域不对。委派后请等几个小时。
App 提示证书无效	你输入的名称与证书上的不同，或仍在使用测试服务的证书（第 4 步第 5 项）。
在家能用，在外不能用	名称没有指向你的地址（查看名称指向）、端口未打开（第 1 步），或 Mac 在睡眠。有些运营商会阻止传入连接：请咨询你的运营商。

安全：从互联网只能通过带证书的 HTTPS、凭用户名和密码进入；失败 10 次后，该地址会被封锁 15 分钟。每台设备使用一个用户：丢了手机，只需停用那个用户。若不想再接受外部连接，请关闭在路由器上打开端口。

设置

• 通用：应用语言（需要重新启动）和外观（跟随系统、浅色或深色）。曲目之间的淡入淡出（0 到 12 秒）。ReplayGain 音量均衡（关闭、曲目、专辑、自动）及前置放大和削波保护。调性记谱法：标准或 Camelot。在该专辑页面的按钮下方，有链接可前往作者在 YouTube Music、Apple Music、Spotify 和 TIDAL 上的更多音乐；YouTube Music 链接也出现在该来源的菜单和此设置旁。
• 音频：输出设备、让采样率匹配每个文件以及独占模式。参见音频输出。
• 资料库：标签编辑、SACD 多声道区域和附带的示例专辑（可移除并恢复）。“显示不可用的来源”关闭时，会从边栏隐藏已断开的来源，并从“所有音乐”和“最近添加”隐藏其曲目，直到它们恢复。首页每排书架显示的专辑数（默认 100）。
• Last.fm：账户和记录播放。
• ListenBrainz：用户令牌和发送收听。
• Discogs：用于艺人简介、照片和链接的个人令牌。
• Apple Music：权限、订阅状态和你的播放列表。
• Spotify：通过浏览器连接和你的播放列表。
• TIDAL：通过浏览器连接和你的播放列表。
• 识别：批量指纹识别。
• 设备：允许 iPhone 和 Apple TV 上的 Ansuz 连接、已配对的设备，以及要传到手机上的播放列表及其格式。参见iPhone 上的 Ansuz和Apple TV 上的 Ansuz。

键盘快捷键

⌘O	添加文件夹
⌘⇧R	重新扫描所有来源
空格	播放 / 暂停
⌘→	下一首
⌘←	上一首（或 3 秒后重新开始）
⌘I	正在播放信息
⌥⌘I	显示或隐藏侧边栏
⌘− ⌘+ ⌘0	缩小、放大歌词或恢复实际大小
⌘,	设置
⌘?	本帮助
队列中的 ⌫	移除所选曲目
双击	播放

致谢

Ansuz 基于开源软件构建：TagLib（LGPL 2.1 / MPL 1.1）读写标签，Chromaprint（LGPL 2.1）计算音频指纹并作为可替换的框架随应用一起提供，FFmpeg（LGPL 2.1）解码 DTS-CD 以及 macOS 不自带的格式（APE、WavPack、Musepack、WMA 等），同样作为只含音频解码器的可替换框架，GRDB.swift（MIT）驱动 SQLite 数据库。许可证文本包含在应用包中。

Ansuz 经应用作者 Alberto Yualé 许可，附带其专辑“Desnudo Frente a Vos”（2026）作为示例来源；它像任何其他来源一样显示在边栏中，可以在设置 › 资料库中移除。

元数据来自 AcoustID、MusicBrainz、Cover Art Archive、Last.fm、LRCLIB、Wikidata 和维基百科，各自遵循其自身条款。Ansuz 只为你要求的事情联系它们：识别歌曲、获取封面、歌词或简介，以及在你连接账户后把你的收听发送到 Last.fm。