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

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

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!