mac-deep-cleaner v2.2.0

v2.2.0 (2026-06-06)

Added

• Docker Cleanup scanner via mdc clean --docker to reclaim space from dangling images and unused volumes.
• Interactive Terminal User Interface (TUI) via mdc tui (requires textual).
• Deep App Uninstaller via mdc uninstall to simultaneously hunt and remove app bundles and their dependencies.
• Background Scheduling enhancement via mdc schedule install --clean to automatically clean junk weekly.
• DNS Cache Flushing via mdc flush-dns to troubleshoot networking routing issues.
• --auto-with-cache flag to clean command to prompt for clearing System Caches.
• Beautified CLI UI with rounded boxes, rich colors, and emojis for reporter.py and cli.py.
• Dozens of modern apps (AI tools, dev environments, productivity apps) added to aliases and safe lists to improve detection.

Fixed

• Fixed bug where Brave Browser configurations (BraveSoftware) were incorrectly flagged as orphaned leftovers.
• Fixed UI bug where an empty table was rendered for the "General Junk" category when no user-actionable junk was found.

Changed

• Refactored monolithic constants.py into a modular src/constants/ package for better maintainability.

mac-deep-cleaner v2.0.1

v2.0.1 (2026-05-22)

Added

• APFS clone-aware duplicate detection (opt-in) with sampling profiles
• Duplicate export fields for logical vs physical wasted space when available

Changed

• Duplicates CLI output shows physical group counts and estimated wasted space

mac-deep-cleaner v2.0.0

v2.0.0 (2026-05-14)

Added

Cross-cutting Work

• Add new CLI subcommands and options in src/cli.py
• Extend config schema in src/config/config.py for new features
• Add logging and safe-path validation in src/core/safety.py where needed
• Expand reporting exports in src/reporting for new outputs
• Add tests for parsers and non-destructive scanners in tests/

External Dependencies (tentative)

• textual or prompt_toolkit for interactive TUI picker
• rumps for menu bar companion
• requests or urllib for HIBP API (prefer urllib to avoid new deps)
• pandas/pyarrow NOT planned (keep lightweight)

Safety Gates

• All destructive operations honor --dry-run and undo staging.
• Time Machine guard before bulk deletes.
• APFS snapshot support behind explicit flags.
• Restore checksum verification for staged files.

Open Decisions (needs confirmation)

• Preferred TUI library (textual vs prompt_toolkit)
• Whether to add optional dependencies vs strict core only
• Handling sudo-required operations (auto prompt vs printed instructions)
• HIBP API key provisioning and storage
• Minimum supported macOS version for system commands
• CI mode via mdc uninstall-cli ti uninstall this package

DOUCMENTATIONS

• Added the documentations for the command references and architecture

Changed

• CLI wiring for new feature commands
• Added reporting utilities
• Updated Readme for new features
• Version bump to v2.0.0 across docs and UI
• Updated the ci/cd pipelining to publish the newer version to pypi directly
• Updated the readme.md file for the references too

[1.5.0] - 2026-04-12

v1.5.0 (2026-05-12)

Added

Distributions

• added the .pkg distribution - but is unsigned distribution for development & testing purpose only
• use xattr -d com.apple.quarantine file-path-here - then install this package

P0 (baseline UX and safety)

• Global --dry-run flag (src/core/dry_run.py)
• Shell completion command (src/core/completions.py)
• Full app uninstaller (src/core/uninstaller.py)

P1 (highest demand data and visibility)

• Browser data cleaner (src/scanners/browser_data.py)
• Visual disk space map (src/scanners/space_map.py)
• Photo library analyzer (src/scanners/photos_analyzer.py)
• iOS simulator deep cleaner (src/scanners/simulators.py)

P2 (system utilities and maintenance)

• Memory pressure reliever (src/core/memory_pressure.py)
• Homebrew deep manager (src/core/brew_manager.py)
• Storage trend tracker (src/reporting/storage_trend.py)
• Recent files and activity cleaner (src/scanners/recent_activity.py)

P3 (advanced and higher risk features)

• Permissions auditor (src/core/permissions_auditor.py)
• APFS snapshot guard (src/core/apfs_snapshots.py)
• Menu bar companion (src/core/menubar.py)
• Data breach monitor (src/core/breach_monitor.py)
• Cloud storage junk scanner (src/scanners/cloud_junk.py)

Changed

• CLI wiring for new P0/P1 commands and dry-run behavior
• Module layout aligned to core/scanners (removed features package)
• README, checklist, and roadmap paths updated for the new layout
• Improved error handling with debug logs across filesystem and subprocess paths
• Dev junk scanner traversal now uses a deque for better performance

• added new files by @NK2552003 @sidkr222003 @nitinsaini26 in #5
• Features/p0 by @NK2552003 in #8
• fixed the init.py version by @NK2552003 in #9

Full Changelog: v1.2.0...v1.5.0

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