docs(macos): recommend notarized downloads
cx
This commit is contained in:
1 file changed
+23
-24
@@ -217,30 +217,9 @@ backends; macOS plays through its own CoreAudio backend, including a Core Audio
|
|||||||
Direct passthrough path for bit-perfect output. Casting (Chromecast/DLNA) and
|
Direct passthrough path for bit-perfect output. Casting (Chromecast/DLNA) and
|
||||||
Qobuz Connect work on macOS as well.
|
Qobuz Connect work on macOS as well.
|
||||||
|
|
||||||
Download the DMG (Apple Silicon or Intel) from
|
**Recommended — signed and notarized:** Afonso Ramos independently maintains a
|
||||||
[Releases](https://github.com/vicrodh/qbz/releases) and drag QBZ into
|
[Homebrew Cask](https://github.com/afonsojramos/homebrew-qbz), which installs
|
||||||
Applications.
|
without requiring a manual Gatekeeper bypass:
|
||||||
|
|
||||||
**First launch:** QBZ is ad-hoc signed but NOT notarized (no Apple Developer
|
|
||||||
subscription), so Gatekeeper will block the first run — and on recent macOS
|
|
||||||
(Sequoia / 15 and later) the old right-click → Open trick no longer works for
|
|
||||||
un-notarized apps. Two ways to unlock it, pick one:
|
|
||||||
|
|
||||||
- **Settings route:** try to open QBZ once (it gets blocked), then go to
|
|
||||||
**System Settings → Privacy & Security**, scroll down to the message that
|
|
||||||
QBZ was blocked, and click **Open Anyway**.
|
|
||||||
- **Terminal route** (what the settings toggle does, minus the clicking):
|
|
||||||
|
|
||||||
```bash
|
|
||||||
xattr -dr com.apple.quarantine /Applications/QBZ.app
|
|
||||||
```
|
|
||||||
|
|
||||||
This removes the quarantine attribute macOS stamps on downloaded files —
|
|
||||||
it's a one-time unlock for this copy of the app; updates installed through
|
|
||||||
QBZ's own updater don't need it again.
|
|
||||||
|
|
||||||
**Community alternative — signed and notarized:** Afonso Ramos independently
|
|
||||||
maintains a [Homebrew Cask](https://github.com/afonsojramos/homebrew-qbz):
|
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
brew install --cask afonsojramos/qbz/qbz
|
brew install --cask afonsojramos/qbz/qbz
|
||||||
@@ -255,6 +234,26 @@ endorsed by the upstream project. The mirror publishes the source commit,
|
|||||||
original checksums, and signed checksums for each release; see its
|
original checksums, and signed checksums for each release; see its
|
||||||
[trust and provenance documentation](https://github.com/afonsojramos/qbz-macos#trust-and-provenance).
|
[trust and provenance documentation](https://github.com/afonsojramos/qbz-macos#trust-and-provenance).
|
||||||
|
|
||||||
|
**Official upstream alternative — ad-hoc signed, not notarized:** if you prefer
|
||||||
|
the artifact produced directly by the QBZ project, download the Apple Silicon
|
||||||
|
or Intel DMG from [QBZ Releases](https://github.com/vicrodh/qbz/releases) and
|
||||||
|
drag QBZ into Applications. Because the project has no Apple Developer
|
||||||
|
subscription, Gatekeeper blocks its first run. On recent macOS versions
|
||||||
|
(Sequoia / 15 and later), unlock it using either route:
|
||||||
|
|
||||||
|
- **Settings route:** try to open QBZ once (it gets blocked), then go to
|
||||||
|
**System Settings → Privacy & Security**, scroll down to the message that
|
||||||
|
QBZ was blocked, and click **Open Anyway**.
|
||||||
|
- **Terminal route** (what the settings toggle does, minus the clicking):
|
||||||
|
|
||||||
|
```bash
|
||||||
|
xattr -dr com.apple.quarantine /Applications/QBZ.app
|
||||||
|
```
|
||||||
|
|
||||||
|
This removes the quarantine attribute macOS stamps on downloaded files —
|
||||||
|
it's a one-time unlock for this copy of the app; updates installed through
|
||||||
|
QBZ's own updater don't need it again.
|
||||||
|
|
||||||
## Features
|
## Features
|
||||||
|
|
||||||
### Audio and playback
|
### Audio and playback
|
||||||
|
|||||||
Reference in new issue
Block a user