**Bug fixes** **CarPlay** - **Letter-bucket pagination:** - **Disconnect timer cleanup:** **Smart-playlist tag filter** **Jellyfin API refresh** **Performance — visualizer hot path** - **FFT magnitude allocation removed** - **Image cache tuned for music workload** **Battery / perf Improvements**

Battery, Background-Work Hygiene & Minimalist Polish Download Hardening, Settings/Profile Polish Connectivity, Cache, Player Improvements

**CarPlay Polish** **Bug Fixes** **Performance** **Hardening** **Fast Bootstrap Snapshots:** **Image Cache Expansion:**

**Offline & Storage** - **Offline Library Expansion:** Added support for browsing by Genres, Playlists, and Recently Played history while offline. The app now dynamically builds a genre index and uses cached metadata to keep your library organized without a connection. - **Offline Artwork Fidelity:** Enhanced `JellyfinImage` with improved local lookup hints, ensuring album and artist art load instantly from local storage in all views (Home, History, Player) when offline. - **Genre Navigation Fix:** Refactored genre browsing to utilize the repository system, enabling full offline exploration of albums within a genre. **Audio Engine** - **Refactored Gapless Transitions:** Implemented instant player swapping by starting the next player immediately and detaching listeners asynchronously, eliminating micro-gaps between tracks. - **Concurrent Crossfade:** Redesigned crossfading to overlap tracks simultaneously using quadratic volume curves for a professional, seamless DJ-style transition. - **FFT Redundancy Fix:** Optimized iOS FFT shadow player to reuse local cache and downloaded files, halving network usage for visualization during streaming. **Battery & Performance** - **Low Power Mode Integration:** Connected iOS Low Power Mode detection to throttle background scrobble retries and disable power-intensive visualizers. - **Visualizer Optimization:** Added logic to halt visualizer frame emissions when Battery Saver Mode is active, reducing CPU/GPU overhead. **Security & Hardening** **Bug Fixes** - Fixed all-time Rewind always showing 0 for Longest Streak - Fixed Marathoner personality being permanently unreachable - Fixed Healing Frequencies discovery not registering any achievement - Fixed `saveAnalytics()` not saving all state on app lifecycle pause — `_fretsOnFireDiscovered` and `_healingFrequenciesDiscovered` were missing from the `Future.wait` batch; both flags are now included - Fixed server-path Top Artists undercounting multi-artist tracks **Performance** - Artist image lookups in all-time Rewind now run in parallel

**New UI: Profile Bento Overview** **New UI: Categorized Settings Landing** performance and bug fixes

Healing Frequencies, Easter Eggs Hub & Service Hardening New Feature: Healing Frequencies Easter Egg Meditative tone generator inspired by evoluteur/healing-frequencies (MIT © Olivier Giulieri) 12 categories, ~90 preset frequencies — Solfeggio, Healing, Organs, Mineral Nutrients, Ohm, Chakras, DNA Nucleotides, Tesla 3·6·9, Cosmic Octave, Osteopathic (Otto), Angels, plus a bonus Schumann (7.83 Hz) category Pure on-device synthesis New Feature: Easter Eggs Hub New EasterEggsScreen lists every hidden feature with descriptions, offline-capability chips, and search-keyword hints Reachable from Settings → Your Music → Easter Eggs (gradient Celebration icon) Offline-gated eggs (Network, Essential Mix) dim and surface a snack-bar explaining they need downloads when you're offline Performance WaveformService in-memory LRU cache bumped from 50 → 200 entries — long listening sessions stop thrashing disk I/O re-reading waveform files for recently-played tracks Service Hardening

**Security** - ListenBrainz API token is now stored in an encrypted Hive box (matching Jellyfin session storage), with automatic migration from unencrypted data - Reduced verbose device ID logging — only logs on first generation, not every app launch **Data Safety** - Fixed session store migration that could lose session data if the app crashed mid-migration — encrypted box is now written before the old unencrypted box is deleted - Playlist cache no longer silently deletes all cached playlists on a single parse error — logs the error and returns gracefully instead **Bug Fixes** - Fixed `markFavorite()` not clearing caches on error paths — cache clearing now runs in a `finally` block so stale data is never served after a failed favorite toggle - Fixed race condition in Fleet Mode participant refresh — `_currentSession` could change during async API calls, causing stale participant data - Fixed `NowPlayingBar` potentially accessing navigator context after dispose - Fixed `JellyfinImage` not refreshing when `itemId` or `imageTag` changed (only artist/album/track IDs were compared in `didUpdateWidget`) - Fixed `RewindScreen` year selector `jumpToPage` failing when `PageController` wasn't yet attached — now deferred to post-frame callback - Fixed uncancellable `Future.delayed` timer in app startup that could fire after widget disposal — replaced with cancellable `Timer` - Made `RemoteControlService.dispose()` explicitly annotate fire-and-forget disconnect with `unawaited()` **Performance** - `DownloadService.downloads` getter no longer sorts the full list on every access — result is now cached and invalidated only on mutations - `fetchAllTracks` now paginates in 500-item batches instead of requesting up to 5000 items at once, preventing UI freezes and potential OOM on large libraries - Library selection screen uses `ListView.builder` instead of eagerly materializing all library tiles - `AddToCollabButton`, `AddToCollabMenuItem`, and `CollabActiveIndicator` switched from `Consumer` to `Selector` — only rebuilds when `isInSession` changes, not on every `SyncPlayProvider` update **JSON Error Handling** - All ~33 `jsonDecode(response.body)` calls in `JellyfinClient` are now wrapped in safe helpers that catch `FormatException` and throw descriptive errors — prevents app crashes when the server returns HTML error pages or malformed JSON -Offline Album Deduplication & Search Polish

Offline Mode & WiFi-Only Download Fixes Helm & Fleet Fixes

Piano Easter egg: Added playable synth keyboard — programmatic WAV synthesis with additive harmonics (fundamental + 2nd + 3rd) and ADSR envelope, 6-player polyphony pool, per-note caching Carplay fixes

Quality Audit: Bug Fixes, Performance Hardening & Code Architecture Critical Bug Fixes** - Fixed LibraryScreen reactivity — `Provider.of` was using `listen: false`, causing album/artist lists not to load, offline toggle delays, and airplane mode not reflecting - Fixed alphabet scrollbar aspect ratio mismatch — itemHeight used `/ 0.75` but grid uses `childAspectRatio: 0.7` - Fixed alphabet scrollbar SliverPadding drift in grid mode — added 16px correction per group - Fixed alphabet accent normalization mismatch — sections now use the same `normalizeToBaseLetter` as the scrollbar - Fixed `DownloadService._loadDownloads` crash — unsafe `as int` cast replaced with safe `as num?` pattern - Fixed `OfflineRepository.getArtistAlbums` — was comparing artist UUIDs against display names (always failed) - Fixed `ConnectivityService.onStatusChange` stream dying silently on `OSError` (Linux interface down) - Fixed SyncPlay playback rate stuck at 1.02/0.98x after session cleanup — now resets to 1.0

Audio Pipeline Fixes Helm Mode (Remote Control) Hardening Fleet Mode (SyncPlay) Reliability UI Performance & Bug Fixes

Audio Performance Optimizations Profile Stats UI Refresh

Long-Press Context Menu, Frets on Fire Visual Upgrade & Offline Navigation Bug Fixes -CarPlay Disconnect Race Condition -Sync Timer Running in Offline Mode on Startup -Waveform Storage Stats Display -Remote Control Disconnect Not Fire-and-Forget Offline Network Silence, Battery Optimization & Storage Management

iOS Lock Screen Desync & CarPlay Browse Fixes

Health Check & Reliability Improvements Submarine Mode, iOS Lock Screen Fix & Performance **New Feature: Submarine Mode (Ultra Battery Saver)** - New toggle in Settings that aggressively reduces all power-hungry features while keeping music perfect - Works in both online and offline mode **Fix: iOS Low Power Mode Detection** **Fix: iOS Lock Screen Play/Pause Graying Out (5 fixes)** **Performance: Stop Timers When Paused** **Performance: Pre-Allocated FFT Buffers** **Performance: Configurable Reporting Interval** Live Search, Queue Undo & Track Info **New Feature: Live Search with Debounce** - Search results now appear as you type — no need to press Enter **New Feature: Queue Undo** - Swiping a track from the queue now has a fully working UNDO action **New Feature: Track Info Bottom Sheet** - Long-press any track → "Track Info" option in context menu Lyrics Sync Fix & Track Info in Album View

**New Feature: Artist Radio** **New Feature: Recently Played Screen** - Full listening history screen accessible via "View All" on the Recently Played shelf - Events grouped by day (Today, Yesterday, This Week, Older) with relative timestamps - Tap to play, long-press for context menu (Play Next, Add to Queue, Instant Mix, etc.) - Powered by local ListeningAnalyticsService data (up to 200 events) **New Feature: Reorderable Navigation Tabs** - Long-press the bottom navigation bar to reorder tabs via drag-and-drop - Order persists across app restarts via Hive storage - Index mapping ensures correct tab content regardless of visual position **Helm Mode Overhaul**

Helm Mode, Fleet Mode, Bug Fixes, Performance & Flatpak Helm Mode (Remote Control) Sessions API: Control another Nautune instance on the same Jellyfin server Device Discovery: Automatically finds other Nautune instances via Sessions API Full Remote Control: Play, pause, seek, skip next/previous on the target device Adaptive Polling: 3s refresh when target is playing, 10s when idle (saves API calls) Player Integration: Ship's wheel icon in the full player screen header to activate Helm Mode Active Banner: Shows "Controlling: [Device Name]" banner when helm is active Fleet Mode (SyncPlay Rebrand + Improvements) Tighter Drift Correction: Sync Quality Indicator: Colored dot (green/yellow/red) showing sync health and average RTT Shuffle/Repeat Controls: Toggle buttons added to Fleet Mode playback controls, wired to SyncPlay API Buffering State Wiring: Audio player buffering state now reported to SyncPlay server for sailor coordination\ Performance Improvements Visualizer Improvements UI Fixes Infinite Radio: Moved toggle from Settings to full player screen's "more options" menu where it's contextually relevant Download Progress: Fixed progress wheel clipped by container — centered with proper sizing and rounded corners Bug Fix: CarPlay Lists Stop Loading After First Browse Bug Fix: iOS Lock Screen Play/Pause Grayed Out Bug Fix: ListenBrainz Discovery False Matches Fuzzy Matching: Added minimum string length requirements (8 chars for tracks, 6 for artists) to prevent short strings like "Love" matching unrelated tracks Album Art Cache: releaseMbid now stored in MusicBrainz metadata cache — discovery album art persists on refresh Stats, discovery & lock screen fixes Smarter Discovery Recommendations

Artist Tracks, Adaptive Colors & Smart Mix Expansion Bug fixes

Popular Tracks & Artist Page Redesign Alphabet Navigation & Artist Mix Fix Alphabet Scrollbar Bugfix CarPlay Stability, ReplayGain & iOS Visualizer Fix Now Playing Layouts, Crossfade Fix & Battery Optimization

Visualizer in Album Art UI Polish & Settings ListenBrainz Discovery + Frets on Fire Polish CarPlay/Lock Screen Sync + Frets on Fire Power-Ups

CarPlay & Background Playback Fixes A-B Loop, Essential Mix & Alternate Icons A-B Loop Improvements & Saved Loops Easter Egg Demo Mode Support Essential Mix Enhanced Visualizer & iOS Performance Frets on Fire Easter Egg + iOS Visualizer Fixes - **Frets on Fire**: New Guitar Hero-style rhythm game easter egg - Search "fire" or "frets" in Library to discover - **SuperFlux-inspired algorithm**: Uses moving maximum + moving average for accurate onset detection - **BPM detection**: Auto-detects tempo and quantizes notes to actual beat grid (16th notes) - **Pitch-based lane assignment**: Spectral centroid tracks melody - notes follow the song's pitch contour - **Hybrid lane logic**: Bass/kick hits use frequency bands, melodic content uses pitch tracking - **Album art in track selection**: See album covers when choosing which track to play - **5-fret gameplay** with theme-derived colors (hue shifts from your primary color) - Keyboard controls: 1-5 or F1-F5 on desktop, tap lanes on mobile - **Real audio decoding**: FFmpeg on Linux/desktop, native AVFoundation on iOS - Scoring matches original Frets on Fire: 50 pts per note, max 4x multiplier (at 30 combo) - BPM-based timing windows (tighter at higher BPMs, like original) - Charts cached for instant replay, supports 3+ hour DJ sets (caps at 3000 notes) - **Streak animations**: Fire glow on hit line, pulsing multiplier, milestone flashes ("ON FIRE!", "BLAZING!", "INFERNO!", "LEGENDARY!", "GODLIKE!") - **Fire mode cheat**: Press 'F' on desktop to instantly activate fire mode for testing - **Legendary track included**: "Through the Fire and Flames" by DragonForce bundled in app - **Always available in demo/offline**: Legendary track playable in demo mode and offline mode - **Perfect score unlock (online)**: Get 100% accuracy online to permanently unlock the legendary status - **Profile stats**: Total songs, plays, notes hit, best score with track name displayed in fire-themed card - **"Rock Star" Milestone**: Unlock a badge with game controller icon for discovering the easter egg - **iOS Visualizer Decay Fix**: Increased decay factor for iOS (0.25 vs 0.12) so spectrum/mirror bars properly fall back down - **iOS Native FFT**: Buffer pre-allocation and native throttling for smooth Essential Mix visualizer - **iOS Audio Decoder**: New native plugin for decoding audio files to PCM for chart generation OS Native FFT Critical Performance Fix - **Native FFT Buffer Reuse**: Pre-allocate all FFT buffers once - 8 arrays totaling ~40KB now allocated once at init, reused every frame - Eliminates memory allocation in the hot path completely - **Native FFT Throttling**: Added ~30fps throttle at native level - Skips processing entirely when emitting too fast - Reduces event channel flooding - **Pre-computed Hanning Window**: Window function computed once at init (was recreated every callback) - **Asymmetric Smoothing**: Essential Mix visualizer now uses fast attack (0.6) / slow decay (0.12) matching fullscreen visualizers - Was using single 0.18 factor for both (too slow on attack, too fast on decay) - Visualizer now reacts instantly to beats and fades smoothly - **Result**: Essential Mix visualizer should now be smooth AND reactive on iOS iOS FFT Desync & Waveform Fix Relax Mode Expansion + Essential Mix Performance Essential Mix iOS Fixes + Low Power Mode ListenBrainz Reliability + Frets on Fire Stability

Multiple Visualizer Styles: 5 Visualizer Styles: Choose from Ocean Waves, Spectrum Bars, Mirror Bars, Radial, and Psychedelic Tag-Aware Smart Playlists View Modes & Download Cleanup Stats Backup & PDF Export Network Stats & Artwork Network Channel Verification Performance Optimizations Profile & Stats UI Improvements

The Network (Easter Egg) Other People Radio: Hidden radio feature with 60+ channels of curated mixes Bug Fixes

offline playback bug fixes offline artist picture

Collaborative Playlists SyncPlay Integration: Create and join collaborative playlists using Jellyfin's SyncPlay Real-Time Sync: Listen together with friends - playback stays synchronized QR Code Sharing: Invite friends by scanning a QR code or share link Captain/Sailor Roles: Captain outputs audio, all participants can control playback Jellyfin Profile Avatars: Participant avatars show Jellyfin user profile pictures Active Session Card: Quick access to rejoin session from Playlists tab (even in empty state) Auto-Reconnect: Session automatically rejoins after WebSocket disconnection Full Visualizer Support: Collab tracks pre-cached for waveform, FFT visualizer, and lyrics Analytics Sync & Server Integration Two-Way Analytics Sync: Play history syncs bidirectionally with your Jellyfin server Timestamped Play Reports: Plays recorded with actual timestamps, even when offline Offline Queue: Plays made offline are queued and synced when network returns Server Reconciliation: Catch up on plays made from other devices automatically Background Sync: Automatic sync on app startup and network reconnection Ambient Sound Mixer: Mix rain, thunder, and campfire sounds with vertical sliders Looping Audio: Seamless ambient loops for focus or relaxation Easter Egg Access: Search "relax" in the library to discover the feature (works in offline & demo mode too) "Calm Waters" Milestone: Unlock a special badge for discovering Relax Mode Relax Mode Stats: Track total time spent and sound usage breakdown (Rain/Thunder/Campfire %) Inspired by ebithril/relax-player Repo on github ios waveform fix Add Rewind (year-in-review) and ListenBrainz integration Performance Optimizations LRU Cache Eviction: Memory-bounded caches for images, HTTP ETags, and API responses prevent memory bloat in long sessions List Virtualization: Added cacheExtent to all scrollable lists for smoother 60fps scrolling with 1000+ items Queue Performance: Fixed-height queue items with itemExtent: 72 for instant scroll calculations Adaptive Bitrate Streaming: Auto quality mode now checks network type (WiFi → Original, Cellular → 192kbps, Slow → 128kbps) RepaintBoundary Isolation: Track tiles wrapped to prevent unnecessary widget repaints during scrolling Stats Accuracy & Offline Improvements CarPlay Navigation Fix