Offline Playback
Everything that lets QBZ keep playing music when the network is gone or you want to insist on local content lives in Settings > Offline Playback.
| Control | Effect |
|---|---|
| Status (Online / Offline) | Shows what QBZ thinks of network reachability right now. |
| Check now | Forces an immediate connectivity probe instead of waiting for the next 30-second poll. |
| Enable Offline Mode | Pretends you have no network even when you do. Useful for testing or when you want to lock the app to local + cached content. |
| Offline Tracks | Live counter of cached tracks and total bytes on disk. |
| Show in Local Library | Surfaces cached Qobuz tracks alongside your own files in the Local Library view. |
| Repair Offline Cache | Re-marks tracks whose offline status was lost during a library scan. |
| Clear All | Wipes every cached track at once after confirmation. Frees all space. |
| Manage offline cache | Opens the Offline Cache Management view for per-artist, per-album, and per-track control. |
| Fetch Qobuz™ Artist Images | Pulls artist photos from Qobuz so they appear in the Local Library view next to local files. |
QBZ polls reachability every 30 seconds in the background. The status row shows the current verdict, and Check now runs the probe immediately when you don't want to wait — useful right after re-connecting to Wi-Fi or VPN. The same indicator is mirrored in the player bar; clicking that yellow icon does the same thing.
See Offline Mode for the full degraded-service indicator and reconnection behavior.
A manual override that puts QBZ into offline mode regardless of real connectivity. Cached tracks remain playable; Qobuz-side features (search, browse, favorites sync) become unavailable until you turn it back off. This is the same state QBZ enters automatically when the network drops, but on demand.
A live readout of the offline cache: number of tracks and total bytes consumed. The detailed disclaimer underneath spells out the legal posture: the cache is a temporary playback aid bound to your active Qobuz subscription, and QBZ removes it after 30 days if the subscription becomes invalid. The same policy applies to the official Qobuz clients.
Opt-in. When enabled, every Qobuz track you've marked offline appears in the Local Library view next to the files you own. The cached tracks remain encrypted on disk and play through QBZ as usual — they don't become exportable files. This bridges the two libraries visually for users who want one combined place to browse.
Disabled by default so the Local Library stays purely "files I own" for users who prefer that separation.
Sometimes a Local Library scan can lose track of which Qobuz tracks were marked offline (the file is still there, the marker isn't). Click Repair to re-link them. Safe to run any time; it only re-marks existing files, never fetches anything from the network.
Deletes every cached track in one go. Asks for confirmation first. Use it to start fresh or to recover disk space without picking through the Offline Cache Management view album by album.
Opens the dedicated cache manager — see Offline Cache Management for the full feature set (per-album re-download, per-track removal, size limit modal, failed-download recovery).
Pulls artist photos from Qobuz when QBZ encounters an artist that doesn't have a local image. Affects the Local Library view's artist tiles. Independent from the audio cache — only image data, fetched lazily.
- Offline Mode — connectivity-loss handling, the L1/L2 playback prefetch cache, offline scrobbling, degraded-service indicator.
- Offline Cache Management — the in-app cache manager view: per-artist alpha-index, per-album/per-track actions, storage limit, failed-download recovery.
- Audio Configuration — bit-perfect, DAC passthrough, and the backends that play cached audio.
- Local Library — your own files. The "Show in Local Library" toggle on this page is what bridges to that view.