https://github.com/alienator88/pearcleaner
A free, source-available and fair-code licensed mac app cleaner
https://github.com/alienator88/pearcleaner
Last synced: 8 months ago
JSON representation
A free, source-available and fair-code licensed mac app cleaner
- Host: GitHub
- URL: https://github.com/alienator88/pearcleaner
- Owner: alienator88
- License: other
- Created: 2023-11-13T03:55:50.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2024-10-29T17:12:37.000Z (over 1 year ago)
- Last Synced: 2024-10-29T18:40:54.924Z (over 1 year ago)
- Language: Swift
- Homepage: https://itsalin.com/appInfo/?id=pearcleaner
- Size: 1.95 MB
- Stars: 3,297
- Watchers: 12
- Forks: 79
- Open Issues: 7
-
Metadata Files:
- Readme: README.md
- Funding: FUNDING.yml
- License: LICENSE.md
Awesome Lists containing this project
README
# Pearcleaner
Status: Maintained
Version: 5.2.7
Download
·
Commits
A free, source-available and fair-code licensed Mac app cleaner inspired by [Freemacsoft's AppCleaner](https://freemacsoft.net/appcleaner/) and [Sun Knudsen's Privacy Guides](https://github.com/sunknudsen/guides/tree/main/archive/how-to-clean-uninstall-macos-apps-using-appcleaner-open-source-alternative) post on his app-cleaner script.
This project was born out of wanting to learn more on how macOS deals with app installation/uninstallation and getting more Swift experience. If you have suggestions I'm open to hearing them, submit a feature request!
### Table of Contents:
[Features](#features) | [Screenshots](#screenshots) | [Issues](#issues) | [Requirements](#requirements) | [Download](#getting-pearcleaner) | [Translations](#translations) | [License](#license) | [Thanks](#thanks) | [Other Apps](#other-apps)
## Features
### Core
- **App Uninstall • Orphaned File Search • Development Environment Manager • File Search • Homebrew Manager • App Lipo • PKG Manager • Plugin Manager • Services Manager • Apps Updater**
- Drag/drop apps, CLI support, and deep link automation [view](https://github.com/alienator88/Pearcleaner/wiki/Deep-Link-Guide)
- List or Grid view with badges for web/iOS apps
- Finder Extension for right-click uninstall
- Pearcleaner self-uninstall and slimming options
### Utilities
- Prune unused app translations, keeping only preferred languages
- Strip unneeded architectures from universal apps without requirement of lipo binary from xcode tools
- **Sentinel Monitor**: Automatic cleanup when apps hit Trash (~2MB RAM)
- Export app bundles and file lists
- Basic Steam games support
### Customization
- Theme system with custom colors
- Include/exclude directories for searching
- Adjustable search sensitivity
## Screenshots
## Issues
> [!WARNING]
> - When submitting issues, please use the appropriate issue template corresponding with your problem [HERE](https://github.com/alienator88/Pearcleaner/issues/new/choose)
> - Beta versions of macOS will not be supported until general release
## Requirements
> [!NOTE]
> - Full Disk permission to search for files
> - Privileged Helper to perform actions on system folders
| macOS Version | Codename | Supported |
|---------------|----------|-----------|
| 13.x | Ventura | ✅ |
| 14.x | Sonoma | ✅ |
| 15.x | Sequoia | ✅ |
| 26.x | Tahoe | ✅ |
| TBD | Beta | ❌ |
> Versions prior to macOS 13.0 are not supported due to missing Swift/SwiftUI APIs required by the app.
## Getting Pearcleaner
Releases
Pre-compiled, always up-to-date versions are available from my [releases](https://github.com/alienator88/Pearcleaner/releases) page.
Homebrew
You can add the app via Homebrew:
```
brew install pearcleaner
```
## Translations
If you are able to contribute to translations for the app, please see this discussion: https://github.com/alienator88/Pearcleaner/discussions/137
## License
> [!IMPORTANT]
> Pearcleaner is licensed under Apache 2.0 with [Commons Clause](https://commonsclause.com/). This means that you can do anything you'd like with the source, modify it, contribute to it, etc., but the license explicitly prohibits any form of monetization for Pearcleaner or any modified versions of it. See full license [HERE](https://github.com/alienator88/Pearcleaner/blob/main/LICENSE.md)
## Thanks
- Much appreciation to [Freemacsoft's AppCleaner](https://freemacsoft.net/appcleaner/) and [Sun Knudsen's app-cleaner script](https://sunknudsen.com/privacy-guides/how-to-clean-uninstall-macos-apps-using-appcleaner-open-source-alternative)
- [DharsanB](https://github.com/dharsanb) for sponsoring my Apple Developer account
## Other Apps
[Pearcleaner](https://github.com/alienator88/Pearcleaner) - An opensource app cleaner with privacy in mind
[Sentinel](https://github.com/alienator88/Sentinel) - A GUI for controlling gatekeeper status on your Mac
[Viz](https://github.com/alienator88/Viz) - Utility for extracting text from images, videos, qr/barcodes
[PearHID](https://github.com/alienator88/PearHID) - Remap your macOS keyboard with a simple SwiftUI frontend