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.5 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.

Version 3.0.5 adds consistent top spacing in browser mode and unified branding across the dashboard, browser tab, README, and macOS app.

# 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/.

Shared App Icon

assets/app_icon.png is the single source for the app's branding. The dashboard and browser favicon serve this image directly; the native build generates its .icns file from it without adding another background or changing its proportions. Python distributions include the same asset inside mac_deep_cleaner/assets/. Replace the source PNG and rebuild to update all of these surfaces.


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.5

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.5
File Size Uploaded Provenance Actions
mac_deep_cleaner-3.0.5.tar.gz 231.0 kB Without provenance Details for mac_deep_cleaner-3.0.5.tar.gz

Built distribution (wheel)

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

Total release size: 463.0 kB

Release files / mac_deep_cleaner-3.0.5.tar.gz

Download URL mac_deep_cleaner-3.0.5.tar.gz
Size 231.0 kB
Tags Source
SHA-256 checksum
How to use checksums
c1700a5af9a47b05896659ef9a76067f73bc11ee4f39d1134f5c5b82df27f69e
BLAKE2b-256 checksum
How to use checksums
01b54217213a8a7f0e7ca8c967e592182c3d235b9bd262e146336aad08367100
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.5-py3-none-any.whl

Download URL mac_deep_cleaner-3.0.5-py3-none-any.whl
Size 232.1 kB
Tags Python 3
SHA-256 checksum
How to use checksums
703e1d8374f99254a42386617f41f8aeb7832e38ddbf5eb35d71a2276db26970
BLAKE2b-256 checksum
How to use checksums
bb05edf341feefc8f9bdd44faa0325deeff5b9327e8851d566c7faca19b3e0f5
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.5

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