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:

Empty Trash
Delete unnecessary logs & files
Clear cache

mac-cleanup-demo

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

Metadata

Release files for mac_cleanup 3.3.0

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_cleanup 3.3.0
File	Size	Uploaded
mac_cleanup-3.3.0.tar.gz	22.9 kB	Mar 19, 2025	Details

Built distribution (wheel)

Table of built distributions (wheels) for mac_cleanup 3.3.0
File	Interpreter	ABI	Platform	Reset
mac_cleanup-3.3.0-py3-none-any.whl 25.0 kB Mar 19, 2025	Python 3	none	any	Details

Total release size: 47.9 kB

Release files / mac_cleanup-3.3.0.tar.gz

Download URL	mac_cleanup-3.3.0.tar.gz
Size	22.9 kB
Tags	Source
SHA-256 checksum How to use checksums	`6773f059ba2025d8121d0c764afe45d1d10d305df23f604b2a485e1360e526a3`
BLAKE2b-256 checksum How to use checksums	`bedc75d83e78c24d7378dad5d3c0c20b68860c0b8e4d2875d242c5ea51f317eb`
Upload date	Mar 19, 2025
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`poetry/2.1.1 CPython/3.13.2 Darwin/24.3.0`

Release files / mac_cleanup-3.3.0-py3-none-any.whl

Download URL	mac_cleanup-3.3.0-py3-none-any.whl
Size	25.0 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`65bc663df82098ecdcf61371fd3cc78bf6e70d93baa62c85d1c91be92c92fcc3`
BLAKE2b-256 checksum How to use checksums	`d2683040c7bc34392b16732e54cc8472da61bd5e703c6b2b3135be4d66295a31`
Upload date	Mar 19, 2025
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`poetry/2.1.1 CPython/3.13.2 Darwin/24.3.0`