Skip to content

alienator88/Pearcleaner

Repository files navigation

Pearcleaner


Status: Maintained (Bi-weekly release cadence)
Version: 4.0.0
Download · Commits

Pearcleaner - An open-source mac app cleaner | Product Hunt
Featured|HelloGitHub


A free, source-available and fair-code licensed Mac app cleaner inspired by Freemacsoft's AppCleaner and Sun Knudsen's Privacy Guides 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:

Translations | License | Features | Screenshots | Issues | Requirements | Download | Thanks | Other Apps


Translations

If you are able to contribute to translations for the app, please see this discussion: #137

License

Important

Pearcleaner is licensed under Apache 2.0 with Commons Clause. 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

Features

  • Swift/SwiftUI
  • Small app size
  • Orphaned file search for finding remaining files from previously uninstalled applications
  • Development environments file/cache cleaning
  • Sentinel monitor helper that can be enabled to watch Trash folder for deleted apps to cleanup after the fact(Extremely small (210KB) and uses ~2mb of ram to run in the background and file watch)
  • Mini mode which can be enabled from Settings
  • Menubar icon option
  • CLI support
  • Can drop apps to uninstall directly on the Pearcleaner Dock icon or the app window
  • Optional Finder Extension which allows you to uninstall an app directly from Finder by right click > Pearcleaner Uninstall
  • Theme System available with custom color selector
  • Differentiate between regular, Safari web-apps and mobile apps with badges like web and iOS
  • Has clean uninstall menu option for the Pearcleaner app itself if you want to stop using it and get rid of all files and launch items
  • New announcements badge
  • Condition builder to easily include or exclude files from searches when file names don't match the app name/bundle id very well
  • Export app file list search results
  • Optional Homebrew cleanup
  • Include extra directories to search for apps in
  • Exclude files/folders from the leftover file search
  • Custom auto-updater that pulls latest release notes and binaries from GitHub Releases (Pearcleaner should run from /Applications folder to avoid permission issues)

Screenshots

Themes
Mini Mode

Finder Extension
Leftover File Search
Condition Builder
Settings

Issues

Warning

  • When submitting issues, please use the appropriate issue template corresponding with your problem HERE
  • Beta versions of macOS will not be supported until general release

Requirements

Note

  • MacOS 13.0+ [Non-beta releases]
  • Full Disk permission to search for files
  • Accessibility permission to delete/restore files
  • Automation permission to control Finder

Getting Pearcleaner

Releases

Pre-compiled, always up-to-date versions are available from my releases page.

Homebrew

You can add the app via Homebrew:

brew install pearcleaner

Thanks

Other Apps

Pearcleaner - An opensource app cleaner with privacy in mind

Sentinel - A GUI for controlling gatekeeper status on your Mac

Viz - Utility for extracting text from images, videos, qr/barcodes