全部功能和設定
Lyrimuse 是一款開源（GPL-3.0）的 macOS 逐字歌詞 App，支援 macOS 14 及以上版本，相容 Apple Silicon 和 Intel 晶片。它為 Apple Music、Spotify、QQ 音樂、網易雲音樂、酷狗音樂、汽水音樂、KKBOX、Amazon Music、洛雪音樂、Kaset、reAMP，以及瀏覽器中的 YouTube Music 和 Spotify 網頁版顯示逐字同步的歌詞：可顯示在桌面浮動歌詞、動態島、選單列、觸控列和歌詞視窗中，並提供譯文和讀音標註（拼音、粵拼、日文羅馬拼音、韓文羅馬字），還可將聆聽記錄打卡到 Last.fm 和 ListenBrainz，並在 Discord 上顯示正在聆聽的歌曲。介面支援簡體中文、繁體中文和英文。
這一頁列出 Lyrimuse 的每一項功能：做什麼、在設定的哪裡、安裝後預設開著還是關著，最後附上設定視窗裡的全部設定項目。同一份清單在 GitHub 上也有 Markdown 版。
1 預設關著的功能
下面這些功能安裝後不會自己打開，要先去設定裡打開（有的還要連上帳號或給權限）：
| 功能 | 在哪裡打開 |
|---|---|
| Apple Music 官方歌詞 | 設定 › 歌詞 › 取得 › 歌詞來源 |
| 直接使用播放器儲存在本機的歌詞 | 設定 › 播放器 › 權限與服務 › 完整磁碟取用權限 |
| 鎖定手選歌詞 | 設定 › 歌詞 › 取得 › 鎖定手選歌詞 |
| 無譯文時自動翻譯 | 設定 › 歌詞 › 譯文 › 無譯文時自動翻譯 |
| 長句拆分、短句合併 | 設定 › 歌詞 › 調整 › 長句拆分 |
| 動態島歌詞 | 設定 › 歌詞顯示 › 動態島 › 動態島歌詞 |
| 選單列歌詞 | 設定 › 歌詞顯示 › 選單列 › 選單列歌詞 |
| 觸控列歌詞 | 設定 › 歌詞顯示 › 觸控列 › 觸控列歌詞 |
| 歌詞視窗 HDR 高亮 | 設定 › 歌詞顯示 › 歌詞視窗 › 文字 › HDR 高亮 |
| 迷你視窗在暫停或全螢幕時隱藏 | 設定 › 歌詞顯示 › 歌詞視窗 › 行為 › 暫停時隱藏 |
| 換句動畫 | 設定 › 歌詞顯示 › 浮動歌詞 › 排版 › 換句動畫 |
| 指標指向時淡化 | 設定 › 歌詞顯示 › 浮動歌詞 › 行為 › 指向時淡化 |
| 鎖定位置、長按拖移 | 設定 › 歌詞顯示 › 浮動歌詞 › 行為 › 鎖定位置 |
| 螢幕快照、螢幕錄製和螢幕分享時隱藏 | 設定 › 歌詞顯示 › 浮動歌詞 › 行為 › 螢幕快照時隱藏 |
| 暫停時隱藏或收起 | 設定 › 歌詞顯示 › 浮動歌詞 › 行為 › 暫停時隱藏 |
| 純音樂或無歌詞時隱藏或收起 | 設定 › 歌詞顯示 › 浮動歌詞 › 行為 › 純音樂/無歌詞時隱藏 |
| 全螢幕時隱藏浮動歌詞 | 設定 › 歌詞顯示 › 浮動歌詞 › 行為 › 全螢幕時隱藏 |
| 網頁歌詞：用手機、平板作為副螢幕，或作為 OBS 瀏覽器來源 | 設定 › 歌詞顯示 › 歌詞視窗 › 網頁歌詞 |
| 瀏覽器中的 YouTube Music、Spotify 網頁版 | 設定 › 播放器 › 網頁版 |
| 自動略過 YouTube Music 廣告 | 設定 › 播放器 › 網頁版 › 自動略過 YouTube Music 廣告 |
| 隨播放器啟動和退出 | 設定 › 播放器 › 連動 › 打開 Lyrimuse 時啟動 |
| Last.fm 打卡與聆聽檔案 | 設定 › Last.fm › 設定 › Scrobble 規則 |
| 同步到 ListenBrainz | 設定 › 實驗室 › ListenBrainz › 帳號資訊 |
| 在 Discord 上顯示正在聆聽的歌曲 | 設定 › Discord › 在 Discord 上顯示 |
| 可分享的「正在聆聽」網頁 | 設定 › 實驗室 › 網頁推送 › 連線資訊 |
| 日報、週報、月報和年度聆聽小結 | 設定 › 實驗室 › 推播提醒 › 推播管道 |
| 靜默啟動 | 設定 › 一般 › 啟動與通知 › 靜默啟動 |
| 換歌時顯示通知 | 設定 › 一般 › 啟動與通知 › 換歌時顯示通知 |
| 自動更新與測試版 | 設定 › 軟體更新 › 更新設定 › 自動檢查 |
2 尋找歌詞
十四個歌詞來源自動查找
網易雲音樂、QQ 音樂、酷狗、酷我、咪咕、Musixmatch、LRCLIB、LyricFind、Deezer、AMLL、汽水音樂、VIBE、Genie 和 Apple Music。每個歌詞來源均可單獨開關、調整順序，或測試目前是否可連線。
Apple Music 官方歌詞
在「歌詞來源」中連線至 Apple Music 帳號後，即可使用 Apple Music 官方歌詞，多數歌曲帶逐字時間軸。需要 Apple Music 訂閱。
智慧比對
預設對各歌詞來源的結果評分，依歌名、歌手、時長和版本（現場版、伴奏等）選出與目前播放歌曲最吻合的一份。也可改為「順序優先」：不評分，依你設定的順序採用第一個有結果的歌詞來源。
比對規則更新後重新選擇
新版本改進比對演算法或評分規則後，在背景重新評估已有歌詞，有更合適的版本時自動替換。關閉後，歌詞一經選定不再自動更換。
預先取得後續歌曲的歌詞
讀取播放器的播放佇列，預先為接下來的幾首歌曲取得歌詞；無法讀取佇列時，優先取得同一專輯中的其他歌曲。QQ 音樂、網易雲音樂、酷狗音樂和汽水音樂的佇列需要「完整磁碟取用權限」才能讀取。
直接使用播放器儲存在本機的歌詞
QQ 音樂、網易雲音樂、酷狗音樂、KKBOX、Amazon Music 和洛雪音樂自己儲存的歌詞可直接使用，與播放器顯示的版本一致，速度也更快；reAMP 播放時使用檔案內嵌的歌詞或同名 .lrc 檔案。QQ 音樂、網易雲音樂、酷狗音樂需要在系統設定中為 Lyrimuse 開啟「完整磁碟取用權限」；未授權時仍可連線尋找歌詞。
歌詞來源異常提醒
某個歌詞來源近期幾乎找不到歌詞、命中率明顯低於平時、頻繁出錯或無法連線時，「歌詞來源」中該來源旁會顯示提醒，按一下可查看判斷依據的次數和比例。其他歌詞來源照常搜尋，統計僅在本機進行。
鎖定手選歌詞
開啟後，從搜尋結果中手動選擇的歌詞將被鎖定，之後的自動比對和重新比對均不會替換。
歌詞管理視窗
瀏覽、編輯、刪除或重新搜尋任意歌曲的歌詞，支援多選批次刪除，並可一次清理廣告和 Podcast 留下的空記錄。時間軸不準的歌曲可單獨調整偏移。尚無歌詞的歌曲可一鍵全部重試，整個歌詞庫也可依目前規則重新比對（每首之間的間隔可調），手動修改過的歌詞不受影響。
同曲條目：同一首歌曲共用歌詞
同一首歌在不同播放器、不同專輯版本中的條目會被辨識為同一首：各條目共用一份歌詞，手動修改和時間軸校正同步生效，播放次數合併統計。在歌詞管理中打開「同曲條目」可逐行對照各條目的歌詞，辨識有誤的條目可拆分，之後也可恢復合併。關閉共用後，各條目分別比對歌詞。
隨時更換、修改歌詞
在歌詞視窗的「⋯」選單中搜尋其他歌詞、重新自動比對，或在外部文字編輯器中修改。編輯逐字歌詞時只修改文字，每個字的時間保持不變。
離線可用，歌詞以 .lrc 檔案儲存
已找到的歌詞均快取在本機，離線時也能顯示。每首歌曲儲存一份 .lrc，有譯文、讀音時另存 .tr.lrc 和 .roma.lrc，逐字時間軸存為 .yrc。預設位於 ~/.config/lyrimuse/lyrics/，位置可更改。
3 譯文、讀音與歌詞處理
譯文
歌詞來源內附的譯文顯示在原文下方。網易雲音樂、QQ 音樂、酷狗的譯文為中文；Musixmatch 和機器翻譯依所選譯文語言提供，共 17 種可選。浮動歌詞、歌詞視窗、動態島、選單列、觸控列可分別設定是否顯示。系統語言包含中文時預設顯示。
無譯文時自動翻譯
歌詞來源未提供譯文時使用機器翻譯。在 macOS 15 及以上且已下載翻譯語言包時，由 macOS 內建的 Apple 翻譯在本機完成，歌詞不離開本機；無法在本機翻譯時，將待翻譯的歌詞傳送至 Google 翻譯，仍不可用時改用 MyMemory。翻譯語言包可在同一張卡片中下載。
讀音標註
日文羅馬拼音、韓文羅馬字、國語拼音、粵語粵拼，逐詞標註在歌詞上方。逐行判斷語言：中文歌曲中夾有一句日文時，只為該句標註。標註哪些語言可在此處選擇，中文介面預設不標註國語拼音。各顯示位置可分別設定是否顯示。
繁簡轉換
將中文歌詞統一顯示為簡體或繁體，與 App 介面語言無關。
長句拆分、短句合併
浮動歌詞、動態島、選單列和觸控列依各自的可用寬度，將放不下的長句拆分為多句，將一閃而過的短句合併為一句。歌詞視窗仍依一句一行顯示。兩項各有獨立開關。
時間軸偏移
整體提前或延後歌詞，可僅對某個播放器生效。單首歌曲可在歌詞管理中單獨調整；也可透過快速鍵隨時提前、延後或歸零。
4 歌詞顯示位置與外觀
桌面浮動歌詞
浮於所有視窗之上、始終置頂的歌詞，逐字亮起。可拖移到任意位置，也可固定在螢幕頂部置中或 Dock 上方置中。連接多台顯示器時，可固定在其中一台，也可跟隨目前使用的視窗切換到其所在的顯示器。可同時顯示讀音、譯文和下一句。
動態島歌詞
緊貼螢幕頂部瀏海的膠囊，沒有瀏海的 Mac 和外接顯示器上同樣可用。左右兩側可分別顯示歌名、歌手、專輯、封面、播放控制、已播放或剩餘時長，旁邊是隨音樂跳動的音浪。指標指向時展開，提供播放控制、進度列、歌詞校正，以及喜歡、搜尋歌詞等快捷按鈕。播放廣告時顯示剩餘時長。
選單列歌詞
目前歌詞直接顯示在選單列中，過長時捲動顯示，不會被截斷。可增加一行顯示下一句、譯文或讀音。
觸控列歌詞
在配備觸控列的 MacBook Pro 上，目前歌詞在觸控列上隨演唱位置捲動，還可顯示封面和播放控制。歌詞顏色可選白色、跟隨封面或自訂，未唱部分的亮度可調。可在開始播放時自動展開、暫停時自動收起；「更多」按鈕中提供歌詞校正、喜歡、隨機和循環、音量和播放進度。
歌詞視窗
參照 Apple Music 歌詞頁設計的整頁歌詞：以模糊的封面為背景，整首歌詞隨播放捲動到目前句；對唱依歌手分開，和聲單獨成行，拖長音的字會放大並發光。背景可選跟隨封面、純色、漸層或毛玻璃，文字粗細、已唱顏色和對齊方式均可調整。可從選單列圖像或快速鍵打開。
歌詞視窗 HDR 高亮
在支援 HDR 的螢幕上，將歌詞視窗目前句已唱部分的亮度提升到一般白色以上。預設關閉，開啟後更耗電；僅完整尺寸可用。
迷你歌詞視窗
將歌詞視窗縮小為一張小卡片，可選僅顯示目前句、目前句加下一句，或整頁捲動。背景、文字顏色、字體、粗細、已唱顏色，以及頂部的歌名、封面、時間均可單獨設定。
迷你視窗在暫停或全螢幕時隱藏
暫停或未播放時迷你視窗自動隱藏，開始播放後重新顯示；所在螢幕有 App 全螢幕（如觀看影片、玩遊戲）時也可自動隱藏。兩項各有獨立開關。
動態封面
Apple Music 上帶動態封面的專輯，在完整尺寸的歌詞視窗中封面也會動態播放。低電量模式或開啟「減少動態效果」時自動停止。可查看已下載的動態封面佔用的空間，並可清除。
未播放時的聆聽總覽
未播放時，歌詞視窗顯示上次播放的歌曲、從其歌詞中選取的一句和「繼續播放」按鈕。連線至 Last.fm 後，還會顯示今日、近 7 天和累計聆聽次數，近 30 天走勢、「那年今日」，以及帶封面的最近播放。
外觀自訂
字體（跟隨系統，或匯入 .ttf / .otf 字體）、字級、粗細、文字和背景顏色、描邊、毛玻璃背景。浮動歌詞提供多套配色主題，也可將自訂配色儲存為主題；文字顏色可跟隨專輯封面變化。浮動歌詞的字級還可透過快速鍵，或按住 ⌘ 在歌詞上捲動滑鼠滾輪或雙指上下輕掃隨時調整。
逐字卡拉OK效果
目前演唱到的字逐字亮起。浮動歌詞、動態島、選單列、觸控列，以及歌詞視窗的完整、迷你兩種尺寸各有獨立開關，關閉後整句同時亮起。
換句動畫
浮動歌詞切換到下一句時，上一句向上移出、下一句隨之移入，而非直接替換。
指標指向時淡化
指標移到浮動歌詞上時變為半透明，不遮擋下方內容。迷你歌詞視窗另有獨立開關，並可設定淡化時按一下穿透到下層視窗，按住 ⌥ 時可操作迷你視窗。
鎖定位置、長按拖移
鎖定後浮動歌詞無法被拖移；也可改為長按後才能拖移，避免誤觸。
指標指向時顯示控制列
指標移到浮動歌詞上時顯示一排快捷按鈕。選單列歌詞也可在指標指向時顯示播放控制。
螢幕快照、螢幕錄製和螢幕分享時隱藏
拍攝螢幕快照、螢幕錄製或在會議中分享螢幕時，其他人看不到歌詞，你自己仍可正常看到。浮動歌詞和動態島各有獨立開關。
暫停時隱藏或收起
暫停或未播放時，浮動歌詞和動態島自動隱藏；動態島也可只縮回到瀏海大小。
純音樂或無歌詞時隱藏或收起
目前歌曲為純音樂，或搜尋確認無歌詞時，浮動歌詞可隱藏，動態島和觸控列可收起歌詞行；搜尋期間照常顯示。三處各有獨立開關。
全螢幕時隱藏動態島
觀看影片、玩遊戲等全螢幕場景下，動態島歌詞自動收起。
全螢幕時隱藏浮動歌詞
浮動歌詞預設始終浮在全螢幕 App 之上。開啟後，在觀看影片、玩遊戲等全螢幕場景下自動隱藏，退出全螢幕後重新顯示。
換歌時顯示歌名
每次切歌時，新歌曲的歌名和歌手從動態島中滑出，短暫停留後收回。
聆聽里程碑
某首歌曲達到第 100、1,000、10,000 次聆聽，或 Last.fm 累計聆聽跨過整數檔時，動態島展開提示一次。需要連線至 Last.fm。
網頁歌詞：用手機、平板作為副螢幕，或作為 OBS 瀏覽器來源
在瀏覽器中顯示歌詞。網頁歌詞顯示的是歌詞視窗的畫面；OBS 輸出背景透明，字體和顏色與浮動歌詞一致。兩者各自設定連接埠與區域網路存取；預設只對本機開放，開啟「允許區域網路存取」後，同一網路中的裝置可掃描 QR Code 開啟，連結帶有存取金鑰。開啟「允許遠端控制」後，還能在網頁上控制播放、點歌詞跳轉。
5 播放器與播放控制
十一款播放器，可多選或自動辨識
Apple Music、Spotify、QQ 音樂、網易雲音樂、酷狗音樂、汽水音樂、洛雪音樂、KKBOX、Amazon Music、仿 Winamp 的 reAMP，以及 YouTube Music 用戶端 Kaset。可同時選擇多個，也可保持自動辨識，跟隨 macOS「正在播放」中的播放器。支援 Apple Music 電台，主持人講話時顯示電台名稱和台標。
瀏覽器中的 YouTube Music、Spotify 網頁版
配對常用的瀏覽器後，網頁中播放的歌曲同樣可顯示歌詞，進度直接取自網頁。提供一鍵偵測，先確認該瀏覽器能否被控制。播放廣告時，動態島顯示剩餘時長和目前是第幾則廣告。
自動略過 YouTube Music 廣告
瀏覽器中的 YouTube Music 出現「略過」按鈕時自動按一下。未開啟時，也可在動態島上手動略過。需要「輔助使用」權限。
新增其他播放器
未列出的播放器可從「應用程式」中選擇並加入信任列表；偵測到未知播放器正在播放時，也會提示是否新增。
依需求申請權限
Apple Music、Spotify 和 Kaset 需要「自動化」權限才能讀取播放狀態；QQ 音樂、網易雲音樂、酷狗音樂需要「完整磁碟取用權限」才能使用本機歌詞和播放佇列，汽水音樂需要該權限讀取播放佇列；Amazon Music 的進度校正，QQ 音樂、網易雲音樂、酷狗音樂、汽水音樂、Amazon Music 和 reAMP 的隨機、循環、喜歡按鈕，以及其他 App 佔用「正在播放」時 QQ 音樂、網易雲音樂和汽水音樂的播放按鈕，需要「輔助使用」權限；瀏覽器中的網頁播放器需要為瀏覽器開啟「自動化」權限，並在瀏覽器中開啟「允許 Apple 事件中的 JavaScript」。其他播放器無需權限。設定中會標明每項的目前授權狀態。
播放控制與進度跳轉
在歌詞視窗和展開的動態島上播放、暫停、切歌，拖移進度列跳轉。隨機、循環、喜歡和音量取決於播放器的支援情況：Apple Music、Spotify、Kaset、QQ 音樂、Amazon Music 和瀏覽器中的 YouTube Music 支援其中部分或全部功能，網易雲音樂、酷狗音樂、汽水音樂和洛雪音樂支援喜歡，洛雪音樂在其設定中開啟開放 API 後還可調整音量。播放、暫停、切歌和喜歡也可設定全域快速鍵。瀏覽器影片等 App 佔用系統「正在播放」時，QQ 音樂、網易雲音樂和汽水音樂的播放、暫停和切歌改為透過其自身的選單或播放列操作，此時無法拖移進度跳轉。
一鍵打開歌曲頁面
在「⋯」選單中按一下，即可打開目前歌曲、所屬專輯或歌手在該平台上的頁面。Apple Music 和 KKBOX 在各自的 App 中打開，Spotify 的歌曲在其 App 中打開；其他均打開網頁：Spotify 的專輯和歌手、QQ 音樂、汽水音樂、Amazon Music 和 YouTube Music。網易雲音樂僅提供歌曲頁，酷狗音樂不提供。
歌曲、專輯和歌手簡介
在歌詞視窗或展開的動態島上按一下歌名、歌手名或專輯名即可查看簡介。專輯和歌手簡介優先取自 Apple Music；沒有時，中文介面依次尋找汽水音樂、網易雲音樂，然後是 YouTube Music 上的維基百科介紹，最後是 Last.fm。歌曲簡介在中文介面優先取自 QQ 音樂，其次是 Last.fm。使用 Last.fm 來源需要連線至 Last.fm 帳號。
隨播放器啟動和退出
可為每個播放器單獨設定：打開 Lyrimuse 時同時打開播放器、打開播放器時同時打開 Lyrimuse，或在所跟隨的播放器全部退出後自動退出。
6 聆聽記錄、Last.fm 與分享
Last.fm 打卡與聆聽檔案
一鍵連線至 Last.fm，無需拷貝權杖。可查看今日、近 7 天和累計聆聽次數，歌手、專輯、歌曲排行榜及排名變化；「足跡」中提供全年熱度圖（按一下某一天可查看當天聆聽最多的歌曲）、聆聽時段、常聽歌手的國家和地區以及「那年今日」。最近播放中的每首歌曲都可按一下紅心標記喜歡。
自訂打卡規則
可設定播放到 50%、75%、90% 或完整播放後才計為一次；可設定是否計入短於 30 秒的歌曲；預設將合唱署名、繁簡寫法和「- Single」等後綴對齊到 Last.fm 的正式條目，也可依原樣傳送；還可將某個播放器整體排除在 Last.fm 之外。
每次播放先記錄在本機
未連線至 Last.fm 時，聆聽記錄先儲存在本機；連線後，在 Last.fm 頁面的「待補交的聆聽記錄」中按一下「補交」即可上傳。已連線期間可能未成功上傳的記錄，會自動與 Last.fm 核對並補交。Last.fm 僅接受約兩週內的聆聽記錄。
同步到 ListenBrainz
每次播放基於同一份播放狀態分別傳送到 Last.fm 和 ListenBrainz，兩邊記錄一致。還可將 iPhone 透過 Last.fm 記錄的播放匯入 ListenBrainz。位於側邊欄的「實驗室」中。
在 Discord 上顯示正在聆聽的歌曲
個人檔案和好友列表中顯示播放器、歌名、歌手、封面和進度列，按一下歌名、歌手可打開播放器網站上的對應頁面。專輯那一行可替換為目前演唱的歌詞，個人檔案下方還可新增最多兩個按鈕。文字排列方式、計入哪些播放器、暫停時是否保留、封面角標顯示什麼圖像均可設定；也可僅顯示所用播放器而不顯示歌曲資訊，或暫時隱藏一段時間。
可分享的「正在聆聽」網頁
一個公開網頁，顯示你正在聆聽的歌曲和聆聽歷史，可新增留言牆、表情回應、訪客計數、Top 10 歌手榜和黑膠效果。只需設定 ListenBrainz 即可顯示即時播放和歷史；需要更多功能時，可依教學部署一個 Cloudflare Worker。位於「實驗室」中。
日報、週報、月報和年度聆聽小結
推播到你設定的管道，可同時設定多個：Bark、ntfy、Server醬、飛書、釘釘、企業微信、Telegram、Discord、Slack，或通用 Webhook。每個管道都可傳送測試；推播記錄中可查看每次是否送達，未送達的可重新傳送。四種小結各有獨立開關。位於「實驗室」中。
7 日常使用
首次啟動引導
首次打開時，逐步引導你選擇播放器、配對瀏覽器、選擇歌詞顯示位置，並逐項檢查所需權限，缺少的權限可當場補上。
簡體中文、繁體中文、英文介面
預設跟隨系統，切換後立即生效，無需重新啟動。
淺色、深色或跟隨系統
設定、歌詞視窗、歌詞管理和選單列面板可固定使用淺色或深色外觀，預設跟隨系統。浮動歌詞始終跟隨系統，動態島始終為深色。
全域快速鍵
可為以下操作設定快速鍵：顯示或隱藏各類歌詞（也可一鍵全部隱藏，適合會議和共享螢幕時使用）、打開歌詞視窗和歌詞管理、搜尋歌詞、調整時間軸、播放控制、喜歡、切換到播放器等。預設不佔用任何按鍵。
深度連結（lyrimuse://）
lyrimuse:// 連結可打開設定的任意頁面、歌詞視窗和歌詞管理，也可執行快速鍵支援的所有操作（播放控制、喜歡、隱藏全部歌詞等），適用於「捷徑」、Raycast、Alfred 等工具。在「捷徑」中透過 x-callback-url 打開時，還可將歌名、歌手、專輯和目前歌詞作為參數傳回。「快速鍵」頁面的「深度連結」卡片列出了全部連結，可直接拷貝。
設定搜尋
在設定視窗側邊欄頂部輸入關鍵字，即可跳轉到對應設定項並醒目標示，收合的分組也會自動展開。支援中文和英文搜尋。
選單列圖像
提供 12 款圖像，播放時隨音樂律動，暫停時靜止。常用操作均在其下拉選單中。
在 Dock 中顯示
關閉後僅保留選單列圖像。
登入時啟動
登入 Mac 時自動打開 Lyrimuse。
靜默啟動
啟動時不打開任何視窗，僅顯示選單列圖像。
換歌時顯示通知
每次切歌時傳送一則系統通知。
備份設定、換新 Mac
可將全部設定匯出為一個檔案，預設儲存到 iCloud 雲碟，也可選擇其他檔案夾；新 Mac 首次打開 Lyrimuse 時，若在 iCloud 中找到備份，會提示是否匯入。
自動更新與測試版
自動檢查新版本，可在「軟體更新」頁面查看更新說明並安裝。如需提前體驗新功能，可開啟「測試版更新」。
一鍵匯出診斷、回報問題
將記錄檔、當機報告和執行狀態打包為一個檔案，已移除帳號憑證和本機使用者名稱。「回報問題」會在 GitHub 新增 issue，並自動附上版本、系統和播放器資訊。
8 全部設定項目
設定視窗裡的每一項，依所在位置列出，共 270 項。在設定視窗側邊欄頂部的搜尋欄位輸入名稱，可以直接跳到那一項。
歌詞 › 取得
- 歌詞來源
- 比對演算法
- 隨比對演算法更新重新選擇：開（預設）：比對演算法或評分規則更新後，會在背景重新評估已有歌詞，並可能更換為更合適的版本；關：歌詞確定後不再自動更換；首次解析、手動重新搜尋和手動編輯不受影響
- 同曲條目共用歌詞：開（預設）：同一首歌在不同播放器、不同專輯版本下、可確認為同一錄音的條目使用同一份歌詞，手動修改一併同步；關：各條目分別比對歌詞，已同步的條目恢復為原來的歌詞
- 預解析待播曲目
- 鎖定手選歌詞：關（預設）：僅替換本次歌詞，之後的自動搜尋或評分變化仍可能再次替換；開：鎖定這首歌曲的歌詞，自動比對不再更改；開啟後，此前手動選定的歌曲一併鎖定（已被自動替換的除外）
歌詞 › 譯文
- 譯文語言：各處是否顯示譯文，在「歌詞顯示」中設定
- 無譯文時自動翻譯：優先在本機翻譯，無法翻譯時再連線翻譯
- 翻譯語言包：僅列出可翻譯為目前譯文語言的語言，因此可能少於「系統設定」中的數量。按一下未下載的語言即可下載
歌詞 › 調整
- 繁簡轉換：中文歌詞統一成簡體或繁體
- 標註讀音的語言：為勾選的語言標註讀音；是否顯示在「歌詞顯示」中設定
- 長句拆分：單行無法完整顯示時，拆分為多段依次顯示
- 短句合併：相鄰短句可容納於一行時合併顯示
- 時間軸偏移：正值歌詞提前，負值延後
歌詞 › 管理
- 歌詞庫
- 自動比對缺少的歌詞：僅搜尋無歌詞或僅有純文字歌詞的歌曲
- 重新比對整個歌詞庫：已有歌詞的歌曲也重新選擇；手動修改、已校正和純音樂的歌曲保持不變
- 掃描間隔：每首歌曲之間的間隔秒數；建議不少於 2 秒，以免被限流
- 歌詞檔案夾：更改位置後，已有檔案不會隨之移動
播放器
- 音樂 App
- 網頁版：在瀏覽器中播放時同樣可顯示歌詞。按一下「+」配對所用瀏覽器，播放進度直接從網頁讀取，切歌後立即同步
- 其他 App：未在上方列出的 App 也可作為播放器：新增後將顯示其正在播放的歌曲，並計入聆聽記錄。按一下圖像即可移除
- 新增 App…：從「應用程式」中選擇，無需等待其開始播放
- 新播放器提醒
播放器 › 網頁版
- 自動略過 YouTube Music 廣告：可略過的廣告出現時自動略過
播放器 › 權限與服務
- 自動化權限
- 完整磁碟取用權限
- 輔助使用權限
- 洛雪音樂開放 API：Lyrimuse 透過此介面讀取洛雪音樂的播放進度並調節其音量
- 歌詞引擎：讀取播放狀態，取得歌詞和封面
播放器 › 連動
- 播放器連動：每項均按播放器分別勾選，僅列出已選擇的播放器；選擇「自動識別」時，還會列出本機已安裝的播放器
- 打開 Lyrimuse 時啟動
- 跟隨播放器啟動
- 跟隨播放器結束
歌詞顯示 › 浮動歌詞
- 桌面浮動歌詞
- OBS
- 寬度
- 位置
- 所在螢幕
- 回復預設：不含內容、排版、行為、位置、OBS 和寬度
歌詞顯示 › 浮動歌詞 › OBS
- OBS 輸出：作為瀏覽器來源疊加到直播畫面，寬高設為 OBS 畫布尺寸
- 瀏覽器來源網址
- 允許區域網路存取：同一網路中的裝置可透過帶金鑰的連結存取
- 存取連結
- 備用連結（IP 位址）
- 重設存取金鑰：已分享的連結將會失效
- 連接埠：更改後需同步修改 OBS 中的網址
歌詞顯示 › 浮動歌詞 › 主題
- 配色主題
- 我的配色主題
歌詞顯示 › 浮動歌詞 › 字形
- 字體
- 粗細
- 字級
歌詞顯示 › 浮動歌詞 › 顏色
- 卡拉OK效果
- 文字顏色
- 文字描邊
- 描邊顏色
- 未唱顏色
- 背景顏色
- 毛玻璃背景
- 玻璃濃淡
歌詞顯示 › 浮動歌詞 › 內容
- 讀音
- 譯文
- 下一句
歌詞顯示 › 浮動歌詞 › 排版
- 對齊方式
- 長句處理
- 換句動畫：換句時，下一句從原本的位置移到目前這一行；關閉時直接切換
- 讀音間距
- 譯文間距
- 下一句間距
歌詞顯示 › 浮動歌詞 › 行為
- 鎖定位置
- 長按拖移
- 指向時淡化
- 指向時顯示控制列
- 螢幕快照時隱藏
- 暫停時隱藏
- 純音樂/無歌詞時隱藏
- 全螢幕時隱藏
歌詞顯示 › 動態島
- 動態島歌詞：緊貼螢幕頂部的瀏海顯示
- 風格
- 螢幕
- 左耳
- 右耳
- 寬度
- 展開寬度
- 回復預設：不含寬度和總開關
歌詞顯示 › 動態島 › 風格
- 圓角
- 展開圓角
歌詞顯示 › 動態島 › 左耳
- 音浪
歌詞顯示 › 動態島 › 歌詞行
- 顯示歌詞：關閉後，平時僅保留瀏海高度，不顯示歌詞；將指標移到上方展開時，播放控制、進度條和下一句預覽仍照常顯示
- 對齊方式
- 副行
- 展開時預覽下一句
- 高度
- 卡拉OK效果
- 顯示封面
- 封面位置
歌詞顯示 › 動態島 › 字體
- 字體
- 粗細
- 字級
歌詞顯示 › 動態島 › 展開狀態
- 顯示播放控制
- 顯示歌詞校正
- 快速操作
- 曲目資訊
歌詞顯示 › 動態島 › 行為
- 暫停時收起
- 螢幕快照時隱藏
- 暫停時隱藏
- 純音樂/無歌詞時收起歌詞行
- 全螢幕時隱藏
- 聆聽里程碑
- 換歌時顯示歌名
歌詞顯示 › 選單列
- 選單列歌詞
- 最大寬度
- 回復預設：不含寬度和總開關
歌詞顯示 › 選單列 › 佈局
- 寬度模式：固定：所有歌曲使用設定的寬度。自適應：按每首歌曲的歌詞確定寬度，不超過設定寬度
- 對齊方式
- 副行
- 歌詞旁的圖像：在歌詞區域最左或最右側顯示選單列圖像，圖像顏色自下而上填充以表示播放進度：已填充部分使用「已唱顏色」，其餘使用「未唱顏色」。僅在顯示歌詞時出現
歌詞顯示 › 選單列 › 配色
- 卡拉OK效果
- 文字顏色
- 已唱顏色
歌詞顯示 › 選單列 › 字體
- 字體
- 粗細
- 字級
歌詞顯示 › 選單列 › 行為
- 指向時顯示播放控制：指標移到選單列歌詞上時顯示「上一曲 / 播放暫停 / 下一曲」三個按鈕，移開後恢復。暫停後歌詞收起為圖像，或區域過窄放不下三個按鈕時不顯示。按一下按鈕以外的區域仍會開啟面板
- 無歌詞時顯示歌名：歌曲無歌詞或仍在搜尋時，在歌詞位置顯示歌名，不收起為小圖像；取得歌詞後立即切換為歌詞。暫停時仍收起為圖像，廣告期間不顯示
歌詞顯示 › 觸控列
- 觸控列歌詞
- 回復預設：不含總開關
歌詞顯示 › 觸控列 › 歌詞
- 副行
- 字級
- 對齊方式
歌詞顯示 › 觸控列 › 樣式
- 卡拉OK效果
- 歌詞顏色：白色、跟隨封面或自訂顏色
- 暗部亮度：未唱部分與副行的亮度
歌詞顯示 › 觸控列 › 佈局
- 顯示封面
- 封面位置
- 顯示播放控制：上一首、播放/暫停、下一首和設定鍵
- 播放控制位置
- 顯示「更多」鍵：按一下後切換到播放進度、歌詞校正、喜歡、隨機/循環和音量；目前播放器不支援的項目不顯示
- 展開時隱藏功能列：歌詞佔滿整條觸控列；需要調整亮度、音量等時，請先按一下左端的 ✕ 收起歌詞
- 系統功能列：觸控列右側的亮度、音量等系統按鍵，可在「系統設定 › 鍵盤 › 觸控列設定…」中增減或調整順序
歌詞顯示 › 觸控列 › 行為
- 開始播放時自動展開：從暫停恢復播放時展開歌詞；播放中切歌不展開，手動收起後保持收起
- 暫停時自動收起：暫停 10 秒後收起為功能列圖像，恢復播放時自動展開
- 純音樂/無歌詞時收起：確認無歌詞後才收起，找到歌詞後自動展開；搜尋期間照常顯示
歌詞顯示 › 歌詞視窗
- 歌詞視窗
- 網頁歌詞：在瀏覽器中顯示歌詞視窗
- 回復預設
歌詞顯示 › 歌詞視窗 › 網頁歌詞
- 本機位址
- 允許區域網路存取：同一網路中的裝置可透過帶金鑰的連結存取
- 允許遠端控制：可在其他裝置上控制播放、跳轉歌詞
- 存取連結
- 備用連結（IP 位址）
- 重設存取金鑰：已分享的連結將會失效
- 連接埠：更改後需重新掃碼連線
歌詞顯示 › 歌詞視窗 › 背景
- 背景：歌詞視窗的背景：跟隨封面／純色／漸層／毛玻璃
- 方向
- 玻璃濃淡：毛玻璃的材質濃淡（五檔）
- 底部顏色
歌詞顯示 › 歌詞視窗 › 文字
- 字級（僅迷你尺寸）：迷你尺寸的歌詞字級上限
- 卡拉OK效果
- 文字顏色：歌詞視窗的文字顏色；「自動」根據背景亮度在淺色與深色之間切換
- 指定顏色
- 字體：歌詞視窗的歌詞字體（正文、譯文、讀音）
- 粗細
- 已唱顏色
- HDR 高亮（僅完整尺寸）：在支援 HDR 的螢幕上提亮已唱部分，開啟後更耗電
歌詞顯示 › 歌詞視窗 › 佈局
- 長句處理（僅迷你尺寸）：迷你尺寸中一行顯示不下時換行或捲動
- 歌詞佈局（僅迷你尺寸）：單行：僅顯示目前句。雙行：顯示目前句和下一句。多行：與完整尺寸相同，整頁捲動顯示歌詞
- 對齊方式（僅完整尺寸）：完整尺寸歌詞的對齊；「自動」按對唱聲部對齊
歌詞顯示 › 歌詞視窗 › 行為
- 指向時淡化（僅迷你尺寸）
- 淡化時點按穿透（僅迷你尺寸）：淡化時按一下將穿透到下層視窗；按住 ⌥ 可恢復不透明並進行操作
- 暫停時隱藏（僅迷你尺寸）
- 全螢幕時隱藏（僅迷你尺寸）
歌詞顯示 › 歌詞視窗 › 內容
- 讀音
- 譯文
歌詞顯示 › 歌詞視窗 › 頂部資訊
- 歌名（僅迷你尺寸）：迷你尺寸頂部顯示歌名／歌手／專輯
- 歌手（僅迷你尺寸）
- 專輯（僅迷你尺寸）
- 封面（僅迷你尺寸）：迷你尺寸頂部資訊左側的封面縮圖
- 時間（僅迷你尺寸）：迷你尺寸頂部顯示已播放時間與歌曲時長
- 寬度（僅迷你尺寸）：迷你尺寸頂部資訊佔視窗寬度的百分比
- 高度（僅迷你尺寸）：迷你尺寸頂部資訊佔視窗高度的百分比，字級與封面隨之縮放
歌詞顯示 › 歌詞視窗 › 封面
- 動態封面（僅完整尺寸）：僅部分專輯提供；低電量或「減少動態效果」時自動暫停
- 動態封面快取（僅完整尺寸）：已下載的動態封面佔用的磁碟空間；清除後再次顯示時會重新下載
快速鍵
- 深度連結：可在「捷徑」、Raycast、Alfred 等工具中打開；將指標移到上方的快速鍵上，可拷貝對應操作的連結
- 顯示/隱藏浮動歌詞
- 顯示/隱藏動態島歌詞
- 顯示/隱藏選單列歌詞
- 展開/收起觸控列歌詞
- 隱藏/恢復全部歌詞
- 鎖定/解鎖位置
- 顯示/隱藏譯文
- 顯示/隱藏讀音
- 放大浮動歌詞字級
- 縮小浮動歌詞字級
- 打開歌詞管理
- 打開歌詞視窗
- 切換迷你 / 完整尺寸
- 搜尋歌詞
- 打開設定
- 切換到播放器
- 歌詞提前
- 歌詞延後
- 歌詞偏移歸零
- 步長：每按一次調整的幅度
- 播放/暫停
- 下一首
- 上一首
- 喜歡/取消喜歡
一般 › 選單列與 Dock
- 選單列圖像
- 圖像動畫
- 在 Dock 中顯示
一般 › 外觀與語言
- 外觀：設定、歌詞視窗、歌詞管理與選單列面板的配色
- 語言
一般 › 啟動與通知
- 登入時啟動
- 靜默啟動
- 換歌時顯示通知
一般 › 備份與遷移
- iCloud 備份
- 設定檔：含明文憑證；匯出為設定與歌詞庫兩個檔案，匯入將覆蓋全部設定
- 清除全部設定：僅清除本機設定，備份與匯出的檔案不受影響；無法復原
軟體更新
- 軟體更新
軟體更新 › 更新設定
- 自動檢查：每天檢查一次新版本
- 自動下載並安裝：在背景下載，結束 Lyrimuse 時安裝
- 測試版更新：預先發佈版本，可能不穩定
關於 › 更新與協助
- 回報問題：在 GitHub 新增 issue，自動附上版本、系統與播放器資訊
- 尋求協助：在 GitHub 討論區的問答分類中提問
- 功能清單：全部功能、所在位置及預設狀態
關於
- Discord 社群：與其他使用者交流，也可在此提問或提出建議
- Telegram 群組：與其他使用者交流，也可在此提問或提出建議
- 版權說明
- 第三方授權：開源元件與詞典
- 開源授權條款：GPL-3.0
關於 › 診斷與資料
- 匯出診斷：打包記錄檔、當機報告與執行狀態，已移除帳號憑證；含曲目名與本機路徑，公開前請檢查
- 執行記錄檔：歌詞引擎的原始記錄檔，供自行排查
- 設定檔案夾：純文字格式，含帳號憑證；不含外觀與快速鍵，完整遷移請使用「備份與遷移」
實驗室 › ListenBrainz
- 帳號資訊
Last.fm › 設定
- Scrobble 規則
- 比對模式：傳送到 Last.fm 的歌手名和歌名；智慧：使用 Last.fm 上聆聽人數最多的寫法，未比對時按原樣傳送；專輯名去除「 - Single」「 - EP」；自訂：分別設定歌名和歌手；原始：按播放器報告的內容原樣傳送
- 歌名
- 歌手
- Scrobble 時機
- 短於 30 秒的曲目：開：同樣 Scrobble，播放過半即記錄；關：不記錄（Last.fm 官方規則）
- Scrobble 的播放器
實驗室 › 網頁推送
- 連線資訊：需先部署網頁端並取得存取權杖。部署步驟見專案 README 的「網頁端」一節：https://github.com/Yudaotor/lyrimuse#网页端
實驗室 › 推播提醒
- 推播管道：報告將推播到所有已啟用的管道。按一下一列可編輯或傳送測試；按右鍵可刪除
- 聆聽報告
- 資料來源
- 每週聽歌小結
- 每日聽歌報告
- 每月聽歌小結
- 年度聽歌小結
- 推播記錄
Discord
- 在 Discord 上顯示：開啟後，Discord 資料卡和好友列表中將顯示正在聆聽的歌曲。如好友無法看到，請在 Discord 的「使用者設定 › 活動隱私」中開啟活動狀態分享
- 顯示內容
- 「正在聆聽」後面顯示：資料卡「正在聆聽 ××」中的 ××。iOS 版和網頁版 Discord 不支援此項，仍顯示播放器名；選擇歌名或歌手時，使用者名稱下方無法再選擇「播放器」
- 使用者名稱下方顯示：Discord 僅支援將第一行、第二行或「正在聆聽」後的內容顯示在使用者名稱下方。歌名和歌手均不在這些位置時，對應選項不可用
- 封面角標
- 暫停後
- 歌曲資訊
- 狀態文字
- 封面與進度
- 為歌手和專輯加上前綴：在歌手前加上「演唱：」，在專輯前加上「專輯：」。歌名和歌手位於同一行時不加上
- 按鈕
- 自訂按鈕
- 「在播放器上聆聽」：打開這首歌曲在目前播放器網站上的頁面，與按一下歌名效果相同。無對應頁面時不顯示
- 「取得 Lyrimuse」
- 隱私
- 暫時隱藏
- 隱藏歌曲資訊：僅顯示所用播放器和播放進度，不傳送歌名、歌手、專輯、歌詞、連結和「在播放器上聆聽」按鈕
- 顯示進度列：關閉後不顯示進度列，Discord 將改為顯示已播放時長，該計時無法關閉
- 顯示哪些播放器