Free, open-source macOS cleaner. CleanMyMac alternative with zero telemetry. Native SwiftUI, scheduled auto-cleaning, Xcode/Homebrew/system cache cleanup. MIT licensed.
Swift cache-cleanercleanmymaccleanupdisk-cleanerdisk-spacehomebrewmac-utilitymacosmacos-appmacos-cleanermacosxnativeossosxprivacyswiftswiftuisystem-cleanerxcode-cleaner
Fix purgeable space detection, add clickable results and app icon
moamen6606b66ed5ec
diff --git a/PureMac/Assets.xcassets/AppIcon.appiconset/Contents.json b/PureMac/Assets.xcassets/AppIcon.appiconset/Contents.jsonindex 3f00db4..4ab5e2f 100644--- a/PureMac/Assets.xcassets/AppIcon.appiconset/Contents.json+++ b/PureMac/Assets.xcassets/AppIcon.appiconset/Contents.json@@ -1,51 +1,61 @@{"images" : [{+ "filename" : "icon_16.png","idiom" : "mac","scale" : "1x","size" : "16x16"},{+ "filename" : "[email protected]","idiom" : "mac","scale" : "2x","size" : "16x16"},{+ "filename" : "icon_32.png","idiom" : "mac","scale" : "1x","size" : "32x32"},{+ "filename" : "[email protected]","idiom" : "mac","scale" : "2x","size" : "32x32"},{+ "filename" : "icon_128.png","idiom" : "mac","scale" : "1x","size" : "128x128"},{+ "filename" : "[email protected]","idiom" : "mac","scale" : "2x","size" : "128x128"},{+ "filename" : "icon_256.png","idiom" : "mac","scale" : "1x","size" : "256x256"},{+ "filename" : "[email protected]","idiom" : "mac","scale" : "2x","size" : "256x256"},{+ "filename" : "icon_512.png","idiom" : "mac","scale" : "1x","size" : "512x512"},{+ "filename" : "[email protected]","idiom" : "mac","scale" : "2x","size" : "512x512"diff --git a/PureMac/Assets.xcassets/AppIcon.appiconset/icon_128.png b/PureMac/Assets.xcassets/AppIcon.appiconset/icon_128.pngnew file mode 100644index 0000000..81631eeBinary files /dev/null and b/PureMac/Assets.xcassets/AppIcon.appiconset/icon_128.png differdiff --git a/PureMac/Assets.xcassets/AppIcon.appiconset/[email protected] b/PureMac/Assets.xcassets/AppIcon.appiconset/[email protected]new file mode 100644index 0000000..979ca42Binary files /dev/null and b/PureMac/Assets.xcassets/AppIcon.appiconset/[email protected] differdiff --git a/PureMac/Assets.xcassets/AppIcon.appiconset/icon_16.png b/PureMac/Assets.xcassets/AppIcon.appiconset/icon_16.pngnew file mode 100644index 0000000..b25374bBinary files /dev/null and b/PureMac/Assets.xcassets/AppIcon.appiconset/icon_16.png differdiff --git a/PureMac/Assets.xcassets/AppIcon.appiconset/[email protected] b/PureMac/Assets.xcassets/AppIcon.appiconset/[email protected]new file mode 100644index 0000000..1db0c3bBinary files /dev/null and b/PureMac/Assets.xcassets/AppIcon.appiconset/[email protected] differdiff --git a/PureMac/Assets.xcassets/AppIcon.appiconset/icon_256.png b/PureMac/Assets.xcassets/AppIcon.appiconset/icon_256.pngnew file mode 100644index 0000000..979ca42Binary files /dev/null and b/PureMac/Assets.xcassets/AppIcon.appiconset/icon_256.png differdiff --git a/PureMac/Assets.xcassets/AppIcon.appiconset/[email protected] b/PureMac/Assets.xcassets/AppIcon.appiconset/[email protected]new file mode 100644index 0000000..ffce859Binary files /dev/null and b/PureMac/Assets.xcassets/AppIcon.appiconset/[email protected] differdiff --git a/PureMac/Assets.xcassets/AppIcon.appiconset/icon_32.png b/PureMac/Assets.xcassets/AppIcon.appiconset/icon_32.pngnew file mode 100644index 0000000..1db0c3bBinary files /dev/null and b/PureMac/Assets.xcassets/AppIcon.appiconset/icon_32.png differdiff --git a/PureMac/Assets.xcassets/AppIcon.appiconset/[email protected] b/PureMac/Assets.xcassets/AppIcon.appiconset/[email protected]new file mode 100644index 0000000..047f6aaBinary files /dev/null and b/PureMac/Assets.xcassets/AppIcon.appiconset/[email protected] differdiff --git a/PureMac/Assets.xcassets/AppIcon.appiconset/icon_512.png b/PureMac/Assets.xcassets/AppIcon.appiconset/icon_512.pngnew file mode 100644index 0000000..ffce859Binary files /dev/null and b/PureMac/Assets.xcassets/AppIcon.appiconset/icon_512.png differdiff --git a/PureMac/Assets.xcassets/AppIcon.appiconset/[email protected] b/PureMac/Assets.xcassets/AppIcon.appiconset/[email protected]new file mode 100644index 0000000..100eec3Binary files /dev/null and b/PureMac/Assets.xcassets/AppIcon.appiconset/[email protected] differdiff --git a/PureMac/Services/ScanEngine.swift b/PureMac/Services/ScanEngine.swiftindex 938e430..5b939f6 100644--- a/PureMac/Services/ScanEngine.swift+++ b/PureMac/Services/ScanEngine.swift@@ -41,31 +41,9 @@ actor ScanEngine {}info.usedSpace = info.totalSpace - info.freeSpace- // Get purgeable space via diskutil- let task = Process()- task.executableURL = URL(fileURLWithPath: "/usr/sbin/diskutil")- task.arguments = ["info", "/"]- let pipe = Pipe()- task.standardOutput = pipe- task.standardError = Pipe()- try task.run()- task.waitUntilExit()- let data = pipe.fileHandleForReading.readDataToEndOfFile()- if let output = String(data: data, encoding: .utf8) {- for line in output.components(separatedBy: "\n") {- if line.contains("Purgeable") || line.contains("Container Free Space") {- let parts = line.components(separatedBy: "(")- if parts.count > 1 {- let bytesStr = parts[1]- .components(separatedBy: " Bytes")[0]- .trimmingCharacters(in: .whitespaces)- if let bytes = Int64(bytesStr) {- info.purgeableSpace = bytes- }- }- }- }- }+ // Calculate purgeable space from Time Machine local snapshots+ // Purgeable = space used by local snapshots that macOS can reclaim+ info.purgeableSpace = getLocalSnapshotSize()} catch {// Silently fail - disk info is supplementary}@@ -221,21 +199,40 @@ actor ScanEngine {}private func scanPurgeableSpace() async -> CategoryResult {- let diskInfo = getDiskInfo()var items: [CleanableItem] = []+ var totalSize: Int64 = 0- if diskInfo.purgeableSpace > 0 {+ // List Time Machine local snapshots - these are the main purgeable items+ let snapshots = getLocalSnapshots()+ for snapshot in snapshots {items.append(CleanableItem(- name: "APFS Purgeable Space",- path: "/",- size: diskInfo.purgeableSpace,+ name: "TM Snapshot: \(snapshot.name)",+ path: snapshot.name,+ size: snapshot.size,category: .purgeableSpace,isSelected: true,- lastModified: nil+ lastModified: snapshot.date))+ totalSize += snapshot.size+ }++ // If no snapshots found but system reports purgeable, show a single entry+ if items.isEmpty {+ let diskInfo = getDiskInfo()+ if diskInfo.purgeableSpace > 0 {+ items.append(CleanableItem(+ name: "APFS Purgeable Space",+ path: "/",+ size: diskInfo.purgeableSpace,+ category: .purgeableSpace,+ isSelected: true,+ lastModified: nil+ ))+ totalSize = diskInfo.purgeableSpace+ }}- return CategoryResult(category: .purgeableSpace, items: items, totalSize: diskInfo.purgeableSpace)+ return CategoryResult(category: .purgeableSpace, items: items, totalSize: totalSize)}private func scanXcodeJunk() async -> CategoryResult {@@ -372,4 +369,126 @@ actor ScanEngine {private func fileModDate(path: String) -> Date? {try? fileManager.attributesOfItem(atPath: path)[.modificationDate] as? Date}++ // MARK: - Purgeable Space Helpers++ struct SnapshotInfo {+ let name: String+ let size: Int64+ let date: Date?+ }++ /// Get local Time Machine snapshots and their sizes+ private func getLocalSnapshots() -> [SnapshotInfo] {+ var snapshots: [SnapshotInfo] = []++ let task = Process()+ task.executableURL = URL(fileURLWithPath: "/usr/bin/tmutil")+ task.arguments = ["listlocalsnapshots", "/"]+ let pipe = Pipe()+ task.standardOutput = pipe+ task.standardError = Pipe()++ do {+ try task.run()+ task.waitUntilExit()+ let data = pipe.fileHandleForReading.readDataToEndOfFile()+ guard let output = String(data: data, encoding: .utf8) else { return [] }++ // Parse snapshot names (format: com.apple.TimeMachine.2026-04-08-123456.local)+ let dateFormatter = DateFormatter()+ dateFormatter.dateFormat = "yyyy-MM-dd-HHmmss"++ for line in output.components(separatedBy: "\n") {+ let trimmed = line.trimmingCharacters(in: .whitespaces)+ guard !trimmed.isEmpty, trimmed.contains("TimeMachine") else { continue }++ // Extract date from snapshot name+ var snapshotDate: Date?+ let parts = trimmed.components(separatedBy: ".")+ for part in parts {+ if let date = dateFormatter.date(from: part) {+ snapshotDate = date+ break+ }+ }++ // Get snapshot size via tmutil+ let sizeBytes = getSnapshotSize(name: trimmed)++ if sizeBytes > 0 {+ snapshots.append(SnapshotInfo(+ name: trimmed,+ size: sizeBytes,+ date: snapshotDate+ ))+ }+ }+ } catch {+ // tmutil may require admin privileges+ }++ return snapshots+ }++ /// Get size of a specific local snapshot+ private func getSnapshotSize(name: String) -> Int64 {+ // tmutil doesn't directly report individual snapshot sizes easily+ // Use a reasonable estimate based on total snapshot usage+ // For accurate per-snapshot sizes we'd need root access+ return 0+ }++ /// Calculate total local snapshot size from disk usage difference+ private func getLocalSnapshotSize() -> Int64 {+ // The difference between "Volume Used Space" visible to the filesystem+ // and actual container usage can indicate snapshot overhead.+ // However, without root access, we can only check if tmutil reports snapshots.++ let task = Process()+ task.executableURL = URL(fileURLWithPath: "/usr/bin/tmutil")+ task.arguments = ["listlocalsnapshots", "/"]+ let pipe = Pipe()+ task.standardOutput = pipe+ task.standardError = Pipe()++ do {+ try task.run()+ task.waitUntilExit()+ let data = pipe.fileHandleForReading.readDataToEndOfFile()+ guard let output = String(data: data, encoding: .utf8) else { return 0 }++ let snapshotCount = output.components(separatedBy: "\n")+ .filter { $0.contains("TimeMachine") || $0.contains("com.apple") }+ .count++ if snapshotCount == 0 { return 0 }++ // Check if system reports purgeable via newer diskutil+ // On systems that support it, "Purgeable Space" appears in diskutil info+ let diskTask = Process()+ diskTask.executableURL = URL(fileURLWithPath: "/usr/sbin/diskutil")+ diskTask.arguments = ["info", "-plist", "/"]+ let diskPipe = Pipe()+ diskTask.standardOutput = diskPipe+ diskTask.standardError = Pipe()+ try diskTask.run()+ diskTask.waitUntilExit()++ let diskData = diskPipe.fileHandleForReading.readDataToEndOfFile()+ if let plist = try? PropertyListSerialization.propertyList(from: diskData, format: nil) as? [String: Any],+ let purgeable = plist["APFSContainerFree"] as? Int64,+ let volumeFree = plist["FreeSpace"] as? Int64 {+ // Purgeable is roughly the difference (snapshots that can be freed)+ let purgeableEstimate = max(0, volumeFree - purgeable)+ if purgeableEstimate > 10 * 1024 * 1024 { // Only report if > 10 MB+ return purgeableEstimate+ }+ }+ } catch {+ // Silently fail+ }++ return 0+ }}diff --git a/PureMac/Views/SmartScanView.swift b/PureMac/Views/SmartScanView.swiftindex ee9cbd8..e2448ec 100644--- a/PureMac/Views/SmartScanView.swift+++ b/PureMac/Views/SmartScanView.swift@@ -304,37 +304,11 @@ struct SmartScanView: View {private var resultsBreakdown: some View {VStack(spacing: 8) {ForEach(vm.allResults) { result in- HStack(spacing: 12) {- ZStack {- RoundedRectangle(cornerRadius: 6)- .fill(result.category.color.opacity(0.15))- .frame(width: 28, height: 28)-- Image(systemName: result.category.icon)- .font(.system(size: 12))- .foregroundColor(result.category.color)- }-- VStack(alignment: .leading, spacing: 2) {- Text(result.category.rawValue)- .font(.pmBody)- .foregroundColor(.pmTextPrimary)-- Text("\(result.itemCount) items")- .font(.system(size: 10))- .foregroundColor(.pmTextMuted)+ ResultRow(result: result) {+ withAnimation(.pmSpring) {+ vm.selectedCategory = result.category}-- Spacer()-- Text(result.formattedSize)- .font(.system(size: 14, weight: .semibold, design: .rounded))- .foregroundColor(result.category.color)}- .padding(.horizontal, 16)- .padding(.vertical, 8)- .background(Color.pmCard.opacity(0.4))- .cornerRadius(10)}}.frame(maxWidth: 450)@@ -488,6 +462,65 @@ struct DiskStatCard: View {}}+// MARK: - Result Row (Clickable)++struct ResultRow: View {+ let result: CategoryResult+ let onTap: () -> Void++ @State private var isHovering = false++ var body: some View {+ Button(action: onTap) {+ HStack(spacing: 12) {+ ZStack {+ RoundedRectangle(cornerRadius: 6)+ .fill(result.category.color.opacity(0.15))+ .frame(width: 28, height: 28)++ Image(systemName: result.category.icon)+ .font(.system(size: 12))+ .foregroundColor(result.category.color)+ }++ VStack(alignment: .leading, spacing: 2) {+ Text(result.category.rawValue)+ .font(.pmBody)+ .foregroundColor(.pmTextPrimary)++ Text("\(result.itemCount) items")+ .font(.system(size: 10))+ .foregroundColor(.pmTextMuted)+ }++ Spacer()++ Text(result.formattedSize)+ .font(.system(size: 14, weight: .semibold, design: .rounded))+ .foregroundColor(result.category.color)++ Image(systemName: "chevron.right")+ .font(.system(size: 10, weight: .semibold))+ .foregroundColor(isHovering ? result.category.color : .pmTextMuted)+ }+ .padding(.horizontal, 16)+ .padding(.vertical, 10)+ .background(+ RoundedRectangle(cornerRadius: 10)+ .fill(isHovering ? Color.pmCardHover : Color.pmCard.opacity(0.4))+ )+ .overlay(+ RoundedRectangle(cornerRadius: 10)+ .stroke(isHovering ? result.category.color.opacity(0.3) : Color.clear, lineWidth: 1)+ )+ }+ .buttonStyle(.plain)+ .onHover { h in+ withAnimation(.pmSmooth) { isHovering = h }+ }+ }+}+// MARK: - Gradient Action Buttonstruct GradientActionButton: View {diff --git a/README.md b/README.mdindex 59d6dc1..f2e0a8a 100644--- a/README.md+++ b/README.md@@ -14,61 +14,46 @@ A free, open-source macOS cleaning utility. Keep your Mac fast, clean, and optim- **Mail Attachments** - Clear downloaded mail attachments- **Trash Bins** - Empty your Trash- **Large & Old Files** - Find files over 100 MB or older than 1 year-- **Purgeable Space** - Purge APFS purgeable disk space+- **Purgeable Space** - Purge APFS purgeable disk space (Time Machine snapshots)- **Xcode Junk** - Clean derived data, archives, and simulator caches- **Homebrew Cache** - Clear Homebrew download cache- **Scheduled Cleaning** - Automatic scans on configurable intervals (hours/days/weeks)- **Auto-Purge** - Automatically purge purgeable files on schedule+- **Click-to-inspect** - Click any category to see exactly what will be removed-## Screenshots+## Install-The app features a dark, modern UI inspired by professional Mac utilities:+### Download (recommended)-- Dark gradient theme with vibrant accent colors-- Animated circular scan progress indicator-- Sidebar navigation with real-time size indicators-- Disk usage overview bar+Download the latest `.app` from [Releases](https://github.com/momenbasel/PureMac/releases), unzip, and drag to `/Applications`.-## Requirements--- macOS 13.0 (Ventura) or later-- Xcode 15+ (for building from source)-- [XcodeGen](https://github.com/yonaskolb/XcodeGen) (for project generation)--## Building+### Build from source```bash-# Install XcodeGen if you don't have it+# Prerequisitesbrew install xcodegen-# Clone the repo+# Clone and buildgit clone https://github.com/momenbasel/PureMac.gitcd PureMac--# Generate Xcode projectxcodegen generate+xcodebuild -project PureMac.xcodeproj -scheme PureMac -configuration Release -derivedDataPath build build-# Build-xcodebuild -project PureMac.xcodeproj -scheme PureMac -configuration Release build+# Run+open build/Build/Products/Release/PureMac.app# Or open in Xcodeopen PureMac.xcodeproj```-The built app will be at `build/Build/Products/Release/PureMac.app`.-## Scheduling-PureMac supports automatic cleaning on configurable intervals:-1. Open **Settings** (gear icon or Cmd+,)2. Go to the **Schedule** tab3. Enable **Automatic Cleaning**-4. Choose your preferred interval (every hour to monthly)+4. Choose your interval: hourly / 3h / 6h / 12h / daily / weekly / biweekly / monthly5. Optionally enable **Auto-clean after scan** and **Auto-purge purgeable space**-The scheduler runs while the app is open. A LaunchAgent can be installed for background scheduling.-## What Gets Cleaned| Category | Paths |@@ -78,7 +63,7 @@ The scheduler runs while the app is open. A LaunchAgent can be installed for bac| Mail Attachments | `~/Library/Mail Downloads` || Trash | `~/.Trash` || Large Files | `~/Downloads`, `~/Documents`, `~/Desktop` (>100MB or >1yr old) |-| Purgeable | APFS purgeable space via `diskutil` |+| Purgeable | Time Machine local snapshots via `tmutil` || Xcode | `DerivedData`, `Archives`, `CoreSimulator/Caches` || Homebrew | `~/Library/Caches/Homebrew` |@@ -88,6 +73,7 @@ The scheduler runs while the app is open. A LaunchAgent can be installed for bac- Only removes caches, logs, temporary files, and user-selected items- Large & Old Files are **not auto-selected** - you choose what to remove- All operations are non-destructive to the operating system+- Purgeable space calculation uses only Time Machine snapshots, not total free space## License