YouLyPlus v3.1.5 — Visual & Performance Boost 🚀

Major lyric rendering & animation refinements + multiple bug fixes for better timing accuracy & smoother flow.

✨ New

• WebGL Context Recovery — Blur effect now recovers automatically after context loss.

⚡ Enhancements

• Smoother lyric transitions (0.7s inactive → active scale-up).
• More accurate wipe animation using syllable width (em) instead of char count.

🧹 Refactors

• Centralized CSS injection in content.js.
• Optimized highlight updates (no array conversions).
• Removed word→line conversion.
• Improved Gemini romanization validation (JSON schema).

🛠 Fixes

• Fullscreen lyric cut-off.
• charBasedDelay timing offset removal.
• Better overlapping line duration handling.
• LRCLib/KPoe parsing cleanup.
• SponsorBlock privacy & request control.
• Google Translate API parsing fix.

YouLyPlus Release v3.1.0



🚀 New Features

• Romanization via Gemini AI
  Introducing the ability to use Google's Gemini AI for romanizing lyrics. Users can now select their preferred romanization provider (Google Translate or Gemini) and even customize the Gemini prompt in the settings for tailored results.
• Word-by-Word Romanization Sync
  Romanized lyrics can now sync word-by-word, similar to the original lyrics. This provides a much more dynamic and precise pronunciation guide, available for songs that support word-level timestamps.

⚙️ Enhancements

• Greatly Improved Romanization Accuracy
  The romanization process is now significantly more accurate. Instead of detecting the language for small, individual lyric segments, the system first detects the language from the entire song's text. This full-text context provides a more reliable hint to the API, reducing errors and improving the quality of the romanization.
• Physics-Based Touch Scrolling
  The manual scrolling experience on touch devices has been enhanced with natural, physics-based momentum. Scrolling now feels smoother and more responsive, with a gentle deceleration effect after lifting your finger.
• Optimized Lyrics Rendering Performance (yee again)
  Lyrics scrolling and highlighting are now more efficient. By caching line visibility, optimizing loops for active line detection, and streamlining highlighting logic, the rendering process is faster and smoother, especially for long or complex lyrics.

🧹 Refactors

• Modular Display Logic
  The core displayLyrics function has been simplified by extracting visual settings, container clearing, and text direction detection into separate, more maintainable helper methods.
• Robust API Error Handling
  Error handling for translation and romanization API calls has been strengthened to gracefully manage potential network issues or API failures.
• Simplified Display Option Logic
  The code for rendering dropdown menu options (e.g., "Show Translation," "Show Romanization") has been clarified, making it more direct and easier to maintain.

🛠 Fixes

• Consistent Romanization Data Handling
  Corrected an issue where romanized text was not being properly assigned and stored, ensuring that romanization displays correctly and is compatible with the lyrics renderer, especially when it's the only active option.

YouLyPlus Release v3.0.0



Important Note: Significant Under-the-Hood Improvements!

This release brings substantial internal code changes and performance optimizations that create a more stable and robust experience. While many improvements are behind the scenes, you'll notice smoother visuals, especially with pre-highlight effects that enhance gradient transitions and seamless lyric flow during simultaneous translation.



🚀 Key Features & Enhancements

• Simultaneous Translation + Romanization: See both translated and romanized lyrics at the same time for complete understanding.
• Dynamic Singer Assignment: Singer lines are now intelligently placed left/right based on their ID, no more fixed positions.
• Smart Auto-Scroll: Manual scrolling now pauses auto-scroll, which then intelligently resumes after 4 seconds of inactivity.
• Custom & Fallback KPoe Servers: Gain more control and reliability by using your own KPoe API endpoints and benefit from multiple fallback server options.
• Enhanced Performance & Responsiveness: Experience faster lyric rendering, smarter scroll logic, and smoother transitions thanks to optimized DOM updates, improved re-timing, and better handling of resizing.
• Refined Scroll Control: Enjoy smoother and fully controlled lyric scrolling across devices with new custom translateY transforms.
• Robust Language Fallbacks: Smarter language detection now matches dialects for improved localization.

🛠 Notable Fixes & Refactors

• Improved lyric sync for overlapping lines.
• Refined pre-highlight transitions for a polished look.
• Streamlined internal scroll state tracking and DOM update logic for better efficiency.

YouLyPlus Release v2.1.0

🚀 New Features

• GPU-Accelerated Dynamic Background
  Enjoy a beautiful, blurred, and animated background generated from the current song's artwork. This feature is GPU-accelerated for smooth performance and includes a "Lightweight Mode" for lower-spec systems.
• Redesigned Settings Page
  The settings page has been completely redesigned for a cleaner layout, better organization, and improved user experience.
• Inactive Lyric Line Blur
  A new visual effect that blurs lyric lines that are not currently active, helping you focus on the current line being sung.
• Mobile Web Player Support
  The dynamic background and other visual enhancements are now available on the YouTube Music mobile web interface.

🛠 Fixes

• High-DPI Display Rendering
  Enhanced the WebGL canvas to render crisply on high-DPI (Retina) displays, eliminating pixelation and blurriness.
• Background Blur Toggling
  Fixed a persistent bug where the background blur effect would remain active even after being disabled in the settings.
• Settings Switches
  Corrected an issue where the "Lightweight Mode" toggle on the settings page was not working correctly.
• Canvas Resizing
  Removed unnecessary dynamic canvas resizing to prevent visual glitches and improve the stability of the blur effect.

⚙️ Enhancements

• Major Performance & Rendering Overhaul
• Re-engineered the lyrics renderer to use IntersectionObserver, which pauses animations for off-screen lyrics to drastically reduce CPU usage.
• The entire animated background system was overhauled for GPU acceleration, ensuring smooth visuals without impacting performance.
• Implemented smarter caching for component dimensions to prevent re-calculations.
• Aesthetic & Animation Polish
• Improved the artwork palette generation algorithm for more aesthetically pleasing background colors.
• Refined lyric animations, including the gap line transition and the alignment of singer parts in lyrics.
• The fullscreen mode UI and blur effects have been polished for a more cohesive look.
• Robust Artwork & Lyrics Handling
• Replaced the old artwork loading mechanism with the modern fetch API for more reliable and robust loading.
• Improved lyrics caching and fetching logic for better performance and reliability.
• The extension now stores the last known song info to seamlessly handle UI transitions.

YouLyPlus Release v2.0.1

🛠 Fixes

• Visual Fix
  This minor fix are just for fixing the v2.0.0 visual bugs ...

YouLyPlus Release v2.0.0

🚀 New Features

• Extension Redesign
  All UI on YouLy+ are following material 3 design rules
• Settings Page Overhaul
  Completely revamped settings layout: grouped sections, translation & AI controls, and responsive design.
• Lyrics Translation & Romanization
• Translate Lyrics via Google Translate or Gemini AI
• Romanization / Pronunciation support for non‑Latin scripts
• Reload Lyrics button to re‑fetch and re‑render on demand
• Gemini AI Integration
  Configurable alternative translation provider with settings for geminiApiKey, geminiModel, prompt overrides, and target‑language overrides.

🛠 Fixes

• Fullscreen Lyrics Interaction
  Removed YouTube Music’s unexpected inert attributes in fullscreen mode so popup tabs and controls remain clickable.
• SponsorBlock Handling
  Improved segment validation, merging, and timing offsets to skip sponsor sections more accurately (supports both hashed and direct API responses).

⚙️ Enhancements

• Rendering Engine & Compatibility
• Enabled content-visibility: auto by default for native lazy‑rendering performance
• Added JS‑Based Line Optimizer as optional fallback when content-visibility causes scroll or visual glitches
• Replace flat wipe effect to Apple‑Music‑inspired gradient highlights design
• Improve Right To Left (Arabic) Text overlapping by adding more line height
• Internal Format Update: KPoe V1 → V2
  Migrated to KPoe v2 lyric format for cleaner parsing, and future feature expansions.
• Add Lyrics+ (User Generated Content) as source
  This will add more syllable-by-syllable sync for missing song on apple music.
• Modular Translation Logic
  Centralized all translation and romanization flows into lyricsManager.js for better maintainability.

YouLyPlus Release 1.4.0
🚀 New Features
Popup UI Redesign
Reimagined popup interface for improved user experience and aesthetic.

Refactor Emphasize Word Logic
Cleaner, modular code to manage lyric emphasis more effectively.

Exact Match Song Fetching
Added duration handling to improve lyric-song matching precision.

🛠 Fixes
Syllable Highlighting Tweaks
Refined animation timing for smoother syllable transitions.

Glowing Effect Correction
Fixed bugs related to glowing lyric animations.

Background Vocal Logic
More consistent and accurate background vocal processing.

Touch Interaction
Enhanced tab responsiveness on mobile devices.

Metadata Update
Included duration info in song metadata for better syncing.

⚙️ Enhancements
Performance Boost (matrix3d)
Switched to matrix3d transforms to fix jank and improve animation fluidity.

Dynamic Syllable Timing
More adaptive animation delays and wave-like lyric transitions.

CSS & Animation Polish
Improved styling, scroll padding, and overflow handling for lyrics display.

YouLyPlus Release 1.3.0

New Features

• Improved UI/UX:
  Redesigned several interface components to provide a more intuitive user experience. Navigation and control elements have been streamlined for better accessibility.

Bug Fixes & Improvements

• Stability and Performance:
  Addressed several bugs reported in version 1.2.0, leading to smoother performance and more robust error handling during video processing.
• Code Refactoring:
  Cleaned up and modularized the codebase, making future enhancements easier to integrate and improving overall maintainability.
• Error Reporting:
  Upgraded error logging mechanisms to offer clearer diagnostic information, helping users and developers quickly identify and resolve issues.

[1.2.0] - 2025-02-28

🚀 New Features

• YouTube Captions fallback when default captions are missing.
• 2-hour cache limit to optimize storage.
• Storage-cached lyrics for better performance.
• Independent songTracker on DOM for improved tracking.
• Auto-scroll & click-to-scroll lyrics for smoother navigation.

🎨 Enhancements

• Improved RTL & "line only" mode for better readability.
• Refactored songTracker & forced scroll fix for reliability.
• Moved focus line system to main-vocal-container for structure.

🛠 Fixes

• Switched to pBrowser from chrome.runtime for compatibility.
• Fixed default caption retrieval & redundant lyric redraws.
• Artist detection now prioritizes DOM, with fallback to author.

⚡ Performance & UI

• Enabled hardware acceleration for animations.
• Redesigned glow animation for a sleeker look.