mac-cleanup

A cleanup script for macOS

What does script do?

• Empty the Trash on All Mounted Volumes and the Main HDD
• Clear System Log Files
• Clear Adobe Cache Files
• Cleanup iOS Applications
• Remove iOS Device Backups
• Cleanup Xcode Derived Data and Archives
• Reset iOS simulators
• Cleanup Homebrew Cache
• Cleanup Any Old Versions of Gems
• Cleanup Dangling Docker Images
• Purge Inactive Memory
• Cleanup pip cache
• Cleanup Pyenv-VirtualEnv Cache
• Cleanup npm Cache
• Cleanup Yarn Cache
• Cleanup Docker Images and Stopped Containers
• Cleanup CocoaPods Cache Files
• Cleanup composer cache
• Cleanup Dropbox cache
• Remove PhpStorm logs
• Remove Minecraft logs and cache
• Remove Steam logs and cache
• Remove Lunar Client logs and cache
• Remove Microsoft Teams logs and cache
• Remove Wget logs and hosts
• Removes Cacher logs
• Deletes Android caches
• Clears Gradle caches
• Deletes Kite logs
• Clears Go module cache
• Clears Poetry cache

Install Automatically

Using homebrew

brew tap fwartner/tap
brew install fwartner/tap/mac-cleanup

Error: SHA256 mismatch

If you'll see Error: SHA256 mismatch try this:

1. Copy "Actual" hash from error
2. Run brew edit fwartner/tap/mac-cleanup
3. Press I and change sha256 "<some hash>" with hash from step 1
4. Press :, then wq and Enter
5. Re-run installation
   brew install fwartner/tap/mac-cleanup

Using curl

curl -fsSL https://raw.githubusercontent.com/mac-cleanup/mac-cleanup-sh/main/installer.sh | bash -s install

Using wget

wget https://raw.githubusercontent.com/mac-cleanup/mac-cleanup-sh/main/installer.sh -O - | bash -s install

Step by Step Install

1. Download: curl -o cleanup https://raw.githubusercontent.com/mac-cleanup/mac-cleanup-sh/main/mac-cleanup
2. Make it executable: chmod +x cleanup
3. Move to make it globally usable: sudo mv cleanup /usr/local/bin/cleanup

Note:

If installing with curl you need to call cleanup instead of mac-cleanup.

Update

Using curl

curl -fsSL "https://raw.githubusercontent.com/mac-cleanup/mac-cleanup-sh/main/installer.sh" | bash -s update

Using wget

wget "https://raw.githubusercontent.com/mac-cleanup/mac-cleanup-sh/main/installer.sh" -O - | bash -s update

Uninstall

Using curl

curl -fsSL "https://raw.githubusercontent.com/mac-cleanup/mac-cleanup-sh/main/installer.sh" | bash -s uninstall

Using wget

wget "https://raw.githubusercontent.com/mac-cleanup/mac-cleanup-sh/main/installer.sh" -O - | bash -s uninstall

Usage Options

Help menu:

$ mac-cleanup -h

A Mac Cleanup Utility by fwartner
https://github.com/mac-cleanup/mac-cleanup-sh

USAGE:
 mac-cleanup [FLAGS]

FLAGS:
-h, --help       Prints help menu
-d, --dry-run    Print approx space to be cleaned
-v, --verbose    Print script debug info
-u, --update     Run brew update

Contributors

Code Contributors

This project exists thanks to all the people who contribute.

If you like what I am doing please consider sponsor my work!