開始使用

Ansuz 不瀏覽資料夾：它讀取一次你音樂的標籤，建立目錄，然後在此基礎上搜尋、排序和播放。從 ⌘O 或檔案 › 加入資料夾…開始，選擇一個或多個資料夾，可以在本地、外置硬碟或已掛載的 NAS 上。每個資料夾是一個來源，在側邊欄中以一個盧恩符文圖標顯示，右鍵點按可以更換。側邊欄的每個部分（資料庫、來源、播放列表、Apple Music、Spotify）都可以透過懸停時出現在標題右側的箭頭折疊；Ansuz 會記住你關閉了哪些。

Ansuz 從不擅自修改你的檔案。它生成的一切（索引、縮略圖、快取）都存放在自己的資料夾中。

首次掃描先統計檔案數，再讀取每個檔案，進度和剩餘時間按該總數計算；之後的掃描只比較大小和日期，非常快。如果在掃描進行中退出 Ansuz，下次啟動會重新統計並比較整個來源，但只讀取尚未讀取的標籤；掃描完成後，開啟應用程式不會再啟動新的掃描。在掃描進行中退出時，Ansuz 會先提醒並讓你選擇。本地資料夾會被自動監視；網路資料夾從來源的選單重新掃描。如果來源未掛載，其曲目會保持灰色直到它回來。如果你把收藏移到了另一塊硬碟或 NAS，使用來源選單中的重新定位…：評分、播放列表和歷史都會保留。

需要伺服器密碼。Ansuz 會用鑰匙圈中的密碼自動掛載網路檔案夾，不顯示任何對話框。如果鑰匙圈裡沒有密碼（例如你把 NAS 從 AFP 改成了 SMB），該來源會留在側邊欄中並標示需要伺服器密碼，把指標停在上面會有輔助說明告訴你該怎麼做。按右鍵點按該來源 › 在「Finder」中連線⋯會打開連線並填好你的使用者名稱：輸入密碼並勾選在我的鑰匙圈中記住此密碼。之後 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 會分批同步，只取回有變化的內容。

檔案夾顯示方式

除了歌曲和專輯，檔案夾顯示方式依音樂的存放方式來瀏覽：每個來源就是一個檔案夾，進入後看到的就是你在 Finder 中看到的那些檔案夾。它有 Finder 的三種顯示方式，在路徑列右側選擇：圖像（檔案夾顯示其中音樂的封面）、列表（用三角形就地展開檔案夾）和直欄（每一層一欄，並預覽所選歌曲）。按兩下檔案夾可打開，按兩下歌曲則連同該檔案夾的其餘歌曲一起播放。返回和往前箭頭以及路徑列用來來回跳轉，搜尋欄位依名稱過濾目前的檔案夾。右鍵點按檔案夾可播放、隨機播放、加入佇列、用它建立播放列表、對尚未完成的歌曲分析 BPM 和調性或計算 ReplayGain，或者在 Finder 中顯示；歌曲則有平常的選單。任何歌曲的選單和播放器的 ⋯ 選單中的前往檔案夾會跳到包含它的檔案夾。

檔案夾顯示方式來自資料庫索引，而不是磁碟：磁碟或共享中斷連線時它也能用，並且只顯示 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 從這裡播放；其他所有 App 繼續使用系統輸出。Ansuz 會在每次啟動之間記住該裝置。

• 讓取樣率配合每個檔案（預設開啟）：裝置會切換到檔案的取樣率，44.1、48、96 kHz⋯⋯，因此不做任何轉換。如果裝置不支援該取樣率，Ansuz 會使用最接近的整數倍取樣率（例如 44.1 對應 88.2）。相同取樣率的曲目之間保持無縫；兩首曲目的取樣率不同時，裝置切換期間會有短暫的停頓。
• 獨占模式（預設關閉）：只要 Ansuz 載入了曲目，其他 App 就無法透過該裝置播放，連系統聲音也不行。播放停止時即釋放。有些裝置（例如聚集裝置）不允許獨占；設定中會註明。
• 音量：如果所選裝置有自己的音量控制，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，貼上歌詞使用剪貼板，你也可以把檔案拖到面板上。純文本歌詞隨後可以在同步編輯器中同步：在每行被唱出時按空白鍵或 Return，↑↓ 移動，←→ 調整 ±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）、物理檔案及其位置和在 Finder 中顯示的按鈕、資料庫使用情況和歌詞。表格右鍵選單中的曲目資訊…對任何曲目開啟同樣的視窗。

偏好版本

當同一曲目存在於多個來源（比如 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 在一個 App 中提供兩種模式：遙控，瀏覽你 Mac 上的資料庫並控制那裡正在播放的內容；以及在這支 iPhone 上播放，手機上有一個資料庫，把 Mac 拷貝過來的播放列表和你自己的音樂合在一起。沒有 Mac 也能使用 iPhone。iPhone 與 Mac 之間的一切都經由你的區域網路加密傳輸，中間沒有帳戶，也沒有伺服器。用左上角的按鈕切換模式。

兩種模式下的第一個分頁首頁以書架顯示你的收藏、最近播放和最常播放的專輯；橫向滑動書架，或點一下標題查看全部。專輯頁面上的心形可將其收藏。控制 Mac 時，書架來自 Mac；在 iPhone 上則來自手機裡的音樂，包括在任一端收藏的專輯（每次同步都會帶過去）以及這支 iPhone 的播放記錄。

你的音樂，不需要 Mac。Ansuz 在「檔案」App 中有自己的資料夾（我的 iPhone › Ansuz）：拷貝到那裡的內容會自動加入資料庫，在「檔案」中從那裡刪除的內容也會離開資料庫。你也可以用傳輸線從電腦把音樂拷貝進去：在 Mac 上用 Finder（iPhone 的「檔案」區段），在 Windows 上用「Apple 裝置」App。Ansuz 資料夾不包含在 iCloud 備份中：換 iPhone 時需要重新拷貝音樂。

匯入和加入資料夾。在來源中，+ 按鈕提供從「檔案」匯入⋯、從電腦傳送⋯、連接伺服器⋯和加入「音樂」資料庫（見下文）。從「檔案」匯入⋯會打開一個選擇器，可以同時勾選音訊檔、zip 和資料夾：檔案會被拷貝到 Ansuz 資料夾；對每個資料夾，Ansuz 都會詢問：拷貝到 Ansuz 會把它留在 iPhone 上，即使原件不在了也不受影響；就地使用 不佔空間，但只有在資料夾可用時才能播放：接上的隨身碟、iCloud 雲碟、在「檔案」中連接的網路伺服器、Google Drive、Dropbox、OneDrive⋯⋯ 就地使用的資料夾永遠不會被修改。選擇器不能同時勾選多個資料夾：要選擇資料夾，請進入包含它們的資料夾，不勾選任何項目，直接點一下打開。如果其中有子資料夾，Ansuz 會顯示選擇要匯入的內容，每個子資料夾都已勾選（取消勾選不需要的；該資料夾中散放的音樂也會列出）：將所選內容拷貝到 Ansuz 會拷貝勾選的內容，就地使用「資料夾」 則使用整個資料夾及其所有子資料夾。例如，打開「下載項目」，在其中勾選專輯。對於音訊檔和 zip，Ansuz 也會出現在「打開方式」和分享選單中：AirDrop、WhatsApp、郵件、Safari 下載項目；它們會被拷貝到 Ansuz 資料夾並自動加入。zip 絕不會未經詢問就解壓縮（要解壓縮音樂嗎？），而且只取出音樂、.lrc 歌詞、.cue 表和封面。在 iPhone 上，Ansuz 可播放 FLAC、ALAC 和 AAC（M4A）、MP3、WAV 和 AIFF，並直接在手機上讀取標籤和封面（內嵌或 cover.jpg）。頂部的橫條會顯示匯入進度，附有取消按鈕，之後顯示結果。

從電腦傳送。在來源 › + › 從電腦傳送⋯中，iPhone 會顯示一個位址（例如 http://192.168.1.20:8080）、該位址的 QR 碼和一組六位數 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 或電腦的共享資料夾，透過「檔案」App 連接。輸入位址（例如 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、單曲、精選集和合輯的作品。沒有訊號時，就像串流 App 一樣，只在伺服器上的內容會消失，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 雲碟或其他供應商的資料夾時，才會透過「檔案」App 與該供應商通訊。你 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.tw），在網域註冊商處購買。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.tw。最好用子網域：網域本身可能已用於其他用途，例如網站。

第 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.tw）。
3. DNS 服務商：ZoneEdit。使用者：你的 ZoneEdit 使用者名稱（不是電子郵件）。動態驗證權杖：第 3 步的權杖。區域：你的網域（yourname.tw）。按一下儲存憑證資料。Ansuz 會把它們存在 Mac 的鑰匙圈中。
4. 開啟讓名稱始終指向這台 Mac（動態 DNS）。幾秒後，名稱指向會顯示你的公用位址。
5. 在開啟使用 Let’s Encrypt 測試服務的情況下，按一下立即取得憑證。需要半分鐘到幾分鐘；狀態會顯示每一步，最後顯示已於 … 取得憑證。
6. 關閉測試服務，再按一下立即取得憑證：這就是正式憑證。申請憑證即表示你接受 Let’s Encrypt 訂戶協議。

此後，Ansuz 會在憑證到期前續期（大約每兩個月一次），並在公用位址變更時更新名稱。為此，Mac 需要不時保持開機。

第 5 步：使用者和 App

1. 在Subsonic 使用者中，為每部手機或每個人建立一個使用者（加入使用者…），並在憑證中拷貝其密碼。
2. 在 App 中輸入外部位址顯示的位址（例如 https://music.yourname.tw:4534）、使用者和密碼。名稱必須完全一致：換成其他名稱，App 會拒絕憑證。同一位址在家和在外都能用。
3. 在 iPhone 版 Ansuz 中：用模式按鈕選擇在這支 iPhone 上播放，然後前往來源 › + › 連接伺服器⋯ › Subsonic 伺服器。在伺服器頁面選擇音質：轉換後，192 kbps更省行動數據。

第 6 步：試一試

關閉手機的 Wi-Fi，用行動數據播放點什麼。在 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。