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.
- 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
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.
- tvOS 17.0 or later, on Apple TV.
- 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, 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.