Repository navigation
v1.4.2 — no Homebrew needed, and the prerequisites written down
Both of these came from someone installing it on their own Mac for the first time.
setup no longer needs Homebrew
It stopped at "Homebrew is not installed", and told you to fetch the driver by hand from a page that asks for an email address first. Requiring a package manager to install one audio driver is a poor trade.
Homebrew is still used where it exists — the driver is tracked and brew uninstall --cask blackhole-2ch removes it. Where it does not, the package is downloaded from the vendor and installed directly, with its checksum verified before anything runs. The URL and checksum come from Homebrew's cask metadata, so the version tracks what is current without Homebrew being present.
Two things found by actually running it:
- The vendor's CDN answers urllib's default User-Agent with
406 Not Acceptable, so without a header this failed for every user on the first request. It worked undercurlwhile investigating, which is exactly how it would have shipped. - The installer path was interpolated with Python's
repr()into an AppleScript literal.reprswitches to double quotes when the value contains a single one, and the literal it sits inside is double-quoted — a home directory belonging to anyone called O'Brien would end the string early, and it would surface at the password prompt.quoted form ofhandles the shell layer now, explicit escaping the AppleScript one.
The prerequisites are written down
Command Line Developer Tools. macOS ships stubs for git and the compilers; touching one pops a dialog demanding the tools, and it can appear part-way through an install, which reads as a failure.
xcode-select --installWhen they are already present this says so and exits non-zero — which also reads as a failure, so the README says that too.
uv. The first install command assumed it and never said where to get it. That matters more than convenience: this needs Python 3.12 or 3.13, and the Python on a Mac is 3.9 (Apple's) or 3.14 (Homebrew's).
curl -LsSf https://astral.sh/uv/install.sh | shHomebrew is documented as optional, because it now is.
379 tests.