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 mounted through the Files app (Browse ▸ ⋯ ▸ Connect to Server ▸ smb://…), then pick the folder in Nyquist. 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.

Supported formats

FLAC, ALAC, MP3, AIFF, WAV, and AAC today. The playback engine is format-agnostic, with DSD and SACD ISO planned.

System requirements

  • macOS 14.6 (Sonoma) or later, on Apple Silicon.
  • iOS / iPadOS 17.6 or later.
  • Liquid Glass styling activates on macOS 26 / iOS 26; earlier OS versions fall back to standard materials.
  • A USB DAC is recommended on macOS to get the most from bit-perfect output, but is not 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.