High-fidelity playback for the music you own — on the Mac, and on iPhone and iPad.
Bit-perfect output, professional DSP, Audio Unit hosting, and headphone virtualization.
Fidelia plays the music you own — files kept here, your Mac's library over your own network, and owned tracks in Apple Music. It is not a subscription service and streams nothing you have not put there yourself.
The library is home. The tab bar along the bottom — Playlists, Songs, Artists, Albums, Streams, Search — is where you start. Tap any song to play it.
Now Playing is a card over the library. Tap the strip above the tab bar to raise it, and tap the artwork to put it back down. The library stays where you left it underneath.
Every new install begins a 14-day trial of the full app. The banner at the top of the library says how long is left; Buy opens the purchase screen.
Getting Music into Fidelia
Four routes, and you can use any combination of them.
From your Mac (Bridge)
The fastest way to start. With Fidelia running on your Mac and both devices on the same
network, open Settings › Fidelia Bridge and pick the Mac.
Your servers, stations and settings come across, and your Mac's library becomes browsable
and playable here. See Bridge for the full picture.
Your own files — four ways in
However the music arrives, Fidelia keeps its own copy on this device. That copy
cannot be cleared to save space the way a cloud folder can, which is what lets
CarPlay play it on a drive with no signal.
From a cloud service, inside Fidelia
Your music is in OneDrive, Google Drive, Dropbox or iCloud Drive, and you would
rather not involve a computer. Tap + at the top of the library,
tap Browse, choose the service, and pick the folder your music
is in — a parent folder with all your albums under it, not one album at a
time. Fidelia copies it across with the album folders and cover art intact.
From a Windows PC, over the cable
The fastest route for a large collection: no upload, no download, no USB stick.
Install Apple Devices from the Microsoft Store, connect this
device with a cable, open Files in the sidebar and find
Fidelia in the list. Drag your albums in. Open Fidelia and they
are in your library. (On a Mac, the same folder is in the Finder sidebar under
this device.)
From the Files app, a track at a time
Touch and hold the track, choose Open With, then
Fidelia.
Looking in Share and not finding Fidelia? Use
Open With instead. iOS keeps the apps that can open a
file in Open With, and saves Share for sending it to a person or posting it
somewhere.
The Fidelia folder itself
In Files, tap Browse, then the location named for this device,
then Fidelia. That folder is
your library: copy albums into it from iCloud Drive, a connected USB drive or
another app’s folder, and everything you put there is picked up the next
time you open Fidelia.
Apple Music
Turn on Settings › Sync Apple Music Library to fold your owned Apple
Music tracks into the library. Only tracks you own and have downloaded can
play — see Apple Music Library.
Swipe a song, or long-press a song or an album cover, for
Delete from Library. Select at the top of
the Songs and Playlists tabs removes several at once. Your audio files are
never touched — the song leaves the library and the file stays exactly
where it is, including Fidelia’s own copy in its folder, which you can
remove yourself in Files. This applies to music you added to Fidelia; Apple
Music tracks are managed in the Music app, and a server’s or a synced
Mac’s catalog is managed at its source.
Trial & Purchase
14-day trial. The whole app, not a crippled subset. The banner at the top of the library counts it down and can be dismissed for the session.
Unlock Fidelia — a one-time purchase that keeps the player working after the trial. Your library, imports and settings are untouched either way; when the trial lapses the app still browses everything you have and asks at the moment you press play.
Unlock Network — a separate one-time purchase that adds network playback: UPnP/DLNA servers and streamers, and Lyrion libraries.
Set up somewhere new, or reinstalled? Restore Purchases on the purchase screen brings both back.
Your Library
Tabs — Playlists, Songs, Artists, Albums, Streams and Search. Each list has its own filter field at the top; typing narrows that tab only.
Albums open to a sleeve: the cover, the track list, and the album's own details. Tap a track to start there.
Row badges tell you where a track lives. A laptop marks music on your Mac, reached over the network through Bridge; a cloud marks a track in iCloud that iOS has not downloaded yet.
Sorting is per context, so the order you choose for Albums does not disturb Songs.
Now Playing
The fidelity readout sits at the top of the card — the source resolution as the file actually is (24-bit/96 kHz, DSD64, AAC 256 kbps) with a coloured dot for the grade of the signal path. It follows the track and the output rate as they change.
Transport — play/pause, next and previous, and a scrubber you can drag. DIM drops the level temporarily; MUTE silences without losing your volume setting.
Tap the artwork to put the card down and return to the library.
The toolbar under the scrubber holds output settings, AirPlay, shuffle and repeat, the station browser, and the effects rack.
Audio Output
Open Settings from the Now Playing card, or the gear in the library toolbar.
Output Device — whatever iOS is currently routing to (built-in, a connected USB DAC, AirPlay or Bluetooth), or a UPnP/DLNA streamer on your network, which Fidelia lists itself. System routes are chosen the usual iOS way; streamers are chosen here.
Follow file sample rate — drives the DAC at the file's own rate where the hardware supports it, instead of resampling everything to one rate.
HeadSpace — Crossfeed with Amount and Center Realism, plus Bass and Treble shelving. Crossfeed relaxes the hard left/right separation that makes headphone listening tiring on recordings mixed for speakers. HeadSpace runs only while one of these is engaged, and is bypassed entirely in Bit-Perfect.
ReplayGain — evens out level between tracks, reading the values already in your files. See ReplayGain.
Bit-Perfect
Bit-Perfect matches the output rate to the file and takes the DSP chain
out of the path — Crossfeed, dither, ReplayGain and any Audio Units you have loaded.
It is the honest setting for critical listening, and it is genuinely exclusive: while it
is on, an effect switched on in the rack is not in the signal path, and the
fidelity readout says so rather than claiming an enhancement that is not happening.
What it does not promise. On iOS the audio path belongs to the system,
and no app is given the guarantee a Mac can make about the exact samples reaching a DAC.
What Fidelia can do — and does — is rate-match and stay out of the way, which is
bit-transparent rather than certified bit-perfect. With a USB DAC that reports
its rate honestly the result is the same; the difference is that iOS will not let any
app prove it. Worth verifying with your own DAC rather than taking on faith.
Sample Rate Conversion
When the output cannot run at the file's own rate, Fidelia resamples
rather than letting the system do it. Quality offers
Standard, High Fidelity (the
default) and Mastering — the same resampler the Mac
uses, which exposes five tiers to its five-tier picker.
Advanced holds the filter's own settings for anyone
who wants them.
Follow file sample rate is what avoids conversion in
the first place, and Bit-Perfect forces it on. Nothing is resampled
when the output is already running at the file's rate.
Dither
Dither on bit-depth reduction is on by default.
Shaped noise keeps low-level detail intact when the output stage
reduces bit depth — without it, truncation turns quiet passages into
harmonic distortion. It is the same psychoacoustic engine as Fidelia
for Mac, and it is bypassed entirely in Bit-Perfect.
Internet Radio
Stations live in the Streams tab and play through the same engine as your own files — the same output device, the same signal path.
The station browser in the Now Playing toolbar searches the directory; stations you keep are saved to the Streams tab.
Stations synced from a Mac through Bridge arrive here too.
The fidelity readout reports the station's codec and bitrate, and upgrades to what the engine actually decoded once the stream connects.
Audio Units (AUv3)
Fidelia hosts third-party Audio Unit v3 effects — the same class of
plug-in used by GarageBand and Logic — alongside the effects built into iOS.
Loading an effect
Open Now Playing, then the sliders button in the toolbar. The rack appears with its slots.
Tap Add Effect on an empty slot. The picker lists what is installed, grouped by manufacturer.
Each loaded slot has a power button to switch that effect in or out, a chevron to open its interface, and a minus to remove it.
The plug-in's own interface
Plug-ins that ship their own interface show it. Those that do not — including the effects built into iOS, which are older-generation units — get Fidelia's parameter list instead.
Where a plug-in has both, the button beside Done switches between its interface and the plain parameter list. A plug-in's own design is not always the easier one to work.
Turn it sideways. Most AUv3 interfaces are modelled on hardware, and hardware is wide — a 500-series EQ laid out across a portrait screen renders its faders too small to use. The plug-in editor is the one screen in Fidelia that rotates: turn it and the whole screen turns with it. Done puts you back in portrait.
Things worth knowing
A plug-in must be installed here from the App Store. Many are sold inside a host app; check that the app actually installs an AUv3 extension.
Install one while Fidelia is running and it appears in the picker without a relaunch.
Bit-Perfect bypasses the whole rack. If an effect seems to do nothing, check that first.
Effects are part of the DSP path, so the fidelity readout reads Enhanced while one is switched on and actually loaded.
DSD Playback
Fidelia plays DSD files (.dsf and .dff) — the 1-bit
stream is decoded to high-resolution PCM in real time, so DSD plays gaplessly on any
output and rides the same signal path as the rest of your library. The readout names the
source for what it is: DSD64, DSD128 and so on, not the
PCM rate it was decoded to.
There is no DoP on iOS. Sending an untouched DSD bitstream to a DAC
inside a PCM carrier is something iOS does not permit any app to do — this is a platform
limit, not a Fidelia one, and no iOS player can offer it. Real-time decode to PCM is the
path, and it is the same decoder the Mac uses. If you need a native-DSD signal to your
DAC, that is a job for Fidelia on the Mac.
Network Servers & Streamers
Both are part of the Network module.
Playing from a server
Fidelia browses UPnP/DLNA servers and Lyrion (LMS) libraries on your network. Their catalogs join your library and browse, search and play like anything else.
Open the server browser from the library toolbar. Servers on your network are found automatically; Add manually takes an address for one that lives elsewhere.
Playing to a streamer
Tap the output button next to the gear on Now Playing. One list holds everywhere the music can go: this device, AirPlay & Bluetooth, and every UPnP/DLNA streamer on your network — a Denon or HEOS component, HQPlayer on another machine, a Sonore Rendu, or anything accepting standard UPnP AV control. Find network streamers searches; an address field adds one discovery can't reach. The same list opens from Play to in Settings.
AirPlay & Bluetooth opens the system picker — Apple's routes live behind Apple's sheet. Engaging one while a streamer is playing brings the music back to your device, routed onward by the system.
Picking an output moves the music. Whatever is playing — a file, your Mac's library, a server's track, a station — restarts on the streamer you chose. Picking a different streamer moves it again and silences the first; picking the top row — your device’s own name — brings it home. The transport shows the current destination beside the output button whenever the sound leaves the device.
The whole signal path travels with it: the engine still decodes, resamples, applies HeadSpace, ReplayGain and any Audio Units, and sends the result to the streamer. Bit-Perfect instead hands the streamer the file's own bytes.
Some streamers accept volume commands and ignore them. Fidelia checks, and keeps the level where it will actually work — see Volume Control beneath the picker.
If nothing is found
iOS asks for Local Network permission the first time. If it was declined, grant it in the system Settings app under Fidelia — nothing on the network can be discovered without it.
Everything must be on the same network, and a guest or client-isolated Wi-Fi network will block discovery by design.
Supported Formats
Lossless — FLAC, ALAC (M4A), AIFF, WAV, CAF
Lossy — AAC (M4A), MP3, Ogg Vorbis, Opus
DSD — DSF, DSDIFF (DFF), decoded to PCM in real time — see DSD Playback
Monkey's Audio — APE
Streaming — internet radio over HTTP and HLS; MP3, AAC, Opus and Ogg Vorbis streams
A format is listed here only when there is a decoder behind it. A row you cannot play is
worse than a row that is not there.
Apple Music Library
Settings › Sync Apple Music Library folds your Apple Music library into Fidelia's, played through Fidelia's engine rather than the Music app's.
Owned music only. Purchases, imports and CD rips can play. Apple Music subscription tracks are protected and cannot be played by another app, so they are left out rather than shown and refused.
A track must also be downloaded. Anything still in iCloud is listed but cannot play until iOS has it locally.
Refresh Automatically re-checks on returning to the app, so new rips and downloads appear. It does nothing when nothing has changed.
iOS asks permission the first time. If it was declined, grant it in the system Settings app under Fidelia.
CarPlay
Fidelia appears in CarPlay with your library — playlists, artists, albums and songs — and full transport on the dashboard.
Show iCloud Tracks in CarPlay decides what the car lists. On, you see everything, including tracks iOS may have removed to save space — one may be missing when you get in. Off, the car shows only music that cannot be taken away. Tracks iCloud has never downloaded never appear either way.
CarPlay's own limits shape the lists: the system caps how many rows a template may show, so very long lists are trimmed for the car rather than truncated silently in the app.
Music that plays anywhere, signal or not
The car plays what is on this device. Anything you added through
Getting Music into Fidelia — over the cable
from a computer, by picking a folder in + › Browse, or with
Open With › Fidelia — is copied here and stays, so it is
always in the car.
Music that lives somewhere else needs bringing across first: use
Keep Offline for a track, album or playlist on a music server
or a synced Mac. A playlist’s row in the car counts this for you —
12 of 12 available is a playlist that will play the whole way.
Troubleshooting
A third-party effect is not in the picker
Confirm the plug-in is actually installed here, and that its host app ships an AUv3 extension — GarageBand's Audio Unit Extensions list is a quick second opinion.
Fidelia 2.0.2 and later notice a plug-in installed while the app is running; on older builds, quit and reopen Fidelia.
An effect is loaded but nothing changes
Check that the slot's power button is on, and that Bit-Perfect is off — Bit-Perfect bypasses the entire chain by design.
Bridge cannot find my Mac
Both devices on the same network, Fidelia running on the Mac, and both signed in to the same iCloud account.
iOS asks for Local Network permission the first time. If it was declined, grant it in the system Settings app under Fidelia. A macOS update can also reset the Mac's own Local Network grant.
Apple Music tracks are missing
Subscription tracks cannot be played by another app and are deliberately left out. Owned tracks must be downloaded before they can play.
Playback stops when the screen locks
It should not — Fidelia keeps playing in the background. If it stops, check that Low Power Mode is not on and that iOS has not restricted background activity for the app.
Getting Started
Launch Fidelia. The player window appears — this is your primary interface for transport controls, volume, and track display.
Open the Library with ⌘L or View → Show Library. Drag audio files or folders onto the library window to import.
Double-click any song in the library to begin playback. Use Space to play/pause.
Your library is stored in ~/Music/Fidelia/ and persists across sessions.
Library
The Library stores all your imported audio with metadata, artwork, and playlists.
Files are referenced by location — Fidelia does not copy files into its library folder.
Importing Music
Drag & Drop — Drag files or folders onto the library window. Fidelia recursively scans folders for supported audio formats.
File → Import to Library (⌘O) — Open a file picker to select files or directories.
Large imports show progress as they run, and Fidelia tells you about any files it had to skip — unreadable or unsupported — rather than failing silently.
To audition tracks without adding them to your library — for example, listening to client mixes, evaluating new files before keeping them, or playing files from an external drive — see Preview Playlist.
Managing Your Library
Sort — Click column headers (Title, Time, Artist, Album, Composer, Genre, Format, Sample Rate, Bit Depth, Bitrate, Year, Comment) to sort. Click again to reverse.
Show / hide columns — Right-click the column header row to toggle optional columns. Composer, Genre, Format, Sample Rate, Bit Depth, Bitrate, Year, and Comment are hidden by default; the optional metadata columns follow the same order as the Get Info fields.
Search — Use the search field to filter by title, artist, album, genre, or composer.
Playlists — Create playlists from the sidebar. Drag songs to reorder within a playlist. Playlists can be organized into folders — see Playlist Folders.
Get Info — Right-click a song and choose Get Info, or press ⌘I, to view and edit metadata. Multi-select before opening for batch edits — see Editing Metadata.
Artwork — Drag artwork onto the album art panel, or use Edit → Find Artwork Online (⌥⌘A) to search automatically.
Delete — Select songs and press Delete to remove them from the library. Original files are not affected.
The track table
Columns — right-click the column header to show or hide columns,
including Date Added. Drag a column edge to set its width; Fidelia
keeps the widths you choose. When your columns need more room than the window has,
the table scrolls sideways.
Sorting — click a column header to sort. Each context remembers
its own sort, so the Library, a playlist and a server each stay how you left them
rather than inheriting one global setting.
The sidebar — drag its inner edge to resize; the width is
remembered.
Playlists play in the order you see
A playlist plays in the order you arranged it. Sorting a playlist's column is a
view — it changes what you are looking at, not the order it will play, and
the header says so. If you would rather a column sort also set the play order, turn on
Sorting a playlist changes the play order in
Settings → General. Playlists imported from Music.app arrive in the
order you arranged them there.
Relocating Missing Tracks
If you move files to a new location, tracks will appear as offline (dimmed with a warning icon).
Use File → Relocate Missing Tracks to point Fidelia at the new folder.
It matches files by name and automatically updates all references.
Album View
The Library has two layouts, toggled by the List / Wall control in the window titlebar (next to Search). The song list is the default; the Wall is a graphical grid of your album covers. Whatever narrows the song list — a playlist selection, a search — narrows the Wall the same way.
Various-artist compilations group as one album — on the Wall and in the Sleeve — rather than scattering by track artist, and a real Album Artist always takes precedence over the compilation flag.
The Wall
Each album appears as its cover, and the covers stay clean until you hover. Hover one to reveal its title and artist and a Play button — click the cover to open its Sleeve, or the Play button to play the whole album on the spot.
The Wall is quietly lit by the music. The covers cast a soft, ever-shifting color drawn from the album that's playing, and each change of album sweeps across the grid like a slow dawn — ambient by design, always present, never in the way, and never at the cost of smooth scrolling.
Sort the grid from the titlebar control — by Artist, Title, or Year, ascending or descending. The Wall keeps its own sort, independent of the song list's columns.
The Sleeve
Opening an album lifts its cover into place on a full page, lit by a slow, breathing gradient drawn from the artwork and kept dark so it never glares. The Sleeve gathers the cover, album credits, and the album's tracks in order.
Play — the Play button plays just this album, from the top, in track order.
Linked credits — the artist, genre, and composer are tappable. Click one to refocus the Library around it — every track by that artist, in that genre, and so on.
Track list — the album's tracks in a table scoped to the Sleeve, with the same shift / ⌘ multi-select, drag-out to a playlist, Get Info, and double-click-to-play as the main list.
Back — the chevron at the top-left returns you to the Wall.
Editing Metadata
Open Get Info on a song with ⌘I or via the right-click menu. The dialog is fully editable for songs imported into Fidelia's library; songs sourced from Music.app are read-only (Music.app is the source of truth there).
Editable fields
Title, Artist, Album, Album Artist, Composer, Genre
Year, Track number, Disc number
Comment
Sample rate, bit depth, bitrate, duration, format, and file location are technical properties of the audio data itself and aren't editable from Get Info.
Apply to all songs in this album
At the bottom of the single-song dialog, the Apply to all songs in this album checkbox expands an edit to every song that shares the current Album and Album Artist. Useful for fixing genre or year across a whole album from one track.
Editing many songs at once
Select multiple songs in the library and open Get Info — a multi-song dialog appears with a subset of fields (Artist, Album, Album Artist, Composer, Genre, Year, Comment). Per-song fields like Title and Track number are hidden because their values aren't meaningfully shared across a selection.
Fields where every selected song already has the same value show that value, ready to edit.
Fields with mixed values render blank with a "Multiple values" placeholder. Type a new value to overwrite across the selection.
Only fields you actually focus or modify get committed — untouched fields preserve each song's existing value, so a quick year-only edit doesn't blank out the rest of the metadata.
A confirmation dialog appears before the first multi-song save (with a Don't ask again checkbox).
Mixed selections that include any Music.app-sourced song are read-only — Fidelia refuses to silently edit a subset.
What Save does
Clicking Save updates Fidelia's library database immediately, then mirrors the new values into the source file's embedded tags off-main:
WAV / AIFF / CAF — Library-only. Embedded tag formats for these containers aren't widely honored by other audio software, so Fidelia leaves the file alone.
For each format that supports it, Fidelia preserves frames and keys it doesn't manage itself — ReplayGain, MusicBrainz IDs, custom user tags from other editors all survive a Save.
Successful saves are silent. If a file write fails (volume offline, file became read-only, format unsupported), a transient toast appears at the top of the Library window confirming the database edit and explaining what didn't reach the file.
Library access for tag writes
For libraries on external volumes or NAS shares, Fidelia may ask once for folder access the first time you save tags into that location — granting the suggested folder covers every file underneath, persists across launches, and won't ask again for that library. Local libraries imported normally don't trigger any prompt.
Multi-song save progress
Album-scope and multi-song commits below 30 songs run silently in the background. Larger commits show a progress toast at the top of the Library window with a counter and Cancel button — you can dismiss the Get Info dialog while the writes finish. Cancel stops scheduling new writes; in-flight writes complete atomically (already-written files stay written).
If a file write fails: it retries automatically
When a tag write can't reach its file (NAS dropped, volume ejected, permission revoked), Fidelia queues the affected song and tries again on the next launch. Once the volume is reachable, the file gets the database's current values silently — no user action needed.
For the rare case where a queued retry can never succeed (a permanently-removed volume), File → Clear Pending Tag Writes empties the queue manually. The menu item is disabled when nothing is pending.
Playlist Folders
The sidebar supports nested folders for organizing large playlist collections. Folders are containers — they hold playlists and other folders, but never songs directly.
Creating folders
Right-click any blank space in the sidebar's Fidelia section and choose New Folder.
To create a folder inside an existing folder, right-click the folder and choose New Folder in Folder.
The new row opens with its name selected for inline rename.
Organizing
Drag a playlist or folder onto another folder to move it inside.
Drag back to the top level by dropping into the Fidelia section's empty space.
Right-click a playlist or folder and use Move to… for a menu of valid destinations when drag-and-drop is awkward.
Folders show their child-count and a disclosure triangle. Click the triangle to expand or collapse.
Deleting
Right-click a folder and choose Delete Folder. Empty folders delete inline. Folders with playlists or sub-folders inside open a confirmation alert that lists what will be removed.
Music.app folders
With Music.app integration enabled, Fidelia mirrors the folder hierarchy from your Music.app library under the Music section of the sidebar. Music-side folders are read-only — they reflect Music.app's organization and update when Music.app changes.
Preview Playlist
The Preview Playlist is an opt-in scratch space for tracks
you want to listen to without adding them to your Library.
It's cleared automatically each time you launch Fidelia, so
it never accumulates state between sessions.
Useful when you're auditioning client mixes, evaluating
promo files before keeping them, or playing tracks from an
external drive you don't want referenced in your permanent
collection. Each new drop replaces the previous Preview
session — Fidelia treats each batch as a new audition.
Turning it on
Open Settings → General → Library and
enable Preview Playlist. A new
Preview entry appears in the sidebar
(under Fidelia, alongside
Library) marked with a lightning-bolt
icon to signal its ephemeral nature. The row is shown only
while Preview has tracks in it; an empty Preview is hidden.
Adding tracks
Hold ⇧ while dragging files onto the Player window, the Mini Player, or the Library list. The drop is routed into Preview instead of being imported.
File → Add to Preview… (⇧⌘O) — File picker that always routes to Preview.
⇧-drag works on Fidelia's own windows. Dropping on the Dock icon, using Open With → Fidelia from the Finder, or double-clicking an associated file always goes to your Library.
For preview semantics from those entry points, see Preview-only mode below.
Each Preview drop replaces any tracks already in Preview — drop a list, the list plays from the first track. If a track in the new drop is also currently playing, it restarts from the beginning so the audition session is consistent.
Promoting tracks to your Library
Right-click the Preview sidebar entry and choose Move All to Library to commit the entire Preview session at once. Duplicates against existing Library content are skipped.
Clearing
Preview clears itself at every cold launch — quit Fidelia and reopen it, and Preview starts empty. To clear during a session, right-click the Preview sidebar entry and choose Clear Preview.
Preview-only mode
If your primary use of Fidelia is auditioning rather than collecting — common for mix engineers, A&R, and reviewers — enable Send all incoming files to Preview by default in Settings → General → Library (visible once Preview Playlist is on).
With this mode on, every entry point — drag-and-drop, Open With → Fidelia, Dock-icon drops, and double-clicks — routes incoming files into Preview instead of your Library. Use File → Import to Library (⌘O) for the rare track you want to keep, or hold ⇧ while dragging onto a Fidelia window to import that specific drop.
Preview is a session-local, machine-local concept. It isn't synced via Music.app, never participates in playback history, and isn't visible to Fidelia Remote. Tracks that exist only in Preview disappear at next launch — back up anything you want to keep by promoting it to your Library first.
Internet Radio
Fidelia plays internet radio alongside the music you own. Stations live in their own Streams section in the sidebar, and every stream runs through the same reference engine as your local files — your output device, HeadSpace, and signal path, untouched.
Adding Stations
Search the directory — Choose File → Import Stream… and use the Search tab to browse a public directory of thousands of stations by name, genre, or country.
Add by URL — Paste a stream or playlist address in the URL tab. Fidelia resolves direct streams, .pls / .m3u / .xspf playlists, and HLS manifests automatically.
Added stations appear under Streams in the sidebar. Double-click to play, use next / previous to move through the list, and press Delete to remove one.
Playing a Stream
The transport shows LIVE in place of a time readout — a live stream has no fixed length to scrub.
The now-playing waveform scrolls at the live edge as audio arrives, and the station's current track title appears whenever the stream broadcasts it. The station playing now is marked in the list with the same speaker indicator as a playing track in your library.
If the connection drops, Fidelia reconnects automatically rather than moving on to the next thing — and the display stays honest while it does, rather than leaving a stale title on screen.
Station Presets
Presets are stations — nine numbered slots you recall blind, like the push buttons on a car radio. Right-click a station and choose Set as Preset to assign a slot (1–9); each slot holds a single station, so setting a slot takes it from whatever held it before. A preset station carries its slot number as a badge and leads the list in slot order — at the top when you're tuned to All, and at the top of its own band.
Recall any preset instantly with ⌃1–⌃9, from Controls → Presets, or from the transport bank in Fidelia Remote — from anywhere in Fidelia, whatever you're doing.
The Tuner
Above the station list, the Tuner is a row of genre bands — Classical, Jazz & Blues, Ambient, Electronic, Rock, and the rest. Each station is filed into one band by matching its tags against Fidelia's genre keywords; a station whose tags match none lands in Other. Tag a station from its Get Info (right-click → Get Info) — the tag field autocompletes from tags already in your library — to steer where it files.
Only the bands present in your stations appear, the most-populated first. Select a band to filter the list to that genre; select it again, or the All card, to clear.
Drag a band to rearrange the Tuner into the order you like — Fidelia remembers your arrangement, and a band keeps its place even if its stations come and go. All stays first.
Search the station list from the field at the top of the window to filter by name, just like the Library.
Honest Fidelity
Streams are graded by their real source quality — the Fidelity Light and signal path read the stream's actual codec and bitrate, and never dress up a lossy feed as more than it is. Where a station broadcasts a lossless stream, you hear it lossless.
HLS, Opus, and Ogg Vorbis stations play natively. Streams are played, not stored — they aren't part of your on-disk library — and you can browse and play them from Fidelia Remote as well.
Playback
Play/Pause — Space
Next / Previous — ⌘→ / ⌘←
Seek — ⌥⌘← / ⌥⌘→ to jump back / forward inside the current track.
Volume — ⌥⌘↑ / ⌥⌘↓ to raise / lower output in fine 0.5 dB steps.
Shuffle — Randomizes the playback order within the current queue.
Repeat — Off, All (loops the queue), or One (loops the current track).
DIM (⇧⌘D) — Reduces volume to a preset level without changing the volume knob.
Mute (⌘M) — Silences output instantly. DIM and Mute are mutually exclusive.
Click the track-time readout to change what it shows — including a precise volume level in dB — and Fidelia remembers your choice, the same way it remembers whether the timer counts up or down.
Fidelia can run as a clean file-to-DAC path or as a full DSP playback chain,
depending on your Output, Audio Engine, HeadSpace, and Advanced settings.
Bit-perfect mode bypasses the DSP chain entirely.
When you press pause with effects loaded (reverbs, delays, convolutions), Fidelia lets the plug-in tails decay naturally for up to a few seconds rather than cutting them off — same behavior a DAW would give you on a transport stop. Resume is still instant.
Now Playing
Now-Playing Panel
As you browse the Library, a now-playing panel stays in the sidebar with the current cover, a scrubber, and transport controls — playback is always to hand without switching back to the player window. Click the cover to jump straight to that album's Sleeve.
Fidelity Light
A small light beside the now-playing track shows at a glance how cleanly it's reaching your ears — a quick read on whether you're hearing the file untouched or with conversion and processing in the path. It's color-graded from a lossless, bit-accurate path through to a lossy source.
Click the light for the full signal path — every stage in order, from the source file through resampling, HeadSpace, Audio Unit effects, and dither to your output device, each one graded. Bit-perfect playback shows a short, clean path (source straight to output), because it bypasses the DSP chain entirely.
Player Views
Large / Medium / Small / Smaller (⌘1–⌘4) — Four player sizes with progressively compact layouts.
Mini Player (⇧⌘M) — A minimal floating player with transport controls, volume, and track info. Ideal for keeping Fidelia visible while working.
Player On Top (⇧⌘T) — Keeps the player window above all other windows.
Audio Output
Fidelia sends audio to your selected output device using its own playback engine.
Configure device selection, hardware sample rate, and routing in Settings → Output.
Device Selection — Choose any connected output device.
Device Rate — Set the hardware sample rate directly when you want Fidelia to hold a specific DAC rate.
Follow file sample rate (DAC) — When enabled, Fidelia switches the DAC to each file's native sample rate whenever the device supports it. This reduces or eliminates SRC.
Channel Routing — For multi-channel devices, a routing matrix lets you map input channels to any output channel. Stereo devices use direct 1:1 routing.
Fidelia plays surround records at their full width — 5.1, 7.1, 7.1.4 and up to
9.1.6, sixteen channels — through any interface with enough outputs.
It reads the channel layout the file declares rather than guessing
from the channel count or their order in the file. That distinction matters on real
records: a 3.1 mix is not played as quad, and an LFE channel goes to the subwoofer
rather than to whichever speaker happens to sit in that position.
A stereo record is unaffected. Fidelia only widens the bus when the file is wider,
so nothing about two-channel playback changes because you own a surround rig.
Fold-down
Playing a surround record on a stereo device folds it down properly — the centre
channel, and the lead vocal that usually lives there, is mixed in rather than dropped.
The same fold-down applies when you send a multichannel track to a network streamer.
Headroom
Settings → Advanced → Headroom gives the chain room at the top. It is
useful when speaker trims push a channel up — an under-powered amp on the surrounds,
for instance — and the sum would otherwise have nowhere to go. Headroom stays out of
the way in Bit-Perfect mode, where nothing may touch a sample.
The Output Dashboard
The Output Dashboard is your rig on one surface: your speakers on the left,
drawn where they actually sit in the room, and your interface's outputs on the
right. Open it from Settings → Output.
Assigning outputs to speakers
Drag an output from the right onto a speaker on the left.
Or use the speaker's own menu, which lists free outputs first and names what the
busy ones already feed — so you can see a mistake before you make it.
An assignment takes effect immediately. There is no apply step.
Hearing what is where
Every speaker carries its own meter. A mis-wired rig is obvious
the moment music plays — the channel you expected to be quiet is moving.
Identify sweeps pink noise through the room one speaker at a time,
so you can confirm by ear that the speaker Fidelia calls "left surround" is the one
behind your left shoulder.
Mute, solo and polarity sit on
each speaker, visible before you engage them — "why is this speaker silent" is
exactly the moment you go looking for the control.
Calibrating a Rig
Fidelia calibrates by measurement, not by arithmetic you have to do yourself. Each
speaker takes three things:
Distance — how far that speaker is from where you sit, measured
with a tape. The farthest speaker becomes the reference, and the nearer ones are
delayed to match so every channel arrives together.
Level trim — a gain offset for that speaker.
Polarity — a phase flip, for a driver wired backwards.
You supply the measurements; Fidelia does the maths. Two subwoofers in different
corners can be calibrated differently from each other, which is the reason to have two.
A rig is remembered per output device
Your positions, distances and trims are a physical fact about a room and an interface,
so they are stored against that output device. They survive a relaunch, they
stay put when a stereo album follows a 5.1 one, and plugging in a different interface
brings back its own rig rather than applying this one to it.
Plug-ins across a wide bus
Audio Unit slots run a bus up to sixteen channels across, so a convolver can take a
stereo record and emit a filtered channel per driver. Slots that only speak stereo say
so plainly and are bypassed rather than guessed at.
The routing matrix names where its row count comes from — the playing file, or a width
you fixed yourself — and links to the control that sets it.
Network Streamers
With the Network upgrade, Fidelia can play to a UPnP/DLNA network streamer —
a Denon or HEOS component, HQPlayer on another machine, a Sonore Rendu, or any renderer
that accepts standard UPnP AV control. Choose Find network streamers…
in the output picker; discovered streamers appear in the Network section.
If your streamer doesn't appear
Check Local Network permission first. macOS requires per-app
permission to talk to devices on your network. Open System Settings →
Privacy & Security → Local Network and make sure Fidelia
is listed and enabled. If it's off, streamer discovery silently finds nothing —
this is the most common cause of an empty search.
Confirm the streamer is in UPnP/DLNA renderer mode. Many streamers
speak several protocols and run one at a time. On Sonore devices, select
MPD/DLNA in the Audio App Switcher. A streamer set to a
Squeezebox/Squeezelite or AirPlay mode is a different kind of endpoint and won't
appear here. Renderers that offer only OpenHome control (with UPnP AV switched off)
are not yet supported — re-enable the standard UPnP AV interface.
Put the Mac and the streamer on the same network. Discovery uses
multicast, which guest Wi-Fi networks, VLANs, and some router features (AP/client
isolation, IGMP snooping) block between segments. Wired and wireless devices on the
same router normally work; if your network separates them, try temporarily joining
the Mac to the streamer's segment.
Restart the streamer after changing any of its settings, then search
again. This matters more than it sounds: on Linux-based streamers the UPnP renderer
only announces itself once the player component behind it is fully up, so a device
that has been reconfigured — or whose music database was rebuilt — can sit there
looking healthy while being invisible to every controller on the network. A beta
tester tracked exactly this down: a setting he'd switched off appeared to be the
cure, but re-enabling it changed nothing. The restart that saving triggered was the
real fix.
Add it by address instead. Some streamers never answer a direct
search no matter how healthy the network is — the UPnP library they use only listens
for broadcast searches. Choose Add streamer by IP or description URL…
in the output picker and type the streamer's address (for example
192.168.1.134). Fidelia asks it directly and adds it permanently. If you
already know its description URL — any UPnP inspector will show one, and the Terminal
check below prints it — paste that whole URL instead; it always works, whatever port
or path the device uses.
Still stuck? A one-minute Terminal check
This asks every UPnP device on your network to identify itself, and prints each one's
address and description URL. Nothing about Fidelia is involved, so it tells you whether
the network path itself is working. Open Terminal (Applications →
Utilities), paste the whole line below, and press Return. If macOS asks whether Terminal
may find devices on the local network, click Allow.
Each line is one device's description URL. If your streamer's address
appears, the network path is good — re-check the Local Network permission
above, and confirm the device is in UPnP/DLNA renderer mode. That URL is also exactly
what Add streamer by IP or description URL… accepts, so you can paste it
straight into Fidelia and be done.
If your streamer is missing but other devices appear, multicast is fine
and the streamer simply isn't announcing itself — restart it, then add it by address.
If nothing prints at all, the network is blocking multicast between the
Mac and the streamer; adding by address usually still works, because that talks to the
device directly. Either way, contact support with the output and
we can pinpoint it quickly.
Network Library (Lyrion / LMS)
Separately from playing to a streamer, Fidelia can play from a
Lyrion Music Server (formerly Logitech Media Server). Its catalog
joins your library as its own section in the sidebar, and its tracks browse, search,
sort and play like any others.
Add a server with the + beside NETWORK in the sidebar, or
File → Connect to Music Server…. Fidelia finds servers on your
network automatically; you can also add one by address if it lives elsewhere.
Try it before you buy it — the Network module has a free trial, so you can point
Fidelia at your server or streamer and hear it working before you decide.
How a server's music is treated
Tracks stream on demand. Nothing is copied to your Mac unless you ask for it.
A track you own in more than one place — locally and on a server — appears
once, at its best available source.
A server that goes offline marks its rows rather than hiding them, so a playlist
that references them still reads correctly. They come back when the server does.
Make Primary
When you own the same recording more than once, Fidelia plays the best copy it can.
Make Primary pins your choice instead — right-click a track or an
album and choose it. A pin beats quality ranking, but yields to availability: if the
copy you pinned is on a server that is currently offline, Fidelia plays a copy that
can actually play rather than failing.
Bridge
Bridge lets Fidelia on iPhone or iPad browse and play the library on your Mac
over your own network — your music, not a cloud service. Both devices must be signed
in to the same iCloud account and on the same network.
The pull always happens from the mobile side. There is nothing to switch on here —
the Mac is simply the source. Start the sync from Fidelia's settings there; the
Mac shows what it last served, and to which device, under
Settings → General → Remote.
What travels: your music servers, radio stations, settings and version pins, along
with the tracks themselves and their artwork.
Keep Offline
Keep Offline downloads chosen albums or playlists to the
device so they play with no network at all — on a plane, or underground. Fidelia keeps
what you asked for up to date as the source changes, and tells you what it is doing
in the status strip while it works.
Bit-Perfect & Exclusive Mode
These options live in Settings → Advanced and control how Fidelia interacts
with the output hardware and DSP chain.
Bit-Perfect Mode — Bypasses HeadSpace, dither, SRC, and Audio Units. It also forces file-rate matching so the DAC follows the track whenever possible.
Exclusive Mode (Hog Device) — Takes exclusive ownership of the selected output device. Other apps cannot use that device while Fidelia is holding it.
DSD Playback
Fidelia plays DSD files (.dsf and .dff) directly — no conversion,
no orphaned files. By default the 1-bit DSD stream is decoded to high-resolution PCM in real time,
so DSD plays gaplessly on any output device and rides the same signal path — and the same SRC
settings — as the rest of your library.
Bit-Perfect DSD over PCM (DoP)
For DACs that decode DSD natively, Settings → Output → Play DSD bit-perfect (DoP)
sends the untouched DSD bitstream to the DAC inside a standard PCM carrier (the DoP standard).
Enable it per device.
Test the tone first. Switching DoP on plays a short test tone at the DAC's highest supported DSD rate. A DAC that understands DoP plays a clean tone; one that doesn't plays loud static — answer honestly, and Fidelia only trusts DoP on hardware that passed.
Volume is fixed while DoP is active. A bit-perfect stream is, by definition, untouched — so Fidelia's volume knob (a digital gain) is bypassed during DoP. Set level on your DAC, preamp, or amplifier. Turn DoP off, or play a non-DSD track, to use Fidelia's volume again.
DACs without DoP lose nothing — DSD keeps playing perfectly via real-time decoding, the volume knob works normally, and playback stays gapless.
Sample Rate Conversion (SRC)
When the source file's sample rate does not match the active device rate, Fidelia
applies sample rate conversion from the Settings → Audio Engine tab.
Quality — Monitor, Standard, High Fidelity (default), and Mastering.
Presets — Default, Gentle, Steep, Ultra-Steep, Intermediate Phase, and Minimum Phase give you faster access to the common filter shapes.
Engine — Linear Phase uses the r8brain path. Phase Selectable uses the soxr path with linear, minimum, and intermediate phase options.
Advanced filter controls — Filter Steepness and Cutoff Scaling let you tune the transition band directly when you need a custom filter shape.
Dither
When reducing effective bit depth, Fidelia applies dither from the Settings → Audio Engine tab to preserve low-level detail.
Type — TPDF (recommended), TPDF Hi-Pass, Rectangular, Gaussian, or None.
Bit Depth — Auto-detect from the output device, or set manually to 16-bit or 24-bit.
Dither Level — Adjusts the added dither level.
Hi-Pass Cutoff — Available for the hi-pass dither types.
Auto-blanking — Silences dither on zero input to avoid noise in quiet passages.
Peak limiting — Prevents clipping when dither raises the signal near 0 dBFS.
HeadSpace
HeadSpace is Fidelia's headphone virtualization DSP. It simulates the spatial
characteristics of loudspeaker listening through headphones, reducing fatigue
and creating a natural soundstage. Configure it in Settings → HeadSpace.
Crossfeed
Angle — Sets the virtual speaker placement (0°–75°).
Amount — Controls how much of each channel bleeds into the opposite ear.
Reflector — Adds early reflection weight to enhance spatial depth.
Equalization
Treble — Shelving EQ with adjustable gain (±6 dB) and frequency (1–16 kHz).
Bass — Shelving EQ with adjustable gain (±6 dB) and frequency (30–500 Hz).
Per-Band Crossfeed
Fine-tune crossfeed independently for Low (<800 Hz), Mid (800–4k Hz), and High (>4k Hz) bands.
Monitoring
Balance — Left/right balance adjustment.
Mono — Sum stereo to mono for single-speaker or reference checks.
Swap L/R — Swap left and right channels.
Phase — Normal or Inverted (polarity flip on one channel).
HeadSpace is designed for headphone listening only. Disable it when using speakers.
ReplayGain
ReplayGain evens out the volume between tracks, so a quiet recording and a loud master play at a comparable level without reaching for the volume between songs. Fidelia reads the ReplayGain values already written into your files — it neither re-analyzes nor alters your audio. Set the mode in Settings → Output.
Off — no normalization; every file plays at its own level (the default).
Track — levels each song individually, so a shuffle across mixed sources stays even.
Album — levels by album, preserving the relative loudness between an album's tracks. Falls back to the track value when no album value is present.
Pre-amp — a fixed offset (−12 to +12 dB) applied on top of the tag value, to set the overall level to taste.
Clip-safe. Fidelia never lets ReplayGain push a track into clipping. Using the peak value in the tags, it caps the applied gain so the loudest sample stays at or below full scale — a positive gain is applied as far as the track's own headroom allows, and trimmed only if it would otherwise clip. You can assign positive ReplayGain values (common on quiet and classical albums) with confidence; Fidelia keeps them safe. This relies on the peak values your tagger writes alongside the gains.
Fidelia reads ReplayGain tags from FLAC, MP3, ALAC/M4A, and AAC files. ReplayGain is applied as a pre-gain, ahead of the DSP chain and the volume fader, and is bypassed in Bit-Perfect mode and for bit-exact DSD (DoP), where the original signal is delivered untouched.
Audio Units
Fidelia hosts Audio Unit (AU) plug-ins in the playback DSP chain. Add EQ, reverb,
metering, and other compatible Audio Unit effects for real-time processing.
Enable the AU processing chain in Settings → Advanced.
Load plug-ins from the effect slots on the player. The slot picker groups plug-ins by manufacturer for easier navigation in large collections.
Click a loaded slot to open the plug-in's native UI.
Audio Units are part of Fidelia's DSP path and are bypassed by Bit-perfect mode.
Opening a slot is instant: your plug-ins appear at once while Fidelia scans them quietly in the background. A slow or unresponsive plug-in won't hold up the list — each is given a moment to respond, then set aside if it doesn't, and stepped around the next time you open the picker, so the slot stays responsive even with a large or misbehaving collection.
Editor Window
When you open a plug-in's editor, Fidelia adds a thin bar at the top of the window with:
Presets — factory presets exposed by the plug-in, plus your saved user states for that slot.
Enabled — per-slot bypass. Toggles processing without unloading the plug-in.
Editor windows open at each plug-in's natural size. Resizing, where supported, is
handled by the plug-in itself inside its view.
Plugin Hosting
Fidelia hosts Audio Unit plug-ins either in-process (loaded directly into
Fidelia's own memory, lowest latency, matches Logic Pro and Fidelia 1.x) or
out-of-process (routed through macOS's AUHostingServiceXPC
sandbox, slightly higher latency, but isolated from Fidelia). The choice is made
per slot — manage it in Settings → Plugins.
Per-Slot Hosting Preference
Each slot has a three-way picker:
Auto (default) — Fidelia decides. Sandbox-safe plug-ins and most legacy plug-ins load in-process. Plug-ins known to trigger macOS authorization dialogs on in-process load (certain PACE-protected titles from Moog, Strymon, UADx, UAD, and similar) are detected by a pre-flight scan and routed straight to out-of-process hosting so the dialogs never appear. Covers the vast majority of plug-ins correctly with no user intervention.
Force Out-of-Process — always route this slot through the XPC sandbox, regardless of what Auto would have chosen. Use this for a plug-in that crashes or misbehaves in-process but isn't caught by Fidelia's scanner.
Force In-Process — always load directly into Fidelia's process, regardless of what Auto would have chosen. May trigger macOS authorization dialogs for PACE-protected plug-ins — approving them unlocks the plug-in. Use this if a scanner-flagged plug-in appears silent or bypassed when hosted out-of-process.
Settings → Plugins
The Plugins pane shows a row per effect slot with:
The plug-in currently loaded in that slot (or (empty)).
The slot's live hosting mode — In-process or Out of process (XPC). Reflects where the plug-in actually ended up after routing, which may differ from the user preference when Auto is selected.
The hosting picker — Auto, Force Out-of-Process, or Force In-Process.
PACE / iLok-Protected Plug-ins
Plug-ins from Moog, Strymon, UAD, UADx, and other PACE- or iLok-protected vendors
need special runtime privileges to load in-process. With Auto (the
default), Fidelia's pre-flight scanner detects these plug-ins and routes them
straight to out-of-process hosting on first load — no authorization dialogs appear.
If you set a slot to Force In-Process and load a PACE-protected
plug-in into it, macOS may present one or more one-time authorization dialogs
(for example, a Lower Security Settings dialog or a PACE licensing alert).
These are macOS / PACE prompts, not Fidelia errors. Approving them unlocks the
plug-in and the dialogs won't appear again for that plug-in.
Hosting preference is per slot, not per plug-in. If you swap a different plug-in into
a slot, the new plug-in inherits the slot's setting. For most users, leaving every
slot on Auto is the right choice — Fidelia's scanner handles
PACE-protected plug-ins correctly without user intervention.
Switching a Loaded Plug-in's Mode
Changing the picker takes effect on the next plug-in load in that slot.
After changing the picker, remove and re-add the plug-in (or relaunch Fidelia) for the change to apply.
A plug-in that works one way may behave differently the other way. If a plug-in sounds bypassed or silent after switching, try the opposite mode.
Format Conversion
Right-click songs in the library and choose Convert Format… to convert between formats.
Sample Rate — Optionally resample to any standard rate (22.05–192 kHz).
Bit Depth — 16-bit or 24-bit for PCM formats. Dither is applied automatically when reducing depth.
AAC Bitrate — 64–320 kbps for AAC output.
Replace Original — Optionally move the source file to Trash after conversion.
Metadata (title, artist, album, artwork, etc.) is preserved in converted FLAC and M4A files.
WAV and AIFF output does not include metadata. To edit metadata after import, see Editing Metadata.
DSD & APE
DSD — DSF and DSDIFF (.dsf, .dff) play directly, decoded to PCM in real time by the engine. Nothing is converted on import and no extra files are written next to your originals. To keep a permanent PCM copy, use Convert Format… to export to ALAC or FLAC.
Monkey's Audio (.ape) is converted to Apple Lossless on import; the converted file plays natively and the original is kept alongside.
Tags are read from each source file — DSF via its embedded ID3v2 chunk, APE via the APEv2 footer. (DSDIFF tag chunks aren't read yet, so a .dff without external tags falls back to its filename.)
Fidelia Remote
Fidelia Remote is the free companion app for iPhone and iPad: your
library, what is playing, and full transport controls, over your own network.
It controls either Fidelia — the one on your Mac, or the one on another
iPhone or iPad. Both advertise themselves the same way, so a handheld playing to the DAC in
the living room is as controllable from the sofa as the Mac is.
Install Fidelia Remote from the App Store.
Put every device on the same Wi-Fi network.
Remote discovers players automatically over Bonjour — nothing to configure. A Mac appears under its computer name, an iPhone or iPad under its device name.
Browse and play your radio Streams, with a live indicator in place of the scrubber.
Recall your nine station presets from the car-radio bank on the transport rail.
iOS asks for Local Network permission the first time, on both the controller and the
player. If discovery finds nothing, that grant is the first thing to check.
Music.app Integration
Enable Music.app integration in Settings → General to browse your Apple Music
library directly in Fidelia. Songs, playlists, and artwork are imported read-only.
Appearance
Settings → General → Appearance chooses how Fidelia draws:
Auto — follow your Mac's Light or Dark setting. This is the default,
and it tracks the system, including a scheduled change at sundown.
Light and Dark — hold that appearance whatever
the Mac is set to.
The player window keeps its dark instrument face in every appearance, exactly as it
does under system Light today.
Sending a Diagnostic Report
Help → Send Diagnostic Report gathers what we need to understand a
problem and opens a message with it attached. It carries the last fifteen minutes of
Fidelia's own log, so the useful order is: reproduce the problem, then send
the report — everything the playback and streaming paths recorded comes with it.
The report contains no audio, and no file paths beyond the names of tracks involved
in whatever went wrong.
Keyboard Shortcuts
Play / Pause
Space
Next Track
⌘→
Previous Track
⌘←
Seek Back / Forward
⌥⌘← / ⌥⌘→
Volume Up / Down (0.5 dB)
⌥⌘↑ / ⌥⌘↓
Recall Station Preset 1–9
⌃1 – ⌃9
Import to Library
⌘O
Add to Preview Playlist
⇧⌘O
Toggle Library
⌘L
Toggle Mini Player
⇧⌘M
Player On Top
⇧⌘T
Large / Medium / Small / Smaller
⌘1 – ⌘4
DIM
⇧⌘D
Mute
⌘M
Find Artwork Online
⌥⌘A
Get Info (selected song[s])
⌘I
All shortcuts are customizable in Settings → Commands.
DSD — DSF, DSDIFF (DFF) — played directly via real-time decode
Monkey's Audio — APE (auto-converted to ALAC on import)
Streaming — internet radio over HTTP and HLS; MP3, AAC, Opus, and Ogg Vorbis streams
Troubleshooting
No audio — Check your output device in Settings → Output. Verify the device is connected and not muted at the hardware level. If using Exclusive Mode, ensure no other app has locked the device. If Bit-perfect mode is on, remember that Fidelia will bypass the DSP chain and force file-rate matching.
Wrong output device or a missing effect right after a reboot — If Fidelia launches before an audio interface, its cloud license, or an iLok is ready, it now waits and recovers as each comes online — restoring your chosen device and effect slots rather than settling for the wrong device or dropping a slot. If something still looks off right after a cold boot, give the hardware a few seconds or relaunch once it's ready.
Library empty after relaunch — The library is stored in ~/Music/Fidelia/. If this folder is missing or permissions were changed, Fidelia cannot persist data. Verify the folder exists and is writable.
Tracks show as offline — Files were moved or the volume is disconnected. Use File → Relocate Missing Tracks to update references, or reconnect the drive.
Music.app library not loading — Ensure Music.app integration is enabled in Settings → General. Grant Fidelia access to your music library in System Settings → Privacy & Security → Media & Apple Music.
Tag-write permission dialog appears — On the first save into a library on an external volume or NAS share, Fidelia asks once for folder access. Granting access here covers every file underneath and persists across launches; you won't be asked again for that library. If you cancel, the database is still updated but the file's embedded tags aren't — re-Save and grant access to retry.
"Saved to library. File could not be updated…" toast — The database edit landed but Fidelia couldn't reach the source file (volume offline, file moved or read-only, format unsupported). Fidelia automatically queues the song and retries on the next launch when the volume is reachable. For permanently-removed files, use File → Clear Pending Tag Writes to empty the queue manually.
Audio Unit not appearing — Ensure the plug-in is installed in ~/Library/Audio/Plug-Ins/Components/ and passes AU validation. Restart Fidelia after installing new plug-ins.
Plug-in shows an authorization dialog on first load — This is a one-time macOS or PACE prompt for PACE- / iLok-protected plug-ins. Usually shouldn't appear in normal use — Fidelia's pre-flight scanner catches these plug-ins and routes them out-of-process automatically. If you see a dialog, you likely set the slot to Force In-Process; approving the dialog unlocks the plug-in, or set the slot back to Auto in Settings → Plugins.
Plug-in fails to load, crashes Fidelia, or shows authorization errors despite being licensed — Set the slot to Force Out-of-Process in Settings → Plugins, then reload the plug-in. This routes it through Apple's XPC host and often works around plug-ins that misbehave in-process.
Plug-in sounds silent or bypassed despite showing its UI — A few plug-ins don't work correctly under out-of-process hosting. Set the slot to Force In-Process in Settings → Plugins, reload the plug-in, and approve any authorization dialogs that appear.
Plug-in appears silent or bypassed — Some plug-ins behave differently in- and out-of-process. Open Settings → Plugins, switch the slot's hosting mode, then reload the plug-in.
Gapless playback gaps — Gapless playback works with all supported formats. If you hear gaps, the source files may have silence encoded at track boundaries.