PureMac README

The project's README from github.com/momenbasel/PureMac. As one markdown file: README.md.

PureMac Smart Care - storage overview and cleanup review

PureMac Smart Care in dark appearance

English | العربية | Español | 日本語 | Português (Brasil) | 简体中文 | 繁體中文

PureMac

Reclaim your Mac.
Free, open-source Mac care: cleanup, app management, storage exploration, and system checks. No subscription or telemetry.

Latest Release macOS 13.0+ Signed & Notarized by Apple No telemetry MIT License Stars Downloads

Install - Why this exists - How it compares - Our promise - What it does - Permissions - Contributing

Want more open source? Try Pesty - a free, native clipboard manager for macOS.


Install

brew install --cask puremac

Or download the signed, notarized .dmg from Releases and drag PureMac into /Applications. No Gatekeeper warnings, no quarantine workaround.

Build from source

brew install xcodegen
git clone https://github.com/momenbasel/PureMac.git
cd PureMac
xcodegen generate
xcodebuild -project PureMac.xcodeproj -scheme PureMac -configuration Release \
  -derivedDataPath build build
open build/Build/Products/Release/PureMac.app

Command line

Open puremac for a keyboard-driven workspace. Select individual cache paths, review project artifacts, or browse your storage by size. Cleanup shows the exact selection and asks for confirmation before permanently removing it.

brew install momenbasel/tap/puremac-cli
puremac

PureMac CLI with individual selections and a running size total

Use puremac clean dev --dry-run for a preview or --json for scripts. See cli/README.md for controls, commands, and cleanup boundaries.

How it compares

PureMac CleanMyMac Pearcleaner Mole OnyX
Price Free $40+/yr Free CLI free / GUI paid Free
Open source Yes (MIT) No Source-available¹ CLI only No
Native Mac GUI Yes Yes Yes Terminal-first Yes
No telemetry Yes No Yes Yes Yes
No subscription Yes No Yes — Yes
Signed + notarized Yes Yes Yes — Yes
App uninstaller + orphans Yes Yes Yes Partial No
App-uninstall Trash support Yes Partial Yes Partial No
Honest about purgeable space Yes No n/a n/a n/a

¹ Pearcleaner is Apache 2.0 + Commons Clause - source-available but not OSI-approved (you may not sell it). PureMac is true MIT. Comparison reflects publicly documented features as of 2026; corrections welcome via PR.

Our promise

A Mac cleaner asks for the deepest permission macOS grants - Full Disk Access - and then deletes your files. That demands a level of trust the category has spent twenty years burning. Here's the contract PureMac holds itself to, and you can verify every line of it in the source:

If PureMac ever adds telemetry, a paywall on core features, or a fear-based scan, it will have become the thing it was built to replace. Hold us to this.

Why this exists

Apple sells base-model Macs with 256 GB SSDs that you can't upgrade. The Mac mini, the Air, every entry-level MacBook Pro - the drive is soldered down. The next storage tier costs more than a midrange Windows laptop. Once you've paid it, every gigabyte you've already bought matters.

Most Mac cleaners are subscription apps that hide their disk usage behind a paywall, ship telemetry by default, and trade on FUD ("47 GB of junk detected!"). PureMac is the opposite:

What it does

App Uninstaller

Discovers everything in /Applications and ~/Applications, then uses a 10-level matching engine (bundle ID, team identifier, entitlements, Spotlight metadata, container discovery, company-name heuristics, partial path matches) to find related files on your disk. Matching is heuristic, so review the results before removal. Three sensitivity tiers - Strict, Enhanced, Deep - let you choose how aggressive that match is. Apple system apps are excluded from the uninstall list automatically. You can also right-click any app in Finder and choose Services → Uninstall with PureMac to jump straight into its related-files scan.

Orphan Finder

Walks ~/Library and surfaces files left behind by apps that no longer exist on disk. The matcher compares against bundle identifiers and normalized names of every installed app, so a leftover ~/Library/Containers/com.foo.bar from an app you deleted in 2022 shows up clearly.

System Cleaner

Smart Scan checks each category in sequence and reports progress as files are found. You can stop a scan and keep the categories already completed:

On "purgeable space": PureMac shows your APFS purgeable space in the storage breakdown for transparency, but it deliberately does not list it as junk to delete. Purgeable space is reserved and reclaimed by macOS itself - no third-party app can reliably free it, and even the Finder's purgeable figure is known to be inaccurate. Cleaners that claim to "reclaim purgeable space" are overpromising. We'd rather be honest than impressive.

Storage and file review

Space Explorer measures the allocated space inside a folder you choose. Drill into directories, compare their sizes, and reveal an item in Finder. Packages are measured without exposing their contents as navigable folders. Skipped and inaccessible items are reported.

Duplicate Finder groups files with matching sizes and SHA-256 content hashes. Hard links are not counted as separate recoverable copies. Every group keeps one protected copy; selected extras move to the Trash only after confirmation and a fresh identity/content check. Emptying the Trash is a separate step.

Similar Photos compares image thumbnails using perceptual hashes, color, and aspect ratio. Review likely matches side by side and reveal them in Finder. Similarity is an estimate, so this tool does not remove photos. Each scan checks up to 500 images and 10,000 directory entries, with a visible notice when a limit is reached. Photo libraries, app packages, symbolic links, and cloud-only files are skipped.

Cleanup results support name/path search, size and age filters, sorting, and selection of visible rows. Right-click a cleanup result to always exclude its path. Exclusions also protect containing folders from cleanup and apply to scheduled runs; manage them in Settings.

Protection and performance

Protection checks Gatekeeper, FileVault, the application firewall, System Integrity Protection, and installed XProtect metadata. A failed or unavailable check stays unknown. It also provides shortcuts to privacy and permission settings. This is a configuration audit, not an antivirus or malware scanner.

Performance shows CPU and memory information, lists third-party launch-agent/daemon definitions, and lists local snapshots. A launch definition is not proof that a process is running. You can open Login Items or Activity Monitor and delete a specific Time Machine local snapshot after confirmation. Snapshot sizes are not estimated, and system update snapshots cannot be removed here.

App updates

Check for updates to Homebrew-managed cask apps and choose which ones to upgrade. PureMac runs Homebrew with analytics disabled and shows command failures. These actions use the network and Homebrew's package sources. Apps installed outside Homebrew are not covered; an App Store shortcut is provided for those managed by Apple.

Scheduled Cleaning

Optional. Configurable interval (hourly to monthly), with auto-clean threshold so background runs only fire when there's something meaningful to remove.

Permissions

PureMac needs Full Disk Access to read the locations macOS hides from every app by default - Mail downloads, Safari data, the TCC database, protected app containers. Without it, some cleanup categories and app-container scans will be incomplete. The locations available depend on your macOS version and permissions.

The first-launch onboarding walks you through granting it with an animated preview of the exact toggle you need to flip. If you skip it, the dashboard surfaces a single-click "Set up" pill. If a cleanup fails because of a permission issue, PureMac opens System Settings, reveals its bundle in Finder so you can drag it into the FDA list, polls the permission state every second, and auto-retries the failed batch the moment you grant access. You never have to re-select anything.

What PureMac does not do:

Troubleshooting

Launchpad / Dock shows a stale or dull PureMac icon

macOS aggressively caches app icons in LaunchServices. After a Homebrew reinstall or upgrade the Dock and Launchpad can keep showing the old cached icon. PureMac's cask runs lsregister -f on install to refresh it automatically. If a stale icon persists, re-register only PureMac and restart the Dock (adjust the app path if you installed it elsewhere):

/System/Library/Frameworks/CoreServices.framework/Versions/A/Frameworks/LaunchServices.framework/Versions/A/Support/lsregister \
  -f "/Applications/PureMac.app"
killall Dock

Give it a minute to re-seed, then open PureMac once. If it still sticks, a restart (or Safe Mode boot) forces a full rebuild.

Screenshots

Smart Care Dark appearance
Smart Care Dark appearance
Space Explorer Duplicate Finder
Space Explorer Duplicate Finder
Protection App Updates
Protection App Updates

Similar Photos comparing sample images for manual review

Screenshots show the running macOS app. File tools use sample files and images.

Architecture

PureMac/
  Logic/Scanning/     - Heuristic scan engine, locations database, conditions
  Logic/Utilities/    - Structured logging
  Models/             - Data models, typed errors
  Services/           - Scanning, cleanup, file tools, protection, updates, scheduler
  ViewModels/         - Centralized app state
  Views/              - Native SwiftUI views
    Apps/             - App uninstaller views
    Components/       - Shared components (FDA demo, permission sheet, theme)
    Orphans/          - Orphan finder
    Tools/            - Space, duplicates, similar photos, protection, performance, updates
    Settings/         - Native Form-based settings

Key components:

Security

If you find a vulnerability, please open a private security advisory rather than a public issue.

Contributing

Pull requests welcome. See CONTRIBUTING.md.

Especially welcome:

Acknowledgments

Star History

If PureMac saved you some disk space, a star helps other people find it.

PureMac star history chart

More open source

Also try

JMacy - the best and fastest downloader for macOS. Multi-connection segmented downloads that saturate your line, plus browser capture and torrents.

License

MIT. See LICENSE. Use it, fork it, ship it under your own name if you want - the only thing the license asks is that the notice stays.

PureMac (momenbasel/PureMac)

Searching Database…

7.2K ·GitHub
这是什么?PureMac 是一款免费的开源 macOS 清理工具,可以卸载应用、清理缓存和垃圾文件、浏览存储空间,并检查系统健康状况。它是作为不收集遥测数据的替代方案设计的,可替代 CleanMyMac 等付费工具。
它是图形界面应用还是命令行工具?它主要是一款原生 SwiftUI macOS 应用,同时还附带一个名为“puremac”的命令行工具,可以用键盘操作,支持脚本化工作流,并提供 dry-run(试运行)和 JSON 输出。
我需要先安装 Homebrew 才能使用它吗?安装 PureMac 本身不需要 Homebrew,但“应用更新”功能会检查并升级由 Homebrew 管理的 cask 应用,因此你的 Mac 上必须已经配置好 Homebrew。
应用卸载器查找相关文件的可靠性如何?它使用一套 10 级启发式匹配引擎(包括 bundle ID、团队标识符、Spotlight 元数据、容器发现等),并分为三个灵敏度档位。但由于匹配基于启发式规则,删除前需要你自行检查结果。
PureMac 会像某些清理工具宣称的那样回收 macOS 的“可清除”磁盘空间吗?不会。PureMac 有意不将“可清除”空间列为可删除的垃圾,因为第三方应用无法可靠地释放这部分空间,而且访达(Finder)显示的可清除数值已知并不准确;PureMac 只是出于透明度的考虑将其显示出来。
重复文件查找器有什么作用?它会按文件大小和 SHA-256 内容哈希值对文件进行分组,每组始终保留一份受保护的副本。只有在重新进行身份检查并经你确认后,它才会把确认多余的文件移到废纸篓。
它能找到我已删除应用遗留的文件吗?可以。孤立文件查找器会遍历你的 ~/Library 目录,并将其中的文件与磁盘上仍安装的所有应用的 bundle ID 和名称进行比对,从而标记出遗留文件。
为什么 PureMac 需要“完全磁盘访问权限”?macOS 默认对所有应用隐藏邮件下载、Safari 数据和受保护的应用容器等位置。如果没有“完全磁盘访问权限”,部分清理类别和应用容器扫描的结果将不完整。
Creator
momenbasel
Size
17 MB
Stars
7.2K
Age
6mo
Commits · 90 Days