Build with Xcode

Jump to bottom

Steffan Andrews edited this page Oct 23, 2023 · 14 revisions

1. Download Xcode

Search for "Xcode" in the macOS App Store.
Click Get to download and install it. If already installed, it will show an Open button instead.

2. Clone BlackHole

Open Xcode.
In the menu bar on the top click on Source Control → Clone.
Paste https://github.com/ExistentialAudio/BlackHole.git in the search bar.
Click Clone and choose a download location.

3. Build BlackHole

In the BlackHole folder, open BlackHole.xcodeproj with Xcode.
To build, click the play button near the top left of the project window, or use the ⌘B keyboard shortcut.

NOTE: If you are having issues with signing unselect Automatically manage signing and make sure Team is set to None.

4. Install

From the menu select Product → Show Build Folder in Finder.
Copy BlackHole.driver and paste in /Library/Audio/Plug-Ins/HAL/
Restart Core Audio with the following Terminal command. It will require entering your user password to complete.

sudo launchctl kickstart -kp system/com.apple.audio.coreaudiod