PLAYBACK • Gapless playback and crossfade are more reliable, and every track now counts toward your stats and ListenBrainz • Streams recover on their own after a signal drop • Previous restarts the song if you're more than 3 seconds in • Music you paused stays paused after a phone call • The sleep timer no longer changes your volume • Uses noticeably less battery and cellular data - Music now plays through just_audio, so gapless albums are truly seamless. - There's a 10-band equalizer with presets. Boosts come with a matching volume cut so they don't distort. - Playback speed can be set from 0.75× to 2×. - A track is saved to the cache while it streams, so it's only downloaded once. The seek bar shows real buffering progress. OFFLINE • Downloads survive the app closing and wait out lost signal • Download buttons on albums, playlists and artists show progress, and let you cancel or retry • New Downloads screen with search, sort and Shuffle All • When you're offline, songs that aren't downloaded are skipped instead of stalling • Playlist edits and favorites sync automatically when you're back online • Formats iPhone can't play natively are converted when downloaded CARPLAY • A simpler, faster CarPlay layout • Browse your whole library, not just the first page • Works even when your iPhone is locked DESIGN • Cleaner Home and Profile screens, a Settings button in the top bar, and one consistent track menu • Easter eggs now live under Settings → About - The app now uses iOS-style page transitions, grouped lists, floating snackbars and rounded sheets, all coloured from your palette. - Every palette, custom ones included, now has a light and a dark version. You pick Palette, System, Light or Dark in Settings → Appearance. - New options: - The accent color can come from the palette or from the artwork that's playing. - Corners can be continuous or circular. - Frosted glass can be switched on or off. - Artwork tint can be switched on or off. LIBRARY - The A-Z index now lands on the exact letter you pick. Scrolling is smoother, and letter headers stay pinned while you scroll. - Tiles look like Apple Music, and long-pressing one opens an action sheet. - The artist page has Play and Shuffle buttons, and a ⋯ menu that holds Radio and Instant Mix. - Search has All, Artists, Albums and Songs filters, plus a Top Result card. - Swipe a song right to play it next, or left to add it to the queue. - You can select several songs on an album and act on them together. - Favorites and playlists can be sorted, and the choice is remembered. - iPad gets a sidebar. - VoiceOver support is better. PLAYER - The mini player floats above a translucent tab bar. Swipe up to open the player, or sideways to skip. - The full player opens like a sheet and closes when you drag it down. - There's a new shuffle button. Turning shuffle off puts the queue back in its original order, and it stays in sync with CarPlay and Siri. - The sleep timer has a new "End of this track" option. - Smart Shuffle is on by default. It plays recently heard songs later and avoids the same artist twice in a row. Playback, streaming and Jellyfin - ReplayGain can be set to Off, Track or Album, with a preamp from -15 to 0 dB. - A play or scrobble only counts after real listening time: 50% of the track or 4 minutes. Skipping or seeking past the halfway point no longer counts. - Progress is reported every 30 seconds while the screen is locked. Offline play reports are saved and survive the app being killed. - The audio cache is keyed by track and quality. A new Transcode Format setting lets you choose MP3 or AAC. - The Jellyfin dashboard and other clients can now control Nautune remotely. You can turn this off in Settings → Audio → Allow Remote Control. Scrobbling - Last.fm scrobbling is new, using your own free API account. It shows what's playing now and keeps an offline queue, and it works alongside ListenBrainz.

**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