Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/alienator88/Pearcleaner

A free, source-available and fair-code licensed mac app cleaner
https://github.com/alienator88/Pearcleaner

Last synced: 9 days 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 (12 months ago)
Default Branch: main
Last Pushed: 2024-10-29T17:12:37.000Z (10 days ago)
Last Synced: 2024-10-29T18:40:54.924Z (10 days 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

StarryDivineSky - alienator88/Pearcleaner
super-awesome-mac - Pearcleaner

README

        # Pearcleaner



   

   


   Status: Maintained

   


   Version: 3.9.2

   


   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://sunknudsen.com/privacy-guides/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:

[Translations](#translations) | [License](#license) | [Features](#features) | [Screenshots](#screenshots) | [Issues](#issues) | [Requirements](#requirements) | [Download](#getting-pearcleaner) | [Thanks](#thanks) | [Other Apps](#other-apps)




## 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)

## Features

- Swift/SwiftUI

- Small app size

- Orphaned file search for finding remaining files from previously uninstalled applications

- 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](https://github.com/alienator88/Pearcleaner/issues/new/choose)

> - Issue templates not filled out with the requested details will be closed.

> - 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](https://github.com/alienator88/Pearcleaner/releases) page.

  Homebrew

You can add the app via Homebrew:

```

brew install pearcleaner

```

## 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