macleanup 5.2.2

Desktop app 5.2.2

macleanup.dmg — Apple silicon and Intel, macOS 11 or later. Installed copies of 5.2.0 update themselves from inside the app.

• Paths you choose to keep are now left alone by every section.
• Scheduled runs report back with a receipt in History. If you created a schedule in 5.2.0, open Schedules and save it once more so it starts reporting.
• Sign-in, the Errors screen, keyboard shortcuts, the appearance shortcut and the data download were fixed.

First open of the unsigned app: System Settings → Privacy & Security → Open Anyway (once).

The command line

Fixed

• --exclude-path now keeps a path in every bulk wipe and age-based prune, not only in the per-item deletes. A folder that holds a kept path is left whole. In a preview, kept entries show as skip.
• Section 18 (large files report) no longer walks into photo libraries, iCloud folders, Movies, Music, virtual machines or the Trash; it skips them, which makes the scan seconds instead of minutes on a large home folder. Its top files are listed as report items in --json-events.

Changed

• The script is split into an entry file, macleanup.sh, and ordered modules in lib/, each under 500 lines. Behaviour is unchanged: --help, --list, --version and dry-run event streams were compared line for line against 5.2.1.
• Logs, reports, --contact and the run footer name the macleanup team and its website, docs and issues page. Personal phone, address and profile links are removed.

Run it with npx macleanup@5.2.2 · Full changelog