note

Reset macOS MIDI Config

The macOS MIDI configuration can become corrupted after experimenting with network MIDI sessions or other MIDI setup changes, leaving ghost devices or sessions that cannot be removed or used. This page describes how to completely reset it.

Symptoms

You may have ghost network sessions or devices that appear in Audio MIDI Setup but cannot be removed or configured.

Example with a ghost session/device named “foo”:

ghost device 'foo' visible in Audio MIDI Setup
ghost device 'foo' visible in Audio MIDI Setup
ghost session 'foo' persists after attempts to remove it
ghost session 'foo' persists after attempts to remove it
ghost session 'foo' visible in a MIDI tool
ghost session 'foo' visible in a MIDI tool

Reset procedure

Close Audio MIDI Setup if it is open, then delete the macOS MIDI configuration:

rm ~/Library/Preferences/ByHost/com.apple.MIDI.*.plist

The wildcard is intentional, the filename contains a machine-specific UUID. The file will be regenerated automatically on next launch.

Re-open Audio MIDI Setup. The configuration should now be blank, showing only the default devices.

Notes