Lyrimuse Files

Lyrimuse v1.1.0 — QQ Music support, click-through overlay, reliability fixes

Added

• QQ Music support alongside Apple Music, chosen explicitly during onboarding or in Settings (default stays Apple Music). QQ Music has no AppleScript support, so playback is read via the bundled media-control tool (macOS's system-level MediaRemote, no permission needed); ListenBrainz submissions and the companion-launch feature now correctly attribute whichever player is actually selected.
• Configurable companion launch between Lyrimuse and Apple Music, in either direction (opt-in, off by default).
• "Check for Updates" in the menu bar dropdown.
• A "searching lyrics..." placeholder shown while a newly-played track's lyrics are still resolving.

Changed

• The classic floating overlay is now click-through by default even when unlocked — ordinary clicks pass straight to whatever's behind it; press and hold it to drag it to a new position. Locking it now just means the position is fully frozen.
• Menu bar dropdown items now show icons, with a divider separating "launch at login" from the one-shot action buttons.
• Building from source no longer requires manually running brew install media-control beforehand — build.sh installs it automatically if it's missing.

Fixed

• QQ Music's lyric-sync timing could drift/jitter (+/-1-1.5s of noise per reading); position tracking now only re-anchors on genuine discontinuities (track change, resume, seek) and otherwise extrapolates from wall-clock time.
• The Automation permission dialog for Music.app could silently never appear if Music.app wasn't already running; it now launches Music.app in the background first so the permission check can actually resolve.
• The companion-launch feature could miss a fast quit-and-reopen of Music.app; detection now uses a dedicated 1-second timer instead of piggybacking on the slower main poll loop.
• The background collector could occasionally get killed by macOS with no clear reason ("exit code 9") due to a stale code-signing trust-cache entry from repeatedly overwriting the same binary file in place; each rebuild now gets a fresh file.

新增

• 新增 QQ 音乐支持，在首次启动引导或设置里显式选择播放器（默认仍是 Apple Music）。QQ 音乐没有 AppleScript 支持，改走内置的 media-control 读取系统级 MediaRemote，不需要任何权限；ListenBrainz 提交记录和"App 联动启动"功能现在 也会正确识别当前实际选中的播放器。
• 新增 Lyrimuse 与 Apple Music 之间可配置的双向联动启动（默认关闭，按需 开启）。
• 菜单栏下拉菜单新增"检查更新"入口。
• 新播放一首歌、歌词还在解析中时，显示"搜索歌词中…"的过渡态提示。

优化

• 经典悬浮歌词窗口现在默认（即使解锁状态下）也对鼠标点击穿透——普通单击会 直接穿透到它下面的内容；长按住才能拖动位置。锁定现在单纯表示"位置完全 冻结"。
• 菜单栏下拉菜单各项加上了图标，"开机启动"和下面的一次性操作按钮之间加了 分隔线。
• 源码构建不再需要提前手动 brew install media-control——build.sh 检测到 缺失时会自动安装。

修复

• 修复 QQ 音乐逐字歌词计时抖动的问题（每次读数有 ±1~1.5 秒噪声）；现在只在 真正发生不连续（换曲/恢复播放/跳转）时才重新定位，其余时间按真实流逝时间 外推。
• 修复 Music.app 尚未启动时，"自动化"权限弹窗有时完全不出现的问题——现在会 先在后台拉起 Music.app，确保权限检查能正常触发。
• 修复"App 联动启动"漏检测快速退出又重开 Music.app 的问题——改用独立的 1 秒定时器单独检测，不再依赖较慢的主轮询周期。
• 修复后台采集器偶尔被系统无端杀死（"退出码 9"）的问题——根因是反复原地 覆盖同一个可执行文件导致内核代码签名信任缓存陈旧，现在每次构建都用全新 文件替换。

Full Changelog: https://github.com/Yudaotor/lyrimuse/compare/v1.0.1...v1.1.0