Luminous v0.95.0

Release Notes - Luminous v0.95.0

Luminous v0.95.0 contains exciting new features, design enhancements, and stability improvements since v0.90.0:

🌟 New Features

• Tag-Based File Organizer: A dry-run preview modal for reorganizing your library into a custom folder/filename template, with conditional blocks (optional disc/track segments), syntax-highlighted variable editing, resizable preview columns, and the option to relocate companion files (artwork, lyrics, logs, cue sheets) alongside moved tracks — now embedded directly inline in Settings (#81).
• Bulk Tag Editor for Albums: Edit metadata tags across an entire album at once instead of one song at a time (#70).
• Playback Fades & Auto-Crossfade: Optional fade-in/fade-out on play, pause, and seek, plus an auto-crossfade mode for gap-free transitions between tracks (#79).
• Detached Picture-in-Picture Miniplayer Window: A floating, always-on-top miniplayer with a hover transport control mask, drag-to-move, and drag-to-resize, with size and position now remembered across sessions (#46).
• Queue Population Modes: Auto-Refill playlists (genre/decade auto-playlists and custom Smart Playlists) can now be biased All / Favourites / Familiar / Discover / Deep Cuts, replacing the old fixed top-N ordering (#120).
• Home Redesign — Top Artists & Row Layouts: A full-width Top Artists carousel plus Most Played and Recently Added row layouts, with album genre now shown under the category label (#118).
• Update & Format Settings: New in-app update checking and automatic format detection, plus further i18n polish; all supported audio formats are now enabled by default (#107).
• Miniplayer Song Rating: Rate the current track directly from the miniplayer's hover controls.
• Keyboard Shortcuts Overlay: A new Ctrl+/ shortcuts help modal, remapped playback keys, and new global hotkeys for layout and history navigation (#138).
• In-App User Guide: A full user guide is now available directly from the Help sidebar item (#142).

🎨 Visual & UX Improvements

• New Design System: App-wide sync to a refreshed design system with a new logo (split into crisp static and lush reactive artifacts) and updated playlist card gradients (#133, #134).
• Artist Discography Overhaul: Sets/Albums/EPs/Singles tabs now only appear when populated, loose singles-only artists get a proper grouped view, and cover art falls back to song artwork when there's no album to draw from.
• Multi-Disc Track Numbering: Track numbers now show as "{disc}-{track}" across releases with more than one disc.
• Clickable Carousel Cards: Song titles and artists in Home/Artist carousels now navigate to their album/artist views, matching the rest of the app.
• Keyboard Shortcuts Everywhere: Escape-to-cancel and Enter-to-confirm now work consistently across the Tag Editor, Album Tag Editor, Organize Files, and confirmation dialogs.
• Themed Range Sliders: Preamp, Target Level, Fallback Gain, Fade, and Crossfade sliders now show an accent-filled track instead of a flat, low-contrast bar.
• Streamlined Overview: Removed the redundant per-view overview infoboxes and added a direct Help link to the side nav (#140).
• Settings & Organizer Polish: Split Settings into dedicated Folders/Tools tabs, readable theme labels with Canadian spelling, a visible border on the organize-pattern input, and highlighted fields for values changed by an AcoustID lookup in the tag editor (#135, #137).
• Playlist & Home Polish: Refined toggles, album cards, Top 5 rows, and the playlist infobox (#129).
• Small Polish: Sun/Moon indicator on the System theme card, Repeat mode shown as a text label like Shuffle, an optional Skip Count column in the songs table, and a click-to-copy version number with a GitHub icon in About.
• Rescaled Visualizers: Spectrum analyzer and reactive logo now scale to peak-relative bins for a more consistent look across tracks.
• Accessibility Audit: Removed low-contrast, opacity-diluted text across every view.

🐛 Stability & Bug Fixes

• Library Watcher Reconciliation: Files moved across watched folders are now reconciled instead of silently breaking playback (#132).
• Cover Art Reliability: Fixed loose singles sharing one cached cover image, the background file watcher wiping cached artwork on tag edits, and embedded cover art being lost when saving tag changes.
• Miniplayer Fixes: Resolved the window growing on repeated enter/exit, a cropped album cover at default size, Ctrl+M double-firing, native/manual resize fighting each other, and a corner/border mismatch with the OS window frame.
• Auto-Playlist Freshness: Genre/decade auto-playlists now rebuild immediately after a scan instead of waiting up to 24 hours.
• Organizer Correctness: Excluded already-pruned songs from the preview, fixed companion-art paths after a relocation, normalized UNC paths on Windows, named colliding files clearly in the preview, and let Apply proceed past collisions by skipping only the affected files.
• Empty-Folder Cleanup: Clean Up now sweeps the whole library for empty folders (not just newly scanned ones), recognizes OneDrive placeholder folders, and shows the empty-folder count in its toast for longer. Ratings are now preserved when a watched-folder move relocates a track.
• Shuffle Mode: Fixed a bug where the previous track could replay itself in shuffle mode.
• Theme Sync: Dynamic Artwork theme colors now apply immediately when selected, instead of waiting for the next track change.
• Immersion Mode: Fixed the immersion toggle button showing an inverted on/off state.
• Scan Reliability: scan_all now always emits a completion signal, even when there are zero watched folders.

Luminous v0.90.0

A major feature update to Luminous Music Player introducing a custom Smart Playlist Builder with flexible filter rules, advanced search filter syntax and live auto-suggestions, native OS Now Playing integration (SMTC / MPRIS2), Back/Forward history navigation, context-aware playback history, lyrics instrumental toggle, and significant performance & UI refinements.

---

🌟 What's New in v0.90.0

🤖 Smart Playlist Builder & Advanced Filter Engine (#13)

• Smart Playlist Builder: Create custom dynamic playlists driven by rules (field, operator, value) with live track matching preview and decade range auto-naming (e.g., 1980s Rock Mix).
• Dedicated Smart Playlist Visuals: Smart playlists feature distinct purple gradient backgrounds and dedicated "Smart" badge styling.
• Advanced Filter Grammar: Search your library with precise target field filters (artist:, album:, title:, genre:, year:, rating:, playcount:, bitrate:).
• Customizable Columns & Audio Format: Toggle and reorder table columns including dedicated audio format display.

📻 Native OS Now Playing Integration (#101)

• System Media Controls (Souvlaki): Full integration with OS system media transport controls (Windows SMTC, Linux MPRIS2) enabling play, pause, track skip, seek, and track metadata broadcast directly to system lock screens and media keys.

🔍 Live Search Auto-Suggestions & History (#100)

• Real-Time Search Suggestions: Top search bar displays live suggestions for tracks, albums, artists, custom playlists, and auto-playlists.
• Direct View Navigation: Jump straight to artist and album pages directly from search suggestion dropdown items.
• Recent Searches: Dropdown panel showing recent search history with quick selection and clearing options.

🧭 Seamless History Navigation (#67)

• Back / Forward History Navigation: Navigate backwards and forwards through app views with top-bar navigation arrows, keyboard shortcuts, and mouse thumb side buttons.

🎧 Context-Aware Recently & Frequently Played (#99)

• Playback Context Tracking: Tracks played within albums or playlists retain their playback context under Recently Played and Most Frequently Played views.
• Interactive PlayerBar Navigation: Clicking album art in the PlayerBar smoothly navigates directly to the originating album or playlist.

🔄 Auto-Refill & Dynamic Playlists (#26)

• Auto-Refill Toggle: Rename and refine Auto-Play to Auto-Refill across the UI with clear status badges and end-of-library notification banners.
• Auto-Playlist Thresholding: Smart categorization, minimum song count limits (25 tracks), and clear info banners explaining auto-generated collections.

🎤 Lyrics & Audio Improvements (#12)

• Instrumental Lyrics Mode: Option to mark tracks as instrumental to skip lyric fetching.
• Waveform Preloading: Proactive audio waveform background preloading with animated loading indicator.
• Track Audio Info: Channel details (mono/stereo) and average VBR bitrate indicators in the right details sidebar.

---

🐛 Bug Fixes & Refinements

• Build Warning Cleanup: Fixed Svelte 5 state_referenced_locally warnings in SmartPlaylistBuilderModal.svelte using untrack().
• Build Hook Polish: Removed postbuild hook that automatically executed screenshot generation on every production build (bun run take-screenshots remains available as a manual script).
• Smart Playlist Routing: Fixed smart playlists being misidentified as exact-match genre auto-playlists and pruned on sync.
• Modal Layering: Elevated Smart Playlist Builder modal to root layout to ensure global modal state and fix z-index overlapping with the floating acrylic PlayerBar.
• Active Playlist Decoupling: Viewing a playlist no longer automatically marks it as the "Active" playback queue target.
• Playlist Card Formatting: Added relative date formatting (Today, Yesterday) and standardized card dimensions across collections.

---

⚠️ Important Notice

Warning

Bundle Identifier Update (org.luminous.app ➔ org.luminous.music)
The application bundle identifier was updated from org.luminous.app to org.luminous.music to resolve OS-level application bundle extension conflicts.
Note for upgrading users: Windows treats this as a new application identity. Installed application data and local settings will not automatically migrate from previous versions (v0.75.0 or earlier).

---

📦 Downloads

Installers and portable binaries for Windows and Linux:

• 🪟 Windows: Luminous_0.90.0_x64-setup.exe / Luminous_0.90.0_x64_en-US.msi
• 🐧 Linux: Luminous_0.90.0_amd64.deb / Luminous_0.90.0_amd64.AppImage / Luminous-0.90.0-1.x86_64.rpm

Luminous v0.75.0

A feature-packed update to Luminous Music Player featuring Decades auto-playlists, major playlist editor enhancements, full application state restoration, integrated library settings, and UI refinement across all views.

---

🌟 What's New in v0.75.0

🎵 Decades & Smart Auto-Playlists

• Automatic Decades Categorization: Instantly browse your library grouped by release decade (60s, 70s, 80s, 90s, 2000s, 2010s, 2020s) with dedicated category color badges (#16).
• Auto-Playlist Visual Polish: Updated grid shell and card styling for both custom and auto-playlists (#92, #95).

📋 Enhanced Playlist Editor

• Multi-Selection & Batch Operations: Select multiple tracks within playlists for bulk operations (#86).
• Batch Drag-and-Drop Reordering: Smooth drag-and-drop reordering with full backend synchronization (#85).
• Duplicate Detection & Inline Search: Identify duplicate tracks instantly and filter playlist content in real time.
• Stacked Cover Art Previews: Visual multi-layered cover art stacks on playlist headers and cards.

🔄 Seamless State Preservation

• Full App State & Context Restoration: Luminous now preserves and restores your active playback queue, position, sidebar tab, and active album/artist detail panes across app restarts (#72, #91).

🎨 Artist & Genre Highlights

• Primary Genre Display: View artist genres directly on artist cards with optimized backend query performance.
• Expanded Sorting Options: Sort artist views by genre, release count, and alphabetical order.
• Unified Cover Stack Component: Standardized multi-layered cover art stack presentation across AlbumCards and detail views.

⚙️ Integrated Library Maintenance

• Library Scanning Settings: Easily configure automatic background watching, incremental rescan behavior, and database indexing directly from Settings (#19).
• About & Credits View: Added About & Credits settings tab with detailed project info and third-party attributions.

---

🐛 Bug Fixes & Refinements

• Seekbar Waveforms: Fixed dual waveform peak generation and normalization for smooth seekbar visualizer rendering (#93).
• Z-Index Layering: Fixed context menus and modal dialogs rendering behind the floating acrylic PlayerBar.
• Grid & Alignment Polish: Unified scroll containers to guarantee right-margin alignment at all grid column counts.
• Artist Metadata: Corrected artist album count calculations and singular/plural formatting.
• Canvas Theme Colors: Fixed dynamic theme resolution for seekbar waveform canvas elements.
• Screenshot Automation: Updated screenshot generator to accurately match lyrics with featured tracks (#96).

---

📦 Downloads

Installers and portable binaries for Windows and Linux are attached below:

• 🪟 Windows: Luminous_0.75.0_x64-setup.exe / Luminous_0.75.0_x64_en-US.msi
• 🐧 Linux: Luminous_0.75.0_amd64.deb / Luminous_0.75.0_amd64.AppImage / Luminous-0.75.0-1.x86_64.rpm

Luminous v0.67.0

Luminous v0.67.0 contains exciting new features, design enhancements, and stability improvements since v0.60.0:

🌟 New Features

• Play Statistics & Ratings: Play counts and last-played tracking across the library, with hearts or 5-star ratings (configurable single rating style) synced live across every view.
• Gapless Playback & 20-Band Parametric Equalizer: Double-buffered decoding removes silence and clicks between tracks, alongside a new DSP chain contract and a 20-band parametric equalizer mode with a live response-curve preview and shared presets.
• EBU R128 Loudness Analysis: Automatic loudness analysis with ReplayGain fallback, plus Format and Loudness rows and a live-syncing Lyrics status in the Now Playing panel.
• Bilingual Interface (English/French): Full i18n support with instant language switching across the entire UI.
• Dedicated Album Detail View: A standalone album page with song count, plays column, and album-level controls.
• Playlist Undo/Redo & Import/Export: A full undo/redo command stack for playlist edits, plus import/export support for M3U, M3U8, PLS, and XSPF playlist files with relative or absolute path options.
• Moodbar Toggle Mode & Moodmoji: A contrast-boosted moodbar visualizer, now toggleable directly on the seek bar (waveform ⇄ moodbar), with a color legend tooltip and a 2-emoji "moodmoji" hash next to the now-playing track.

🎨 Visual & UX Improvements

• Home Page Curation: Album curation grouping on the Home hub, clickable album artists, and renamed Grid views ("Overview").
• Adaptive Player Bar: The player bar now hides automatically when nothing is playing, and the rating control moved next to repeat.
• Consistent Naming: Standardized "Song" over "Track" throughout the interface.

🐛 Stability & Bug Fixes

• Playlist Drag-and-Drop: Fixed track reordering races and disabled native window drag interference so HTML5 drag reordering works reliably.
• Lyrics Fetching: Synced lyrics are now prioritized over plain-text results when fetching online.
• Cover Art & Screenshot Tooling: Corrected cover art extraction, auto-detection of the local database, and mock-config overrides used by the docs screenshot harness.
• i18n Coverage: Closed remaining gaps where hardcoded strings bypassed translation.

Luminous v0.60.0

Luminous v0.60.0 contains exciting new features, design enhancements, and stability improvements since v0.50.0:

🌟 New Features

• Home Discovery & Personalized Curation Hub: A new landing dashboard featuring personalized curation queries, recently played tracks, and custom item sorting.
• Artist Detail View: A fully custom detail view for artists with a hero collage, discography, and playlist integrations, plus cover-flow style album art stacks on Artist cards.

🎨 Visual & Theme Customizations

• Dynamic Color Palette Generation: Analyzes cover artwork dynamically using a Median Cut algorithm and archetype scoring to extract dominant colors and apply them across the player interface.
• Floating Glass PlayDock: A modern, minimized floating music player deck with blur backdrops and theme-wide glassmorphism styling.
• System Auto-Theme Integration: Full support for light/dark mode syncing and matching brand accents.
• Logo Visualizer Improvements: Maps bass frequencies to the inner corona and treble to the outer ring for more responsive, dynamic SVG pulsing, with fixes to prevent glow clipping.

🐛 Stability & Bug Fixes

• Rapid Skip Protection: Prevents potential UI freeze when rapidly skipping tracks.
• Mock Data Updates: Upgraded screenshot utility mock data, cover arts, and sidebar states to ensure consistent presentation.

Luminous v0.50.0

Luminous v0.50.0 is a minor feature and stability update:

🌟 New Features

• File & Playlist Opening: Directly open supported audio files and M3U playlists using the new folder button in the search bar.
• Collapsible Sidebar: Implemented collapsible and snappable sidebar with a compact icon-only state for a cleaner layout.
• Improved Collection Sorting: Added header-based column sorting (including track numbers) and restored filter pills to all sub-tabs.
• Virtualized Tracks List: Enhanced CollectionView performance on large libraries via Svelte track list virtualization.

⚙️ Performance Benchmarks & Testing

• 100k Tracks Suite: Scaled the performance benchmark suite to support 100k tracks to stress-test collection rendering, and added Vitest timeout parameters.

🐛 Compatibility & Bug Fixes

• Linux WebKitGTK 2D Fallback: Fixed rendering issues and pointer event bugs on Linux by falling back to 2D fade transitions.
• Artist Fallback: Resolved issues displaying "Various Artists" when multiple tracks shared the same artist metadata.
• Icon Tweaks: Refined the application icon and brand logo SVG viewBox to align better with taskbar proportions.

Luminous v0.43.0

Luminous v0.43.0 introduces a major visual redesign, performance tuning, and tag metadata updates:

🌟 New Features & Redesign

• Three-Column Grid Shell: Fully redesigned the main user interface layout with a top navigation ribbon for a more modern appearance.
• Immersive Now Playing: Pivots to a full-screen immersive album artwork view when bottom panel is toggled, including a premium 3D card flip transition.
• Audio Visualizer Header Logo: Implemented multi-band pulsing mapped directly to Bass (glow), Mids (outer ring), and Treble (inner burst) frequencies.
• AcoustID Tag Lookups: Added automatic AcoustID metadata matching and fingerprint lookup, with error-handling, logger masking, and setup guidelines in the TagEditor UI.
• Global Keyboard Media Keys: Integrated global media keys support for play, pause, next, and previous.

🎨 Customization & Style Tweaks

• Theme Adjustments: Nordic Blue is now the default app theme when no preference is saved. Theme custom properties are fully reactive on initial load.
• Custom Volume Slider: Replaced default input range with a styled, theme-matching custom volume bar.

🐛 Stability & Backend Improvements

• ALSA Buffer Fix: Resolved Linux ALSA PCM underruns using a lock-free Single Producer Single Consumer (SPSC) ring buffer.
• Soft-Delete Mode: Preserves playlist metadata when referenced audio files are missing from the filesystem.
• Consolidated Albums: Properly groups "Various Artists" compilations.

Luminous v0.31.0

Luminous v0.31.0 is the initial tagged release of Luminous Music Player, bringing a beautiful, modern desktop interface to your music collection:

🌟 Core Features

• High-Performance Audio Playback Engine: Built on CPAL and rodio, providing cross-platform hardware-accelerated playback for MP3, FLAC, ALAC, and WAV files with seeking and volume controls.
• Asynchronous Metadata & Artwork Scanner: Scans folders for music tracks, parsing embedded ID3/Vorbis metadata and caching album artwork.
• Synced Karaoke-Style Lyrics: Automatically pulls, caches, and scrolls timestamped lyrics in sync with current audio playback.
• Interactive Playlist Organizer: Create custom music playlists with interactive drag-and-drop track reordering.
• Modern Responsive Svelte 5 / Tauri UI: Sleek layout featuring theme presets, custom styling, and responsive panels.

🛠️ Developer & CI/CD Tooling

• Cucumber BDD Tests: Automated behavior-driven tests for the Rust audio backend.
• Vitest Suite: Detailed unit testing for all reactive stores.
• Release Automation: Integrated custom bump-version and release scripting with GitHub Actions.