qbz/ROADMAP.md

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: Completed

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

Implemented Features:

• System tray icon with app icon
• Play/Pause from tray menu
• Next/Previous track from tray menu
• Show/Hide window toggle
• Left-click toggles window visibility
• Double-click shows and focuses window
• Right-click shows context menu
• Quit option in tray menu

Not Implemented (optional):

• Dynamic tooltip with current track info
• Quick access to settings
• Minimize to tray on window close (currently just hides)

---

4. MiniPlayer

Status: Completed

Description: Compact floating player window for minimal screen usage.

Implemented Features:

• Compact 340x90 floating window
• Draggable (no decorations)
• Always-on-top toggle (pin button)
• Play/Pause, Next/Previous controls
• Album art, track title, artist display
• Progress bar
• State sync from main window via events
• Toggle via NowPlayingBar button (PictureInPicture icon)

Technical:

• Route: /miniplayer
• Service: src/lib/services/miniplayerService.ts
• Uses Tauri WebviewWindow for secondary window
• Events: miniplayer:track, miniplayer:playback

---

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