A rebuild from a clean slate. Spotify's lyrics view is no longer replaced or redrawn: the extension changes the lyrics Spotify receives and how each line's text is drawn, so Spotify's own highlighting, scrolling, click-to-seek, layouts and colours keep working, and Spotify changes break far less. Settings carry over from 3.x.

• Lyrics where Spotify has none, drawn by Spotify itself: when Spotify has no lyrics, it is given the lyrics found on LRCLIB or YouTube Music in its own format, and shows them like its own (synced, credited in its footer). Unsynced Spotify lyrics are replaced by a synced copy in the same script.
• Original script restored before Spotify draws the lyrics: for a song Spotify serves romanized, YouTube Music and LRCLIB are asked at once, and a copy is used only when it is the same song (line by line, or as a whole text when the two break their lines differently, with timings that agree). Never for a song Spotify already serves in its script.
• Two lines (replacing Dual lyrics): the main line, with the original beneath it. Your Dual lyrics choice is kept.
• Romanization: each script in a line by its own engine; Japanese by word, read as pronounced; Thai offline; Hindi and Punjabi spelled the way lyrics are written ("kuchh", "sajjna").
• Translation: one Google request per song, never one per line; a backup endpoint when the main one refuses; pauses when Google rate-limits instead of retrying; lines Google sends back unchanged aren't shown as translations; songs already in your translation language are left as they are.
• Firefox: an MV3 build (Firefox 142+).
• Permissions: fewer sites (no longer spclient.wg.spotify.com, open.spotifycdn.com, translate.google.com, i.scdn.co); declarativeNetRequestWithHostAccess instead of declarativeNetRequest, its header rules limited to the extension's own requests; scripting, to add the extension to Spotify tabs already open when it is installed or updated, without a reload.

• All three lines: original, romanization and translation together, in every mode.
• No lyrics anywhere: the lyrics view says so, with Search again and Add lyrics to LRCLIB; instrumentals are named when Spotify says so.
• Wrong lyrics? in the popup: sends a song back to Spotify's own lyrics, with Undo.
• Alt+Shift+O / R / T browser shortcuts, beside the O / R / T keys on the lyrics.
• Decoration in the Now Playing sidebar's lyrics card and the mini player.

• 3.x's own lyrics renderer and its reading of Spotify's React tree: Spotify draws every line itself now.

🎶 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.)