Skip to content

Repository files navigation

Lyrisland Icon

Lyrisland

/ˈlɪrɪslænd/ — Lyrics + Island

Real-time Spotify lyrics in a Dynamic Island style overlay for macOS

macOS 14.0+ Spotify

简体中文 | 繁體中文 | English | 日本語 | 한국어


What is Lyrisland?

Lyrisland displays real-time Spotify lyrics at the top of your screen in a Dynamic Island style overlay. Lyrics are precisely synced with playback — lightweight, elegant, and always on your desktop.

Features

  • Dynamic Island Modes — Compact, Expanded, and Full modes with smooth animated transitions; Expanded shows track info, Full includes playback controls (prev/play-pause/next)
  • Real-time Sync — Line-by-line lyrics highlighting, precisely aligned with playback progress
  • Album Artwork — Displays album art in all three modes — thumbnail in Compact, medium cover in Expanded, large cover in Full
  • Dual-line Lyrics — Karaoke-style display showing current and next line simultaneously (toggle with ⌘D)
  • Multiple Lyrics Sources — Fallback chain across 4 providers: LRCLIB → Musixmatch → SodaMusic → Netease, with drag-to-reorder priority and per-source enable/disable in Settings
  • Flexible Positioning — Snap to menu bar (attached) or free-drag anywhere on screen (detached), with position persisted across launches
  • Background Styles — Choose from solid color, album gradient, frosted glass, or dynamic gradient backgrounds
  • Customizable Shortcuts — View, rebind, or disable all keyboard shortcuts in Settings, with conflict detection and one-click reset
  • RTL Support — Automatic text direction detection for right-to-left languages (e.g. Arabic), with adaptive marquee scroll and alignment
  • Multilingual UI — Localized in English, 简体中文, 繁體中文, 日本語, 한국어
  • No Login Required — Reads playback state directly from the local Spotify client via AppleScript, no account authorization needed
  • Lightweight & Resident — Runs in the menu bar only, no Dock icon, minimal resource usage

Installation

Homebrew (recommended)

brew tap EurFelux/tap
brew install --cask lyrisland

# Update to the latest version
brew upgrade lyrisland

Manual Download

Download the latest .dmg from GitHub Releases, open it, and drag Lyrisland to Applications.

Preview

Compact

Compact

Expanded

Expanded

Full

Full

Background Styles

Solid

Solid

Album Gradient

Gradient

Frosted Glass

Glass

Dynamic Gradient

Dynamic

Position Modes

Attached to Menu Bar

Attached

Free Floating

Detached

Getting Started

  1. Make sure Spotify Desktop is installed
  2. Open Lyrisland
  3. On first launch, macOS will request Automation permission — please allow it
  4. Play a song in Spotify, and lyrics will automatically appear at the top of your screen

Requirements

  • macOS 14.0 (Sonoma) or later
  • Spotify Desktop client

FAQ

Q: Do I need to log in to Spotify? No. Lyrisland reads playback info from the local Spotify client without any account authorization.

Q: Why are there no lyrics for some songs? Lyrics come from third-party public databases. Niche tracks or instrumentals may not be available yet.

Q: What if the lyrics are out of sync? Use the offset adjustment from the menu bar icon ([ / ] keys, ±0.5 seconds each).

Q: Does it support Apple Music? Currently only Spotify is supported.

Credits

License

This project is licensed under the GNU General Public License v3.0.

About

A macOS Dynamic Island-style floating widget that displays real-time synced lyrics for Spotify. No login required.

Topics

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages