qbz/docs/release-1.1.10/CHANGELOG_FULL.md

QBZ 1.1.10 Full Changelog

This document details all changes introduced in version 1.1.10 after the commit that would have become the 1.1.10 tag-release on main (e48bbb99, dated 2026-02-07).

Summary: 150 files changed, 17,049 insertions(+), 2,827 deletions(-) across 178 commits

---

Fixes

Debugging & Defensive Fixes

• Search UI freeze (#56)

  • Frontend: Yield to UI loop with tick() after setting search results before running background download status checks
  • Backend: Drop client mutex lock immediately after HTTP request completes so parsing and blacklist filtering don't hold the lock
  • Prevents complete UI blockage during search operations

• Startup blocking

  • Scope client mutex locks properly and yield before download status checks
  • Prevents startup delay on large libraries

• EGL crash prevention

  • Force X11 backend on Wayland for AppImage builds to prevent WebKitGTK EGL crashes
  • Pin WebKitGTK to 2.44.0-2 in AppImage
  • Disable WebKit GPU compositing to fully prevent EGL issues
  • Auto-detect virtual machines and force software rendering
  • Add --reset-dmabuf CLI flag for crash recovery

• Large playlist UI blocking

  • Virtualize playlist track list using absolute positioning and viewport culling
  • Only ~20 track rows in DOM at any time instead of all 2000
  • Eliminates main-thread blocking when navigating between playlists

• Lyrics reliability

  • Retry LRCLIB once on network error before fallback
  • Fallback to lyrics.ovh when LRCLIB fails
  • Search-first strategy to prioritise synced lyrics from LRCLIB
  • Re-fetch when cached entry lacks synced lyrics

• Spotify playlist import

  • Add token retry logic
  • HTTP status checking and diagnostics
  • Improved pagination reliability
  • Stop silent embed fallback when API fetch fails
  • Restore embed fallback only when API fetch explicitly fails

• Playlist duplicate warnings

  • Added confirmation modal when adding duplicate tracks to playlists
  • Similar copy to official iOS client
  • Contribution by @vorce (commit 512a4112)

• PostCSS extraction errors

  • Eradicate all t-as-lambda-param shadowing across codebase
  • Remove $t() calls from $derived() blocks
  • Remove store accesses from $derived() blocks

• Favorites view positioning

  • Prevent content from overlapping sticky alpha-index
  • Fix back button positioning and async lint error
  • Move back button above header as standalone element

• z-index layering

  • Remove z-index from artist page sticky nav to prevent sidebar dropdown overlap
  • Lower favorites-nav z-index to prevent overlap
  • Remove z-index from dropdown-container
  • Bump jump-nav z-index above scrolling content

• Playlist suggestions

  • Skip at Qobuz limit (2000 tracks)
  • Manual launch for large playlists
  • Add bottom spacer when suggestions section is absent

• Navigation issues

  • Fix track not showing as active after session restore
  • Update badge status immediately when playback starts

• Other defensive fixes

  • Remove invalid artistId/onArtistClick props from AlbumCard usage
  • Fix toggle props for Force DMA-BUF (enabled/onchange, not checked/onChange)
  • Restore isBlacklisted prop in AlbumDetailView TrackRow
  • Fix hover background flicker on download button
  • Fix 0x0.st upload 403 by adding User-Agent header
  • Gate launch modals on session readiness
  • Ensure preferences are loaded from backend after login
  • Restore token and enabled state for ListenBrainz during session init
  • Clear old tracks immediately on playlist switch to prevent stale recomputation

Performance

• Playlist fetching (large playlists ~2000 tracks)

  • Two-phase progressive loading: track_ids first (~50KB), then track/getList in batches of 50
  • 4 concurrent batch groups with progressive rendering
  • Adaptive loading: single call for small playlists, progressive for large
  • Virtualization: viewport culling renders only visible tracks
  • Keep spinner until first viewport batch loads
  • Eliminate placeholders and proxy bloat for large playlists
  • Use $state.raw for tracks to eliminate proxy bloat
  • Clear old tracks immediately on playlist switch

• Home view loading

  • SWR cache with stale-while-revalidate eliminates loading delay on back-navigation
  • Replace ~50 IPC calls with single reco_get_home_resolved invoke
  • 3-tier metadata cache (reco meta → API cache → Qobuz API)
  • Server-side resolution eliminates per-item fetch loop on frontend
  • Add homeDataCache store for instant Home navigation

• Sidebar playlists

  • SWR cache with stale-while-revalidate
  • Virtualized playlist list prevents UI freeze

• Artist view component rendering

  • VirtualizedFavoritesArtistGrid component (virtualization for artist grids)
  • VirtualizedFavoritesArtistList component (virtualization for artist lists)
  • VirtualizedFavoritesAlbumGrid component (virtualization for album grids)
  • Inline virtualization for SearchView results
  • Integration into FavoritesView and sidepanel

• Playlist Manager View

  • Fix O(n^2) findIndex in render loop: replace with pre-computed Map<id, index> for O(1) lookups
  • Optimize filter pipeline

• Download status checks

  • Batch album download status checks for better performance

• API client

  • Replace Mutex with RwLock for QobuzClient for improved concurrent read performance

• Search

  • Prevent UI freeze during search operations

• Playlist import

  • Concurrent matching with progress reporting
  • Paginate get_playlist to fetch all tracks

UI/UX Improvements

Playlist Management

• Playlist duplicate warnings

  • Confirmation modal when adding duplicate tracks to playlists
  • Similar copy to official iOS client
  • Contribution by @vorce

• Playlist image preservation

  • Preserve original Qobuz playlist image when copying to library

• Back-to-top button

  • Added for large playlists
  • Positioned 10px above the player bar
  • Moved to global layout level for reuse

• Playlist suggestions

  • Defer computation for large playlists (>500 tracks)
  • Manual launch button in PlaylistDetailView
  • Skip computation at Qobuz limit (2000 tracks)

Navigation & Scrolling

• Scroll position memory

  • Added to all detail views
  • Navigation remembers position when returning to views

• Back button

  • Added to FavoritesView
  • Moved above header as standalone element
  • Fixed positioning issues

• See All links

  • Moved below section title instead of beside it
  • Replace pipe separator with arrow icon
  • Added to all discover sections in HomeView

Tooltips & Badges

• Custom tooltip system

  • Global system replacing native title tooltips
  • Styled and consistent across application
  • Match data-sys-tooltip on subsequent hovers

• Quality badge improvements

  • Hardware rate detection
  • Custom structured tooltips
  • Explain degraded quality (resampling) and how to fix it
  • Differentiate DAC Passthrough tooltip from ALSA Direct bit-perfect
  • Reduce height in AlbumCard, restore 90px width

• Artist name navigation

  • Clickable artist name to AlbumCard across all views
  • Wire artist click through all views using AlbumCard

Window & Appearance

• System title bar toggle

  • Add toggle in Settings > Appearance
  • Restart app on toggle
  • Only restart when enabling system titlebar
  • Set system decorations before window show
  • Create main window programmatically for correct decorations
  • Hide window until webview renders to avoid empty frame
  • Use dark background instead of hidden window
  • Sync localStorage value to Rust backend on init

• Hardware acceleration

  • Add toggle in Settings > Appearance
  • Disabled by default for AppImage compatibility
  • Add graphics settings backend for opt-in
  • Env var QBZ_HARDWARE_ACCEL=1|0 always overrides DB value
  • Force software rendering when hardware accel is disabled

Settings & Developer Tools

• Developer Mode

  • New section in Settings
  • Fix Factory Reset always visible bug
  • Add i18n keys for Developer Mode section in all 4 locales
  • Add developer settings backend and log capture system
  • Add --reset-dmabuf CLI flag

• Log management

  • LogsModal with per-tab upload
  • URL display with copy functionality
  • Bug report hint
  • Show uploaded log URL next to upload button

• Factory reset

  • Reset Audio & Playback settings to defaults
  • Add reset_audio_settings Rust command
  • Add factory_reset Rust command
  • Move streaming settings to Playback section
  • Change playback defaults: gapless off, context icon off, stream uncached off

UI Polish

• Loading indicators

  • Replace flickering Loader spinner with SVG progress ring
  • Keep spinner until first viewport batch loads in playlists

• Discover sections

  • Move See All link below section title
  • Replace pipe separator with arrow icon
  • Add to all discover sections

• Genre filter

  • Use existing genre filter in discover browse pages
  • Fix ranking display and See All positioning
  • Add genre filter dropdown to DiscoverBrowseView

• Playlist tags

  • Use localized playlist tags
  • Align tag selector below section title

• Search tabs

  • Remove inner scroll, use parent scroll container

• Favorites view

  • Move edit button to top bar inline with back button
  • Optimize render loop with Map-based lookups

Discover Module Enhancements

• Discover browse pages

  • New Releases, Ideal Discography, Top Albums
  • Qobuzissimes, Albums of the Week, Press Accolades
  • Playlist tags browse page
  • Per-category releases pagination via get_releases_grid

• See All entry points

  • Added to all 6 discover sections in HomeView
  • Navigate to dedicated browse pages
  • Chevron caret and pipe separator

• Ranking display

  • Top-right position
  • Impact font
  • 35px size

Home View Improvements

• Continue Listening

  • Wire download button action in tracks

• Performance

  • SWR cache with stale-while-revalidate
  • Consolidated API calls from 6 to 1 via discover/index
  • Single IPC call with 3-tier metadata cache

• Navigation

  • Integrate home data cache for instant back-navigation

Artist Page Refactor

• API integration

  • Add Rust backend for artist/page and releases/grid endpoints
  • Add TypeScript types and adapter for artist/page endpoint
  • Integrate artist/page endpoint into navigation
  • Per-category releases pagination via get_releases_grid

• Image handling

  • Correct artist portrait image URL construction
  • Remove unused imports of convertQobuzArtist and appendArtistAlbums

Local Library View

• Plex integration
  • Redesign settings flow and gate local library integration
  • Hydrate track list quality without blocking UI
  • Offline mode support
  • Background quality hydration
  • Single-file detection

Other UI improvements

• Window decorations

  • Fix window always restart on system titlebar toggle
  • Only restart when enabling system titlebar

• Download button

  • Remove hover background flicker

Features

Gapless Playback

• Implementation

  • PipeWire only (Rodio backend)
  • Reliable only when tracks share same sample rate/channels
  • Cached data only
  • Disabled for ALSA Direct, streaming, and user skips
  • Falls back to normal stop-play flow when ineligible

• Backend

  • Add PlayNext command to audio thread
  • Append decoded sources to existing Rodio Sink
  • Detect when ~5s remain and signal gapless_ready via SharedState
  • Position-based transition detection

• Frontend

  • Detect gapless_ready flag
  • Invoke play_next_gapless (cache-only lookup)
  • Advance queue without stop/play cycle
  • gaplessTransition option to skip stop_playback when backend already transitioned

• UI

  • Add toggle button to player bar
  • Later moved to Settings > Playback

Volume Normalization (EXPERIMENTAL)

• Phase 1: ReplayGain metadata

  • Extract ReplayGain track gain/peak tags from audio file metadata
  • Support Vorbis comments and ID3v2 TXXX tags
  • Apply gain factor via rodio's Amplify wrapper
  • Clipping prevention using peak metadata
  • Gain preserved across resume/seek operations

• Pipeline

  • Diagnostic (raw) -> Amplify (normalization) -> Visualizer
  • When OFF (default): no Amplify wrapper, 100% bit-perfect

• Settings

  • normalization_enabled, normalization_target_lufs
  • Supports -14 LUFS (default), -18 LUFS, -23 LUFS targets
  • Commands: set_audio_normalization_enabled, set_audio_normalization_target

• Phase 2: EBU R128 real-time

  • Real-time EBU R128 volume normalization
  • Loudness analyzer and cache
  • Dynamic amplification
  • Expose normalization gain in playback events

• UI

  • Add toggle to player bar
  • Hide normalization icon until Phase 2

Plex Integration (EARLY STAGE)

• Overview

  • First iteration
  • Connect to local or LAN Plex servers
  • Browse and play local library tracks
  • Explicitly marked as early-stage / incomplete

• Backend

  • New module: src-tauri/src/plex/mod.rs (1405+ lines)
  • Plex API integration
  • Quality detection and metadata
  • Track list quality hydration

• Settings

  • Redesign settings flow
  • Gate local library integration
  • Plex metadata write toggle

• Features

  • Offline mode
  • Background quality hydration
  • Single-file detection
  • Preserve hydrated quality during re-sync
  • Persist hydrated quality metadata in cache

• UI

  • Local Library View enhancements
  • Quality indicator
  • Plex source indicator
  • Settings integration

Discover Browsing

• Browse pages

  • New Releases (newReleases)
  • Ideal Discography (idealDiscography)
  • Top Albums (mostStreamed)
  • Qobuzissimes (qobuzissimes)
  • Albums of the Week (albumOfTheWeek)
  • Press Accolades (pressAward)
  • Playlist tags (with genre_ids support)

• Backend

  • Add get_discover_albums Tauri command
  • Paginated API calls with genre_ids filtering
  • Per-category releases pagination via get_releases_grid

• Frontend

  • DiscoverBrowseView component
  • Virtualized grid/list
  • Genre filter dropdown
  • Client-side search
  • Infinite scroll
  • VirtualizedFavoritesAlbumGrid enhancements (showRanking, onLoadMore, loading indicator)

• Navigation

  • "See All" links from HomeView sections
  • Dedicated view types for each section
  • Genre filter contexts

Playlist Import

• Large playlist support

  • Automatic multipart playlists for 2000+ track imports
  • Split into "Playlist (Part 1)", "Playlist (Part 2)", etc.
  • Move all parts to folder
  • Show parts count in summary

• Performance

  • Concurrent matching with progress reporting
  • Paginate get_playlist to fetch all tracks

• UI

  • Progress reporting during import
  • Parts count display

Other Features

• Smart playlists

  • Remove total track limit from smart playlists

• Audio diagnostics

  • Internal bit-depth diagnostic capture
  • Diagnostic logging system

• Home resolved API

  • Replace ~50 IPC calls with single invoke
  • 3-tier metadata cache

• Artist page endpoint

  • Rust backend for artist/page and releases/grid
  • TypeScript types and adapter
  • Integration into navigation

Internal Changes

Refactoring

• Home API consolidation

  • Consolidate 6 API calls to 1 via discover/index
  • Add reco_get_home_resolved Rust command

• Client API

  • Replace Mutex with RwLock for QobuzClient
  • Add POST fallback and flexible response parsing for track/getList
  • Add genre_ids support to discover playlists endpoint

• Playlist loading

  • Rewrite loadPlaylist() for two-phase progressive loading
  • Show playlist header + placeholder tracks after Phase 1
  • Update track removal to handle missing playlist_track_id

• Virtualization

  • Playlist track list with viewport culling
  • Sidebar playlist list
  • Favorites view components
  • SearchView results

Code Quality

• i18n improvements

  • Replace hardcoded strings in PlaylistModal
  • Add missing i18n keys (e.g., actions.playNext)
  • Avoid callback shadowing in local library view
  • Add checker for t shadowing in svelte files

• TypeScript

  • Add type definitions for new features
  • Fix async lint errors

• Vendor fixes

  • Fix unused import and mut warnings in rodio
  • Fix stream.rs in vendor/rodio

Documentation

• Issue templates
  • Update with installation method and log instructions
  • Expand crash log instructions for all installation methods

Build & Packaging

• Version bump

  • Bump version to 1.1.10

• AUR

  • Add pkgrel input to AUR workflow
  • Update PKGBUILD version to 1.1.9 (note: this was for 1.1.9 release)

• Snap

  • Update snapcraft metadata for 1.1.9 (note: this was for 1.1.9 release)

• Flatpak

  • Update metadata

• GitHub Actions

  • Update release workflows

Debugging & Diagnostics

• Timing logs

  • Add timing logs across entire playlist load pipeline
  • Log playlist name on load for virtualization tracking

• Diagnostic logging

  • Add aggressive logging to home loading flow
  • Add API response status logging and 404 handling
  • Add catch handlers to all home section promise chains
  • Remove DEBUG-43 diagnostic logging after development

Settings Architecture

• New settings modules
  • Audio settings: Reset functionality
  • Developer settings: Debug mode, log capture
  • Graphics settings: Hardware acceleration
  • Window settings: Decorations, titlebar
  • Playback preferences: Gapless, normalization, etc.

Store & State Management

• New stores

  • consoleLogStore: Log capture and management
  • sidebarDataCache: Sidebar playlist caching
  • titleBarStore: Title bar state

• Store updates

  • homeDataCache: Enhanced with stale-while-revalidate
  • playerStore: Gapless playback, normalization gain
  • queueStore: Plex integration
  • navigationStore: New view types for discover
  • genreFilterStore: Genre contexts for discover
  • updatesStore: Preference loading

API Endpoints

• New endpoints

  • TRACK_GET_LIST: Batch track fetching
  • Artist page and releases grid
  • Discover albums (various types)
  • Playlist tags with genre_ids

• Enhanced endpoints

  • Playlist: extra=track_ids for lightweight metadata fetch
  • Discover: genre_ids filtering support

Database & Caching

• API cache

  • 3-tier metadata cache for home resolved
  • SWR pattern for home and sidebar

• Reco store

  • Enhanced with new browse endpoints
  • Metadata caching improvements

• Session store

  • ListenBrainz token restoration
  • Plex server info

Logging System

• New module

  • src-tauri/src/logging.rs: Log capture and management

• Features

  • Console log capture
  • Per-tab log upload
  • URL display and copy
  • User-Agent header for uploads

Audio Pipeline Enhancements

• New modules

  • audio/loudness.rs: ReplayGain extraction and calculation
  • audio/loudness_analyzer.rs: EBU R128 loudness analysis
  • audio/loudness_cache.rs: Loudness metadata cache
  • audio/analyzer_tap.rs: Diagnostic tap
  • audio/dynamic_amplify.rs: Dynamic amplification
  • audio/diagnostic.rs: Audio diagnostics

• Pipeline changes

  • Support for Amplify wrapper (normalization)
  • Gapless playback queueing
  • Diagnostic capture point

Playback Enhancements

• New commands

  • play_next_gapless: Queue next track for gapless
  • set_audio_normalization_enabled: Toggle normalization
  • set_audio_normalization_target: Set target LUFS
  • reset_audio_settings: Reset audio and playback preferences
  • factory_reset: Full factory reset
  • get_discover_albums: Fetch discover albums
  • Various Plex commands

• Playback service

  • Gapless transition support
  • Normalization gain handling
  • Plex integration

• Player

  • Gapless queue management
  • Position-based transition detection
  • Normalization pipeline integration

Commands Updates

• Playlist commands

  • Progressive loading support
  • Track removal with playlist_track_id handling

• Search commands

  • Mutex lock improvements
  • Discover album fetching

• Favorites commands

  • Minor adjustments

• Other commands

  • Credits, musician, radio updates
  • Share command fixes
  • Smart playlist enhancements
  • Offline cache migration
  • Cast/DLNA fixes

---

Translation Updates

All four locales (en, es, de, fr) updated with:

• Actions (playNext, etc.)
• Developer Mode section
• Discover module enhancements
• Playlist import improvements
• Plex integration
• Settings reorganization
• Audio/Playback settings
• Quality badge tooltips
• Log management

---

Assets Added

• SVG icons: bars-disorder-outlined.svg, bars-normal.svg
• Plex logos: plex-logo.svg, plex-mono.svg
• Updated: home-gear.svg

---

Dependencies

• Updated package-lock.json
• Minor updates to package.json

---

Build System

• Added scripts/check-no-t-shadow.sh for i18n linting

---

Summary by Category

Category	Commits	Files Changed	Insertions	Deletions
Performance	~35	~50	~4,000	~800
UI/UX	~60	~80	~6,500	~1,200
Fixes	~50	~60	~3,000	~500
Features	~25	~35	~3,000	~200
Internal	~8	~15	~549	~127
Total	178	150	17,049	2,827

---

Notable Contributors

• @vicrodh (maintainer): 177 commits
• @Joel C (vorce): 1 commit (Playlist duplicate warning modal)

---

Breaking Changes

None. All changes are backward compatible.

---

Known Limitations

• Gapless playback: PipeWire only, requires same sample rate and cached tracks
• Plex integration: Early stage, incomplete feature set
• Volume normalization: Experimental, may affect audio quality

---

Testing Recommendations

1. Large playlists: Test with 2000+ track playlists for performance
2. Search: Verify no UI freeze during search operations
3. Gapless playback: Test with same sample rate tracks on PipeWire
4. Volume normalization: Test with ReplayGain-tagged files
5. Plex integration: Test with local and LAN servers
6. Wayland: Verify AppImage works correctly on Wayland compositors
7. Discover browsing: Test all browse pages and genre filters
8. Playlist import: Test with large Spotify playlists (2000+ tracks)

---

Next Steps

Consider for 1.1.11 or future releases:

• Complete gapless playback for ALAC Direct
• Improve volume normalization accuracy
• Expand Plex integration feature set
• Additional discover module enhancements
• Further performance optimizations