Skip to main content
Mac Deep Cleaner Icon

Mac Deep Cleaner

Reclaim gigabytes of disk space with confidence — the safest, smartest macOS storage analyzer and cleanup suite.

PyPI Version Python 3.9+ License macOS 10.15+ PyPI Downloads


Mac Deep Cleaner v3.0 is a modern macOS storage analysis and reviewed cleanup suite combining an interactive local web dashboard, native macOS desktop integration, and powerful command-line tooling with multiple layers of safety and full Trash protection.

# Three convenient commands, same powerful tool
mac-deep-cleaner    # Standard entrypoint
mac-cleaner         # Alias
mdc                 # Fast CLI shorthand

Key Highlights

Safety First Modern UI & Desktop App Deep Local Analysis
Never deletes without review Responsive dashboard with dark-minimal aesthetic Intelligent application footprints & leftovers
Finder Trash protection by default Integrated macOS native window chrome & full-screen Dev toolchains, Docker, caches, logs, Xcode
Protected & macOS-managed path guards Optional Rich & Questionary interactive terminal UI Duplicate file detection with content hashing
Validated scan generations & revisions Zero third-party cloud analytics or external leaks Fast multi-threaded local scanning

Installation

You can install Mac Deep Cleaner directly from PyPI:

pip install mac-deep-cleaner

To include the optional interactive terminal UI (rich + questionary):

pip install "mac-deep-cleaner[terminal]"

From Source

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

Quick Start & Usage

1. Launch the Interactive Dashboard (Default)

Running without arguments automatically launches the local web UI dashboard on an available loopback port:

mac-deep-cleaner
# or
mac-cleaner
# or
mdc

Options:

mac-cleaner --port 8765        # Custom port
mac-cleaner --no-open          # Start server without automatically launching browser
mac-cleaner --apps             # Jump straight to Application Analyzer

2. Command-Line & Terminal Mode

Generate non-interactive reports, JSON exports, or run the interactive terminal interface:

# Generate report to stdout
mac-cleaner --report

# Export complete scan report as JSON
mac-cleaner --json storage-report.json --no-interactive

# Interactive terminal UI
mac-cleaner --terminal

# Dry-run safe clean preview
mac-cleaner --clean safe --dry-run

# Execute safe cleanup non-interactively
mac-cleaner --clean safe --yes

Native macOS App Build

To build the standalone native .app bundle with the integrated Swift window chrome:

python3 scripts/build_mac.py

The resulting Mac Deep Cleaner.app will be placed in dist/.


Cleanup & Safety Rules

  • Safe by Default: Files are moved to Finder's Trash. Trash moves do not immediately increase free disk space until Trash is emptied.
  • Strict Verification: The backend verifies scan generation tokens, exact file IDs, inode matches, and path restrictions before performing any changes.
  • System Protection: System files (com.apple.*, SIP paths, running app bundles) are strictly locked and protected.
  • Privacy & Permissions: For full analysis of user caches and containers, grant Full Disk Access to Terminal (or Mac Deep Cleaner) in System Settings → Privacy & Security → Full Disk Access.

License

Distributed under the Apache 2.0 License. See LICENSE for more information.

Metadata

Release files for mac-deep-cleaner 3.0.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for mac-deep-cleaner 3.0.0
File Size Uploaded Provenance Actions
mac_deep_cleaner-3.0.0.tar.gz 96.4 kB Without provenance Details for mac_deep_cleaner-3.0.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for mac-deep-cleaner 3.0.0
File Interpreter ABI Platform Actions
mac_deep_cleaner-3.0.0-py3-none-any.whl Python 3 none any Details for mac_deep_cleaner-3.0.0-py3-none-any.whl

Total release size: 201.5 kB

Release files / mac_deep_cleaner-3.0.0.tar.gz

Download URL mac_deep_cleaner-3.0.0.tar.gz
Size 96.4 kB
Tags Source
SHA-256 checksum
How to use checksums
53adfbf8c2a0ec4918344fb6b05f882b99a6ec36c14bff7979d96207d9accc74
BLAKE2b-256 checksum
How to use checksums
76a9bd86f51c6d5e8361d57ed186d1b3f13c96de770f81518344e96a39addefa
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.11.9

Release files / mac_deep_cleaner-3.0.0-py3-none-any.whl

Download URL mac_deep_cleaner-3.0.0-py3-none-any.whl
Size 105.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
c39175555b4d8b2581a98fa7de6bb79921f4c06690af0ca1f288d2c03a550718
BLAKE2b-256 checksum
How to use checksums
090ce020f2ed7229ed3ad53f58f60529247755c5c786b75199518d6e58d8ea9b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.11.9

Security for mac-deep-cleaner 3.0.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page