Skip to content

README.md

Latest commit

 

History

History
157 lines (121 loc) · 9.37 KB

README.md

File metadata and controls

157 lines (121 loc) · 9.37 KB
Raw

MacOS Cleaner Logo
MacOS Cleaner

Free, native, privacy-first cleaner and application uninstaller for macOS.
Built with Swift 6 and SwiftUI. Moves files to Trash by default instead of permanently deleting them.

Requirements: macOS 26.0 or later. Apple Silicon only (Intel Macs are not supported).

Download DMG   Official Website

Release macOS 26+ Swift 6 SwiftUI License

✨ Features  •  📸 Screenshots  •  🛠️ Build from Source  •  📖 Documentation

🛡️ Safety and Architecture

Principle Technical Implementation
No Telemetry No background daemons, analytics SDKs, or remote loggers. All scanning runs locally without network access.
Trash-First Files are moved to macOS Trash via trashItem(at:) when supported, preserving native file recovery.
Protected Paths Hardcoded blocklists protect SIP paths, /System, /Library, /usr, ~/.ssh, and user document directories.
Open Core Swift 6 codebase with strict concurrency, actors, and structured task groups. Core engine and heuristics are inspectable.
On-Device AI Checksums, hashes, and FoundationModels file explanations execute strictly on-device.
Native Runtime Built in Swift 6 and SwiftUI with Liquid Glass materials. No Electron or WebKit container overhead.

📸 Screenshots

Dashboard App Uninstaller

Smart Cleanup Process Manager

View high-resolution screenshots

🚀 Quick Download & Install

  1. Direct Download: Grab the latest .dmg from GitHub Releases.
  2. Mount & Drag: Open the .dmg and drag MacOSCleaner.app into /Applications.
  3. First Launch (Gatekeeper): If macOS shows a Gatekeeper warning on locally built/unnotarized apps: 
    sudo xattr -r -c /Applications/MacOSCleaner.app

    Note: This removes the quarantine attribute set by macOS. It does not modify app files, system security, or grant persistent permissions.

✨ Features

  • Smart Cleanup: scans 55+ categories across system caches, 275+ applications, 85+ developer toolchains & package managers (Xcode, Docker, uv, mise, Rust, Go, Python, Node), local AI models & coding assistants (Claude Code, Ollama, MLX, Hugging Face, WhisperKit), and safe Time Machine snapshot thinning (thinlocalsnapshots).
  • Forensic Uninstaller: inspects 30 evidence types (Bundle ID, Team ID, Spotlight metadata, Launch Services) to trace remnants across 1,800+ known application paths and heuristics, with standalone orphaned residuals discovery, confidence score tiers, post-uninstall review sheets, and root-level helper removal.
  • Duplicate Finder: identifies duplicate files through a 3-stage pipeline (file size matching, 4 KB header checksum, full SHA-256 verification).
  • Disk Space Analyzer: hierarchical folder drill-down with breadcrumb navigation, honest APFS allocated block sizing (totalFileAllocatedSize), Quick Look previews (Space), recursive category filters (Videos, Audio, Photos, Documents, Archives), and dataless iCloud item skip protection.
  • Process and Service Manager: monitors live CPU and RAM usage with termination safeguards for critical processes (kernel_task, launchd), plus LaunchAgents and LaunchDaemons toggling.
  • Native System Integrations: on-device FoundationModels explanations for unknown caches, Siri and App Intents automation, Liquid Glass materials with keyboard navigation (⌘,, ⌘C, ⌘F, ⌘R, ⌘⌫), and 10 language localizations.

Complete feature breakdowns and path specifications are documented in the MacOSCleaner Wiki.

🛠️ Build from Source

Prerequisites: macOS 26.0+, Xcode 18+, XcodeGen.

git clone https://github.com/AlexTkDev/MacOSCleaner.git
cd MacOSCleaner/MacOSCleaner
xcodegen
open MacOSCleaner.xcodeproj

Build and run with ⌘R, or run tests with ⌘U.

Note: Public source builds use the public fallback cleanup catalog.

⭐️ Support & Community

Note: Contributions are subject to the project's Contributor License Agreement (CLA).

👨‍💻 Author

AlexTkDev Aleksandr (AlexTkDev)
Follow on GitHub ORCID Ko-fi Donate

Citation reference: CITATION.cff

📄 License

Dual-licensed:

  • GNU GPLv3 + Commons Clause v1.0 for personal, non-commercial use, testing, and open-source contributions. Commercial resale and commercial re-licensing are prohibited.
  • Commercial License for enterprise, commercial, or proprietary distribution. Contact the author for licensing inquiries.

Trademark Notice: The license does not grant permission to use the project name ("MacOSCleaner"), logos, or branding in derivative works.