Skip to content

v1.4.2 — no Homebrew needed, and the prerequisites written down

Choose a tag to compare

@colakang colakang released this 28 Aug 18:40
· 18 commits to main since this release
dd6d631

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 under curl while investigating, which is exactly how it would have shipped.
  • The installer path was interpolated with Python's repr() into an AppleScript literal. repr switches 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 of handles 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 --install

When 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 | sh

Homebrew is documented as optional, because it now is.

379 tests.