🎶 Truly Unlimited Lyrics: We’ve lifted the storage quota! You can now cache thousands of romanzied and translated songs permanently without hitting browser limits.

📊 Smarter Storage UI: The extension popup now automatically scales from KB to MB as your library grows, providing real-time visibility into your offline lyrics cache.

✨ Quality First Romanization: Refined our mode-switching engine to prioritize the highest quality phonetic data available, ensuring you always get the best sing-along experience.

🛡️ Reliability Overhaul: Completed a comprehensive technical audit. This version features hardened context validation to prevent "Extension context invalidated" errors after updates, and an optimized fetch-interceptor for zero-latency lyrics restoration.

💎 Performance Polish: Improved state coherence for rapid track skipping and fixed several edge cases in the Indic and East Asian romanization pipelines.

The "Industrial Strength" Update (v3.0.4)

This major update transforms the core engine for 100% reliability and adds powerful new controls.

✨ NEW FEATURES:
• Expanded Native Restoration: Automatically restores original scripts for ALL non-Latin languages including Thai, Arabic, Greek, and more (beyond the previous Indian language support).
• Keyboard Shortcuts: Switch modes instantly while the lyrics panel is open by pressing 'O' (Original), 'R' (推), or 'T' (Translated).
• Discrete Mode: You can now hide the on-page floating controls via the popup and rely exclusively on shortcuts or the popup remote.
• Searchable Language Picker: Quickly find your target language from over 100 options in the new, high-performance popup selector.

🛠️ IMPROVEMENTS:
• "Unbreakable" Fetch Engine: Completely re-engineered the way lyrics are intercepted to eliminate "Couldn't load lyrics" errors.
• Zero-Latency Startup: Improved caching and module-level token warming ensure lyrics appear instantly without flickering.
• Brotli-Safe Fallbacks: Intelligent header management prevents browser decompression errors when switching between original and translated text.
• UI Polish: Refined dark-mode aesthetics to match the latest Spotify design system.

✨ New Features

• Tamil Romanization: Tamil is now romanized locally using practical phonetics (like zh, th, aa digraphs) rather than relying on external API diacritics.
• Odia Support: Added Odia to the list of supported Indian languages for native-script restoration.
• Custom Settings Modal: Replaced the clunky native browser alert with a beautifully synthesized, custom Settings UI overlay that perfectly matches the Spotify design system. This also resolves a known visual bug where Firefox dialogs appeared squished.

🐛 Bug Fixes & Improvements

• Firefox Cache Fix: Resolved an issue where Firefox's local storage cache would fail to evict old lyrics, preventing unbounded storage growth.
• Flicker-Free Injection: Eliminated occasional visual flashes of original lyrics during song changes by implementing a zero-latency synchronous in-memory cache.
• Injection Reliability: Massively improved the reliability of the fetch-interceptor to ensure native-script lyrics (for Indian languages) are consistently restored on the first try.
• Performance: Reduced DOM observer overhead by dropping aggressive text-node tracking.

v2.0.2 — Native Script Restoration for Indian Languages

Many Indian-language songs on Spotify display lyrics only in romanized form (e.g. "un peyaryl en perai cherttu" instead of Tamil script) even though the original native-script version exists in Musixmatch's database.

This update silently fixes that: when a supported Indian-language song is detected, the extension fetches the native-script synced lyrics directly from Musixmatch and replaces the romanized fallback before Spotify renders it. No settings or toggles required.

Supported scripts: Hindi, Tamil, Telugu, Kannada, Malayalam, Gujarati, Punjabi, Marathi, Sanskrit, Bengali.

The Romanize and Translate features now operate on the correct native source script, producing significantly more accurate results for these languages.

Welcome to Version 2.0! This is a massive architectural overhaul designed to make Spotify Karaoke faster, lighter, and more accurate.

What's New:
✨ Complete under-the-hood engine rewrite for lightning-fast real-time lyrics synchronization
✨ Brand new "Dual Lyrics" mode: See the original lyrics directly beneath your translated/romanized translation!
✨ Rebuilt translation chunking pipeline for significantly improved syntax and context preservation
✨ Brand new popup UI interface and settings panel
✨ Massive stability improvements across all language romanization engines (Japanese, Korean, Chinese, Cyrillic, Indic, Thai, etc.)