Overview

The Diretta CoreAudio Driver for macOS allows macOS applications such as Roon, Audirvana, and other CoreAudio-compatible players to stream bit-perfect audio directly to Diretta Targets on your local network.

The installer sets up:

  • DirettaAudio.driver: A CoreAudio HAL virtual output driver (/Library/Audio/Plug-Ins/HAL/DirettaAudio.driver).
  • syncCore: A background system service (LaunchDaemon) that automatically discovers Diretta Targets on your network and starts automatically when macOS boots.

Key Features

  • Bit-Perfect PCM (16 / 24 / 32-bit Signed Integer, automatic sample rate switching)
  • DoP to Native DSD: Automatically detects DSD over PCM (DoP) streams and transmits Native DSD directly to your Diretta Target
  • Automatic Background Service: Runs continuously in the background with no manual startup required
  • Apple Signed & Notarized: Installs smoothly via the standard macOS .pkg installer

System Requirements

  • Mac: Apple Silicon (M1 / M2 / M3 / M4 or later)
  • Network: Connected to the same local network (LAN) as your Diretta Target

Installation

  1. Download the installer package (DirettaCoreAudioDriver-x.xxx.x-arm64.pkg).
  2. If you are upgrading an existing installation, stop playback in your audio player app (such as Roon or Audirvana) first.
  3. Double-click the .pkg file and follow the on-screen instructions.
  4. Enter your macOS administrator password when prompted.

Once installation finishes, the syncCore background service and CoreAudio driver start automatically — no reboot is required. Discovered Diretta Targets will appear in macOS Sound settings and your audio player as:

<Target Name> : <Sink Name>

Tip: If your audio player was already open before installation, restart the player app so it refreshes the audio device list.

Recommended Audio Player Settings (Roon / Audirvana)

For best sound quality and proper sample rate / DSD switching:

  1. Select your Diretta device (<Target Name> : <Sink Name>) as the output device.
  2. Enable Exclusive Mode (required for bit-perfect output and automatic sample rate switching).
  3. DSD Playback: Select DSD over PCM (DoP) in your player settings. The Diretta CoreAudio Driver automatically detects the DoP stream and converts it to Native DSD over the Diretta protocol before sending it to your Target.

Configuration File

The configuration file is located at:

/Library/Application Support/Diretta/synccore_setting.inf

Your existing configuration file is preserved when upgrading to a newer version. For details on available parameters, please refer to our common Diretta Host configuration guide.

After editing the configuration file, restart the background service in Terminal to apply changes:

sudo launchctl kickstart -k system/com.diretta.synccore

Troubleshooting

Diretta Target does not appear

  • Confirm that your Mac and Diretta Target are on the same local network and the Target is powered on.
  • Check that the background service is running in Terminal:
    sudo launchctl print system/com.diretta.synccore | head -n 20
  • Restart CoreAudio if needed:
    sudo killall coreaudiod

No sound or playback issues after upgrading

  • Quit and reopen your audio player app (e.g., Roon / Audirvana), or restart your Mac to clear any previous Exclusive Mode session.

Logs

Service logs are located in:

/Library/Logs/Diretta/

Uninstallation

To completely remove the driver and background service, open Terminal and run:

sudo "/Library/Application Support/Diretta/uninstall.sh"

This stops and unregisters the background service, removes the CoreAudio driver and support files, and restarts coreaudiod.