/BlackHole

BlackHole is a modern macOS virtual audio driver that allows applications to pass audio to other applications with zero additional latency.

Primary LanguageCGNU General Public License v3.0GPL-3.0

BlackHole Virtual Audio Driver v0.2

Platform:macOS GitHub GitHub All Releases GitHub Build Status

Twitter Follow

Description

BlackHole is a modern MacOS virtual audio driver that allows applications to pass audio to other applications with zero additional latency.

Features

  • Supports 16 audio channels.
  • Customizable to 256+ channels if you think your computer can handle it.
  • Supports 44.1kHz, 48kHz, 88.2kHz, 96kHz, 176.4kHz, and 192kHz sample rates.
  • No additional driver latency.
  • Works on macOS 10.10+ including macOS 10.15 Catalina

Image of BlackHole Audio Driver

Easy Installation Instructions

  1. Download BlackHole.vx.x.x.pkg
  2. Close all running audio applications
  3. Right-click on package and select open
  4. Open and install package
  5. Restart Computer (Catalina Only)

BlackHole is also available using brew cask install blackhole

Visit the Wiki for application specific setup.

Usage Examples

Record System Audio

  1. Open Audio MIDI Setup
  2. Right-click on "BlackHole" and select "Use This Device For Sound Output"
  3. Open DAW and set input device to "BlackHole"
  4. Set track to input from channel 1-2
  5. Play audio from another application and monitor or record in your DAW.

Route Audio Between Applications

  1. Set output driver to "BlackHole" in sending application
  2. Output audio to any channel
  3. Open receiving application and set input device to "BlackHole"
  4. Input audio from the corresponding output channels

Advanced Installation Instructions

  1. Build driver in Xcode
  2. Copy BlackHole.driver to /Library⁩/Audio⁩/Plug-Ins⁩/HAL
  3. Restart CoreAudio with terminal command sudo killall coreaudiod

Advanced Customization

  1. In "BlackHole.h" change NUMBER_OF_CHANNELS to the desired number of channels.
  2. Follow Advanced Installation Instructions

Uninstallation Instructions

  1. Delete BlackHole.driver from /Library⁩/Audio⁩/Plug-Ins⁩/HAL
  2. Restart computer or restart CoreAudio with terminal command sudo killall coreaudiod

Feature Requests

If you are interested in any of the following features please leave a comment in the linked issue. If you want any features not listed please create a new issue.

FAQ

Why isn't BlackHole showing up in the Applications folder?

BlackHole is an audio interface driver. It only shows up in Audio MIDI Setup, Sound Preferences, or other audio applications.

How can I listen to the audio and use BlackHole at the same time?

Setup a Multi-Output Device

How can I change the volume of a Multi-Output device?

Unfortunately macOS does not support changing the volume of a Multi-Output device but you can set the volume of individual devices in Audio MIDI Setup.

How can I use BlackHole with Audacity in Catalina?

Audacity is not compatible with Catalina. But there might be a work around.

Why is nothing is playing through BlackHole?

Check System Preferences -> Security & Privacy -> Privacy -> Microphone to make sure your DAW has microphone access.

Check that the volume is all the way up on BlackHole input and output in Audio Midi Setup.

Can I integrate BlackHole into my app?

BlackHole is licensed under GPL-3.0. You can use BlackHole as long as your app is also licensed as GPL-3.0. For all other applications contact me directly at devinroth@existential.audio.

You are awesome. Where can I donate?

Support us on Patreon

Bitcoin: 1DxkhWHfRUBezMNbRM3rDKLbxEi1GVZRXz

Litecoin: LchR249L8aXnDEDToLpPVSJotuvV381Yka