NotchMuse v0.8.1 · Build61

NotchMuse v0.8.1

Build61 · macOS14+ · Apple silicon · manual installation.

Download · SHA256SUMS · 简体中文

Changes since v0.8.0 Build47

• Better Spotify lyric recovery using public track identity and complete artist information. No Spotify Premium, developer account or user API key is required by this lookup route.
• Select lyrics using recording evidence, artist/version checks and timeline bounds; reject conflicting versions instead of accepting the fastest nonempty result.
• Normalize multi-artist metadata and preserve source identity. Restore validated recording matches without disabling wrong-version protections.
• Recover NetEase native song identity only when fresh local playback state and current player ownership agree; revalidate on resume.
• Preserve line/word timing information and protect against stale results after switching tracks or players.
• Distinguish Searching, No Lyrics, search timeout and network failure in the interface. Production does not expose Preview selection diagnostics or enable the shadow service.

Compatibility and limitations

macOS14 or later, Apple silicon. Supported player integrations remain Spotify, Apple Music, NetEase Cloud Music, QQ Music and Soda Music. Some rely on macOS private MediaRemote behavior and may change with system/player updates.

Lyrics depend on third-party availability and recording metadata. Some songs remain unavailable; first lookup can take several seconds during slow requests. This release does not promise every song or version. Engineering selectable counts are not human-verified accuracy rates.

This build is ad-hoc signed, not Developer ID signed, and not Apple notarized. No Apple Developer account is required for this chosen distribution route. Clean-Mac first-install verification is still pending; this document does not claim that verification passed.

Install

Download only from the official GitHub Release or notchmuse.com. Compare shasum -a 256 NotchMuse.dmg with the matching release's SHA256SUMS. Open the DMG, drag NotchMuse into Applications, eject the image, then open the installed App. If macOS blocks the unverified developer, and you trust the verified official download, use System Settings → Privacy & Security → Open Anyway, then confirm Open. Do not disable Gatekeeper or remove quarantine with terminal commands. If macOS reports malware or a damaged App, stop and verify the download rather than forcing it to run. Apple installation guidance.

Open a supported player and play music. Allow Automation access to Spotify/Apple Music if requested; the menu bar provides settings and Quit. Independent clean-Mac permission and first-launch testing has not been completed; no such test is reported as passed.

Upgrade and rollback

This release uses manual download and installation. The existing Build47 update feed remains unchanged: Build61 is not offered through Sparkle. Its archive signature verifies against the existing update key, but real isolated Build47→61 installation/relaunch/failed-update recovery has not passed; cryptographic checks alone do not qualify automatic updates.

Quit the old Stable before replacing it manually. Keep its App and preferences backed up together; rollback means quitting the new version and restoring both from the same backup. Preview remains separate. Never overwrite Preview with the Stable package. Existing v0.8.0 downloads remain available for rollback.

---

NotchMuse v0.8.1

Build61 · macOS14+ · Apple 芯片 · 手动安装。

下载安装包 · SHA256SUMS · English

相比 v0.8.0 Build47

• 使用 Spotify 公开歌曲身份和完整联合歌手信息，提高现有来源的正确歌词召回；该链路无需 Spotify Premium、开发者账号或用户 API Key。
• 按歌曲、歌手、录音版本和时间轴证据选择歌词，保护错歌、Live/Remix 等版本冲突，替代“最快非空结果”的做法。
• 规范多歌手元数据并保留来源信息；在保留版本保护的前提下恢复可靠候选。
• 网易云 Exact-ID 仅在新鲜的本地播放状态、队列和当前播放器身份一致时使用，恢复播放后重新授权。
• 保留歌词行/词时间信息，阻止切歌或切换播放器后旧请求覆盖当前结果。
• 界面区分搜索中、无歌词、超时和网络失败；正式配置关闭 Preview 诊断入口及 Shadow 服务。

要求与限制

macOS14+、Apple Silicon。保留 Spotify、Apple Music、网易云、QQ音乐及汽水音乐集成；部分播放器依赖私有 MediaRemote 行为，系统或播放器升级可能影响兼容性。

歌词可用性取决于第三方来源和录音信息，并非所有歌曲/版本都有歌词。慢网络下首次查询仍可能耗时数秒；工程候选命中率不等于人工歌词正确率。

本包为 ad-hoc 签名，不是 Developer ID 签名，未经 Apple 公证。本次发行不要求购买 Apple Developer；真实干净 Mac 首次安装验收仍待完成，不能将本地自测视为通过。

安装

仅从官方 GitHub Release 或 notchmuse.com 下载；执行 shasum -a 256 NotchMuse.dmg，与同一版本 SHA256SUMS 核对。打开 DMG，将 NotchMuse 拖入“应用程序”，推出镜像，再打开已安装 App。

若 macOS 提示无法验证开发者，仅在确认官方来源及校验一致后，前往 系统设置 → 隐私与安全性 → 仍要打开，再确认打开。不要关闭 Gatekeeper，也不要用终端删除隔离标记。若提示恶意软件或 App 损坏，应停止并核对下载，不强制运行。Apple 官方说明。

打开受支持播放器并播放音乐；Spotify／Apple Music 如请求自动化权限，由用户确认。菜单栏可进入设置和退出。尚未完成独立干净 Mac 的首次安装与权限验证，本说明不声称此项已通过。

升级与回滚

本次采用手动下载安装方案。现有 Build47 正式更新 feed 保持不变，不通过 Sparkle 推送 Build61。Build61 的更新包签名已用旧版公钥验证，但真实隔离47→61安装、重启和失败恢复尚未通过；签名验证不能替代完整更新验收。

手动升级前退出旧正式版，同时备份 App 和偏好设置；回滚时退出新版本，再恢复这两项。常规 Preview 维持独立，勿用正式包覆盖 Preview。保留公开 v0.8.0 下载用于回滚。

Artifact verification

d8e2bc73e22cc79919708b88539edf480b7c07f14fe67d1d9683c9d530f77851  NotchMuse.dmg

Public release source: 8320271b4218431b66175bf40e203230ce8fa741. The frozen binary was originally built at 4c392efbd8da0c8abb0fdc70833575192e18d7d1; published runtime and packaging inputs are byte-identical, as documented by SOURCE_PROVENANCE.json.

NotchMuse v0.8.0

NotchMuse v0.8.0

What's New

• In-app updates with Sparkle: release notes, download, EdDSA verification, installation, and relaunch. Manual checks remain available with automatic checks off.
• Refined Settings navigation, live previews, window-size persistence, and System / Light / Dark appearance, including the Support window.
• Launch at Login, Dock visibility, menu bar icon controls, and reliable reopening of Settings.
• Status Bar lyrics and four overlay positions: top, above the Dock, left vertical, and right vertical. Custom width, solid/gradient colors, and background controls.
• English and Simplified Chinese; a compact Support page.
• Spotify, Apple Music, NetEase Cloud Music, QQ Music, and Soda Music. Existing matching, provider order, and saved settings are preserved.

Installation and Updates

Requires macOS 14+ and Apple Silicon. If you're using Beta 3 or an earlier version, install v0.8.0 manually once. Starting with v0.8.0, NotchMuse supports in-app update checks and installation.

This release is ad-hoc signed, not Apple Developer ID notarized. If macOS blocks first launch, use System Settings → Privacy & Security → Open Anyway. Do not disable Gatekeeper.

更新内容

• 新增 Sparkle 应用内更新：更新说明、下载、EdDSA 校验、安装与重启。关闭自动检查后仍可手动检查。
• 优化设置导航、实时预览和窗口尺寸保存；支持跟随系统、浅色和深色外观，支持页面也随外观切换。
• 开机自动启动、Dock 与菜单栏图标控制，以及可靠的设置窗口重新打开行为。
• 菜单栏歌词及顶部、Dock 上方、左侧竖排、右侧竖排四个位置；可调宽度、纯色/渐变色与背景。
• 简体中文与 English，以及简洁的支持作者页面。
• 支持 Spotify、Apple Music、网易云音乐、QQ 音乐、汽水音乐。保留原有匹配逻辑、歌词来源顺序和已保存设置。

安装与更新

需要 macOS 14+ 和 Apple 芯片。如果你正在使用 Beta 3 或更早版本，请手动下载安装一次 v0.8.0。从 v0.8.0 开始，后续版本可以在应用内检查与安装。

本版本为 ad-hoc 签名，尚未配置 Apple Developer ID 公证。首次启动被阻止时，请前往 系统设置 → 隐私与安全性 → 仍要打开，不要关闭系统 Gatekeeper。

NotchMuse v0.8.0 Beta 3

NotchMuse v0.8.0 Beta 3

Build 38, macOS 14+, Apple silicon.

Changes

• Four lyric positions: top, above the Dock, left vertical, right vertical.
• Clear Solid / Gradient color selection, with 12 solid and 10 gradient presets plus custom colors.
• Fixed solid colors not appearing correctly in Notch mode.
• Background-only opacity, compact background padding, background colors and hover hiding controls.
• Improved Settings mode selection, custom width and horizontal-offset controls.

Spotify, Apple Music, NetEase Cloud Music, QQ Music and Soda Music remain supported. No player, Matcher or Provider-order changes in this release.

Install

Download NotchMuse.dmg, drag NotchMuse to Applications, then open it.
This beta is ad-hoc signed and not notarized. If macOS blocks the first launch, choose Done, then System Settings > Privacy & Security > Open Anyway. The DMG includes an installation guide and Privacy & Security shortcut. Do not disable Gatekeeper globally.

Notes

• Side placements use upright-character columns; arbitrary dragging is not included.
• Side layouts may be less suitable for long English lyrics.
• Private MediaRemote bridge compatibility may change with macOS updates.
• User GUI acceptance, full self-tests and Settings interaction checks passed. Prior releases remain available for rollback.

NotchMuse v0.8.0 Beta 2

NotchMuse v0.8.0 Beta 2

Installer update for macOS 14+ on Apple Silicon. Player and lyrics runtime code is unchanged from Beta 1.

What's new / 更新内容

• A compact, music-themed drag-to-install DMG layout.
• Bilingual first-open instructions inside the installer.
• A Privacy & Security shortcut that opens System Settings; it does not approve the app or change security settings.
• Download filename remains NotchMuse.dmg.

First launch / 首次打开

This beta is ad-hoc signed and not notarized. macOS may block the first launch. After verifying that you downloaded this release from the official site/GitHub, drag NotchMuse to Applications and try opening it. If blocked, choose Done, then System Settings > Privacy & Security > Open Anyway, and authenticate. The bundled shortcut is optional; use the manual path if it does not work on your macOS version.

此 Beta 使用 ad-hoc 签名，尚未经过 Apple 公证。首次打开可能被系统阻止。确认下载来源为官网/GitHub 后，将应用拖入 Applications 并尝试打开；若被阻止，点击“完成”，前往“系统设置 > 隐私与安全性 > 仍要打开”，按系统提示确认。快捷入口仅导航，不会绕过安全保护。

Supports Spotify, Apple Music, NetEase Cloud Music, QQ Music, and Soda Music. The latter three depend on private macOS MediaRemote behavior and may require updates after system/player changes.

Build: 31
Source: c606f18
DMG SHA-256: 1017d81bc80d15244fef3f3ff1d1988d8430c619ce8394cd4ec3e480c00d3e68

Release build, packaged self-test, signature, DMG integrity, and source CI passed. Cross-macOS first-open behavior still needs broader beta feedback. Beta 1 assets are preserved.

NotchMuse v0.8.0 Beta 1

NotchMuse v0.8.0 Beta 1

Highlights

• Spotify, Apple Music, NetEase Cloud Music, QQ Music, and Soda Music support.
• Auto Detect for supported players.
• Redesigned Settings with live previews and appearance presets.
• English and Simplified Chinese interface.
• Status Bar and Notch lyric display modes.

Compatibility and Installation

Requires macOS 14 or later and Apple Silicon (arm64).

This beta is ad-hoc signed and is not notarized with an Apple Developer ID.

1. Download the DMG and drag NotchMuse to Applications.
2. Control-click NotchMuse and choose Open where available.
3. If macOS blocks opening, use System Settings > Privacy & Security > Open Anyway.
4. Grant the permissions required by your selected player and display mode.

Known Issues

• Lyrics availability depends on third-party providers; some songs may have no result.
• Intel Macs are not supported.
• This beta is not notarized.

Clean-device installation validation follows this release. Please report the
app version, player, song, and reproduction steps with any issue.

Build Provenance

• Version: 0.8.0-beta.1
• Build: 29
• Source / release candidate: 47fe9fa
• CI: https://github.com/Xiye88/NotchMuse/actions/runs/36229154287
• Executable SHA-256: 73d10769af1dc3c0ae684382cd03e7b68669f01cf1eba6f52e3db4e9f5ef2a7d
• DMG SHA-256: 74546ec6f371caeb0d31b15949f902ee94a7b06b307d81b8aaa5f1d0b6cf6660

NotchMuse v0.6.1 Beta

NotchMuse v0.6.1 Beta

This stability patch fixes a false Apple Music Automation permission warning
that could appear during rapid song changes.

Changes

• Improved Apple Music track-transition handling.
• Verified Apple Music and Spotify recovery after network interruption.
• Verified Apple Music and Spotify recovery after macOS sleep and wake.
• Re-ran English and Simplified Chinese Release self-tests.

Installation

1. Download NotchMuse.dmg.
2. Open the DMG and drag NotchMuse.app to Applications.
3. Control-click NotchMuse, choose Open, and confirm the beta launch warning.

macOS Signing Notice

This beta is ad-hoc signed and not notarized with Apple Developer ID. If macOS
blocks the first launch, open System Settings > Privacy & Security and choose
Open Anyway for NotchMuse.

Known Issues

• Lyrics availability depends on third-party providers; some songs may return
  no result.
• Spotify may need a normal page reload if its own client does not recover after
  a network interruption.
• Intel Macs are not supported in this beta.

Compatibility

• macOS 14.0 or later
• Apple Silicon
• Spotify desktop app or Apple Music

NotchMuse v0.6.0 Beta

NotchMuse v0.6.0

NotchMuse v0.6.0 adds Apple Music support while preserving the existing Spotify experience.

Highlights

• Choose Spotify or Apple Music in Settings.
• Show synchronized lyrics in Status Bar Mode or Notch Mode.
• Recover cleanly when a player exits or Automation permission changes.
• Report a lyrics issue from the app with the current track details attached to a user-controlled email draft.
• Use NotchMuse in English or Simplified Chinese.

Installation

1. Download NotchMuse.dmg.
2. Open the DMG and drag NotchMuse.app to Applications.
3. Control-click NotchMuse, choose Open, and confirm the unsigned beta warning.
4. Open Spotify or Apple Music and play a song.
5. Choose the player in NotchMuse Settings and allow macOS Automation when prompted.

Unsigned macOS Notice

This beta is ad-hoc signed and not notarized with Apple Developer ID. If macOS blocks the first launch, open System Settings > Privacy & Security and choose Open Anyway for NotchMuse.

Known Issues

• Lyrics availability depends on third-party providers; some popular songs may still return no result.
• Most providers supply line-level timing rather than word-by-word timing.
• Apple Music may not retain its current track after the Music app restarts. NotchMuse clears stale lyrics and recovers after playback resumes.
• Left Status Bar Mode requires Accessibility permission.
• Intel Macs are not supported in this beta.

Compatibility

• macOS 14.0 or later
• Apple Silicon
• Spotify desktop app or Apple Music

NotchMuse v0.3.1

NotchMuse v0.3.1

NotchMuse v0.3.1 is a stability and lyrics-display quality update for the
GitHub beta.

Documentation: English README ·
简体中文 ·
Setup help

Highlights

• Long lyrics scroll left once, stop at the end, and reset for each new line.
• Hide Lyrics now removes the Status Bar or Notch display while keeping the
  current Spotify and lyrics state ready for Show Lyrics.
• The Notch and overlay lyrics window is click-through during normal use.
• DEBUG-only matcher decision logging improves local failure analysis without
  changing production matching behavior.
• The README now includes Status Bar Mode and Notch Mode demo videos.

Installation

1. Download NotchMuse.dmg.
2. Open the DMG and drag NotchMuse.app into Applications.
3. Control-click NotchMuse and choose Open on first launch.
4. Allow Spotify automation access when macOS asks.
5. Look for the orange note icon in the menu bar, then open Settings to choose
   Status Bar Mode or Notch Mode.

Unsigned macOS Notice

This beta is unsigned and not notarized. macOS may require
System Settings > Privacy & Security > Open Anyway during the first launch.

Requirements

• macOS 14 or later
• Apple Silicon Mac
• Spotify desktop app

Known Issues

• Lyrics coverage depends on third-party providers.
• Left Status Bar mode requires Accessibility permission.
• Intel Mac is not supported.
• Some menu bar organizers may hide the NotchMuse menu icon.

Matching Scope

This release does not change matching scores, thresholds, provider order, or
retry behavior.

NotchMuse v0.3.0-beta

NotchMuse 0.3.0 Beta

This is the first GitHub Open Source Beta Release Candidate for NotchMuse.

Highlights

• Native macOS menu bar lyrics companion for Spotify
• Status Bar and Notch Mode lyrics display
• English and Simplified Chinese interface
• Multiple lyrics providers: LRCLIB, NetEase, LRCMux, QQ Music, Kugou, and Soda Music
• Settings for display mode, width, screen target, color, font size, animation speed, opacity, and launch behavior
• Unsigned DMG package for GitHub beta distribution

Installation

Download NotchMuse.dmg, open it, and drag NotchMuse.app into Applications.

This beta is unsigned. If macOS blocks launch, Control-click NotchMuse.app, choose Open, and confirm. If needed, use System Settings > Privacy & Security > Open Anyway.

System Requirements

• macOS 14.0 or later
• Apple Silicon Mac
• Spotify desktop app for macOS

Known Issues

• macOS Gatekeeper warning is expected because this beta is unsigned.
• Intel Mac is not supported yet.
• Lyrics coverage depends on third-party providers.
• Left Status Bar mode requires Accessibility permission.
• Menu bar organizer apps may hide the NotchMuse icon.

Artifact

• NotchMuse.dmg
• SHA-256: f956eb31915ea8c69431c93542e6a34797d3e081c4f493872faa254c79664c99