Joren/qbz
1
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
6c8f4298d6c0cceadf32a4df13f13d0294565fff
qbz/ROADMAP.md
T

5.5 KiB
Raw Blame History

QBZ Launch Roadmap

Last updated: 2026-01-12

Overview

6-point roadmap for QBZ v1.0 launch - a native Qobuz client for Linux.

1. Session Persistence

Status: Completed

Description: Remember playback state, queue, and position when restarting the app.

Implemented Features:

  • SQLite-based session storage (~/.local/share/qbz-nix/session.db)
  • Position saved every 5 seconds during playback (debounced)
  • Full session save every 30 seconds during playback
  • Immediate save on pause
  • Volume changes persisted immediately
  • Shuffle/repeat mode changes persisted immediately
  • Queue and current track restored on login
  • Playback position restored accurately

Fixed Issues (2026-01-12):

  • Fixed race condition in beforeunload (async save might not complete)
  • Enabled debouncedSavePosition() which was imported but never called
  • Added periodic full session save during playback
  • Position now saved frequently enough that app crash loses max 5-30 seconds

2. Device Select / Passthrough / Exclusivity Wiring

Status: Completed

Description: Full audio device management with exclusive mode and DAC passthrough.

Implemented Features:

  • Device selection from PipeWire sinks
  • Pretty device names from PipeWire descriptions
  • Exclusive mode toggle
  • DAC passthrough for external devices
  • Proper device release when disabling exclusive mode
  • Audio device reinitialization (ReinitDevice command)
  • AudioOutputBadges showing DAC/EXC status
  • Volume display in device tooltip

3. Tray Icon

Status: Not Started

Description: System tray icon with playback controls and quick actions.

TODO:

  • Add system tray icon
  • Play/Pause from tray
  • Next/Previous track
  • Show current track info
  • Quick access to settings
  • Minimize to tray option

4. MiniPlayer

Status: Not Started

Description: Compact floating player window for minimal screen usage.

TODO:

  • Design compact player UI
  • Implement floating window mode
  • Essential controls (play/pause, next/prev, seek)
  • Album art display
  • Always-on-top option
  • Toggle between full and mini mode

5. DLNA and AirCast Integration

Status: Partial (ChromeCast only)

Description: Stream to network devices via DLNA, AirPlay, and ChromeCast.

Current State:

  • ChromeCast streaming works
  • DLNA not implemented
  • AirPlay (AirCast) not implemented

TODO:

  • DLNA device discovery
  • DLNA streaming implementation
  • AirPlay/AirCast support
  • Device selector in UI
  • Handle network device disconnection gracefully

6. Playlist Management

Status: Completed

Description: Full playlist management with CRUD, statistics, and enhanced UI.

Implemented Features:

Import (100% complete):

  • Import from Spotify, Apple Music, Tidal, Deezer
  • Track matching via ISRC + fuzzy matching algorithm
  • Progress log UI during import
  • Auto-create Qobuz playlist with matched tracks
  • Rate limiting and API chunk size handling

Database & Backend (100% complete):

  • playlist_settings table with custom_artwork_path, sort_by, sort_order, hidden, position
  • playlist_stats table with play_count, last_played_at
  • Backend commands: playlist_get_settings, playlist_set_artwork, playlist_get_stats, etc.
  • get_playlist_suggestions command for ML-based track suggestions

UI Components (100% complete):

  • PlaylistCollage component (2x2 grid layout)
  • Custom artwork selection per playlist
  • Sort menu in sidebar (dropdown with submenu)
  • PlaylistDetailView with collage header
  • Stats display (play count)
  • Filter dropdown (All/Visible/Hidden) in PlaylistManagerView
  • Drag-to-reorder playlists in PlaylistManagerView
  • Grid view toggle (list vs mosaic) in PlaylistManagerView
  • PlaylistEditModal (PlaylistModal handles edit name/description/visibility/delete)

ML Suggestions (Removed):

  • Removed due to lack of similarity algorithm (suggested unrelated tracks)

Recent Fixes (This Session):

  • Fixed custom artwork not loading (asset:// URL conversion)
  • Fixed settings state persisting between playlists
  • Fixed sort submenu closing too fast
  • Fixed z-index for all menus/tooltips (10000+)
  • Added hi-res logo variants (grayscale version in use)

Additional Completed Features

UI/UX:

  • Enhanced notifications with album artwork
  • Quality info in notifications (Hi-Res / CD Quality badges)
  • 3-line notification format (Title, Artist • Album, Quality)
  • Window drag region fix for TitleBar
  • Hi-res logo variants (gold, gray, blue, mono SVGs)
  • Sidebar tooltip system with lazy loading
  • Fixed scrollbar spacing in main content

Performance:

  • Removed unnecessary PipeWire polling (was every 10s)
  • Artwork caching with MD5 hash filenames

Technical Notes

  • Stack: Tauri 2.0, Rust backend, Svelte 5 (runes) frontend
  • Audio: rodio/cpal with PipeWire/ALSA integration
  • Commands: pactl list sinks for PipeWire device info
  • Notifications: notify_rust with reqwest::blocking for artwork download
  • Icons: Hi-res logo at /static/hi-res-gray.svg (grayscale version)

Priority Order for Remaining Work

  1. Session Persistence debugging - Critical for UX
  2. Tray Icon - Expected feature for music apps
  3. MiniPlayer - Nice to have
  4. DLNA/AirPlay - Lower priority
Reference in new issue View Git Blame Copy Permalink