github AlexTkDev/MacOSCleaner 3.0.1
MacOS Cleaner 3.0.1

one hour ago

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 ~/Library folders with ResidualScanIndex (bulk URLResourceValues snapshot + inverted token lookup) and a single pkgutil --pkgs pass, eliminating millions of redundant filesystem syscalls.
  • Bounded Memory & Icon Loading: Replaced synchronous main-thread tiffRepresentation icon loading with lazy off-main AppIconCache (RenderGate max 4 concurrent, 64/128px downsampling), added batched autoreleasepool passes, bounded PlistContentCache (512 entries) and size caches (4,096 entries), and coalesced lsregister -dump parsing.
  • In-Process Code Signing & POSIX Sizing: Replaced /usr/bin/codesign subprocess spawns with in-process SecStaticCode checks, removed NSRegularExpression from hot matching paths, and switched directory sizing to iterative POSIX fstatat with SF_DATALESS (iCloud) skipping and inode cycle protection.
  • Concurrency & Checkbox Safety: Bounded concurrent deep scans (withTaskGroup max 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 (with VerificationEngine respecting unchecked profiles).
  • Homebrew & CLI Service Protection: OrphanScanner now checks Homebrew Cellar/opt and Program/ProgramArguments executables so active homebrew.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 MDItemCreate against nil when mdutil -a -i off is enabled, skipped mdfind lookups when indexing is off, added a Spotlight status banner in Uninstaller, and made CrashSignalHandler async-signal-safe.
  • No Spurious Xcode CLT Prompts: Checked xcode-select -p and simctl availability before invoking xcrun so Macs without Xcode no longer see "Install Command Line Tools" popups.

💾 External Volumes (/Volumes/...)

  • Symlinked & External Apps: Added support for symlinked .app bundles and writable <ExternalVolume>/Applications discovery so external apps are never misclassified as leftovers.
  • Safe External Operations: Enabled .uninstall and 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 failedDeletions in the Uninstaller instead of silently succeeding.

✨ Improvements & UI Fixes

  • Live Progressive Dashboard: Replaced the static Scanning... spinner with live DiskRingsChartView updates showing Free/Total capacity, % 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/.systemextension bundles, privileged helpers, or hardware plug-ins via the standard loginwindow restart dialog.
  • Leftovers Naming, Categories & Localization: Fixed truncated versioned filenames (e.g. python3.8.plist now displays as python3.8 instead of 8), grouped LaunchAgents/LaunchDaemons under Launch Agents, hid redundant duplicate bundleID pills, and completed missing translations (including Spanish Analizando, 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, fixed GlassPillPicker multi-update warnings, deduplicated Review manually entries in Dynamic Cache Discovery, and silenced harmless EPERM process-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 (arm64 only).

# Clear Gatekeeper quarantine flag on first launch (for direct DMG downloads):
xattr -dr com.apple.quarantine /Applications/MacOSCleaner.app

If MacOSCleaner helped you, a ⭐ on the repo helps other people find it: https://github.com/AlexTkDev/MacOSCleaner

Don't miss a new MacOSCleaner release

NewReleases is sending notifications on new releases.