Pro free for a week: code NETMUTE
NetMute

Two ways to get NetMute

Both are free to download and contain the same features. They differ in how you buy Pro.

Mac App Store

The simple route

  • Pro is bought in the app with your Apple Account
  • No licence key to keep
  • Apple handles payment and refunds
Open the App Store

Direct download

Version 2.3.10 · 13 MB

  • Invoice with VAT ID, ready for expenses
  • 5- and 10-seat licences for teams
  • Unlocked with a licence key
Download the .dmg

The direct build is signed with a Developer ID, notarised by Apple and updates itself. Pro does not carry over between the two: a licence key works only in the direct build, an App Store purchase only in the App Store version.

com.apple.quarantine on Mac: What It Is and When to Remove It

com.apple.quarantine is an extended attribute that macOS attaches to files downloaded from the internet, and it is the signal that makes Gatekeeper check an app before its first launch. Removing it from a single app you trust with `xattr -d com.apple.quarantine` is safe in a narrow sense, but it skips that check, so use the Open Anyway button in Privacy & Security first and keep the Terminal route for cases where you know exactly where the software came from.

9 min readUpdated

What com.apple.quarantine is and what sets it

Files on a Mac can carry extended attributes: small pieces of metadata stored with the file but separate from its contents, name or dates. The xattr manual page describes them as "arbitrary metadata stored with a file". Finder tags, the source URL of a download and the quarantine flag all live there.

You notice them first in Terminal. ls -l shows an @ after the permission string (for example -rw-r--r--@) when a file has extended attributes, and ls -l@ lists their names underneath, such as com.apple.quarantine followed by the size in bytes.

The quarantine attribute is written by the app that saves the file, not by the file itself. Apps opt in, and browsers and messengers do. On the Mac used for this article, Safari, Google Chrome, Brave and WhatsApp all declare LSFileQuarantineEnabled in their Info.plist, which tells macOS to mark everything they save. Mail, Messages and AirDrop mark incoming files as well, and Archive Utility passes the attribute on to files it unpacks from a quarantined archive.

What does not get the attribute is just as useful to know. Files you create yourself, files copied from another disk you own, and files fetched with command-line tools such as curl arrive without it, because those tools do not ask macOS to quarantine what they write. That is why a script downloaded with curl runs without a Gatekeeper prompt while the same file from Safari triggers one.

The name sometimes leads to the wrong idea. A quarantined file is not isolated, encrypted or moved. It works normally as a document. The attribute only matters when macOS is asked to run something from it, and that is where Gatekeeper comes in.

How to read the attribute and what the fields mean

Three commands cover everything:

  • xattr file lists the names of all extended attributes on the file.
  • xattr -l file lists names and values together.
  • xattr -p com.apple.quarantine file prints only the quarantine value.

A typical value from a Safari download looks like this (the example is made up but has the real structure): 0083;6750a1b2;Safari;1F2E3D4C-5B6A-4789-9ABC-0D1E2F3A4B5C.

The four fields are separated by semicolons:

  1. Flags (0083): a hexadecimal number. macOS changes it over time. On the Mac used for this article, fresh downloads in the Downloads folder carried values such as 0082, 0083 and 0086, while apps in the Applications folder that had already been opened and approved showed values such as 01c3. The attribute stays after approval. The flags record that the check has happened.
  2. Timestamp (6750a1b2): the download time as seconds since 1 January 1970, written in hexadecimal. In zsh, date -r $((16#6750a1b2)) turns it into a readable date.
  3. Agent (Safari): the name of the app that saved the file. This is often the quickest way to answer "where did this file come from?"
  4. Event identifier: a UUID that links the file to an entry in the download history database described in the last section. It can be empty: on the test Mac, files saved by Microsoft PowerPoint and by a mail client had an empty fourth field.

For apps, look at the top-level .app bundle. That is where Gatekeeper reads the attribute, and it is the path you would pass to xattr.

What reads it: Gatekeeper, notarization and XProtect

When you open a quarantined app for the first time, macOS runs a set of checks before any of the app's code executes. The quarantine attribute is the trigger. Without it, most of these first-launch checks are skipped.

Gatekeeper checks the code signature: is the app signed with a valid Developer ID, and has it been changed since it was signed? Notarization adds Apple's own scan: developers who distribute outside the Mac App Store upload their app to Apple, and Gatekeeper checks that Apple has issued a notarization ticket for it. XProtect, Apple's built-in malware signature scanner, checks the app against known malware at the same moment.

You can run the same assessment yourself without opening the app: spctl -a -vv /Applications/SomeApp.app. For a normal downloaded app the result reads accepted, source=Notarized Developer ID and an origin line naming the developer's certificate.

The dialog you get when a check fails tells you which one it was. These are the English texts macOS uses:

  • "… is damaged and can't be opened." Despite the wording, this usually means the code signature is broken or missing. In Apple's own string files it sits under a key for a bad signature, not for a corrupt download.
  • "Apple could not verify … is free of malware that may harm your Mac or compromise your privacy." The app is signed but not notarized, or Gatekeeper could not confirm the ticket.
  • "… is from an unidentified developer." The app is not signed with a Developer ID Apple recognises.
  • "… was not opened because it contains malware." XProtect matched a known signature. Do not try to work around this one.

The full first-launch assessment does not repeat on every later launch. They are a gate at the door, which is why stripping the attribute matters: it takes the door away.

Removing it safely, and what not to do

Start with the method Apple provides. Try to open the app once and dismiss the dialog with Done. Then open System Settings, go to Privacy & Security and scroll to the Security section. macOS shows a line saying the app was blocked to protect your Mac, with an Open Anyway button next to it. Click it, confirm with your password, and the app opens. Since macOS 15 Sequoia, the old shortcut of Control-clicking the app and choosing Open no longer skips this step.

This route keeps Gatekeeper in the loop. You make the decision, macOS records it, and the app is still checked against XProtect.

The Terminal route is for cases where Open Anyway is not offered, typically the "damaged" message for an open-source or hobby project that ships without a Developer ID signature. If you trust the source, remove the attribute from that one app:

xattr -d com.apple.quarantine /Applications/SomeApp.app

If the app still refuses, some guides add -r to apply the change to every file inside the bundle. Keep that limited to the one app bundle. Before you do either, check that the download really came from the developer, ideally by comparing the checksum published on the project's own site or release page.

Three things are worth avoiding:

  • Running xattr -r -d com.apple.quarantine on a whole folder such as Downloads or your home folder. That removes the first-launch check from every file in it, including the ones you have forgotten about or never looked at.
  • xattr -c, which clears all extended attributes, not only quarantine. It is a blunt tool for a precise job.
  • Disabling Gatekeeper with sudo spctl --global-disable. According to its manual page, it reveals the "Anywhere" option in Privacy & Security, and macOS itself warns that allowing apps from anywhere makes the Mac less secure. Choosing it turns off the check for everything you download from then on, to fix a problem with one app.

The download log behind the UUID, and what quarantine does not check

The fourth field points to a database most people have never heard of: ~/Library/Preferences/com.apple.LaunchServices.QuarantineEventsV2. It is an SQLite file, and it exists on any Mac that has downloaded something. Its table has columns for the app that downloaded the file, the data URL, the origin page and, for mail attachments, sender name and address. In other words, it is a download history kept by macOS, separate from your browser. It is not part of your browser's history settings, so clearing the history in a browser is not a reliable way to empty it. If you share the Mac or care about that record, it is worth knowing it is there. Removing quarantine attributes from files does not remove their entries either.

The other limit is about time. Quarantine, Gatekeeper, notarization and XProtect all look at an app before its first launch. Once the app runs, none of them watch what it does on the network. A properly signed and notarized app can still send analytics, contact advertising networks or phone home every few minutes, and nothing in the quarantine system will tell you.

That is the gap NetMute covers. It does not touch Gatekeeper, quarantine attributes or the Open Anyway decision. It lists every app and system process with live network traffic and the domains each one contacted, so you can open a newly downloaded app for the first time and see who it talks to right away. If the answer is not what you expected, one switch blocks that app from the network while you decide whether to keep it.

Frequently asked questions about com.apple.quarantine

See what a new app connects to on first launch

NetMute shows live traffic for every app and system process and lists the domains each one contacted. One switch takes an app offline. It does not change Gatekeeper. Free on the Mac App Store, Pro is a one-time purchase.

Free on the Mac App Store

Free with no time limit · Pro $12.99 one-time

Download free