Skip to content

shfire616/mac_cleaner

Repository files navigation

MacCleaner 🧹

The honest, open-source disk cleaner for macOS.

License Platform Python


😫 Tired of running out of disk space?

💸 Tired of "free" cleaners that ask for a subscription to delete 1 file?

MacCleaner is for you.


⚠️ WARNING: USE AT YOUR OWN RISK ⚠️

MacCleaner is a powerful system utility. While it is designed to be safe by moving files to the Trash, the author is NOT responsible for any data loss, system instability, or accidental deletion of important files. Always ensure you have a full system backup (Time Machine) before performing any cleaning operations.


No ads. No subscriptions. No hidden tracking. Just a simple, powerful tool to reclaim your hard drive space safely. Built by a developer, for everyone.


📸 Screenshots

Modern Dashboard Smart Scanning
Dashboard Scan Results
Visual overview of your disk usage Grouped results for safe & easy cleaning

✨ Why MacCleaner?

  • 💯 100% Free & Open Source: The code is right here. No secrets.
  • 🛡️ Safety First: We don't just "delete" files. We move them to the Trash 🗑️, so you can always change your mind.
  • 🚀 Native Performance: Built with PyQt6 to look and feel like a native macOS app.
  • 🧠 Smart Detection: Automatically finds orphaned files from apps you uninstalled years ago.

🔍 Features

  • 📊 Dashboard: See exactly how much space you have left at a glance.
  • 🧹 System Junk: Safely clear Caches, Logs, and Xcode DerivedData (a lifesaver for developers!).
  • 🐘 Large Files: Instantly spot the massive files clogging up your Downloads folder (>100MB).
  • 🗑️ App Leftovers: Our smart engine scans Application Support to find junk left behind by deleted apps.
  • ✅ Select All: Use the header checkbox or Cmd+A to select all scan results.
  • 📏 Adjustable Columns: Resize File/Folder and Size columns to fit your workflow.
  • 🌗 Night Mode: Follow system theme or toggle Light/Dark manually.
  • ℹ️ About Menu: Quick app intro with MIT license link.
  • 🛠️ System Tools:
    • Update Cleaner: Remove old macOS installer packages.
    • Time Machine Snapshots: The #1 cause of hidden "System Data" bloat.

📦 Download & Install

For Users

  1. Download the latest MacCleaner-Silicon.dmg (for M1/M2/M3) or MacCleaner-Intel.dmg (for Intel Macs) from the Releases Page.
  2. Open the file and drag MacCleaner to your Applications folder.

🛡️ Bypassing macOS Security (First Time Only)

Since MacCleaner is open-source and not signed with a paid Apple Developer certificate, macOS will block it by default.

Option 1: The Right-Click Trick

  1. Go to your Applications folder.
  2. Right-click (or Control-click) the MacCleaner icon.
  3. Select Open from the menu.
  4. A dialog will appear. Click Open.
  5. Done! You only need to do this once.

Option 2: Fix "App is Damaged" Error If macOS says the app is "damaged" (this is a Gatekeeper error), run this in your Terminal:

sudo xattr -cr /Applications/MacCleaner.app

👨‍💻 For Developers

Want to tweak the code? Build it yourself?

Setup

# Clone the repo
git clone https://github.com/shfire616/mac_cleaner.git
cd mac_cleaner

# Setup the environment and install dependencies
uv sync

Build Your Own DMG

# Build the App Bundle
uv run pyinstaller --name="MacCleaner" --windowed --noconfirm --clean --paths=src src/main.py

# Create the DMG Installer
uv run dmgbuild -s dmg_settings.py "MacCleaner" dist/MacCleaner.dmg

⚠️ Disclaimer

Your data is your responsibility. MacCleaner is designed to be safe (using the Trash), but always ensure you have a backup (Time Machine) before performing system maintenance. The author provides this software "as is" without warranty.

📄 License

MIT License. Copyright © 2026 William Tam. Free to use, modify, and distribute.

About

A modern, native, and open-source macOS system cleaner. Free forever, no ads, no tracking. 🧹 ✨

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages