From 333f8f2ed58be10c06fd97c06788f3791296320d Mon Sep 17 00:00:00 2001 From: Aditya Date: Mon, 22 Jun 2026 14:55:39 +0530 Subject: [PATCH] docs: improve macos gatekeeper warning --- README.md | 8 +++++++- 1 file changed, 7 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index 0ff63e6..dfbf3d6 100644 --- a/README.md +++ b/README.md @@ -49,7 +49,13 @@ brew install --cask papercache **Direct download:** grab the latest `.app` or `.exe` from [Releases](https://github.com/VariableThe/PaperCache/releases). -> If macOS blocks the app, run: `xattr -cr /Applications/PaperCache.app` +⚠️ **Note on macOS Gatekeeper ("App is damaged" error)** Because PaperCache is an open-source utility and is not code-signed with a paid Apple Developer ID, macOS will apply a quarantine flag to the application upon manual download, throwing a false "damaged app" warning. + +To fix this, simply open your Terminal and run the following command to strip the quarantine flag: + +```bash +xattr -cr /Applications/PaperCache.app +``` ---