Repository navigation
Maintenance & Performance Release: Fixes Spotlight-off crashes, eliminates the Uninstaller ~15 GB icon memory spike, cuts leftover deep scan time and RAM via single-pass indexing, protects browser extensions/profiles and active Homebrew services, adds external volume support, and introduces a live progressive Dashboard scan.
🙏 Acknowledgments
Special thanks to @trhuxtonr for detailed profiling, fs_usage traces, and testing throughout issue #39, as well as sabakagen, Jovo, and everyone who reported bugs and edge cases after 3.0.0.
🐛 Key Bug Fixes & Performance
⚡ Uninstaller Deep Scan Speed & Memory
- Single-Pass Indexed Deep Scan: Replaced per-app re-enumeration of
~/Libraryfolders withResidualScanIndex(bulkURLResourceValuessnapshot + inverted token lookup) and a singlepkgutil --pkgspass, eliminating millions of redundant filesystem syscalls. - Bounded Memory & Icon Loading: Replaced synchronous main-thread
tiffRepresentationicon loading with lazy off-mainAppIconCache(RenderGatemax 4 concurrent, 64/128px downsampling), added batchedautoreleasepoolpasses, boundedPlistContentCache(512 entries) and size caches (4,096 entries), and coalescedlsregister -dumpparsing. - In-Process Code Signing & POSIX Sizing: Replaced
/usr/bin/codesignsubprocess spawns with in-processSecStaticCodechecks, removedNSRegularExpressionfrom hot matching paths, and switched directory sizing to iterative POSIXfstatatwithSF_DATALESS(iCloud) skipping and inode cycle protection. - Concurrency & Checkbox Safety: Bounded concurrent deep scans (
withTaskGroupmax 4) and preserved user checkbox selections during background scanning.
🛡️ Data Safety, Browser Protection & Leftovers Accuracy
- Browser Extensions & Profiles Preserved: Enforced exact bundle ID matching (
DeletionPolicy,browserSpecs) so Chrome/Chromium extensions, Local Storage, IndexedDB, Cookies, and Login Data stay intact during cleanup, PWA uninstall, and browser uninstalls (withVerificationEnginerespecting unchecked profiles). - Homebrew & CLI Service Protection:
OrphanScannernow checks Homebrew Cellar/optandProgram/ProgramArgumentsexecutables so activehomebrew.mxcl.*,homebrew.cask.*, MacPorts, and Nix services are not flagged as leftovers. - Shared SDK & System Guards: Protected
tvappservices.*containers and shared crash/telemetry/updater SDKs (io.sentry,com.plausiblelabs.crashreporter,com.google.keystone,com.crashlytics.*) from false-positive leftover detection. - Spotlight-Off Stability: Guarded
MDItemCreateagainstnilwhenmdutil -a -i offis enabled, skippedmdfindlookups when indexing is off, added a Spotlight status banner in Uninstaller, and madeCrashSignalHandlerasync-signal-safe. - No Spurious Xcode CLT Prompts: Checked
xcode-select -pandsimctlavailability before invokingxcrunso Macs without Xcode no longer see "Install Command Line Tools" popups.
💾 External Volumes (/Volumes/...)
- Symlinked & External Apps: Added support for symlinked
.appbundles and writable<ExternalVolume>/Applicationsdiscovery so external apps are never misclassified as leftovers. - Safe External Operations: Enabled
.uninstalland user-selected Disk Analyzer / Duplicate Finder paths on external volumes while blocking volume roots, Time Machine backups, and OS metadata folders (.Spotlight-V100,.Trashes). - Honest Error Reporting: Read-only or ejected volumes now report accurate
failedDeletionsin the Uninstaller instead of silently succeeding.
✨ Improvements & UI Fixes
- Live Progressive Dashboard: Replaced the static
Scanning...spinner with liveDiskRingsChartViewupdates showingFree/Totalcapacity,% Used, category progress counters, animated orbital ring sweeps, and live byte counts while scanning (0% animation CPU when idle or with Reduce Motion). - System Restart Recommendations: Added a post-cleanup restart card (escalating to Restart Required after Font Cache resets) and an Uninstaller restart banner when removing system daemons,
.kext/.systemextensionbundles, privileged helpers, or hardware plug-ins via the standardloginwindowrestart dialog. - Leftovers Naming, Categories & Localization: Fixed truncated versioned filenames (e.g.
python3.8.plistnow displays aspython3.8instead of8), grouped LaunchAgents/LaunchDaemons underLaunch Agents, hid redundant duplicatebundleIDpills, and completed missing translations (including SpanishAnalizando,Preferencias,Otros,Agentes de inicio) across all 14 languages. - UI & Console Polish: Eliminated tab-switch re-scanning via
WorkspaceStore, moved Disk Analyzer to on-demand scanning, fixed vertical text jitter on the"Analyzing X/Y..."scan label, fixedGlassPillPickermulti-update warnings, deduplicatedReview manuallyentries in Dynamic Cache Discovery, and silenced harmlessEPERMprocess-polling debug noise.
📦 Download & Verification
| Asset | Description |
|---|---|
MacOSCleaner.dmg |
Release DMG for Apple Silicon (arm64), macOS 26.0+ |
System Requirements: macOS 26.0+ on Apple Silicon (
arm64only).
# Clear Gatekeeper quarantine flag on first launch (for direct DMG downloads):
xattr -dr com.apple.quarantine /Applications/MacOSCleaner.appIf MacOSCleaner helped you, a ⭐ on the repo helps other people find it: https://github.com/AlexTkDev/MacOSCleaner