Support¶

Contact¶

Questions, bugs, suggestions? Write to:

support@priet.us

We answer as soon as we can.

Frequently asked questions¶

What does "bit-perfect" mean in Zplayer?¶

Bit-perfect playback means the bits leaving your iPhone or iPad to your DAC are identical to the bits stored in the file. Zplayer plays FLAC, ALAC, WAV and DSD (DSF/DFF) at their native sample rate and bit depth, with no resampling and no system-level mixing applied to the audio path. The "bit-perfect" badge in the now-playing screen turns on when the connected DAC reports a sample rate that matches the file.

Tap the badge to see the full audio path: file format, output sample rate, bit depth, and route.

Does Zplayer support DSD?¶

Yes. DSF and DFF files play through AVAudioEngine with a custom decimator that converts DSD to high-resolution PCM (176.4 kHz / 24-bit for DSD64, 352.8 kHz / 24-bit for DSD128). The conversion uses a 128-tap windowed-sinc lowpass filter to keep DSD's noise shaping out of the audible band.

True hardware DSD (DoP) is not supported on iOS — Apple does not expose the necessary APIs.

What WebDAV servers work with Zplayer?¶

Anything that speaks WebDAV: Synology, QNAP, Nextcloud, ownCloud, a plain Apache or nginx with mod_dav, a self-hosted server… The app uses standard HTTP verbs (PROPFIND, GET, MOVE, DELETE, PUT) and HTTP Range requests for fast tag reading.

Why is the first scan slow?¶

On first launch the app walks every folder on your WebDAV share, downloads the first 256 KB of each FLAC (to read Vorbis Comments) and the last few KB of each DSF/DFF (to read ID3v2 tags). This builds a local cache. Subsequent launches read from the cache and are instant. You can re-run the scan from Settings → Refresh library.

How does iCloud sync work between my iPhone and iPad?¶

If both devices are signed in to the same Apple ID with iCloud enabled, the app syncs:

Favorites, play counts, ratings, last-played timestamps (via CloudKit private database).
The playback queue handoff between devices.
WebDAV credentials and API keys (via iCloud Keychain).

Music files themselves are not synced — they live on your WebDAV server. Each device builds its own library cache from the same source.

If sync seems stuck, open Settings → iCloud Sync and tap Refresh. The diagnostic panel shows whether your iCloud account is reachable and how many records have been written.

I added cover art to a folder but the app shows the embedded one. Why?¶

The app first uses the embedded cover stored inside the audio file. If you place additional images in a sibling folder named Art, Artwork, Scans, Cover or Covers (case-insensitive), they appear as a swipeable carousel on the album page. For multi-disc sets where tracks live in Disc 1/Disc 2/ subfolders, the app also looks one level up for that artwork folder.

How do I download missing cover art?¶

Two options:

Bulk: Settings → Download covers. The app walks every album without a cached cover and tries Last.fm, Discogs and the Cover Art Archive in order. Configure API keys in Settings to enable Last.fm and Discogs.
One album at a time: double-tap the placeholder cover on any album page.

Can I use Zplayer without an internet connection?¶

Yes — once your library is cached, you can browse it offline. Playback requires reaching your WebDAV server, so if your library is on a NAS in your home network, your device must be on that network or reachable via VPN. Cover-art downloads, MusicBrainz metadata and Wikipedia summaries require internet.

What permissions does the app need?¶

Local network — to connect to a WebDAV server on your home network.

Nothing else. No camera, microphone, photos, location, contacts, calendar, Health or notifications.

Apple Watch?¶

Now Playing controls (play/pause, skip, scrub) appear on Apple Watch automatically once you start playing on iPhone. There is no separate watchOS app to install.

Which devices does Zplayer run on?¶

iPhone and iPad with iOS 17 or later. The app is universal — same binary, layouts adapted for each form factor.

Reporting a problem¶

When writing in, please include if you can:

Device model and iOS version.
Zplayer version (Settings → About).
The file format and sample rate of the track involved (if it is a playback issue).
What you expected and what happened instead.
A screenshot if it helps illustrate the problem.