Performance Overhaul

plugins/radiant-lyrics-luna/README.md

@@ -0,0 +1,83 @@
+# 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