Skip to content



PyPI Tests CodeQL JetBrains

🧹 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
  • brew - Clears Homebrew cache
  • cacher - Clears Cacher logs
  • chrome - Clears Google Chrome cache
  • composer - Clears composer cache
  • dns_cache - Clears DNS cache
  • docker - Cleanup dangling Docker Images and stopped containers
  • dropbox - Clears Dropbox cache
  • 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
  • microsoft_teams - Remove Microsoft Teams logs and cache
  • minecraft - Remove Minecraft logs and cache
  • npm - Cleanup npm Cache
  • 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
  • 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
  • telegram - Clear old Telegram 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]

    A Mac Cleanup Utility in Python

  -h, --help         show this help message and exit
  -n, --dry-run      Dry run without deleting stuff
  -u, --update       Update HomeBrew on cleanup
  -c, --configure    Configure default and custom modules
  -p, --custom-path  Specify path for custom modules

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