Support
Getting started
Open EasySweep and it begins measuring. On a machine with a lot of build output the first scan can take a few minutes — walking a hundred gigabytes of small files is genuinely slow, and every size shown is measured rather than estimated. Each section has its own rescan button, so you never have to re-walk everything to refresh one part.
Nothing is selected when a scan finishes. Look first. Tick what you want gone, and use that section’s Clean button — each section cleans only its own selection.
Permissions
Direct download (the DMG)
This edition is not sandboxed and reaches everything in your home folder
without asking. A few catalogued locations sit under /Library, which
macOS protects; if one of those is refused, the app tells you so and points you
at Full Disk Access.
To grant it: System Settings → Privacy & Security → Full Disk Access, then switch on EasySweep and relaunch the app. This is optional — everything under your home folder works without it.
Mac App Store edition
This edition is sandboxed, which is Apple’s requirement rather than a choice.
A sandboxed app cannot read ~/Library/Developer or ~/.npm
unless you hand it access, so each section asks once for your home folder
through the standard macOS panel.
Two things to know about that panel:
- It only accepts the folder it asked for. Everything else is greyed out. This is deliberate — the sandbox grants whatever you pick, not what was requested, so a panel that accepted the wrong folder would leave a section still asking for permission with no explanation.
- Hidden files are shown.
~/Libraryand every dot-folder are hidden by default in macOS, and those are exactly what is being asked for.
Once granted, the app re-measures everything the grant reaches.
Common problems
A section says there’s nothing to clean, but I know there is
Almost always a permission issue. On the App Store edition, check the section hasn’t got an outstanding folder request. On the direct download, try Full Disk Access as above. An unreadable folder is reported as a failure rather than as an empty one, so look for a failure message — if you see one, that’s the cause.
It couldn’t remove the app itself when uninstalling
Expected on the Mac App Store edition. A sandboxed app is not permitted to delete another application’s bundle. EasySweep removes everything that app left behind and tells you the bundle is yours to drag to the Trash. The direct download does not have this restriction.
Where did my uninstalled files go?
The Trash. Uninstalls always move rather than delete, because matching an app’s leftover files is partly guesswork and a guess has to be reversible. That is why the app reports “moved n items to the Trash” and never counts them as space freed — the bytes come back when you empty it.
A simulator I wanted is gone
Simulators are only ever deleted if you tick them yourself. They appear in the Developer section because they live inside Xcode’s folder, but the menu bar button, the low-space notification and every automation rule are structurally unable to reach them. If you deleted them deliberately, Xcode can recreate devices from Window → Devices and Simulators; installed apps and their data are not recoverable.
Cleaning is stuck on one item
Large simulator device sets take a while, since they are deleted through
Apple’s simctl rather than by removing folders. The progress bar names
the item currently going. Every child process the app starts is bounded by a
timeout, so a genuinely hung tool becomes a readable failure rather than an
endless spinner. Pressing Stop ends the clean between items — never
inside one — so nothing is left half-deleted.
My sidebar is missing a section
Sections can be hidden by right-clicking them, which hides the row and keeps all of its data. Settings holds the full list with checkboxes, plus Restore Default Arrangement. The sidebar arrangement is per-Mac and is not synced.
Licences and purchases
Direct purchase
A direct licence covers 1, 2, or 3 Macs, depending on which one you bought. Enter your key in Settings → Licence. To move it to a different Mac, deactivate it on the old one from the same screen, which frees the seat.
If a licence check fails — you’re offline, the server is slow, anything of that sort — nothing happens to your entitlement. It is only ever revoked on an explicit answer that the licence has been disabled, expired, or is not recognised. Being on a plane will not lock you out of a feature you paid for.
Which tier is my key?
Once a key is entered, Settings → Licence shows how many Macs it covers. Your purchase email and receipt name the tier too. To see which Macs are currently using it, open the licence from the link in that email — the customer portal lists every activation and lets you release one.
Buying more Macs later
Email support@easysweep.app. You pay the difference between what you bought and the tier you want, and we raise the limit on your existing key — the same key keeps working, and the Macs already activated stay activated. There is nothing to reinstall and no second key to keep track of.
App Store purchase
Tied to your Apple Account with no device limit. If Pro doesn’t appear on a new Mac, use Restore Purchases in Settings.
Lost your key?
Email support@easysweep.app from the address you bought with and we’ll resend it.
Refunds
Direct purchases: a full refund within 30 days, no reason required — email us. Refunds are issued by Polar, our merchant of record, and the licence is deactivated when one is processed.
App Store purchases: refunds are handled by Apple, not by us. Request one at reportaproblem.apple.com. We have no ability to issue or refuse an App Store refund.
If Pro lapses
Nothing is deleted. Your custom categories and automation rules stay stored and stay visible — they simply can’t be added to, cleaned or run until the entitlement is restored.
Sizes, and what you actually get back
Yes. Sizes are allocated blocks, the same measure du uses, which is the space the filesystem actually returns. There is a test that compares the app’s figures against du output directly.
The one exception is app uninstalls, which move files to the Trash rather than deleting them. Those are reported as “moved to the Trash” and never counted as freed space, because the bytes don’t come back until you empty it.
Before you clean something irreversible
Most of what EasySweep finds regenerates itself; the only cost of deleting it is the time to rebuild or re-download. Three things do not, and are marked in the app:
- Archives hold the dSYMs you need to read crash reports from versions you already shipped. Without them those crashes stay unreadable forever.
- Simulator devices take their installed apps and all of their data.
- AI session history (Claude Code, Codex) can no longer be resumed or searched.
Like every tool of this kind, EasySweep depends on Xcode’s undocumented folder layout, which Apple can change at any time. Keep a backup.
Requirements
| macOS | 14 Sonoma or later |
|---|---|
| Architecture | Apple silicon and Intel (universal) |
| Signing | Signed and notarized by Apple |
Contact
Report a bug or request a feature
Open an issue on GitHub. Reporting there rather than by email means the problem is public, other people can say “this happens to me too”, and you can see what has already been fixed before you write anything. Please include your macOS version, which edition you have, and what the app told you.
If you would rather not use GitHub, or the problem involves a licence or anything you would rather not post publicly, email support@easysweep.app instead.
Add a tool EasySweep doesn’t know about
Every location the app scans is defined in the same public repository, so you can read every path it targets. If a tool you use is missing, adding it is one entry in one file and contributions are welcome — open a pull request, or file an issue naming the tool and we’ll add it.