v1.2.0 - [2026-05-11]

Mac Deep Cleaner v1.2.0

Professional macOS cleanup tool — Smart App Orphan Detector

Detects and removes leftover files from uninstalled apps, stale caches, crash reports, logs, and other system junk — safely, with multiple layers of protection and full undo support.

---

What's New in v1.2.0

Feature	Command
Duplicate file finder (by hash)	mac-cleaner duplicates
Large file scanner (sortable)	mac-cleaner large-files
Broken symlink detector	mac-cleaner symlinks
iOS/iPhone backup finder	mac-cleaner extras --ios-backups
Language pack stripper	mac-cleaner extras --language-packs
Universal binary thinner	mac-cleaner binary
Undo / restore staged deletions	mac-cleaner undo
YAML config + profiles	~/.config/mac-cleaner/config.yaml
Scan history & diff	mac-cleaner history / mac-cleaner diff
HTML report export	--export report.html
Launch item manager	mac-cleaner system --launch-items
Login items viewer	mac-cleaner system --login-items
SIP & permission health check	mac-cleaner system --health
Weekly auto-scan scheduler	mac-cleaner schedule install
macOS notifications	--notify flag
CI mode / JSON threshold gate	mac-cleaner scan --ci --threshold-mb 500
Live TUI dashboard (expanded panels)	mac-cleaner dashboard
Developer junk scanner (project caches)	mac-cleaner scan --dev-junk
Global dev caches (opt-in)	mac-cleaner scan --dev-junk-global
First-run profile selection	mac-cleaner scan
Custom scan roots	mac-cleaner scan --root ~/Projects
Self-update from PyPI	mac-cleaner update
Homebrew formula + .pkg builder	Formula/mac-deep-cleaner.rb, bash scripts/build.sh pkg

mdc is a shorter alias for every command, for example mdc dashboard,
mdc clean, and mdc scan --ci --threshold-mb 500.

---

Installation

From PyPI (recommended)

pip install mac-deep-cleaner

From source (venv)

git clone https://github.com/NK2552003/Mac-Cleaner.git
cd mac_deep_cleaner
python3 -m venv .venv
source .venv/bin/activate
pip install -e .

---

Use either command name:

mac-cleaner scan
mdc scan

---

What's Changed

• Initialization by @NK2552003 in #1
• Bug/enhancement by @NK2552003 in #3

New Contributors

• @NK2552003 made their first contribution in #1
• @nitinsaini26 , @prashantX-code , @sidkr222003 made their contribution on this release

Full Changelog: https://github.com/NK2552003/Mac-Cleaner/commits/v1.2.0