Remove, disable or rescan macOS Audio Units plug-ins in Logic Pro for Mac or MainStage

Find out what to do if you're using third-party Audio Units plug-ins and Logic Pro or MainStage isn't working correctly, or if you can't find a recently installed plug-in.

Try these recommendations depending on what you're experiencing:

• If you can open Logic Pro or MainStage but you’re experiencing issues with your project or concert, remove Audio Units plug-ins from your project.

• If you can’t open Logic Pro or MainStage, disable Audio Units plug-ins.

• If you can't find a recently installed plug-in, restart your Mac, confirm the plug-in has been installed and rescan your plug-ins.

Before you start troubleshooting Audio Units plug-ins, check with the manufacturer to see if the plug-in is compatible with your version of macOS and if an update is available.

Remove Audio Units plug-ins from your project or concert

If you’re experiencing an issue in a particular Logic Pro project that uses Audio Units plug-ins, open Logic Pro without Audio Units plug-ins first. If that fixes your issue, you can then remove individual Audio Units plug-ins from your project to determine if a particular plug-in is causing the issue.

If you're having an issue with a MainStage concert, start troubleshooting by removing individual Audio Units plug-ins from the concert.

Open Logic Pro without Audio Units

1. Close Logic Pro if it’s open.

2. Open Logic Pro and immediately press and hold the Control key before a project opens.

3. In the alert, click Launch Without Audio Units.

4. Open the project you’re troubleshooting.

If this resolves the issue, remove individual Audio Units plug-ins from your Logic Pro project.

If this doesn’t resolve the issue, try other troubleshooting methods.

Remove individual Audio Units plug-ins from your Logic Pro project or MainStage concert

If opening Logic Pro without Audio Units fixes your issue in Logic Pro, remove individual Audio Units from your Logic Pro project to isolate the plug-in that’s causing your issue. You can also use this method to troubleshoot Audio Units plug-ins in MainStage.

1. If you opened Logic Pro without Audio Units, close Logic Pro.

2. Open Logic Pro or MainStage, then open the project or concert you’re experiencing issues with.

3. Save a copy of your project or concert.

4. Close the original project or concert.

5. Open the copy of the project or concert, then remove one Audio Units plug-in from the project or concert:

   • Place the cursor over the slot of a channel strip that contains an Audio Units plug-in.

   • Click the arrows that appear to the right.

   • Choose No Plug-in from the pop-up menu.

6. Try to recreate the issue.

If the issue isn’t resolved, remove another Audio Units plug-in, testing after each time you remove a plug-in.

If the issue is resolved, reinstall the plug-in or check with the manufacturer for updates or further support. You can also replace the plug-in with a similar plug-in from Apple or a different manufacturer.

Disable Audio Units plug-ins

If you can’t open Logic Pro or MainStage, move the installed files for third-party Audio Units plug-ins. You may also want to move a plug-in file if you found that a particular plug-in is causing an issue in a project.

1. If you can’t find the files in that location, check the Library in your Home folder. From the Finder menu bar, choose Go > Go to Folder, type “~/Library/Audio/Plug-Ins/Components” into the Go to Folder field, then click Go.

   If you can't find the files in that location, check the Library in your Home folder. From the Finder menu bar, choose Go > Go to Folder, type “~/Library/Audio/Plug-Ins/Components” into the Go to Folder field, then click Go.

2. If you suspect a particular plug-in may be causing the issue, locate the file for the plug-in in the folder, then drag the file to the Desktop or another location, such as a folder dedicated for this procedure.

3. Restart your Mac.

4. Try to reopen Logic Pro.

If you still can't open Logic Pro or MainStage:

1. Create a new folder on the Desktop.

2. Move all of the plug-in files that appear in their installation locations to the new folder.

3. Try to open Logic Pro or MainStage.

4. If you can open the app, replace each plug-in file to its original location one at a time. Exit and reopen the app after you've replaced each plug-in file.

5. If you can't open the app after replacing a particular plug-in file, that plug-in may have been corrupted or is incompatible. Try reinstalling the plug-in or check with the manufacturer to see if there's an update.

Find a recently installed plug-in for Logic Pro or MainStage

If you installed a third-party Audio Units plug-in but it's not available in Logic Pro or MainStage, try following the steps provided in this section in the order they're listed until your plug-in is available.

Restart your Mac

If your Mac is running macOS High Sierra or later and you've recently installed a plug-in that isn't available in Logic Pro or MainStage, restart your Mac. Before you restart your Mac, confirm that the plug-in is 64-bit compatible. 32-bit plug-ins aren't compatible with Logic Pro or MainStage.

1. Choose Apple menu  > Restart.

2. Open Logic Pro or MainStage.

3. Click an Audio Effect, Instrument or MIDI Effect slot to see if the plug-in is available in the pop-up menu.

If the plug-in still isn't available in Logic Pro or MainStage, make sure the plug-in has been installed.

Make sure the plug-in has been installed

Use the Plug-in Manager to check if the plug-in has been installed.

1. Choose Logic Pro > Settings (or Preferences) > Plug-in Manager, or MainStage > Settings (or Preferences) > Plug-in Manager.

2. If "not authorised" appears in the Compatibility column for the plug-in, make sure the plug-in has been authorised correctly as documented by the manufacturer.

   If “not authorized” appears in the Compatibility column for the plug-in, make sure the plug-in is properly authorized as documented by the manufacturer.

3. Reinstall the plug-in, then restart the computer.

4. Open Logic Pro or MainStage, then check the Plug-in Manager to see if the plug-in appears there. If it does, open a project or concert and make sure the plug-in is available.

5. If the plug-in appears in the Plug-in Manager but is not available in a Logic Pro project or MainStage concert, rescan the plug-in.

6. If you still can't find the plug-in in the Plug-in Manager, reset all Audio Units.

Rescan a plug-in

If the plug-in appears in the Plug-in Manager but still isn't available in Logic Pro or MainStage, rescan the plug-in.

1. In the plug-in Manager, locate the plug-in you want to check. To filter the list by manufacturer, click manufacturer's name in the left-hand column.

2. If "not authorised" appears in the Compatibility column for the plug-in, make sure the plug-in has been authorised correctly as documented by the manufacturer, then rescan the plug-in.

   If “not authorized” appears in the Compatibility column for the plug-in, make sure the plug-in is properly authorized as documented by the manufacturer, then rescan the plug-in.

3. If the plug-in fails validation again, check with the manufacturer to see if the plug-in is compatible with your version of macOS and for possible updates.

4. If the plug-in doesn't appear in the plug-in manager, try resetting all Audio Units.

Reset all Audio Units in Logic Pro and MainStage

If you can't find a recently installed plug-in in the Plug-In Manager in or MainStage, try resetting all Audio Units using the Logic Pro Plug-in Manager. Resetting Audio Units in Logic Pro will also reset them for MainStage.

1. Choose Logic Pro > Settings (or Preferences) > Plug-In Manager.

2. Click Full Audio Unit Reset.

3. Close Logic Pro, then reopen it. Logic Pro will rescan all installed Audio Units plug-ins.

4. Check Logic Pro or MainStage to see if the plug-in is available.

If the plug-in is still not available, check with the manufacturer to see whether the plug-in is compatible with your version of macOS and if there are any updates available.

Rescan Audio Units plug-ins in all apps

As a last resort for troubleshooting any app that has validation or other issues with a specific Audio Units plug-in, remove AudioUnitCache files manually to force a full rescan. You can also do this to rescan MainStage plug-ins if you don’t also use Logic Pro on the same Mac.

1. In the Finder, press and hold the Option key, then choose Go > Library.

2. In the Finder window that opens, locate the AudioUnitCache folder in the Caches folder.

3. Move the files from the AudioUnitCache folder to the Desktop or another location, such as a folder dedicated to this procedure.

4. Restart the computer, then open MainStage. All installed Audio Units plug-ins will be rescanned. If the plug-in is still not available, check with the manufacturer to see whether the plug-in is compatible with your version of macOS and if there are any updates available.

Find out more

• About dynamic plug-in loading in Logic Pro

• Use the Plug-In Manager