Repository navigation
NotchMuse v0.3.1
Pre-release
Pre-release
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
- Download
NotchMuse.dmg. - Open the DMG and drag
NotchMuse.appintoApplications. - Control-click NotchMuse and choose
Openon first launch. - Allow Spotify automation access when macOS asks.
- 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.