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:

Copy "Actual" hash from error

Run brew edit fwartner/tap/mac-cleanup

Press I and change sha256 "<some hash>" with hash from step 1

Press :, then wq and Enter

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

Download: curl -o cleanup https://raw.githubusercontent.com/mac-cleanup/mac-cleanup-sh/main/mac-cleanup
Make it executable: chmod +x cleanup
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