Lyric Fever

The Best Lyrics Experience for Spotify & Apple Music on macOS. It Just Works.

Installation

Manual

Download the DMG file here.

Homebrew

Run brew install lyric-fever

Screenshots

lyricfeverad.webm

Features

• Automatic Lyric Playback on Menubar
• Fullscreen Mode (Modeled after Apple Music’s fullscreen view)
• Karaoke Mode (Lyric popup that stays on screen)
• Karaoke Mode customization (font color, etc)
• Lyric Translation (using Apple’s on device APIs)
• 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.
• Lyrics fetched from Spotify, LRCLIB, and NetEase as a backup lyric provider
• Simplified Chinese language support in app UI, thanks to @InTheManXG

YouTube Promo Vid:

![LyricFever Promo Vid]

Requirements

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

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
• Lyrics are fetched from LRCLIB as a backup when Spotify fails
• I fetch the song “background color” with each lyric, and the color is used for the karaoke mode window background
• Songs translated using Apple's Translation API.
• The fullscreen view uses a custom mesh gradient and extracts colors from the album art using ColorKit
• Spiritual successor to LyricsX (95% more efficient, 0.1% CPU usage of Lyric Fever vs 3% of LyricsX)
• Technical write-up coming soon

Translation Help

Crowdin Translation website

Please open a GitHub issue request to translate to more languages. Thank you very much.

Other Contributors

• InTheManXG for Simplified Chinese translations
• ARui-tw for traditional chinese translations
• lcandy2 For their pull request

Acknowledgements / Special Thanks

• Sparkle: For app updates
• Amplitude: For app analytics
• Spotify: The music platform this project depends on! (for playback, for lyrics)
• Apple Music: Another platform that this project depends on
• ColorKit-macOS: My port of ColorKit for macOS
• Cindori for their blog post on writing an NSPanel view for SwiftUI
• autozimu for https://github.com/autozimu/StringMetric.swift, used to determine how similar NetEase search results are from search query
• tranxuanthang for LRCLIB, an open source Lyric library. Used when Spotify fails.
• NetEase for their Lyrics, used when LRCLIB and Spotify fail.
• fatbobman for ObservableDefaults
• https://neteasecloudmusicapi-ten-wine.vercel.app for their NetEase API
• LyricsX/ddddxxx for their ChineseConversion class (SwiftlyOpenCC)
• sindresorhus for KeyboardShortcuts
• f728743 for the mesh gradient view.
• jayasme for the LRC Lyric Parser I used as a base
• MusicBrainz & the CoverArtArchive projects for their MBID and Cover Art APIs (used for non-spotify / local files)
• LyricsX/MxIris for their Spotify TOTP fix and NetEase lyric provider
• Mecab-Swift by shinjukunian for the excellent Japanese Romanization
• Christian Selig for his efficient image color averaging technique
• Various StackOverflow snippets