BlackHole

BlackHole: 音频回环驱动

BlackHole是一款现代macOS虚拟音频回环驱动程序，允许应用程序以零额外延迟将音频传递给其他应用程序。

下载安装程序

加入Discord服务器

资助

赞助: https://github.com/sponsors/ExistentialAudio

特性

构建2、16、64、128和256音频通道版本
可自定义通道数、延迟、隐藏设备
可自定义镜像设备，允许隐藏输入或输出
支持8kHz、16kHz、44.1kHz、48kHz、88.2kHz、96kHz、176.4kHz、192kHz、352.8kHz、384kHz、705.6kHz和768kHz采样率
零额外驱动延迟
兼容macOS 10.10 Yosemite及更新版本
为Intel和Apple Silicon构建
无需内核扩展或修改系统安全性

音频MIDI设置

安装说明

选项1：下载安装程序

下载最新安装程序
关闭所有正在运行的音频应用程序
打开并安装软件包

选项2：通过Homebrew安装

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

卸载说明

选项1：使用卸载程序

选项2：手动卸载

使用终端命令删除BlackHole驱动程序：

rm -R /Library/Audio/Plug-Ins/HAL/BlackHoleXch.driver

确保将X替换为2、16或64。

注意，目录是根目录/Library，而不是/Users/user/Library。
使用终端命令重启CoreAudio：

sudo killall -9 coreaudiod

更多具体细节请访问Wiki。

用户指南

Logic Pro X

GarageBand

Reaper

Reaper到Zoom 作者：Noah Liebman

录制系统音频

设置多输出设备
在音频MIDI设置→音频设备中右键点击新创建的多输出设备，选择"将此设备用于声音输出"
打开数字音频工作站（DAW），如GarageBand，将输入设备设置为"BlackHole"
将轨道设置为从通道1-2输入
从其他应用程序播放音频，并在DAW中监听或录制

在应用程序之间路由音频

在发送应用程序中将输出驱动程序设置为"BlackHole"
将音频输出到任何通道
打开接收应用程序，将输入设备设置为"BlackHole"
从相应的输出通道输入音频

开发者指南

所有非GPLv3项目都需要许可证

请支持我们的辛勤工作和持续开发。要请求许可证，请联系Existential Audio。

构建和安装

构建完成后，安装BlackHole：

将构建好的BlackHoleXch.driver包复制或移动到/Library/Audio/Plug-Ins/HAL
使用sudo killall -9 coreaudiod重启CoreAudio

自定义BlackHole

可以使用以下预编译常量轻松自定义BlackHole的构建。

kDriver_Name
kPlugIn_BundleID
kPlugIn_Icon

kDevice_Name
kDevice_IsHidden
kDevice_HasInput
kDevice_HasOutput

kDevice2_Name
kDevice2_IsHidden
kDevice2_HasInput
kDevice2_HasOutput

kLatency_Frame_Size
kNumber_Of_Channels
kSampleRates

可以在构建时使用xcodebuild的GCC_PREPROCESSOR_DEFINITIONS指定这些常量。

示例：

xcodebuild \
  -project BlackHole.xcodeproj \
  GCC_PREPROCESSOR_DEFINITIONS='$GCC_PREPROCESSOR_DEFINITIONS kSomeConstant=value'

使用字符串时请确保转义任何引号。

重命名BlackHole

要自定义BlackHole，需要更改以下常量：

kDriver_Name
kPlugIn_BundleID（注意，这必须与目标bundleID匹配）
kPlugIn_Icon

可以使用xcodebuild将这些指定为预编译常量。

driverName="BlackHole"
bundleID="audio.existential.BlackHole"
icon="BlackHole.icns"

xcodebuild \
  -project BlackHole.xcodeproj \
  -configuration Release \
  PRODUCT_BUNDLE_IDENTIFIER=$bundleID \
  GCC_PREPROCESSOR_DEFINITIONS='$GCC_PREPROCESSOR_DEFINITIONS
  kDriver_Name=\"'$driverName'\"
  kPlugIn_BundleID=\"'$bundleID'\"
  kPlugIn_Icon=\"'$icon'\"'

自定义通道、延迟和采样率

kNumber_Of_Channels用于设置通道数。指定高通道数时要小心。虽然BlackHole在高通道数下设计得非常高效，但你的计算机可能无法跟上。采样率也起作用。不要在高通道数下使用高采样率。一些应用程序不知道如何处理高通道数。请谨慎操作。

kLatency_Frame_Size是驱动程序处理传入和传出音频所需的时间（以帧为单位）。它可以用来延迟BlackHole内部的音频，最多可达65536帧。如果在高通道数下使用BlackHole，这可能会有帮助。

kSampleRates设置音频设备的采样率。如果使用多个采样率，请用逗号（,）分隔。例如：kSampleRates='44100,48000'。

镜像设备

默认情况下，BlackHole有一个隐藏的镜像音频设备。可以使用以下常量自定义设备。

// 原始设备
kDevice_IsHidden
kDevice_HasInput
kDevice_HasOutput

// 镜像设备
kDevice2_IsHidden
kDevice2_HasInput
kDevice2_HasOutput

当所有设置为true时，将出现第二个完全相同的BlackHole。输入和输出是镜像的，因此两个设备的输出都会进入两个设备的输入。

如果需要单独的输入和输出设备，这很有用。

示例

// 原始设备
kDevice_IsHidden=false
kDevice_HasInput=true
kDevice_HasOutput=false

// 镜像设备
kDevice2_IsHidden=false
kDevice2_HasInput=false
kDevice2_HasOutput=true

在这种情况下，我们有两个BlackHole设备。一个只有输入，另一个只有输出。

在项目中使用这种方法的一种方式是隐藏镜像设备，并在后台使用它。这样用户将看到一个仅输入的设备，同时在后台通过输出路由音频。

可以使用kAudioHardwarePropertyTranslateUIDToDevice访问隐藏的音频设备。