From c51e60b6e17eba89b022c54801f606985dc97067 Mon Sep 17 00:00:00 2001 From: Jatin K Malik Date: Mon, 15 Jun 2026 11:44:21 -0700 Subject: [PATCH] docs: trust Homebrew tap for installs --- README.md | 4 ++-- docs/HOMEBREW.md | 20 +++++++++++--------- web/layouts/index.html | 4 ++-- 3 files changed, 15 insertions(+), 13 deletions(-) diff --git a/README.md b/README.md index 5f06114..2c2d62e 100644 --- a/README.md +++ b/README.md @@ -129,7 +129,7 @@ VocaMac requires three macOS permissions: ```bash brew tap jatinkrmalik/vocamac -brew trust --cask jatinkrmalik/vocamac/vocamac +brew trust jatinkrmalik/vocamac brew install --cask vocamac ``` @@ -198,7 +198,7 @@ Nightly builds are automated builds from the latest `main` branch, published eve **Via Homebrew (recommended):** ```bash brew tap jatinkrmalik/vocamac -brew trust --cask jatinkrmalik/vocamac/vocamac-nightly +brew trust jatinkrmalik/vocamac brew install --cask vocamac-nightly ``` diff --git a/docs/HOMEBREW.md b/docs/HOMEBREW.md index 75d53fa..e3e0958 100644 --- a/docs/HOMEBREW.md +++ b/docs/HOMEBREW.md @@ -16,7 +16,7 @@ Since VocaMac is a native macOS `.app` primarily distributed via Homebrew (with ```bash # Install brew tap jatinkrmalik/vocamac -brew trust --cask jatinkrmalik/vocamac/vocamac +brew trust jatinkrmalik/vocamac brew install --cask vocamac # Upgrade to latest version @@ -29,13 +29,15 @@ brew untap jatinkrmalik/vocamac After installation, VocaMac appears in `/Applications/VocaMac.app`. Launch it from Spotlight or the Applications folder. +`brew trust jatinkrmalik/vocamac` trusts the whole VocaMac tap. This is intentional: the stable and nightly casks conflict with each other, so Homebrew may load both cask definitions while resolving an install. + ## Nightly Builds A nightly cask is also available, built daily from the latest `main` branch: ```bash brew tap jatinkrmalik/vocamac -brew trust --cask jatinkrmalik/vocamac/vocamac-nightly +brew trust jatinkrmalik/vocamac brew install --cask vocamac-nightly ``` @@ -45,7 +47,7 @@ The nightly cask uses `version :latest` and `sha256 :no_check` because the DMG c ```bash brew uninstall --cask vocamac -brew trust --cask jatinkrmalik/vocamac/vocamac-nightly +brew trust jatinkrmalik/vocamac brew install --cask vocamac-nightly ``` @@ -85,7 +87,7 @@ Users can then install with: ```bash brew tap jatinkrmalik/vocamac -brew trust --cask jatinkrmalik/vocamac/vocamac +brew trust jatinkrmalik/vocamac brew install --cask vocamac ``` @@ -96,7 +98,7 @@ Before pushing a cask update to the tap, test it from a tap checkout against a r ```bash brew tap jatinkrmalik/vocamac cp homebrew/Casks/vocamac.rb "$(brew --repository jatinkrmalik/vocamac)/Casks/vocamac.rb" -brew trust --cask jatinkrmalik/vocamac/vocamac +brew trust jatinkrmalik/vocamac brew install --cask vocamac ``` @@ -243,18 +245,18 @@ A previous installation exists at `/Applications/VocaMac.app`. **Fix:** Remove the existing app first: ```bash rm -rf /Applications/VocaMac.app -brew trust --cask jatinkrmalik/vocamac/vocamac +brew trust jatinkrmalik/vocamac brew install --cask vocamac ``` ### Homebrew refuses to load the cask from an untrusted tap -Homebrew 6 requires explicit trust for casks from third-party taps. +Homebrew 6 requires explicit trust for casks from third-party taps. Trust the VocaMac tap rather than only one cask, because the stable and nightly casks declare `conflicts_with` and Homebrew may load the other cask while resolving an install. -**Fix:** Trust the VocaMac cask, then install again: +**Fix:** Trust the VocaMac tap, then install again: ```bash -brew trust --cask jatinkrmalik/vocamac/vocamac +brew trust jatinkrmalik/vocamac brew install --cask vocamac ``` diff --git a/web/layouts/index.html b/web/layouts/index.html index 371c772..76c2d2d 100644 --- a/web/layouts/index.html +++ b/web/layouts/index.html @@ -123,7 +123,7 @@

$ brew tap jatinkrmalik/vocamac -$ brew trust --cask jatinkrmalik/vocamac/vocamac +$ brew trust jatinkrmalik/vocamac $ brew install --cask vocamac
@@ -417,7 +417,7 @@

Install via Homebrew

$ brew tap jatinkrmalik/vocamac -$ brew trust --cask jatinkrmalik/vocamac/vocamac +$ brew trust jatinkrmalik/vocamac $ brew install --cask vocamac