lyricglow
# LyricGlow
### Real-Time Synchronized Lyrics for macOS
Word-by-word lyrics highlighting for Spotify, Apple Music, and any macOS music player.
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](https://github.com/ateymoori/lyricglow/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** - Apple Liquid Glass UI - Dark/light mode auto-switch - RTL support (Arabic, Persian, Hebrew) - Always-on-top floating window |
Screenshots
 Full Mode |
 Compact Mode |
 Lyrics Only |
 RTL Support |
Menu Bar Integration
Usage
- Launch LyricGlow from Applications
- Play music in any supported player
- Watch lyrics sync with word-by-word glow
- 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 |
**MIT License** © [AmirHossein Teymoori](https://github.com/ateymoori)
