TidaLuna-Plugins/plugins/radiant-lyrics-luna/README.md

Radiant Lyrics Luna Plugin

A plugin for Luna (Tidal Desktop) that adds enhanced lyrics styling, cover art backgrounds, and UI management features.

Features

✨ Lyrics Glow Effect

• Beautiful glowing effect for lyrics with custom font styling
• Can be toggled on/off in settings

🎨 Cover Everywhere (Performance Optimized)

• Apply spinning cover art background to the entire app
• NEW: Ultra-performance mode with significant optimizations:
  • Reduced blur effects (max 20px in performance mode)
  • Smaller image sizes (640x640 vs 1280x1280)
  • Static backgrounds (no animations)
  • Optimized GPU usage with hardware acceleration
  • DOM element reuse to prevent memory leaks
  • Throttled updates (max once per 500ms)
  • Adaptive polling for track changes

🔧 Performance Mode Features

When enabled, Performance Mode provides:

• Blur Reduction: Caps blur at 20px instead of up to 200px
• Image Optimization: Uses 640x640 resolution instead of 1280x1280
• Animation Disable: Removes all CSS animations for static backgrounds
• Memory Optimization: Better DOM element management and cleanup
• GPU Optimization: Reduces will-change properties and backdrop-filter effects
• Size Reduction: Smaller background image dimensions (120vw vs 150vw for global, 80vw vs 90vw for Now Playing)

🎛️ UI Management

• Hide/unhide UI functionality with smooth transitions
• Player bar visibility control when UI is hidden
• Customizable background effects (blur, brightness, contrast, spin speed)

Technical Improvements

Performance Optimizations (Latest Update)

1. DOM Element Reuse: Background elements are created once and reused instead of being recreated on every track change
2. Update Throttling: Cover art updates are throttled to prevent excessive DOM manipulation
3. Adaptive Polling: Track change detection starts fast and slows down when no changes occur
4. Hardware Acceleration: Added GPU acceleration hints for smoother animations
5. Memory Management: Proper cleanup of cached DOM elements
6. CSS Optimizations: Better use of transform3d and backface-visibility for GPU rendering

Normal Mode Performance Enhancements

Even without Performance Mode enabled, the plugin now includes significant optimizations:

• Optimized Filter Order: Reordered CSS filters for better GPU performance (contrast → brightness → blur)
• CSS Custom Properties: Dynamic filter updates use CSS variables to avoid style recalculation
• Transform3D: All transforms use translate3d() for better GPU acceleration
• Image Caching: LRU cache for cover art images (max 10 images) for instant loading
• Preloading: Smart image preloading with cache checking for smoother transitions
• Enhanced GPU Layers: Better use of transform-style: preserve-3d and isolation: isolate
• Optimized Animations: Improved keyframe animations with cubic-bezier timing
• Backdrop-Filter Optimization: More efficient backdrop-filter usage with hardware acceleration
• Compositing Hints: Added contain: layout style paint for better rendering isolation

Browser Compatibility

• Respects prefers-reduced-motion for accessibility
• Optimized for modern browsers with hardware acceleration support

Settings

• Lyrics Glow Effect: Toggle the enhanced lyrics styling
• Hide UI Feature: Enable hide/show UI functionality
• Player Bar Visibility: Keep player bar visible when UI is hidden
• Cover Everywhere: Apply cover art background to entire app
• Performance Mode: Enable ultra-light performance optimizations
• Background Controls: Adjust contrast (0-200), blur (0-200), brightness (0-100)
• Spin Speed: Control rotation speed (10-120 seconds per rotation)
• Settings Affect Now Playing: Apply background settings to Now Playing view

Performance Recommendations

• Enable Performance Mode if you experience lag or high GPU usage
• Reduce Background Blur setting for better performance
• Use lower Background Contrast values on slower systems
• Consider disabling Cover Everywhere on very low-end systems

Credits

• Heavily inspired by Cover-Theme by @Inrixia
• Thanks to the Luna development team for the plugin framework