aviwad / lyricfever

Spotify & Apple Music Lyrics app for macOS menubar (spiritual successor to LyricsX)

Lyric Fever

Live Spotify & Apple Music lyrics in your macOS menubar. It Just Works.

Downloads

Download from releases.

Requirements

• macOS Ventura or higher
• Spotify Desktop Client (if using Spotify)

Features

• It Just Works.
• Offline caching! Lyrics are automatically stored offline efficiently using CoreData
• Play some music on the Spotify / Apple Music app and watch the lyrics play on the menu bar automatically.

Screenshots

Technical Details

• UI is built using SwiftUI.
• The lyrics are updated and fetched using Swift Concurrency and Swift Tasks
• The lyrics are stored into disk using CoreData.
• I interface with Spotify & Apple Music using their AppleScript methods as well as by subscribing to their playback state change notifications.
• I interface with Spotify and Apple Music's AppleScript methods by using Apple's provided ScriptingBridge interface.
• I additionally use private APIs to get the currently playing Apple Music song's iTunes ID, and use MusicKit to map that to an ISRC code
• I map Apple Music songs to equivalent Spotify ID using ISRC to display Lyrics fetched from Spotify for either platform
• Spiritual successor to LyricsX (95% more efficient, 0.1% CPU usage of Lyric Fever vs 3% of LyricsX)
• Technical write-up coming soon

Acknowledgements / Special Thanks

• Sparkle: For app updates
• Amplitude: For app analytics
• spotify-lyrics-api: For fetching Spotify lyrics
• Spotify: The music platform this project depends on! (for playback, for lyrics)
• Apple MusicKit: Apple Music API
• Apple Music: Another platform that this project depends on

lyricfever's Issues

Spotify Connect on Google Home: Lyrics not playing sometimes

Have not debugged but Spotify might be returning incorrect playback timing (maybe a 0.0 repeatedly?) When casting to Google Home.

CHANGE LYRIC PROVIDER

the main heroku instance run by the spotify-lyric-api guy is basically shut. need to host my own spotify-lyric-api server asap.

Apple Music inefficient behaviour

Lyric Fever on Spotify: 0.1 to 1% CPU usage
Lyric Fever on Apple Music: 0.1 to 6% CPU usage
The lyric updater is duplicating in xcode logs. don't know why.

Detect when menubar is hidden / unhidden

Pause the Lyric updater when menubar is hidden.
Should reduce CPU usage when invisible.

Custom Lyric Upload Support

Does or will this app implement custom lyric upload? In many case that it's not able to search the lyric and we want to upload my local .lrc files just like what https://github.com/ddddxxx/LyricsKit does.

[Help Needed] Translation support

Need to start translating the menu bar strings as well as the onboarding window strings. In all the languages App Store and LyricsX (the ancestor) supports.

Fix Lyric Drift for 1 song on repeat Spotify

When the same song plays again, we don't receive a song change notification. LyricUpdater stays in the loop. Drift Fix is never called.

Remove cross-fade page from onboarding

Not needed. Have fixed the Spotify lyric drift. Let the user keep the crossfades on if they want to 😄

detect automation permission denied

if denied post a message and disable the timer (waste of energy bc there's no playback position to use)

Lyrics Content Translation

Check for network calls made on Spotify on iOS and enable translated lyrics. Alternatively, use third party API to translate the lyrics. Enable option to display these translated lyrics instead of original (where translation required).

Can't read Spotify track if playing before application is opened

No spotify distributed notification available if song was already playing before the app is opened. Using the LyricsX MusicPlayer API is garbage because no data for currentTrack is returned. A solution could be to use AppleScript to read the Spotify current track on init.

Amazon Echo Spotify Connect: Consistent 3 second delay.

Perhaps using the AppleScript Spotify data I can detect when the current device is an Amazon Echo and automatically insert a 3 second delay?

Hide text/ Add icon, if no music is playing

It took lot of space from the menu bar, just to displaying that"Nothing Playing on Apple Music"

immediately update lyric on unpause

unpause starts the lyric updater, setting the timeline for the next lyric update. it should also update the current lyric immediately rn

Feature request: "Subtitles" mode

Awesome work! I've only been using it for 30 minutes and I already love your app. One feature I would love to have would be displaying the lyrics as "subtitles", similar to how LyricsX does. That is, "floating", windowless text that can be dragged around the screen and displays on top of all other apps.

Improve onboarding experience

Prevent Spotify and Apple Music from opening up on first use. Detect permissions in onboarding before continuing. Remove crossfades info page (not necessary.)

Lyrics from Apple Music

https://github.com/dropcreations/Manzana-Apple-Music-Lyrics can maybe use the API call used here. Would be better for a few songs (better syncing compared to spotify)

Lyrics says "no lyrics not found"

Hi @aviwad ,
thanks for the awesome app, I noticed that the lyrics don't show:

Is there any way I can help with it?

Title doesn't show for a long lyrics

I found a new issue in here:

So, if the lyrics it's too long, it will not appear.

I think it will be hard to do the code where the lyrics isn't timestamp per word :D

Anyway, on the tiktok Music it can appear like this, the lyrics will be slowly moving to left (I didn't use if because the sound quality isn't great for me)

Apple Music support

integrate apple music applescript + usernotifications -> convert apple music id to ISRC -> use spotify api to convert to spotify ID

More efficient lyric change

Instead of a 1 second timer running during song (with lyric) playback, instead update the index on the next lyric's timestamp. the only problem is i can't receive any notification for the user scrubbing the playback position during playback, and so a timer is necessary. perhaps a combination of using the lyric's timestamp to maintain a timeline of updates, alongside a 5 second timer to reset the timeline if the user scrubs playback

prevent concurrent lyrics fetching, concurrent lyrics timers

rapidly skipping through spotify leads to multiple async Tasks running in parallel, fetching lyrics for songs that were skipped in milliseconds, and then the the lyrics fetcher running the lyric updater for the song. this leads to multiple timers running in parallel, each recursively calling itself again. even calling stop does nothing. this leads to redundant timers running a few milliseconds away from each other for the same update, as well as timers spamming the CPU when the song is paused / spotify is closed

Add support for brew install

easy to manage and update.

Unnecessary dependence on mostly-useless LyricsX MusicPlayer library

Currently only using to access Spotify's playback position. Can easily do the same using AppleScript. Need to decide whether to interface with AppleScript directly or use the scripting bridge.

Should I keep storing show-lyrics as userdefaults? or reset on every app launch

Sometimes I'll click "Don't show lyrics" and then the next time I relaunch the app I'll wonder why lyrics aren't loading. Maybe other users feel the same way.

truncate song title

truncation should be enabled for song names too, or the menubarextra disappears suddenly on low space

Deal with spdc cookie expiration

The cookie expires a year after generation. Right now I don't account for this. User may be blind sided by it not working. I don't check for the cookie working or not. All access token generation errors are currently lumped together (network error, incorrect cookie, expired cookie, etc)

Slightly delay on songs autoplaying / Autoplay induces Spotify lyric drift

Even with crossfades set to off, if Playback -> Autoplay is on, and songs autoplay (without user skipping or pausing) a slight delay is introduced. spotify is sending slightly incorrect playback position. This only happens sometimes. Cannot be replicated easily.

Potentially use Spotify cookie stored from desktop prefs file

The Spotify desktop app stores its preferences (including an "autologin blob") in ~/Library/Application Support/Spotify/prefs

Need to figure out how to decode this and use it as compared to the spDc -> auth token process I'm using right now... maybe some Wireshark sniffing?

Spotify Login webview instead of access token

More user friendly option to embed a WebView (as I have done in https://github.com/aviwad/Friend-Activity-for-Spotify) instead of requesting the user to copy a cookie.

Cache lyrics offline: Save LyricLine array to CoreData

can't keep bombarding the spotify-lyrics-api guy's heroko server with requests on each new song load. need to cache my LyricLine struct array to coredata. need to learn core data