Skip to content

whickybravo388/macleaner

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

7 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

MacCleaner — Open Source macOS Cleanup App Built with SwiftUI

macOS 13+ SwiftUI Apple Silicon MIT License

Free native macOS cleaner for caches, logs, browser data, Xcode DerivedData, duplicate files and app leftovers.
Built with SwiftUI. No ads. No tracking. No subscriptions.


What is MacCleaner?

MacCleaner is a free open-source macOS cleanup utility built with SwiftUI.

It helps you scan your Mac, find storage waste, remove cache files, clean browser data, detect duplicate files, uninstall apps with leftovers, and free up disk space safely.

MacCleaner is designed for users who want a simple native Mac cleanup app without ads, tracking, subscriptions, or bloated background services.


Download

Download MacCleaner.dmg — open, drag to Applications, done.

Requires macOS 13+ Ventura and Apple Silicon arm64.


Features

Feature What it does
System Cleanup Clean macOS caches, logs, temporary files and Xcode DerivedData
Browser Cache Cleaner Remove Safari, Chrome, Firefox and Edge cache files
App Uninstaller Delete macOS apps and related leftovers: caches, preferences and containers
Duplicate Finder Find duplicate files using MD5 hashing
Large Files Scanner Find large files over 100 MB that take up disk space
Auto-Clean Scheduler Schedule cleanup hourly, daily, weekly or monthly
Menu Bar Cleaner Run quick cleanup directly from the macOS menu bar
Disk Dashboard See disk usage, top space wasters and cleanup suggestions

Why MacCleaner?

Many Mac cleaner apps are overloaded with subscriptions, background services, aggressive notifications, or tracking.

MacCleaner keeps things simple:

  • Native SwiftUI interface
  • Free and open-source
  • No ads or analytics
  • No paid cleanup limits
  • No unnecessary background bloat
  • Clear confirmation before deleting files

Screenshots

Dashboard with disk usage ring chart

Clean view with category selection

Browser cache cleaning for Safari, Chrome, Firefox, Edge


Architecture

Macclean/
├── cli/                          ← Python CLI (legacy, still works)
│   ├── maccleaner.py
│   ├── commands/
│   └── utils/
├── maccleaner/                   ← SwiftUI macOS App
│   ├── MacCleaner.xcodeproj/
│   └── MacCleaner/
│       ├── MacCleanerApp.swift
│       ├── ContentView.swift
│       ├── Models/
│       ├── ViewModels/
│       ├── Views/
│       └── Services/
├── MacCleaner.dmg                ← Installer
├── README.md
└── .gitignore

Tech Stack

  • SwiftUI — native macOS interface
  • AppKit — macOS system integration
  • CommonCrypto — MD5 hashing for duplicate file detection
  • AppleScript — Trash cleanup via Finder
  • Zero dependencies — built with Apple frameworks

Building from Source

# Compile
SDK=$(xcrun --show-sdk-path)
SRC=maccleaner/MacCleaner

swiftc -sdk "$SDK" -target arm64-apple-macosx13.0 \
  -framework SwiftUI -framework AppKit \
  -parse-as-library -o MacCleaner \
  $(find "$SRC" -name "*.swift")

# Create .app bundle
mkdir -p MacCleaner.app/Contents/MacOS
cp MacCleaner MacCleaner.app/Contents/MacOS/
# Add Info.plist and codesign...

Safety

MacCleaner focuses on safe cleanup instead of aggressive deletion.

  • ✅ Asks for confirmation before deletion
  • ✅ Shows what will be removed before cleaning
  • ✅ Does not remove system-critical files
  • ✅ Trash cleanup is handled through Finder via AppleScript
  • ✅ Requires user-granted filesystem access where needed

Requirements

  • macOS 13+ Ventura
  • Apple Silicon arm64

Recommended GitHub Topics

For better discovery, add these topics in the repository settings:

macos
macos-app
macos-cleaner
mac-cleaner
swift
swiftui
appkit
cache-cleaner
system-cleaner
disk-cleaner
duplicate-files
duplicate-finder
app-uninstaller
xcode-cleaner
browser-cache
open-source
apple-silicon
ventura
productivity
utility

Keywords

macOS cleaner, Mac cleaner, SwiftUI macOS app, native Mac cleaner, cache cleaner, disk cleaner, duplicate file finder, app uninstaller, Xcode DerivedData cleaner, browser cache cleaner, open-source macOS utility.


License

MIT License — free to use and distribute.


Contributing

Pull requests are welcome. Create issues with bugs, feature ideas, or cleanup improvements.