mac-cleanup-py

🧹 Python cleanup script for macOS

mac-cleanup-py is a powerful cleanup script for macOS.
This project is a rewrite of the original mac-cleanup-sh rewritten in Python.

🚀 Features

mac-cleanup-py helps you:

1. Empty Trash
2. Delete unnecessary logs & files
3. Clear cache

📦 Default Modules

• adobe - Clears Adobe cache files
• android - Clears Android caches
• arc - Clears Arc Browser caches
• brew - Clears Homebrew cache
• bun - Clears Bun cache
• cacher - Clears Cacher logs
• chrome - Clears Google Chrome cache
• chromium - Clears Chromium cache files
• composer - Clears composer cache
• conan - Clears Conan cache
• docker - Cleanup dangling Docker Images and stopped containers
• dns_cache - Clears DNS cache
• dropbox - Clears Dropbox cache
• ea - Clears EA App cache files
• gem - Cleanup any old versions of Gems
• go - Clears Go cache
• google_drive - Clears Google Drive caches
• gradle - Clears Gradle caches
• inactive_memory - Purge Inactive Memory
• ios_apps - Cleanup iOS Applications
• ios_backups - Removes iOS Device Backups
• java_cache - Removes Java head dumps from home directory
• jetbrains - Removes logs from PhpStorm, PyCharm etc
• kite - Deletes Kite logs
• lunarclient - Removes Lunar Client logs and cache
• minecraft - Remove Minecraft logs and cache
• microsoft_teams - Remove Microsoft Teams logs and cache
• npm - Cleanup npm Cache
• obsidian - Clears Obsidian cache files
• nuget - Clears .nuget package files
• pnpm - Cleanup pnpm Cache
• pod - Cleanup CocoaPods Cache Files
• poetry - Clears Poetry cache
• pyenv - Cleanup Pyenv-VirtualEnv Cache
• steam - Remove Steam logs and cache
• system_caches - Clear System cache
• system_log - Clear System Log Files
• telegram - Clear old Telegram Cache
• trash - Empty the Trash on All Mounted Volumes and the Main HDD
• wget_logs - Remove Wget logs and hosts
• xcode - Cleanup Xcode Derived Data and Archives
• xcode_simulators - Reset iOS simulators
• yarn - Cleanup yarn Cache

📥 Installation

Using Homebrew

brew tap mac-cleanup/mac-cleanup-py
brew install mac-cleanup-py

Using pip

pip3 install mac-cleanup

🗑️ Uninstallation

Using Homebrew

brew uninstall mac-cleanup-py
brew untap mac-cleanup/mac-cleanup-py

Using pip

pip3 uninstall mac-cleanup

💡 Usage Options

Help menu:

$ mac-cleanup -h
usage: mac-cleanup [-h] [-n] [-u] [-c] [-p] [-f]

    Python cleanup script for macOS
    Version: 3.3.0
    https://github.com/mac-cleanup/mac-cleanup-py

options:
  -h, --help         show this help message and exit
  -n, --dry-run      Run without deleting stuff
  -u, --update       Update Homebrew on cleanup
  -c, --configure    Open module configuration screen
  -p, --custom-path  Specify path for custom modules
  -f, --force        Accept all warnings
  -v, --verbose      Print folders to be deleted

🌟 Contributing

Contributions are always welcome!
If you have any ideas, suggestions, or bug reports, feel free to submit an issue or open a pull request.

📝 License

This project is licensed under the Apache-2.0 License.

👏 Acknowledgements

This project is developed using tools provided by the JetBrains OSS Development Program.

Find out more about their program and how they support open source here.