README

!BlackHole: Audio Loopback Driver

 BlackHole: Audio Loopback Driver

!Platform: macOS





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

 Download Installer 

 Join the Discord Server

 Sponsors

 Recall.ai - API for desktop recording

If you’re looking for a desktop recording API, consider checking out Recall.ai, an API that records video, audio, and transcripts from Zoom, Google Meet, Microsoft Teams, in-person meetings, and more.

To sponsor this project visit https://github.com/sponsors/ExistentialAudio

 Table of Contents

- Features
- Installation Instructions
- Uninstallation Instructions
- User Guides
- Developer Guides
- Feature Requests
- FAQ
- Wiki

 Features

- Builds 2, 16, 64, 128, and 256 audio channels versions
- Customizable channel count, latency, hidden devices
- Customizable mirror device to allow for a hidden input or output
- Supports 8kHz, 16kHz, 44.1kHz, 48kHz, 88.2kHz, 96kHz, 176.4kHz, 192kHz, 352.8kHz, 384kHz, 705.6kHz and 768kHz sample rates
- Zero additional driver latency
- Compatible with macOS 10.10 Yosemite and newer
- Builds for Intel and Apple Silicon
- No kernel extensions or modifications to system security necessary

!Audio MIDI Setup

 Installation Instructions

 Option 1: Download Installer

1. Download the latest installer
2. Close all running audio applications
3. Open and install package
4. Restart your system when prompted

 Option 2: Install via Homebrew

- 2ch: brew install blackhole-2ch
- 16ch: brew install blackhole-16ch
- 64ch: brew install blackhole-64ch

 Uninstallation Instructions

 Option 1: Use Uninstaller

- Download BlackHole 2ch Uninstaller
- Download BlackHole 16ch Uninstaller
- Download BlackHole 64ch Uninstaller

 Option 2: Manually Uninstall

1. Delete the BlackHole driver with the terminal command:
   
    rm -R /Library/Audio/Plug-Ins/HAL/BlackHoleXch.driver 
   
   Be sure to replace X with either 2, 16, or 64.
   
   Note that the directory is the root /Library not /Users/user/Library.

2. Restart CoreAudio with the terminal command:

    sudo killall -9 coreaudiod

For more specific details visit the Wiki.

 User Guides

 Logic Pro X

- Logic Pro X to FaceTime
- Logic Pro X to Google Meet
- Logic Pro X to Skype
- Logic Pro X to Zoom

 GarageBand

- GarageBand to FaceTime
- GarageBand to Google Meet
- GarageBand to Skype
- GarageBand to Zoom

 Audacity

- Audacity Setup

 Reaper

- Reaper to Zoom by Noah Liebman

 Record System Audio

1. Setup Multi-Output Device
2. In Audio MIDI Setup → Audio Devices right-click on the newly created Multi-Output and select "Use This Device For Sound Output"
3. Open digital audio workstation (DAW) such as GarageBand 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 ap

Top issues

Discussions

Latest release

Changed
Add better permissions for preinstall and postinstall scripts
FirmwareVersion uses plist version

Full Changelog: https://github.com/ExistentialAudio/BlackHole/compare/v0.7.0...v0.7.1