Help & Support

Nyquist Support

Everything you need to get Nyquist set up and playing your library correctly. If you can't find an answer below, get in touch — replies usually come within a couple of business days.

Questions, bug reports, or feature requests? Reach José Garfias López directly at:

[email protected]

Getting started

Nyquist starts empty — you point it at the music you already own.

  • macOS: use Add Folder to grant access to any folder of audio files. Nyquist stores a security-scoped bookmark so the folder reopens automatically next launch.
  • iPhone & iPad: tap Add Location and pick a folder through the Files app (a local On My iPhone/iPad folder works; SMB/NAS is optional).
  • Browse and play: drill into an album and double-click (macOS) or tap (iOS) a track. Same-format tracks play gaplessly.
  • Inspect: the inspector / now-playing screen shows format, sample rate, bit depth, and the live signal path.

Folder access & permissions

Nyquist is sandboxed and only reads files and folders you explicitly grant through the system file picker. A grant covers that folder and everything below it — but not its parents.

  • If you navigate above a granted folder and hit a permission wall, use the Grant Access… button to authorize that folder (or a higher one) once; it is then persisted.
  • Your Locations (favorites) and Recents appear in the sidebar. Recents are recorded when a track actually plays, not merely on browse.

Bit-perfect & output devices

On macOS, before building its audio graph Nyquist sets the output device's nominal sample rate to match the file (or a clean same-family multiple) and waits for the DAC clock to re-lock, so CoreAudio performs no resampling. It never forces cross-family conversions (e.g. 44.1 ↔ 48); if no native match exists, it leaves the device untouched rather than degrade the signal.

  • Choose your output (macOS): pick the exact CoreAudio output device in the app — your choice is remembered by stable UID across launches, and falls back to the system default if the device is unplugged.
  • AirPlay on macOS: route audio from macOS Control Center.
  • iPhone & iPad: use the system route picker to send audio to AirPlay, Bluetooth, or wired output.
  • Exclusive (hog) mode: optionally take exclusive ownership of the DAC during playback on macOS.

The transport bar's output badge reflects the live state:

  • Green — bit-perfect (source rate equals output rate)
  • Yellow — resampling in effect
  • Lock — exclusive (hog) mode active

NAS & network shares

Add SMB shares two ways. You can connect a share directly in Nyquist by entering the server host and share name with your credentials, or mount it through the Files app (Browse ▸ ⋯ ▸ Connect to Server ▸ smb://…) and then pick the folder in Nyquist. Either way the security-scoped bookmark persists it across launches. Remote tracks start instantly while a background copy is made to local storage so seeks become instant, and the next track is prefetched for gapless rotation.

Casting to a network receiver (UPnP/DLNA)

Nyquist discovers UPnP/DLNA receivers — such as Denon and HEOS devices — on your local network and streams the original file straight to them. Network receivers appear in the same output picker as your DACs. For DSD in DSF or DFF files, compatible receivers get the original DSD file directly.

  • Pick a receiver: open the output picker and choose the network device; the receiver's own volume stays in sync with the transport.
  • Gapless hand-off: on receivers that support it, same-format tracks hand off without a gap.
  • Discovery: the device and the receiver must be on the same local network; nothing about this leaves your LAN.

Search & track analysis

On-device search: Nyquist keeps a private, persistent index of your saved locations so you can search by keyword and filter by file type and metadata field — title, artist, album, genre, composer, label, year, or format. The index is built and stored entirely on your device.

Track analysis: open the analysis pane for any file to see a whole-track waveform with peak, RMS, and dynamic-range readouts; EBU R128 loudness with ReplayGain; a long-term spectrum that exposes upsampled or lossy-sourced files; a full spectrogram; plus live spectrum, level meters, and a stereo goniometer — each with a plain-language verdict.

Supported formats

Nyquist recognizes FLAC; AAC, ALAC, or PCM in MPEG-4 Audio; MP3; AIFF and AIFC; WAV and Wave64; CAF; AU and SND; AAC and ADTS; Ogg Vorbis, Opus, or FLAC; and DSD in DSF and DFF files. See the complete format and platform details. On macOS, compatible USB DACs receive DSD through bit-perfect DoP; compatible UPnP/DLNA receivers receive the original DSD file directly.

Not currently supported: Apple's audio stack does not natively decode MMF/SMAF (.mmf) or WMA/ASF (.wma), so either would require custom decoding or an FFmpeg integration. SACD ISO (.iso) also requires disc parsing, virtual tracks, DST decoding, and licensing work. Nyquist may revisit these formats if user demand justifies the integration cost; they are not indexed today.

System requirements

  • macOS 14.6 (Sonoma) or later, on Apple Silicon.
  • iOS / iPadOS 17.6 or later.
  • tvOS 17.0 or later, on Apple TV.
  • A USB DAC is recommended on macOS to get the most from bit-perfect output, and a UPnP/DLNA receiver for network play, but neither is required.

Troubleshooting

  • A folder won't open: you may have navigated above a granted folder — use Grant Access… to re-authorize.
  • Output badge is yellow: the file's rate has no native match on the current device, or sample-rate matching is off. Check the output pane's Match device sample rate toggle.
  • Selected DAC isn't used: if the device was unplugged, Nyquist falls back to the system default; reconnect it and reselect if needed.
  • Still stuck? email a short description (and your OS version) using the address below.

Contact

Email José Garfias López at [email protected]. Please include your device, OS version, and steps to reproduce any issue. See also the FAQ and the Privacy Policy.