BlackHole Studio  (RandomPlanet build)
=====================================

One driver, two virtual audio devices that behave like the two ends of a multichannel cable:

  BlackHole Studio   30 in / 30 out   -> add this one to your DAW's aggregate device
  BlackHole Stage    30 in / 30 out   -> pick this one in SonoBus, OBS, browsers, or as the Mac's output

Audio sent to an OUTPUT of one device arrives on the same-numbered INPUT of the other.
A device never hears its own outputs, exactly like a hardware interface.

Channel map (same at both ends; the number is the wire):
  1-2    BH Mac L / BH Mac R     Mac system audio -> DAW (set the Mac output to BlackHole Stage)
  3      BH Talkback             DAW -> players
  4      BH Click                DAW -> players
  5-6    BH Aux L / BH Aux R     DAW -> stream / recorder feed
  7-30   BH IN 1-24 / BH OUT 1-24   general lines (players, sends, anything)

Setup
  1. Run the installer (BlackHole_Studio package, or Install_BlackHole_Studio.command). It asks for your
     admin password and restarts the audio service. A newer version installed over an older one replaces it.
  2. Audio MIDI Setup: add "BlackHole Studio" to your aggregate. Keep your interface as clock
     source. Turn Drift Correction ON for BlackHole Studio only.
  3. Point SonoBus (input AND output) at "BlackHole Stage".
  4. Optional: System Settings > Sound > Output = "BlackHole Stage" to bring Mac audio into the DAW
     on BH Mac L/R. You then hear Mac audio only through your DAW.

Notes
  - Studio and Stage share one sample rate; set it on your aggregate / clock master, not on Stage.
  - You can rename any channel in Audio MIDI Setup; DAWs and SonoBus pick up your names.
  - Requires macOS 10.15 Catalina or newer, Intel or Apple silicon.
  - Uninstall with Uninstall_BlackHole_Studio.command.

License
  Based on BlackHole by Existential Audio Inc., GNU GPL v3. Modifications by RandomPlanet.
  Source code for this build is provided alongside this download (BlackHole_Studio_src.tar.gz). Release history: RELEASES.md inside the source.
