mac-cleanup-py
mac-cleanup-py copied to clipboard
๐จโ๐ป Python cleanup script for macOS
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

๐ฆ Default Modules
adobe- Clears Adobe cache filesandroid- Clears Android cachesbrew- Clears Homebrew cachecacher- Clears Cacher logschrome- Clears Google Chrome cachecomposer- Clears composer cachedns_cache- Clears DNS cachedocker- Cleanup dangling Docker Images and stopped containersdropbox- Clears Dropbox cachegem- Cleanup any old versions of Gemsgo- Clears Go cachegoogle_drive- Clears Google Drive cachesgradle- Clears Gradle cachesinactive_memory- Purge Inactive Memoryios_apps- Cleanup iOS Applicationsios_backups- Removes iOS Device Backupsjava_cache- Removes Java head dumps from home directoryjetbrains- Removes logs from PhpStorm, PyCharm etckite- Deletes Kite logslunarclient- Removes Lunar Client logs and cachemicrosoft_teams- Remove Microsoft Teams logs and cacheminecraft- Remove Minecraft logs and cachenpm- Cleanup npm Cachepnpm- Cleanup pnpm Cachepod- Cleanup CocoaPods Cache Filespoetry- Clears Poetry cachepyenv- Cleanup Pyenv-VirtualEnv Cachesteam- Remove Steam logs and cachesystem_caches- Clear System cachesystem_log- Clear System Log Filestrash- Empty the Trash on All Mounted Volumes and the Main HDDwget_logs- Remove Wget logs and hostsxcode- Cleanup Xcode Derived Data and Archivesxcode_simulators- Reset iOS simulatorsyarn- Cleanup yarn Cachetelegram- 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
3.0.4
https://github.com/mac-cleanup/mac-cleanup-py
options:
-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.