一、这个项目解决的是什么问题
Mac 上看歌词一直有点别扭。Apple Music 有自己的歌词页,但一边干活一边听就得来回切窗口;Spotify 桌面端整行跳;QQ 音乐、网易云、酷狗各有各的歌词窗,也挪不到菜单栏。
Lyrimuse 补的就是这个缺口。一个常驻菜单栏的开源小程序,把当前这首歌的歌词按字高亮,铺到你选的位置:能拖到任何地方的浮层、菜单栏那一行字、刘海下面那条胶囊、MacBook Pro 的触控栏,或者一整页模仿 Apple Music 的歌词窗,五个位置可以任意组合。
它不替代播放器,也不接管音乐库,只做两件事:认出正在放哪首歌,把最合适的歌词找出来对齐显示。
二、核心设计机制
歌词是搜出来的。一首歌开始放,它同时去十六个源问:网易云、QQ 音乐、酷狗、酷我、咪咕、LRCLIB、经 YouTube Music 的 LyricFind、Deezer、AMLL、汽水音乐、韩语的 VIBE 与 Genie、日语的 PetitLyrics、越南语的 Zing MP3、Megalobiz,以及 Apple Music 自带歌词。
回来的结果不取第一个,而是全部打分:标题、艺人、专辑、时长对不对得上,有没有逐字时间轴,分最高的胜出。每首歌都有决策面板,列出候选、分数和胜出原因。你手选过的那份会被锁住。
逐字还是逐行,取决于源。AMLL 是人工校对的逐字库,汽水音乐有自己的逐字时间轴,Apple Music 不少曲目带逐字时间;这些源赢了字就一个一个亮。只有行时间的源赢了,整行一起亮,不会假装逐字。
翻译和罗马音是另一层。源里带社区翻译就用社区的;没有的话,打开设置里的系统兜底翻译(默认关着),Mac 用 Apple 的翻译框架在本机翻,翻不动才退到在线翻译,十七种目标语言。罗马音按行判断,中文歌里夹一句日文只有那一行出读音。
播放器怎么读分两条通道。Apple Music、Spotify、Kaset、VOX、Swinsian、Audirvana 走自动化权限,拿到精确播放位置;其余十六个走系统的 MediaRemote,不需要授权。
三、功能拆解
显示面五个。浮层能拖到任何位置,也能钉在屏幕顶部中间或程序坞上方;胶囊能显示封面、把封面虚化垫在背后、让歌词行淡出以便点击穿透,还能开到锁屏;触控栏那条跟着唱到哪走哪,打字时自动让位;歌词窗能拉大拉小,两栏、虚化封面当背景;菜单栏文字模式把当前这句放进菜单栏。
菜单栏图标点开是一个能自己摆的面板,像控制中心:歌曲信息、播放控制、一排能拖能改大小的方块。浏览器里的视频抢了系统「正在播放」时,它会改去点 QQ 音乐、网易云自己的菜单栏,这一步要辅助功能权限。
歌词本身也能修。Lyrics Manager 里可以逐首浏览、编辑、删除、重搜,能清掉广告和播客留下的空条目;某一首对不上就单独加偏移。
另外一半是听歌记录。Last.fm 在 Accounts 里一键连,不用手抄 token,连上就有今天、近七天、全部时间的统计。Footprint 单独一页:日均多少、最猛的一天、当前和最长连续,下面一张年度热力图。
四、适合谁,不适合谁
适合长期在 Mac 上挂着音乐的人,你不一定开着歌词窗,但菜单栏那一行确实省事。适合学语言的人:日语可以选罗马音或假名注音,粤语有认词的 Jyutping。
适合录屏、直播、共享屏幕的人。歌词在截图、录屏、屏幕共享里自动隐藏,你自己看得见,别人看不见。也适合本地无损党,VOX、Audirvana、foobar2000 都在列表里。
不适合 Windows 和 Linux 用户,只有 macOS 版本,最低要 14。不适合想要 iPhone、iPad 原生应用的人,手机平板只能开浏览器当第二块屏。也不适合指望冷门歌一定有词的人。
五、几个需要提前知道的限制
第一,系统版本卡得死。要求 macOS 14 起;本机翻译要 macOS 15 起,在 14 上只能用在线翻译,歌词会发到在线服务去。
第二,首次打开一定被拦。发布用的是项目自己的证书,不是 Apple 开发者 ID,Gatekeeper 会报「来自身份不明的开发者」。一次性的,终端跑 xattr -dr com.apple.quarantine /Applications/Lyrimuse.app 就行。用 Homebrew 装的话这一步它自己做掉。
第三,安装包要挑对。文件名没有后缀的 dmg 只含 Apple Silicon 代码;带 intel 的同时含两种架构,体积是两倍,macOS 27 起还会提示需要更新。Intel 机器只能下带 intel 的那个。
第四,权限不是一次给完。六个播放器要自动化权限,某些播放按钮、随机循环要辅助功能权限。拒绝自动化权限歌词还能显示,但时间可能差一秒左右。
第五,歌词质量完全取决于源。冷门歌、现场版、纯音乐很可能十六个源都没有;有也可能是错版本、错时间轴。能修,但要你自己动手。
第六,卸载不能只把应用拖进废纸篓,歌词引擎是注册给 launchd 的常驻作业,应用删了它还会被反复拉起。
六、项目现状
版本 v1.14.0,星标四百多,GPL-3.0 许可。仓库里是两部分:Swift 写的应用本体,和 Go 写的后台歌词引擎 lyrimuse-engine,构建脚本会把引擎打进应用包里。
应用内自带更新,设置里有独立的软件更新页,能看更新说明和进度。界面十六种语言,切换即时生效。
七、常见问题
问:一定要有 Apple Music 订阅吗?
答:不用。Apple Music 只是十六个歌词源里的一个,还是可选的,连账号才有用。不连也能用其余十五个源。
问:逐字高亮是每首歌都有吗?
答:不是。只有赢下的那份歌词本身带逐字时间轴才有,比如 AMLL、汽水音乐、Apple Music 的部分曲目。只有行时间的源就整行一起亮。
问:会不会把我听的歌传出去?
答:找歌词时要把艺人、标题、专辑发给那十六个源,这是必须的。翻译默认在本机做,翻不动才走在线。匿名使用数据每天发一次,只有版本和崩溃摘要,不带歌名和账号。
问:歌词对不上怎么办?
答:先试单曲偏移,把那首的时间轴整体挪一点,偏移会记住。如果是错版本,打开手动搜索,每个结果都带分数,挑对了就锁定。
问:能在手机上看吗?
答:能,但不是原生应用。在设置里允许本地网络访问之后,用手机浏览器打开歌词窗的地址,扫码连过来当第二块屏。
问:为什么卸载完还在后台跑?
答:因为歌词引擎注册成了 launchd 的常驻作业,把应用拖进废纸篓不会注销它。要跑仓库里的卸载脚本,加 --services 只注销作业保留数据。
下载地址
夸克网盘(永久有效):https://pan.quark.cn/s/eddeb14c8f79
本教程由「宝藏星球屋」整理,更多软件、游戏、开源项目都在 https://cbge.top。






















暂无评论内容