Overview
入口
- iPhone、iPad: 設定 › 音樂來源管理(「資料庫」分組),點右上角的 +(「新增音樂來源」)。還沒有任何來源時頁面顯示「沒有音樂來源」。
- Mac: 左側邊欄「音樂來源」一節中新增和管理。
進入「選擇音樂來源類型」後,最上方是區域網裡自動發現的裝置(「正在掃描區域網路裝置...」),點一下會預填位址;接著是 Apple Music,然後按分類列出全部類型。
支援的類型
| 分類 | 類型 |
|---|---|
| NAS | Synology(DSM 6/7,支援兩步驗證與 QuickConnect)、QNAP(QTS/QuTS) |
| 通訊協定 | WebDAV、SMB/CIFS(SMB2/3)、FTP/FTPS/FTPES、SFTP、NFS(v3/v4)、UPnP/DLNA、S3(AWS S3 / MinIO / R2) |
| 媒體伺服器 | Jellyfin、Emby、Plex、Subsonic / OpenSubsonic、Navidrome、Airsonic、gonic、飛牛音樂、道理魚、Songloft、Audiobookshelf、Synology Audio Station、Ting Reader |
| 雲端硬碟 | 百度網盤、阿里雲盤、Google Drive、OneDrive、Dropbox、Drime、InfiniCLOUD、115 網盤、123 雲盤、光鴨雲盤、pCloud |
| Apple | Apple Music(同步 Apple Music 訂閱資料庫);Mac 另有 Apple Music 資料庫(本機 Apple Music / iTunes) |
| 本機 | 本機檔案(引用資料夾、引用檔案、複製到 Primuse)、裝置傳輸 |
說明:
- 綠聯 Ugreen 與 飛牛 fnOS 在目前版本不在新增清單中(原始碼中標記為「等待官方公開 API · 尚未開放」)。飛牛 NAS 上的音樂可以透過「飛牛音樂」或 SMB、WebDAV 等通用協定接入。
- 115 網盤 的副標題為「115 開放平台 · 尚未開放」:需要你自己有 115 開放平台的開發者應用憑證才能試用。
- 可以新增任意多個來源,它們會合併成一個資料庫。
新增步驟(通用)
- 選擇類型,填寫「名稱」和伺服器位址。連接埠留空,儲存時 Primuse 會自己試出來。
- 填寫「憑證」:使用者名稱、密碼、API Key 或權杖,按類型而定。需要時在「進階」中設定埠、路徑、加密等。
- 儲存時 Primuse 會先測試連線。如果失敗,會顯示原因(例如「等不到回應」「加密交握沒成功」),可以「修改位址」或「仍然儲存」。
- 檔案型來源(NAS、協定、雲端硬碟)接著選擇要掃描的目錄(「掃描目錄」:連線後選擇要掃描音樂檔案的目錄),點「完成」後開始掃描。媒體伺服器登入後直接同步資料庫。
各類來源的詳細欄位見下方相關文章。
音樂來源清單裡的操作
| 操作 | 作用 |
|---|---|
| 掃描 / 繼續掃描 | 讀取目錄變化;上次中斷時可以接著掃 |
| 連線並選擇目錄 / 管理目錄 | 連線並選擇或修改要掃描的目錄 |
| 健檢 | 逐項檢查位址、憑證、路徑和網路,給出修復建議 |
| 重新登入 | 登入過期時重新登入 |
| 編輯音樂來源 | 修改名稱、位址、憑證和高階選項 |
刪除的音樂來源會先進入 設定 › 最近刪除(「資料庫」分組),可以在那裡恢復。
有聲書和播客內容
- Jellyfin、Emby、Plex、Navidrome、Audiobookshelf、Ting Reader: 新增後再「編輯音樂來源」,在「資料庫」中把每個庫設為「音樂」「有聲書」或「不同步」。選擇伺服器上每個資料庫裝的是什麼。有聲書庫會進書架、用聽書播放頁;不同步的庫下次掃描就不再讀取。
- 其他來源: 在歌曲選單裡選「標記為有聲書」「標記為播客」或「標記為音樂」,可以一次選多首。
- 早期版本里開啟過「整個來源都是有聲內容」的來源,編輯時仍會顯示這個開關:這個來源的所有歌曲都進有聲書書架、用聽書播放頁。單首仍可以標回音樂。