{"id":13467607,"url":"https://github.com/mac-cleanup/mac-cleanup-py","last_synced_at":"2025-05-13T22:11:04.529Z","repository":{"id":41239388,"uuid":"508810544","full_name":"mac-cleanup/mac-cleanup-py","owner":"mac-cleanup","description":"👨‍💻 Python cleanup script for macOS","archived":false,"fork":false,"pushed_at":"2025-04-25T12:31:05.000Z","size":8660,"stargazers_count":1919,"open_issues_count":12,"forks_count":76,"subscribers_count":13,"default_branch":"main","last_synced_at":"2025-04-30T14:16:02.166Z","etag":null,"topics":["cleaner","cleanup","macos","script"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mac-cleanup.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null},"funding":{"github":"fwartner"}},"created_at":"2022-06-29T18:50:23.000Z","updated_at":"2025-04-30T08:43:29.000Z","dependencies_parsed_at":"2023-11-25T18:31:35.111Z","dependency_job_id":"ccc8f5dc-9706-4c26-bf46-eb9042a1a715","html_url":"https://github.com/mac-cleanup/mac-cleanup-py","commit_stats":{"total_commits":343,"total_committers":10,"mean_commits":34.3,"dds":"0.23323615160349853","last_synced_commit":"2393e6b268503ec76236eece9c53cac43a549ae8"},"previous_names":[],"tags_count":27,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mac-cleanup%2Fmac-cleanup-py","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mac-cleanup%2Fmac-cleanup-py/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mac-cleanup%2Fmac-cleanup-py/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mac-cleanup%2Fmac-cleanup-py/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mac-cleanup","download_url":"https://codeload.github.com/mac-cleanup/mac-cleanup-py/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254036838,"owners_count":22003654,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cleaner","cleanup","macos","script"],"created_at":"2024-07-31T15:00:58.422Z","updated_at":"2025-05-13T22:11:04.485Z","avatar_url":"https://github.com/mac-cleanup.png","language":"Python","funding_links":["https://github.com/sponsors/fwartner"],"categories":["macOS","Python","macos"],"sub_categories":[],"readme":"# mac-cleanup-py\n\n[![PyPI](https://img.shields.io/pypi/v/mac_cleanup)](https://pypi.org/project/mac-cleanup/)\n[![Tests](https://github.com/mac-cleanup/mac-cleanup-py/actions/workflows/tox.yml/badge.svg)](https://github.com/mac-cleanup/mac-cleanup-py/actions/workflows/tox.yml)\n[![CodeQL](https://github.com/mac-cleanup/mac-cleanup-py/actions/workflows/codeql.yml/badge.svg)](https://github.com/mac-cleanup/mac-cleanup-py/actions/workflows/codeql.yml)\n[![JetBrains](https://img.shields.io/badge/Thanks-JetBrains-green.svg)](https://www.jetbrains.com)\n\n## 🧹 Python cleanup script for macOS\n\n**mac-cleanup-py** is a powerful cleanup script for macOS.\\\nThis project is a rewrite of the original [mac-cleanup-sh](https://github.com/mac-cleanup/mac-cleanup-sh) rewritten in Python.\n\n## 🚀 Features\n\n**mac-cleanup-py** helps you:\n\n1. Empty Trash\n2. Delete unnecessary logs \u0026 files\n3. Clear cache\n\n![mac-cleanup-demo](https://user-images.githubusercontent.com/44712637/231780851-d2197255-e24e-46ba-8355-42bcf588376d.gif)\n\n\u003cdetails\u003e\n   \u003csummary\u003e\n   📦 Default Modules\n   \u003c/summary\u003e\n\n  \u003c/br\u003e\n\n- `adobe` - Clears **Adobe** cache files\n- `android` - Clears **Android** caches\n- `arc` - Clears **Arc Browser** caches\n- `brew` - Clears **Homebrew** cache\n- `bun` - Clears **Bun** cache\n- `cacher` - Clears **Cacher** logs\n- `chrome` - Clears **Google Chrome** cache\n- `chromium` - Clears **Chromium** cache files\n- `composer` - Clears **composer** cache\n- `conan` - Clears **Conan** cache\n- `docker` - Cleanup dangling **Docker** Images and stopped containers\n- `dns_cache` - Clears **DNS** cache\n- `dropbox` - Clears **Dropbox** cache\n- `ea` - Clears **EA App** cache files\n- `gem` - Cleanup any old versions of **Gems**\n- `go` - Clears **Go** cache\n- `google_drive` - Clears **Google Drive** caches\n- `gradle` - Clears **Gradle** caches\n- `inactive_memory` - Purge **Inactive Memory**\n- `ios_apps` - Cleanup **iOS Applications**\n- `ios_backups` - Removes **iOS Device Backups**\n- `java_cache` - Removes **Java head dumps** from home directory\n- `jetbrains` - Removes logs from **PhpStorm**, **PyCharm** etc\n- `kite` - Deletes **Kite** logs\n- `lunarclient` - Removes **Lunar Client** logs and cache\n- `minecraft` - Remove **Minecraft** logs and cache\n- `microsoft_teams` - Remove **Microsoft Teams** logs and cache\n- `npm` - Cleanup **npm** Cache\n- `obsidian` - Clears **Obsidian** cache files\n- `nuget` - Clears **.nuget** package files\n- `pnpm` - Cleanup **pnpm** Cache\n- `pod` - Cleanup **CocoaPods** Cache Files\n- `poetry` - Clears **Poetry** cache\n- `pyenv` - Cleanup **Pyenv-VirtualEnv** Cache\n- `steam` - Remove **Steam** logs and cache\n- `system_caches` - Clear **System cache**\n- `system_log` - Clear **System Log** Files\n- `telegram` - Clear old **Telegram** Cache\n- `trash` - Empty the **Trash** on All Mounted Volumes and the Main HDD\n- `wget_logs` - Remove **Wget** logs and hosts\n- `xcode` - Cleanup **Xcode Derived Data** and **Archives**\n- `xcode_simulators` - Reset **iOS simulators**\n- `yarn` - Cleanup **yarn** Cache\n\n\u003c/details\u003e\n\n## 📥 Installation\n\n### Using Homebrew\n\n```bash\nbrew tap mac-cleanup/mac-cleanup-py\nbrew install mac-cleanup-py\n```\n\n### Using pip\n\n```bash\npip3 install mac-cleanup\n```\n\n## 🗑️ Uninstallation\n\n### Using Homebrew\n\n```bash\nbrew uninstall mac-cleanup-py\nbrew untap mac-cleanup/mac-cleanup-py\n```\n\n### Using pip\n\n```bash\npip3 uninstall mac-cleanup\n```\n\n## 💡 Usage Options\n\nHelp menu:\n\n```\n$ mac-cleanup -h\nusage: mac-cleanup [-h] [-n] [-u] [-c] [-p] [-f]\n\n    Python cleanup script for macOS\n    Version: 3.3.0\n    https://github.com/mac-cleanup/mac-cleanup-py\n\noptions:\n  -h, --help         show this help message and exit\n  -n, --dry-run      Run without deleting stuff\n  -u, --update       Update Homebrew on cleanup\n  -c, --configure    Open module configuration screen\n  -p, --custom-path  Specify path for custom modules\n  -f, --force        Accept all warnings\n  -v, --verbose      Print folders to be deleted\n\n```\n\n## 🌟 Contributing\n\nContributions are always welcome!\\\nIf you have any ideas, suggestions, or bug reports, feel free to submit an issue or open a pull request.\n\n## 📝 License\n\nThis project is licensed under the [Apache-2.0 License](https://github.com/mac-cleanup/mac-cleanup-py/blob/main/LICENSE).\n\n## 👏 Acknowledgements\n\nThis project is developed using tools provided by the _JetBrains OSS Development Program_.\n\n\u003e Find out more about their program and how they support open source [here](https://jb.gg/OpenSourceSupport).\n\n\u003ca href=\"https://www.jetbrains.com\"\u003e\n  \u003cimg src=\"https://resources.jetbrains.com/storage/products/company/brand/logos/jb_square.svg\" alt=\"JetBrains\" width=\"80\"\u003e\n\u003c/a\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmac-cleanup%2Fmac-cleanup-py","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmac-cleanup%2Fmac-cleanup-py","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmac-cleanup%2Fmac-cleanup-py/lists"}