Major updates:
- Replace outdated 1.1.8 highlights with comprehensive feature list
- Add all 4 audio backends, loudness normalization, cache sizes
- Document immersive player with 14 visualization panels
- Add 26 themes, auto-theme, native KDE title bar
- Document multi-crate architecture and all 9 crates
- Add system dependencies per distro (Debian, Fedora, Arch)
- Update project structure to reflect current codebase
- Add 4-language i18n, custom artist images, recommendations
- Update tech stack table with all major dependencies
- Remove stale "Coming soon" screenshots placeholder
KWin scripting noBorder=false cannot override the xdg-decoration
protocol on Wayland. Window rules (kwinrulesrc) operate at a deeper
level and should force SSD before protocol negotiation. Uses
kwriteconfig6 to add/remove rules and qdbus6 to trigger reconfigure.
Now that the script is confirmed working (noBorder=false set on QBZ
window, resourceClass=qbz), remove the chatty per-window log lines
that would spam journalctl on every app launch.
The KWin D-Bus scripting API requires calling run() on the specific
script object (/Scripting/Script{id}) returned by loadScript(), not
start() on the /Scripting root. Also unloads previous script instance
before reloading, and adds 500ms delay to ensure window is mapped.
The KWin script checked for resourceClass === "qbz" but on Wayland,
KWin sets resourceClass from the xdg-toplevel app_id, which is the
full GTK application ID: "com.blitzfc.qbz" (from tauri.conf.json
identifier). Now matches all three possible values: com.blitzfc.qbz,
qbz, qbz-nix. Added diagnostic print() for journalctl debugging.
GTK3 hardcodes CLIENT_SIDE in the xdg-decoration Wayland protocol,
so GTK_CSD=0 alone doesn't work — KWin still sees CSD preference
and won't draw server-side decorations.
New approach for KDE Plasma + Wayland + system title bar:
1. Create window with decorations=false (no GTK CSD)
2. Load a KWin script via D-Bus that forces noBorder=false for QBZ
3. KWin draws its own native Breeze SSD title bar
This gives QBZ a title bar identical to Dolphin, Konsole, etc.
On non-KDE DEs, the old decorations(true) path is used unchanged.
Reverts the ineffective GTK_CSD=0 approach from previous commit.
Previously GTK_CSD=1 was set unconditionally on Wayland, forcing GTK to
draw its own client-side title bar (Breeze-GTK). On KDE Plasma this
looks wrong because native apps use KWin's server-side decorations
(Breeze-KDE).
Now reads the use_system_titlebar setting before GTK init:
- system title bar ON: GTK_CSD=0 (WM draws native decorations)
- system title bar OFF: GTK_CSD=1 (doesn't matter, decorations=false)
This makes QBZ's title bar match Dolphin, Konsole, etc. on KDE Plasma,
and Nautilus, etc. on GNOME — the window manager draws the decorations
in its own native style.
Replace the 5 static k-means palette previews with 8 labeled, editable
swatches showing the actual applied CSS variables: Base, Surface,
Elevated, Accent, Text, Muted, Border, Danger.
Each swatch opens a native color picker on click. Changes apply
instantly to the live theme and persist to localStorage.
Remove unused ThemePalette/PaletteColor types and k-means palette
extraction from the frontend store (no longer needed since swatches
are driven by the GeneratedTheme variables directly).
Instead of using wallpaper k-means + accent override (which produced
wrong backgrounds), the system source now reads ALL colors from the
DE config (kdeglobals for KDE, dconf hints for GNOME).
Maps Window/View/Button/Selection/Header sections directly to CSS
variables — bg-primary from Window, bg-secondary from View,
bg-tertiary from Button, accent from Selection, text from
ForegroundNormal, etc.
Adds SystemColorScheme type, get_system_color_scheme() in system.rs,
generate_theme_from_scheme() in generator.rs, and two new V2 commands:
v2_generate_theme_from_system_colors and v2_get_system_color_scheme.
Frontend tryAccentColorTheme() replaced with trySystemColorSchemeTheme()
which calls the new endpoint. Old color math helpers removed.
- V2 commands (generate_theme_from_image, generate_theme_from_wallpaper,
extract_palette) now use tokio::task::spawn_blocking to avoid freezing
the main thread during CPU-bound image decoding and k-means clustering.
This lets the UI spinner animate properly.
- KDE accent detection now falls back to Colors:Selection DecorationFocus
and BackgroundNormal from kdeglobals when no explicit AccentColor is set.
This reads the actual KDE color scheme accent instead of only looking
for the Plasma 6 custom accent field.
cc
Source options: System Colors (accent -> wallpaper fallback), Wallpaper
Sync, Custom Image. Selecting System shows fullscreen overlay while
generating. On failure: modal recommends another theme or custom image,
falls back to Dark immediately.
Store cascade logic: tryAccentColorTheme() first (with wallpaper
backgrounds + system accent override), then generateFromWallpaper(),
then throw for caller to handle.
cc
- autoThemeStore.ts: manages theme generation, CSS injection, and localStorage persistence
- Bootstrap: restoreAutoThemeVars() called before loadSavedTheme() to prevent FOUC
- data-theme="auto" prevents static CSS theme blocks from matching
- ~40 CSS variables injected at runtime via document.documentElement.style
cc
Six new commands:
- v2_detect_desktop_environment: detect current DE
- v2_get_system_wallpaper: get wallpaper path
- v2_get_system_accent_color: get DE accent color
- v2_generate_theme_from_image: generate theme from any image
- v2_generate_theme_from_wallpaper: generate theme from system wallpaper
- v2_extract_palette: extract color palette for preview
All are pure functions (no State needed), registered in invoke_handler.
cc
Rust module auto_theme/ with:
- K-means clustering (k=6) on downsampled images for palette extraction
- CSS variable generator producing all ~40 required theme tokens
- WCAG AA contrast enforcement for text and accent colors
- Desktop environment detection (GNOME, KDE Plasma, COSMIC, XFCE, Cinnamon)
- Wallpaper path retrieval per DE (gsettings, Plasma config, COSMIC config)
- System accent color retrieval (GNOME 47+, KDE, COSMIC)
cc
After setting/removing custom artist images in ArtistDetailView
or LocalLibraryView, update the global store so all views
reflect the change immediately. Also fix LocalLibraryView to use
the resized thumbnail path from the backend result instead of
the original unresized file path.
Add withCustomImages() helper that overrides artist image objects
before passing to groupArtists(). All 3 call sites (alpha index,
sidepanel, virtualized grid) get custom image overrides.
Wrap getArtistImage() to check custom image store before
falling back to Qobuz default. All 3 call sites (most popular,
search results, virtual grid) get the override automatically.
Centralized store for resolving custom artist image overrides
globally. Loaded on login, exposes resolveArtistImage() with
normalized name matching (handles diacritics, case differences).
Add get_all_custom_artist_images() database method and
v2_library_get_all_custom_artist_images command to support
loading all custom artist image overrides at once for the
global resolution store.
Remove header-content wrapper so h1 and action buttons are direct
flex children of .header, placing them inline on the same row.
Remove orphaned CSS and margin-top from header-actions.
Strip the customizable icon from the Favorites header (now always a
Heart icon) and remove icon/background customization sections from the
edit modal. The modal now only handles tab order reordering. Removed
dead code: resolveCustomIconSrc, customIconSrc, unused lucide imports
(Star, Folder, Library, Heart), convertFileSrc import, header-icon CSS.
Add a Move icon button inside the expandable window controls group
in ImmersiveHeader. On mousedown it calls window.startDragging() to
let the user reposition the window. Cursor shows grab/grabbing.
Only available when the controls are expanded (hover), so collapsed
state has no drag zone as intended.
Grey out shuffle, previous, play/pause, next, repeat, add-to-playlist,
and favorite buttons when no track is loaded and queue is empty.
Volume/mute controls remain always active.
Closes#103
- Auto-detect installed .desktop filename (com.blitzfc.qbz.desktop,
qbz.desktop, qbz-nix.desktop) instead of hardcoding
- Run update-desktop-database after register/deregister so xdg-open
and browsers pick up the MIME association immediately
- Fix v2_check_qobuzapp_handler to match all known desktop filenames
- Align StartupWMClass to com.blitzfc.qbz across all packaging formats
- Add StartupNotify=true to Arch/AUR/Snap desktop files
Fixes browser URI handler not working for .deb users (Discussion #44)
vicrodh