Simple CLI tool for removing the com.apple.quarantine extended attribute from files on macOS built on go.
- Platform: only macOS
- Requires: homebrew installed
- Permissions: Modifying some files may require root privileges
-
You must have homebrew installed.
-
Installing:
-
Install using Homebrew (preferred):
brew install jurek-zsl/antiquarantine/aq -
Or add the tap first (alternative):
brew tap jurek-zsl/antiquarantine brew install aq -
Updating:
brew upgrade aq
Tip
I recommend putting filenames and directories in quotes, if they contain spaces or special symbols.
- Show help menu for antiQuarantine
aq -h - Check for quarantine in a single file:
aq `/path/to/file` - Remove quarantine from a single file:
aq -r `/path/to/file` - Check for quarantine in multiple files:
aq -f `path` - Remove quarantine from multiple files:
aq -rf `path`
If you prefer to build locally:
-
Clone the repository:
git clone https://github.com/jurek-zsl/homebrew-antiQuarantine.git cd homebrew-antiQuarantine -
Build (simple approach—adjust if the project uses a specific subdirectory for cmd):
go build -o aq -
Move the binary into your PATH:
sudo mv aq /usr/local/bin/
- "Permission denied" errors: try running with
sudoor adjust file ownership. xattrnot found: ensure you are on macOS and have standard command line tools installed.- If
aqdoesn't remove the attribute, verify withxattr -land check that the file is not locked or in use.
If you find antiQuarantine helpful, please consider giving it a star on GitHub to help others discover it!
- I'm open on new ideas and improvements, feel free to create an issue or PR.