Mac Deep Cleaner
Reclaim gigabytes of disk space with confidence — the safest, smartest macOS storage analyzer and cleanup suite.
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
Via pip (Recommended)
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)
| 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)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| 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.