mac-cleanup/mac-cleanup-py

Folders and files

Name		Name	Last commit message	Last commit date
Latest commit History 391 Commits
.github		.github
mac_cleanup		mac_cleanup
tests		tests
.gitignore		.gitignore
.pre-commit-config.yaml		.pre-commit-config.yaml
CODE_OF_CONDUCT.md		CODE_OF_CONDUCT.md
CONTRIBUTING.md		CONTRIBUTING.md
LICENSE		LICENSE
README.md		README.md
SECURITY.md		SECURITY.md
bumpVersion		bumpVersion
module_template.py		module_template.py
poetry.lock		poetry.lock
pyproject.toml		pyproject.toml
tox.ini		tox.ini

Repository files navigation

mac-cleanup-py

PyPI Tests CodeQL JetBrains

🧹 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 install mac-cleanup-py

Using pip

pip3 install mac-cleanup

🗑️ Uninstallation

Using Homebrew

brew uninstall 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