Bug Fix

• Window close no longer disables window permanently — Closing the window (X or Cmd+W) now just hides it. Previously it saved windowEnabled=false, causing the app to start hidden on next launch. Window visibility toggle is only controlled via tray menu or Cmd+L.

Full Changelog: v0.6.0...v0.6.1

What's New

Apple Liquid Glass Design System 🎨

This release introduces a complete UI overhaul inspired by Apple's Liquid Glass design language.

Design Tokens

• Centralized color, spacing, radius, typography, and animation variables
• Single source of truth for consistent styling

Glass Effects

• Three-layer glass effect (illumination, shadow, highlight)
• backdrop-filter: blur(20px) saturate(180%) for authentic glass look
• Native macOS vibrancy (under-window) enabled

Unified Button System

• .icon-btn - Small 28px circular glass buttons
• .control-btn - Medium 34px media control buttons
• .control-btn-play - Large 44px filled play button with brightness hover effect
• .btn-primary, .btn-secondary, .btn-danger, .btn-link variants

Theme Support

• Auto dark/light mode via prefers-color-scheme
• Accessibility: prefers-reduced-transparency, prefers-contrast

Settings UI Improvements

• Flat list design with subtle dividers
• Cleaner section headers
• Simplified logs tab layout

Full Changelog: v0.5.4...v0.6.0

What's New

Code Quality Improvements

• Added code quality tooling (Knip, jscpd, Biome)
• Fixed all TypeScript lint errors and warnings
• Replaced any types with proper TypeScript types
• Removed unused barrel export files
• Improved error handling with proper type guards

Quality Metrics

• 0 lint errors, 0 warnings
• 0.91% code duplication (under 5% threshold)
• 0 dead code issues

Downloads

• LyricGlow-arm64.dmg - For Apple Silicon Macs (M1/M2/M3)
• LyricGlow-x64.dmg - For Intel Macs

Installation

1. Download the appropriate DMG for your Mac
2. Open the DMG file
3. Drag LyricGlow to Applications folder
4. Launch from Applications

What's New

Bug Fix: macOS Sequoia Permission Detection

This release fixes an issue where LyricGlow would show "No music playing" on macOS Sequoia 15.x even when music was playing in Apple Music.

The Problem:
On macOS Sequoia, when Automation permission wasn't granted, the app would silently fail to detect music. Users had no indication that a permission was missing.

The Solution:

• LyricGlow now detects when Automation permission is denied
• Shows a clear message: "Permission Required"
• Displays instructions to grant permission in System Settings
• Auto-recovers when permission is granted (no restart needed)

How to Fix (if you see "Permission Required")

1. Open System Settings
2. Go to Privacy & Security → Automation
3. Find LyricGlow and enable the toggle for Music

Download

Quick Install

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

Full Changelog: v0.5.2...v0.5.3

What's New

Translation System

• 43 Languages - Support for Arabic, Bengali, Chinese, French, German, Hindi, Japanese, Korean, Persian, Portuguese, Russian, Spanish, and 31 more languages
• Alphabetically Sorted - Easy to find your language in settings
• RTL Support - Full right-to-left text support for Arabic, Hebrew, Persian, and Urdu
• Smart Caching - Translations are cached for offline use
• Batch Processing - Fast parallel translation of lyrics

UI Improvements

• Enhanced Seekbar - 24px clickable area makes it easier to seek in tracks
• Better Text Readability - Improved contrast for secondary and tertiary text
• Compact Player - More efficient use of space in the player section
• Hover Feedback - Seek handle scales up on hover for better visibility

Bug Fixes

• Fixed release script output directory path

Download

Quick Install

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

Full Changelog: v0.5.1...v0.5.2

🎉 What's New in v0.5.1

New Features

📦 Update Checker

• "Check for Updates" menu item in system tray
• Automatically detects new versions from GitHub
• Shows version comparison and changelog
• Opens browser to download page

How It Works

1. Click system tray icon
2. Click "Check for Updates"
3. App checks GitHub for latest release
4. If update available: shows dialog with changelog + Download button
5. If up-to-date: shows "You are running the latest version"

Technical Details

• Manual check only (no auto-update, no code signing needed)
• Uses GitHub API (/repos/ateymoori/lyricglow/releases/latest)
• Semantic version comparison (0.5.0 vs 0.5.1)
• Zero dependencies (built-in fetch)
• Battery optimized (only checks when user clicks)

Downloads

• LyricGlow-arm64.dmg - For Apple Silicon (M1/M2/M3 Macs) - 95MB
• LyricGlow-x64.dmg - For Intel Macs - 99MB

Installation

1. Download the appropriate DMG for your Mac
2. Open the DMG file
3. Drag LyricGlow to Applications folder
4. Launch and test the new update checker!

🤖 Generated with Claude Code

🎉 What's New in v0.5.0

Major Features

🔧 Redesigned System Tray Menu

• Simple checkbox controls for independent window and tray lyrics
• "Show Window" - master switch for window visibility
• "Show Tray Lyrics" - control tray display
• Settings persist across app restarts

🎵 Improved Lyrics Synchronization

• Window and tray lyrics now perfectly synchronized
• First line appears instantly when track changes
• Sub-100ms accuracy for both displays
• Time-based position calculation (no lag)

🪟 Window Close Button Fix

• Clicking X now hides window instead of quitting app
• Same behavior as unchecking "Show Window" in tray
• App continues running in background

Technical Improvements

• ⚡ Battery optimized with single polling source
• 🏗️ Moved lyrics sync to main process for reliability
• 🔒 Fixed all TypeScript strict mode errors
• 🧹 Cleaned up redundant IPC communication
• 📊 Independent operation of window and tray

Downloads

• LyricGlow-arm64.dmg - For Apple Silicon (M1/M2/M3 Macs)
• LyricGlow-x64.dmg - For Intel Macs

Installation

1. Download the appropriate DMG for your Mac
2. Open the DMG file
3. Drag LyricGlow to Applications folder
4. Launch from Applications

Requirements

• macOS 10.15 (Catalina) or later
• Spotify, Apple Music, or YouTube Music

🤖 Generated with Claude Code

🎉 LyricGlow v0.4.0 - TypeScript Migration

This is a major update that migrates the entire codebase from JavaScript to TypeScript, bringing significant improvements in code quality, maintainability, and developer experience.

✨ What's New

TypeScript Migration

• Full TypeScript 5.9.3 migration with strict mode
• 100% type coverage - no any types
• Enhanced IntelliSense and auto-completion
• Compile-time error detection
• Better refactoring capabilities

Build System Overhaul

• electron-vite 4.0.1 + Vite 5.4.21 integration
• Lightning-fast builds (~158ms)
• Hot Module Replacement (HMR) for development
• Optimized bundling and tree-shaking

Critical Bug Fix

• Fixed recursive packaging bug that caused bloated builds
• DMG size reduced by 80% (496MB → 95-99MB)
• Optimized app.asar (675MB → 3.3MB)

Code Organization

• Reorganized into main/, renderer/, preload/, shared/
• Type-safe IPC communication
• Shared type definitions
• Enhanced modularity

📦 Downloads

Choose the appropriate DMG for your Mac:

• LyricGlow-arm64.dmg (95MB) - For Apple Silicon (M1/M2/M3/M4)
• LyricGlow-x64.dmg (99MB) - For Intel Macs

📊 Migration Stats

• 27 files changed
• +4,902 additions, -1,873 deletions
• 0 TypeScript errors (strict mode)
• Build time: ~158ms
• Memory usage: <30MB

🔧 Technical Details

Tech Stack:

• TypeScript 5.9.3 (Strict Mode)
• Electron 33.4.11
• electron-vite 4.0.1
• Vite 5.4.21
• Node.js 22.x

Architecture:

• Type-safe main process
• Secure IPC communication
• Context-isolated renderer
• Modular shared utilities

🚀 All Features Still Work

All v0.3.0 features remain fully functional:

• ✅ Real-time synchronized lyrics
• ✅ Word-by-word highlighting
• ✅ Spotify OAuth integration
• ✅ Rich artist metadata
• ✅ Album artwork display
• ✅ RTL language support
• ✅ Apple Music & Spotify detection

📝 Notes

This is a backwards-compatible release. Your existing settings, cache, and Spotify authentication will work seamlessly.

🙏 Acknowledgments

Migration completed with assistance from Claude Code AI Assistant.

Full Changelog: v0.3.0...v0.4.0

What's Changed

Code Signing Improvements

• Switched to ad-hoc signing - Removed third-party certificates for cleaner open-source distribution
• Added visual installation guide - DMG now shows step-by-step installation instructions
• Updated README - Clear instructions for bypassing macOS security warning on first launch

Installation

1. Download LyricGlow.dmg
2. Open and drag to Applications
3. Right-click LyricGlow → Select "Open"
4. Click "Open" in security dialog (required only once)

Technical Details

• App now uses local ad-hoc signing (standard for free open-source Mac apps)
• DMG includes visual installation background
• No third-party certificates or team identifiers
• Universal binary (Apple Silicon + Intel)

Full Changelog: v0.2.10...v0.2.12

🎵 What's New in v0.2.10

Full Lyrics Modal Synchronization

• Smart State Management: Modal now automatically refreshes when songs change
• Auto-Scroll Reset: Scroll position resets to top on new track
• Seamless Experience: No more outdated lyrics when switching songs
• Single Source of Truth: Centralized lyrics state through LyricsHandler

UI Overlap Prevention

• Z-Index Stacking: Proper layering prevents lyrics from covering media controls
• Always Clickable: Media controls remain accessible at all times
• Improved Spacing: 16px top margin on lyrics container for better separation
• Resize-Safe: Controls stay clickable even when resizing the window

Polish & Refinements

• More Content Space: Reduced modal padding (48px/20px) for better readability
• Cleaner Layout: Background layer on player content prevents visual overlap

🔧 Technical Details

State Synchronization

• Added refresh() method to FullLyricsModal class
• Connected modal to onLyricsUpdate event for automatic updates
• Event-driven architecture maintains synchronization

Z-Index Hierarchy

• Header buttons: 1000
• Media controls: 101
• Player content: 100
• Lyrics container: 50

📦 Installation

1. Download LyricGlow.dmg below
2. Open the DMG file
3. Drag LyricGlow to Applications folder
4. Launch from Applications

💡 What We Fixed

• Full lyrics modal showing old lyrics after song changes
• Lyrics overlapping and blocking media control buttons
• Controls becoming unclickable when window resized
• Modal padding taking too much space

Full Changelog: v0.2.9...v0.2.10

🤖 Generated with Claude Code