# 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 ```bash 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 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 ```bash 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](https://lrclib.net/) | Synchronized lyrics | | [TheAudioDB](https://www.theaudiodb.com/) | Artist metadata | | [Spotify API](https://developer.spotify.com/) | Top tracks & albums |
---

[Report Bug](https://github.com/ateymoori/lyricglow/issues) · [Request Feature](https://github.com/ateymoori/lyricglow/issues) · [Releases](https://github.com/ateymoori/lyricglow/releases)