Overview
適用裝置與系統
| 裝置 | 最低系統版本（原始碼設定） | 說明 |
|---|---|---|
| iPhone、iPad | iOS / iPadOS 18.0 | 主要 App，可新增全部類型的音樂來源 |
| Mac | macOS 15.0 | 原生 Mac App，有側邊欄、選單列和桌面歌詞 |
| Apple TV | tvOS 17.0 | 獨立的電視介面，可透過 iCloud 接收 iPhone 上的音樂來源 |
| Apple Watch | watchOS 10.0 | 控制 iPhone 播放，或播放傳到手錶上的離線歌曲 |
部分功能需要更新的系統，例如卡拉 OK 人聲分離所需的模型下載元件只在 iOS、macOS、tvOS 26 及以上提供。App Store 上的實際最低版本請以商店頁面為準。
Primuse 本身不提供音樂內容，也不需要註冊 Primuse 帳號。它播放的是你自己的 NAS、媒體伺服器、雲端硬碟、本機檔案，以及（可選的）Apple Music 訂閱資料庫。
首次開啟
第一次開啟時會看到幾頁介紹：
- 「你的音樂，存在你的伺服器」：說明音樂從你自己的裝置和服務播放。
- 「將音樂彙整到一處」：列出可接入的來源類型。
- 「讓資料庫更完整」：封面、歌詞和專輯資訊的補全，在「設定 > 中繼資料與刮削」中按需啟用和排序。
- 「不只是在手機上聽歌」與「讓首頁更像你的」：播放、投放和首頁個性化。
- 「完全屬於你」：音訊檔案永遠不會離開你的音樂來源；資料庫設定僅透過你自己的 iCloud 同步。
最後可以點「新增第一個音樂來源」直接去新增，也可以點「稍後再說」先進入 App。Mac 上的引導分 3 步，可點「略過引導」略過。
認識主介面
iPhone 底部有四個標籤：首頁、資料庫、搜尋、設定。在任意頁面點底部的播放條可以開啟播放頁。
Mac 使用左側邊欄，「音樂來源」一節裡可以新增和管理音樂來源；設定在選單列 Primuse →「設定…」（⌘,）。
新增第一個音樂來源
App 內引導「三步新增音樂來源」概括了流程，展開如下：
- 開啟 設定 › 音樂來源管理（「資料庫」分組），點右上角的 +（「新增音樂來源」）。
- 在「選擇音樂來源類型」中選擇類型。同一區域網內能發現的裝置會顯示在最上方（「正在掃描區域網路裝置...」）。
- 填寫伺服器位址和帳號。只要填伺服器位址，連接埠和加密方式會自動確認。
- 勾選放音樂的資料夾，點「完成」，掃描會自動開始。可以離開此頁繼續使用，掃描會在背景進行。
雲端硬碟按提示授權登入即可；Navidrome、Jellyfin 等媒體伺服器登入後會同步整個資料庫，不需要選擇資料夾。
預期結果： 掃描時資料庫會分批出現歌曲；掃描結束後，可以在 資料庫 中按歌曲、專輯、演出者等瀏覽，在 搜尋 中搜尋。封面、歌詞等資訊會在背景繼續補讀。
只想先試試本機檔案
在「選擇音樂來源類型」的「本機」一節裡：
- 「引用資料夾」/「引用檔案」：從原位置播放所選音訊，不額外複製。
- 「複製到 Primuse」：儲存由 App 管理的副本，方便離線播放。
- 「裝置傳輸」：在同一區域網路內，將音樂、歌詞及資料夾傳送到另一台 Primuse 裝置。
常見問題
- 找不到某種來源？ 綠聯 Ugreen 與 飛牛 fnOS 目前版本不在新增清單中；區域網裡發現的這兩類裝置即使出現也不能選擇（「等待官方公開 API · 尚未開放」）。完整類型見 新增和管理音樂來源：類型總覽、入口與日常操作。
- 連不上？ 見 音樂來源連不上、登入失敗或掃描不到歌曲怎麼辦。
- 掃描後歌曲不全？ 見 資料庫裡少了歌曲或找不到某首歌怎麼辦。