Skip to content

LyricGlow for macOS, an always-on-top Electron widget showing real-time, word-by-word synced lyrics with glow effects, plus artist metadata and album art. Works with Spotify, Apple Music, and YouTube Music. LRC support, offline cache, and menu bar controls.

License

Notifications You must be signed in to change notification settings

ateymoori/lyricglow

Repository files navigation

LyricGlow

LyricGlow

Real-Time Synchronized Lyrics for macOS

Word-by-word lyrics highlighting for Spotify, Apple Music, and any macOS music player.

CI CodeFactor Version Downloads License

macOS Electron TypeScript Architecture

Stars Forks


LyricGlow Demo
Real-time synchronized lyrics with word-by-word highlighting

Quick Install

curl -fsSL https://raw.githubusercontent.com/ateymoori/lyricglow/main/scripts/install.sh | bash

Supports: Apple Silicon (M1/M2/M3/M4) and Intel Macs • macOS 11.0+

Manual Installation
  1. Download from Releases:
    • Apple Silicon: LyricGlow-arm64.dmg
    • Intel: LyricGlow-x64.dmg
  2. Open DMG → Drag to Applications
  3. First launch: Right-click → Open

Features

Core

  • Real-time word-by-word highlighting
  • Auto-sync with playback position
  • Full lyrics modal view
  • Progress bar seek support

Integrations

  • Spotify, Apple Music, YouTube Music
  • Spotify OAuth for top tracks/albums
  • Menu bar live lyrics display
  • 7-day intelligent caching

Design

  • Glassmorphism UI
  • RTL support (Arabic, Persian, Hebrew)
  • Customizable sections
  • Always-on-top floating window

Screenshots


Full Mode

Compact Mode

Lyrics Only

RTL Support

Menu Bar Integration

Usage

  1. Launch LyricGlow from Applications
  2. Play music in any supported player
  3. Watch lyrics sync with word-by-word glow
  4. Customize via settings (gear icon)
Shortcut Action
Cmd+L Toggle window
Click progress bar Seek to position
Click album art Open in Spotify

Development

git clone https://github.com/ateymoori/lyricglow.git && cd lyricglow
npm install
npm run dev      # Development with hot reload
npm run build    # Compile TypeScript
npm run dist     # Build DMG
Project Structure
src/
├── main/           # Electron main process
│   ├── auth/       # Spotify OAuth
│   └── managers/   # Lyrics, metadata, cache
├── preload/        # IPC bridge
├── renderer/       # UI (DOM manipulation)
└── shared/         # Types, utilities, logger

Contributing

PRs welcome! Priority areas:

  • Windows/Linux support
  • Additional lyrics sources
  • UI translations

Credits

Service Purpose
LRCLIB Synchronized lyrics
TheAudioDB Artist metadata
Spotify API Top tracks & albums


About

LyricGlow for macOS, an always-on-top Electron widget showing real-time, word-by-word synced lyrics with glow effects, plus artist metadata and album art. Works with Spotify, Apple Music, and YouTube Music. LRC support, offline cache, and menu bar controls.

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Contributors 2

  •  
  •