Skip to content

Free, open-source macOS cleaner. CleanMyMac alternative with zero telemetry. Native SwiftUI, scheduled auto-cleaning, Xcode/Homebrew/system cache cleanup. MIT licensed.

feat: v2.8.2 - Riot detection, scan perf, large-file exclusions, orphan ignore

momenbasela48a74461961
diff --git a/.gitignore b/.gitignore
index 36131fc..58d2cab 100644
--- a/.gitignore
+++ b/.gitignore
@@ -1,5 +1,6 @@
# Xcode
build/
+build-ci/
DerivedData/
*.xcworkspace
!*.xcworkspace/contents.xcworkspacedata
diff --git a/PureMac.xcodeproj/project.pbxproj b/PureMac.xcodeproj/project.pbxproj
index 2da84c7..6d51a3e 100644
--- a/PureMac.xcodeproj/project.pbxproj
+++ b/PureMac.xcodeproj/project.pbxproj
@@ -537,7 +537,7 @@
CODE_SIGN_STYLE = Automatic;
COMBINE_HIDPI_IMAGES = YES;
COPY_PHASE_STRIP = NO;
- CURRENT_PROJECT_VERSION = 14;
+ CURRENT_PROJECT_VERSION = 17;
DEBUG_INFORMATION_FORMAT = dwarf;
DEVELOPMENT_TEAM = H3WXHVTP97;
ENABLE_STRICT_OBJC_MSGSEND = YES;
@@ -559,7 +559,7 @@
GENERATE_INFOPLIST_FILE = NO;
INFOPLIST_FILE = PureMac/Info.plist;
MACOSX_DEPLOYMENT_TARGET = 13.0;
- MARKETING_VERSION = 2.7.0;
+ MARKETING_VERSION = 2.8.2;
MTL_ENABLE_DEBUG_INFO = INCLUDE_SOURCE;
MTL_FAST_MATH = YES;
ONLY_ACTIVE_ARCH = NO;
@@ -661,7 +661,7 @@
CODE_SIGN_STYLE = Automatic;
COMBINE_HIDPI_IMAGES = YES;
COPY_PHASE_STRIP = NO;
- CURRENT_PROJECT_VERSION = 14;
+ CURRENT_PROJECT_VERSION = 17;
DEBUG_INFORMATION_FORMAT = "dwarf-with-dsym";
DEVELOPMENT_TEAM = H3WXHVTP97;
ENABLE_NS_ASSERTIONS = NO;
@@ -677,7 +677,7 @@
GENERATE_INFOPLIST_FILE = NO;
INFOPLIST_FILE = PureMac/Info.plist;
MACOSX_DEPLOYMENT_TARGET = 13.0;
- MARKETING_VERSION = 2.7.0;
+ MARKETING_VERSION = 2.8.2;
MTL_ENABLE_DEBUG_INFO = NO;
MTL_FAST_MATH = YES;
ONLY_ACTIVE_ARCH = NO;
diff --git a/PureMac/Logic/Scanning/AppInfoFetcher.swift b/PureMac/Logic/Scanning/AppInfoFetcher.swift
index ef48766..31e377e 100644
--- a/PureMac/Logic/Scanning/AppInfoFetcher.swift
+++ b/PureMac/Logic/Scanning/AppInfoFetcher.swift
@@ -45,13 +45,23 @@ final class AppInfoFetcher {
var apps: [InstalledApp] = []
var seenBundleIDs: Set<String> = []
- let searchPaths = [
- "/Applications",
- "\(home)/Applications",
- "/System/Applications",
+ // `/Users/Shared` is where game launchers (Riot Client, some Blizzard
+ // and Epic helpers) drop their `.app` bundles instead of /Applications,
+ // so it has to be scanned for those to show up in the uninstaller
+ // (issue #123). It can also hold multi-gigabyte game data trees, so it
+ // is depth-bounded — the launcher bundles live within the first few
+ // levels (e.g. /Users/Shared/Riot Games/Riot Client.app at depth 2);
+ // the bound is kept generous (6) so a vendor that nests one or two
+ // directories deeper is still found, while the multi-gigabyte asset
+ // trees below that are not walked.
+ let searchRoots: [(path: String, maxDepth: Int)] = [
+ ("/Applications", 8),
+ ("\(home)/Applications", 8),
+ ("/System/Applications", 8),
+ ("/Users/Shared", 6),
]
- for searchPath in searchPaths {
+ for (searchPath, maxDepth) in searchRoots {
guard let enumerator = fileManager.enumerator(
at: URL(fileURLWithPath: searchPath),
includingPropertiesForKeys: [.isDirectoryKey],
@@ -59,7 +69,14 @@ final class AppInfoFetcher {
) else { continue }
for case let url as URL in enumerator {
- guard url.pathExtension == "app" else { continue }
+ guard url.pathExtension == "app" else {
+ // Stop descending once past the depth bound so a deep data
+ // tree (e.g. a game's assets) doesn't get fully walked.
+ if enumerator.level >= maxDepth {
+ enumerator.skipDescendants()
+ }
+ continue
+ }
// Skip subdirectories inside .app bundles
enumerator.skipDescendants()
diff --git a/PureMac/Services/ScanEngine.swift b/PureMac/Services/ScanEngine.swift
index 5c74cc9..882cbd6 100644
--- a/PureMac/Services/ScanEngine.swift
+++ b/PureMac/Services/ScanEngine.swift
@@ -15,7 +15,7 @@ actor ScanEngine {
private func report(_ path: @autoclosure () -> String) {
guard let onPath else { return }
let now = Date()
- guard now.timeIntervalSince(lastReport) > 0.08 else { return }
+ guard now.timeIntervalSince(lastReport) > 0.1 else { return }
lastReport = now
onPath(path())
}
@@ -253,8 +253,36 @@ actor ScanEngine {
private func scanLargeFiles() -> CategoryResult {
var items: [CleanableItem] = []
- let minSize: Int64 = 100 * 1024 * 1024 // 100 MB
- let oneYearAgo = Calendar.current.date(byAdding: .year, value: -1, to: Date())!
+
+ // Honor the thresholds the user set in Settings → Cleaning. These keys
+ // were previously surfaced in the UI but never read here, so the sliders
+ // did nothing; defaults match the old hardcoded 100 MB / 12-month values.
+ let defaults = UserDefaults.standard
+ let thresholdMB = defaults.object(forKey: "settings.cleaning.largeFileThreshold") as? Int ?? 100
+ let oldFileMonths = defaults.object(forKey: "settings.cleaning.oldFileMonths") as? Int ?? 12
+ let minSize = Int64(max(1, thresholdMB)) * 1024 * 1024
+ let oldCutoff = Calendar.current.date(byAdding: .month, value: -max(1, oldFileMonths), to: Date())
+ ?? Date.distantPast
+
+ // Folders the user excluded from the large-file scan (issue #121) —
+ // e.g. VM images, media libraries, project assets they never want
+ // surfaced. Files anywhere inside an excluded folder are skipped, and
+ // the directory subtree is pruned so we don't even walk it.
+ let excludedFolders = (defaults.stringArray(forKey: "settings.cleaning.largeFileExcludedFolders") ?? [])
+ .map(normalizePath)
+ .filter { !$0.isEmpty }
+
+ // Honor the "Skip hidden files during scan" toggle, which was a dead
+ // control until now (no scanner read it). Default true preserves the
+ // previous always-skip behavior.
+ let skipHidden = defaults.object(forKey: "settings.cleaning.skipHiddenFiles") as? Bool ?? true
+ var enumerationOptions: FileManager.DirectoryEnumerationOptions = [.skipsPackageDescendants]
+ if skipHidden { enumerationOptions.insert(.skipsHiddenFiles) }
+
+ func isExcluded(_ path: String) -> Bool {
+ let normalized = normalizePath(path)
+ return excludedFolders.contains { normalized == $0 || normalized.hasPrefix($0 + "/") }
+ }
let searchPaths = [
"\(home)/Downloads",
@@ -266,7 +294,7 @@ actor ScanEngine {
guard let enumerator = fileManager.enumerator(
at: URL(fileURLWithPath: basePath),
includingPropertiesForKeys: [.fileSizeKey, .contentModificationDateKey, .isRegularFileKey],
- options: [.skipsHiddenFiles, .skipsPackageDescendants]
+ options: enumerationOptions
) else { continue }
// No entry cap. A 5k cap was here previously and meant any user
@@ -274,6 +302,13 @@ actor ScanEngine {
// checkouts) would never see anything past entry 5k — the
// scattered 100+ MB files were always past that bound.
for case let fileURL as URL in enumerator {
+ // Prune excluded subtrees: hitting the excluded directory itself
+ // skips its whole contents; for files the call is a harmless no-op.
+ // Skip the path normalization entirely when nothing is excluded.
+ if !excludedFolders.isEmpty, isExcluded(fileURL.path) {
+ enumerator.skipDescendants()
+ continue
+ }
report(fileURL.path)
guard let resourceValues = try? fileURL.resourceValues(forKeys: [.fileSizeKey, .contentModificationDateKey, .isRegularFileKey]),
let isFile = resourceValues.isRegularFile, isFile,
@@ -283,7 +318,7 @@ actor ScanEngine {
let size = Int64(fileSize)
let modDate = resourceValues.contentModificationDate
- if size > minSize || (modDate != nil && modDate! < oneYearAgo && size > 10 * 1024 * 1024) {
+ if size > minSize || (modDate != nil && modDate! < oldCutoff && size > 10 * 1024 * 1024) {
items.append(CleanableItem(
name: fileURL.lastPathComponent,
path: fileURL.path,
diff --git a/PureMac/ViewModels/AppState.swift b/PureMac/ViewModels/AppState.swift
index 0b6879e..cb62eac 100644
--- a/PureMac/ViewModels/AppState.swift
+++ b/PureMac/ViewModels/AppState.swift
@@ -27,6 +27,18 @@ enum ExternalUninstallBuffer {
static var pendingPath: String?
}
+/// Standalone observable for the live scan-path ticker. The scan engine reports
+/// the filesystem path it is touching ~10×/sec. Routing that through AppState's
+/// own `@Published` storage republished the *entire* view tree at that rate,
+/// which surfaced as window-drag / button-hover lag and a Smart Scan that
+/// looked frozen until you switched sidebar sections and forced a fresh render
+/// (issues #119, #120). Isolating the high-frequency value here means only the
+/// small ticker label observes it, so the rest of the UI stays still.
+@MainActor
+final class ScanProgressTicker: ObservableObject {
+ @Published var path: String = ""
+}
+
@MainActor
final class AppState: ObservableObject {
typealias AppFileScanner = @MainActor (
@@ -46,9 +58,11 @@ final class AppState: ObservableObject {
@Published var scanProgress: Double = 0
@Published var cleanProgress: Double = 0
@Published var currentScanCategory: String = ""
- /// Last filesystem path the scan engine touched — feeds the dashboard's
- /// live ticker. Throttled at the engine side (~10Hz).
- @Published var currentScanPath: String = ""
+ /// Live filesystem path the scan engine is touching, feeding the dashboard's
+ /// ticker. Deliberately NOT a `@Published` on AppState — it updates ~10×/sec
+ /// and would otherwise invalidate the whole view tree (issues #119, #120).
+ /// Only the ticker label observes this object directly.
+ let scanTicker = ScanProgressTicker()
@Published var showCleanConfirmation = false
@Published var lastCleanedDate: Date?
@Published var selectedCleanupItems: Set<UUID> = []
@@ -501,6 +515,10 @@ final class AppState: ObservableObject {
let knownApps = await MainActor.run { self.installedApps }
let knownIDs = Set(knownApps.map { $0.bundleIdentifier.normalizedForMatching() })
let knownNames = Set(knownApps.map { $0.appName.normalizedForMatching() })
+ // Paths the user marked "Always Ignore" (issue #114). These were
+ // false positives for them, so they stay hidden from every scan
+ // until the user forgets the list in Settings.
+ let ignored = Set(UserDefaults.standard.stringArray(forKey: Self.ignoredOrphansKey) ?? [])
var orphans: [URL] = []
let fm = FileManager.default
@@ -519,6 +537,7 @@ final class AppState: ObservableObject {
if !belongsToApp {
let fullPath = URL(fileURLWithPath: path).appendingPathComponent(item)
+ if ignored.contains(fullPath.path) { continue }
if OrphanSafetyPolicy.isSafeCandidate(fullPath) {
orphans.append(fullPath)
}
@@ -534,6 +553,41 @@ final class AppState: ObservableObject {
}
}
+ // MARK: - Orphan ignore list (#114)
+
+ static let ignoredOrphansKey = "settings.orphans.ignored"
+
+ /// Number of paths currently on the "always ignore" list. Read from
+ /// UserDefaults each access so the Settings row tracks live changes.
+ var ignoredOrphanCount: Int {
+ UserDefaults.standard.stringArray(forKey: Self.ignoredOrphansKey)?.count ?? 0
+ }
+
+ /// Permanently hide the given orphans from future scans and sweep them out
+ /// of the current results.
+ func ignoreOrphans(_ urls: [URL]) {
+ guard !urls.isEmpty else { return }
+ var ignored = Set(UserDefaults.standard.stringArray(forKey: Self.ignoredOrphansKey) ?? [])
+ for url in urls { ignored.insert(url.path) }
+ UserDefaults.standard.set(Array(ignored), forKey: Self.ignoredOrphansKey)
+
+ let urlSet = Set(urls)
+ if NSWorkspace.shared.accessibilityDisplayShouldReduceMotion {
+ orphanedFiles.removeAll { urlSet.contains($0) }
+ } else {
+ withAnimation(.spring(response: 0.35, dampingFraction: 0.8)) {
+ orphanedFiles.removeAll { urlSet.contains($0) }
+ }
+ }
+ Logger.shared.log("Ignoring \(urls.count) orphan(s) in future scans", level: .info)
+ }
+
+ /// Forget every ignored path so they can surface again on the next scan.
+ func clearIgnoredOrphans() {
+ UserDefaults.standard.removeObject(forKey: Self.ignoredOrphansKey)
+ objectWillChange.send()
+ }
+
// MARK: - Selection
func isItemSelected(_ item: CleanableItem) -> Bool {
@@ -765,7 +819,7 @@ final class AppState: ObservableObject {
let result = await scanEngine.scanCategory(category) { [weak self] path in
Task { @MainActor [weak self] in
- self?.currentScanPath = path
+ self?.scanTicker.path = path
}
}
categoryResults[category] = result
@@ -773,7 +827,7 @@ final class AppState: ObservableObject {
}
scanProgress = 1.0
- currentScanPath = ""
+ scanTicker.path = ""
scanState = .completed
loadDiskInfo()
}
@@ -790,14 +844,14 @@ final class AppState: ObservableObject {
clearSelectionState(for: category)
let result = await scanEngine.scanCategory(category) { [weak self] path in
Task { @MainActor [weak self] in
- self?.currentScanPath = path
+ self?.scanTicker.path = path
}
}
categoryResults[category] = result
totalJunkSize = categoryResults.values.reduce(0) { $0 + $1.totalSize }
scanProgress = 1.0
- currentScanPath = ""
+ scanTicker.path = ""
scanState = .completed
}
}
diff --git a/PureMac/Views/DashboardView.swift b/PureMac/Views/DashboardView.swift
index e849c2b..a79ebd2 100644
--- a/PureMac/Views/DashboardView.swift
+++ b/PureMac/Views/DashboardView.swift
@@ -451,16 +451,10 @@ struct DashboardView: View {
.padding(.top, 2)
// Live file-path ticker — the "it's really working"
- // signal. Fixed height so rapid path swaps don't bounce
- // the layout.
- Text(tickerPath)
- .font(.system(size: 11, design: .monospaced))
- .foregroundStyle(.tertiary)
- .lineLimit(1)
- .truncationMode(.middle)
- .frame(maxWidth: 360, alignment: .leading)
- .frame(height: 14)
- .opacity(tickerPath.isEmpty ? 0 : 1)
+ // signal. Observes the standalone ScanProgressTicker so the
+ // ~10Hz path churn re-renders only this label, not the whole
+ // dashboard (issues #119, #120).
+ ScanPathTicker(ticker: appState.scanTicker)
}
.animation(reduceMotion ? nil : .easeOut(duration: 0.18), value: appState.currentScanCategory)
Spacer(minLength: 0)
@@ -468,11 +462,6 @@ struct DashboardView: View {
}
}
- private var tickerPath: String {
- guard !appState.currentScanPath.isEmpty else { return "" }
- return (appState.currentScanPath as NSString).abbreviatingWithTildeInPath
- }
-
private var currentlyInText: String {
String(
format: String(localized: "Currently in: %@"),
@@ -770,6 +759,29 @@ private struct SuggestionRow: View {
}
}
+/// Live file-path ticker. Observes the standalone `ScanProgressTicker` directly
+/// so the scan engine's ~10Hz path updates re-render only this one label rather
+/// than the whole AppState-observing view tree (issues #119, #120).
+private struct ScanPathTicker: View {
+ @ObservedObject var ticker: ScanProgressTicker
+
+ private var display: String {
+ guard !ticker.path.isEmpty else { return "" }
+ return (ticker.path as NSString).abbreviatingWithTildeInPath
+ }
+
+ var body: some View {
+ Text(display)
+ .font(.system(size: 11, design: .monospaced))
+ .foregroundStyle(.tertiary)
+ .lineLimit(1)
+ .truncationMode(.middle)
+ .frame(maxWidth: 360, alignment: .leading)
+ .frame(height: 14)
+ .opacity(display.isEmpty ? 0 : 1)
+ }
+}
+
// MARK: - Gauges
private struct LegendDot: View {
diff --git a/PureMac/Views/Orphans/OrphanListView.swift b/PureMac/Views/Orphans/OrphanListView.swift
index a018e64..38973c4 100644
--- a/PureMac/Views/Orphans/OrphanListView.swift
+++ b/PureMac/Views/Orphans/OrphanListView.swift
@@ -33,6 +33,7 @@ struct OrphanListView: View {
NSPasteboard.general.clearContents()
NSPasteboard.general.setString(fileURL.path, forType: .string)
},
+ onIgnore: { ignoreOrphans([fileURL]) },
onTrash: { Task { await removeSingleOrphan(fileURL) } }
)
.transition(
@@ -65,6 +66,11 @@ struct OrphanListView: View {
}
if !selectedOrphans.isEmpty {
+ Button(ignoreSelectedLabel) {
+ ignoreOrphans(Array(selectedOrphans))
+ }
+ .disabled(isRemoving)
+
Button(removeSelectedLabel, role: .destructive) {
Task {
await removeSelectedOrphans()
@@ -94,6 +100,17 @@ struct OrphanListView: View {
String(format: String(localized: "Remove Selected (%lld)"), Int64(selectedOrphans.count))
}
+ private var ignoreSelectedLabel: String {
+ String(format: String(localized: "Ignore Selected (%lld)"), Int64(selectedOrphans.count))
+ }
+
+ /// Persist the given URLs to the ignore list (so future scans skip them)
+ /// and drop them from the local selection.
+ private func ignoreOrphans(_ urls: [URL]) {
+ appState.ignoreOrphans(urls)
+ selectedOrphans.subtract(urls)
+ }
+
private func orphanBinding(for url: URL) -> Binding<Bool> {
Binding(
get: { selectedOrphans.contains(url) },
@@ -272,6 +289,7 @@ private struct OrphanRowView: View {
let fileSize: Int64?
let onReveal: () -> Void
let onCopyPath: () -> Void
+ let onIgnore: () -> Void
let onTrash: () -> Void
@State private var hovering = false
@@ -316,6 +334,7 @@ private struct OrphanRowView: View {
Button("Reveal in Finder") { onReveal() }
Button("Copy Path") { onCopyPath() }
Divider()
+ Button("Always Ignore") { onIgnore() }
Button("Move to Trash", role: .destructive) { onTrash() }
}
}
diff --git a/PureMac/Views/Settings/SettingsView.swift b/PureMac/Views/Settings/SettingsView.swift
index 772fd41..8c5e4d7 100644
--- a/PureMac/Views/Settings/SettingsView.swift
+++ b/PureMac/Views/Settings/SettingsView.swift
@@ -159,10 +159,14 @@ struct GeneralSettingsView: View {
// MARK: - Cleaning
struct CleaningSettingsView: View {
+ @EnvironmentObject var appState: AppState
@AppStorage("settings.cleaning.skipHiddenFiles") private var skipHiddenFiles = true
@AppStorage("settings.cleaning.largeFileThreshold") private var largeFileThresholdMB: Int = 100
@AppStorage("settings.cleaning.oldFileMonths") private var oldFileMonths: Int = 12
+ private static let excludedFoldersKey = "settings.cleaning.largeFileExcludedFolders"
+ @State private var excludedFolders: [String] = []
+
var body: some View {
Form {
Section("File Discovery") {
@@ -182,8 +186,82 @@ struct CleaningSettingsView: View {
in: 1...60
)
}
+
+ Section("Excluded Folders") {
+ if excludedFolders.isEmpty {
+ Text("Files inside these folders are skipped from the Large & Old Files scan (Downloads, Documents, Desktop).")
+ .font(.caption)
+ .foregroundStyle(.secondary)
+ } else {
+ ForEach(excludedFolders, id: \.self) { folder in
+ HStack(spacing: 8) {
+ Image(systemName: "folder")
+ .foregroundStyle(.secondary)
+ Text((folder as NSString).abbreviatingWithTildeInPath)
+ .lineLimit(1)
+ .truncationMode(.middle)
+ .help(folder)
+ Spacer()
+ Button {
+ removeExcludedFolder(folder)
+ } label: {
+ Image(systemName: "minus.circle.fill")
+ .foregroundStyle(.secondary)
+ }
+ .buttonStyle(.borderless)
+ .help(String(localized: "Remove from exclusions"))
+ }
+ }
+ }
+ Button("Add Folder…") { addExcludedFolder() }
+ }
+
+ Section("Orphan Finder") {
+ HStack {
+ // Read the live count directly (it's a UserDefaults-backed
+ // computed property on AppState) so it stays correct when
+ // orphans are ignored from the Orphans view while this tab
+ // is open. AppState fires objectWillChange on both ignore
+ // (via @Published orphanedFiles) and clear, re-rendering this.
+ Text(String(format: String(localized: "Ignored orphans: %lld"), Int64(appState.ignoredOrphanCount)))
+ .foregroundStyle(.secondary)
+ Spacer()
+ Button("Forget Ignored") {
+ appState.clearIgnoredOrphans()
+ }
+ .disabled(appState.ignoredOrphanCount == 0)
+ }
+ Text("Ignored files won't appear in future orphan scans.")
+ .font(.caption)
+ .foregroundStyle(.secondary)
+ }
}
.formStyle(.grouped)
+ .onAppear {
+ excludedFolders = UserDefaults.standard.stringArray(forKey: Self.excludedFoldersKey) ?? []
+ }
+ }
+
+ private func persistExcludedFolders() {
+ UserDefaults.standard.set(excludedFolders, forKey: Self.excludedFoldersKey)
+ }
+
+ private func addExcludedFolder() {
+ let panel = NSOpenPanel()
+ panel.canChooseDirectories = true
+ panel.canChooseFiles = false
+ panel.allowsMultipleSelection = true
+ panel.prompt = String(localized: "Add Folder…")
+ guard panel.runModal() == .OK else { return }
+ for url in panel.urls where !excludedFolders.contains(url.path) {
+ excludedFolders.append(url.path)
+ }
+ persistExcludedFolders()
+ }
+
+ private func removeExcludedFolder(_ folder: String) {
+ excludedFolders.removeAll { $0 == folder }
+ persistExcludedFolders()
}
}
diff --git a/PureMac/ar.lproj/Localizable.strings b/PureMac/ar.lproj/Localizable.strings
index c1d5e9e..4930da7 100644
--- a/PureMac/ar.lproj/Localizable.strings
+++ b/PureMac/ar.lproj/Localizable.strings
@@ -351,3 +351,16 @@
/* v2.8.1: purgeable honesty */
"Managed by macOS" = "تُدار بواسطة macOS";
"Reserved by macOS - freed automatically when space is needed" = "محجوزة بواسطة macOS - تُحرَّر تلقائيًا عند الحاجة إلى مساحة";
+
+/* v2.8.2: large-file folder exclusions (#121) */
+"Excluded Folders" = "المجلدات المستثناة";
+"Files inside these folders are skipped from the Large & Old Files scan (Downloads, Documents, Desktop)." = "يتم تخطّي الملفات داخل هذه المجلدات في فحص الملفات الكبيرة والقديمة (التنزيلات، المستندات، سطح المكتب).";
+"Remove from exclusions" = "إزالة من المستثناة";
+"Add Folder…" = "إضافة مجلد…";
+
+/* v2.8.2: orphan ignore list (#114) */
+"Always Ignore" = "تجاهل دائمًا";
+"Ignore Selected (%lld)" = "تجاهل المحدد (%lld)";
+"Ignored orphans: %lld" = "الملفات اليتيمة المتجاهَلة: %lld";
+"Forget Ignored" = "نسيان المتجاهَلة";
+"Ignored files won't appear in future orphan scans." = "لن تظهر الملفات المتجاهَلة في عمليات فحص الملفات اليتيمة المستقبلية.";
diff --git a/PureMac/en.lproj/Localizable.strings b/PureMac/en.lproj/Localizable.strings
index 365e71c..a6c686a 100644
--- a/PureMac/en.lproj/Localizable.strings
+++ b/PureMac/en.lproj/Localizable.strings
@@ -351,3 +351,16 @@
/* v2.8.1: purgeable honesty */
"Managed by macOS" = "Managed by macOS";
"Reserved by macOS - freed automatically when space is needed" = "Reserved by macOS - freed automatically when space is needed";
+
+/* v2.8.2: large-file folder exclusions (#121) */
+"Excluded Folders" = "Excluded Folders";
+"Files inside these folders are skipped from the Large & Old Files scan (Downloads, Documents, Desktop)." = "Files inside these folders are skipped from the Large & Old Files scan (Downloads, Documents, Desktop).";
+"Remove from exclusions" = "Remove from exclusions";
+"Add Folder…" = "Add Folder…";
+
+/* v2.8.2: orphan ignore list (#114) */
+"Always Ignore" = "Always Ignore";
+"Ignore Selected (%lld)" = "Ignore Selected (%lld)";
+"Ignored orphans: %lld" = "Ignored orphans: %lld";
+"Forget Ignored" = "Forget Ignored";
+"Ignored files won't appear in future orphan scans." = "Ignored files won't appear in future orphan scans.";
diff --git a/PureMac/es.lproj/Localizable.strings b/PureMac/es.lproj/Localizable.strings
index df5104e..2edaeda 100644
--- a/PureMac/es.lproj/Localizable.strings
+++ b/PureMac/es.lproj/Localizable.strings
@@ -351,3 +351,16 @@
/* v2.8.1: purgeable honesty */
"Managed by macOS" = "Gestionado por macOS";
"Reserved by macOS - freed automatically when space is needed" = "Reservado por macOS - se libera automáticamente cuando se necesita espacio";
+
+/* v2.8.2: large-file folder exclusions (#121) */
+"Excluded Folders" = "Carpetas excluidas";
+"Files inside these folders are skipped from the Large & Old Files scan (Downloads, Documents, Desktop)." = "Los archivos dentro de estas carpetas se omiten en el análisis de archivos grandes y antiguos (Descargas, Documentos, Escritorio).";
+"Remove from exclusions" = "Quitar de las exclusiones";
+"Add Folder…" = "Añadir carpeta…";
+
+/* v2.8.2: orphan ignore list (#114) */
+"Always Ignore" = "Ignorar siempre";
+"Ignore Selected (%lld)" = "Ignorar seleccionados (%lld)";
+"Ignored orphans: %lld" = "Huérfanos ignorados: %lld";
+"Forget Ignored" = "Olvidar ignorados";
+"Ignored files won't appear in future orphan scans." = "Los archivos ignorados no aparecerán en futuros análisis de huérfanos.";
diff --git a/PureMac/ja.lproj/Localizable.strings b/PureMac/ja.lproj/Localizable.strings
index 17341e8..10bf101 100644
--- a/PureMac/ja.lproj/Localizable.strings
+++ b/PureMac/ja.lproj/Localizable.strings
@@ -351,3 +351,16 @@
/* v2.8.1: purgeable honesty */
"Managed by macOS" = "macOS が管理";
"Reserved by macOS - freed automatically when space is needed" = "macOS が予約 - 空き容量が必要になると自動的に解放されます";
+
+/* v2.8.2: large-file folder exclusions (#121) */
+"Excluded Folders" = "除外するフォルダ";
+"Files inside these folders are skipped from the Large & Old Files scan (Downloads, Documents, Desktop)." = "これらのフォルダ内のファイルは「大きい/古いファイル」スキャン(ダウンロード、書類、デスクトップ)でスキップされます。";
+"Remove from exclusions" = "除外から削除";
+"Add Folder…" = "フォルダを追加…";
+
+/* v2.8.2: orphan ignore list (#114) */
+"Always Ignore" = "常に無視";
+"Ignore Selected (%lld)" = "選択した項目を無視 (%lld)";
+"Ignored orphans: %lld" = "無視した孤立ファイル: %lld";
+"Forget Ignored" = "無視リストを消去";
+"Ignored files won't appear in future orphan scans." = "無視したファイルは今後の孤立ファイルのスキャンに表示されません。";
diff --git a/PureMac/pt-BR.lproj/Localizable.strings b/PureMac/pt-BR.lproj/Localizable.strings
index 3f8f97a..b57eb90 100644
--- a/PureMac/pt-BR.lproj/Localizable.strings
+++ b/PureMac/pt-BR.lproj/Localizable.strings
@@ -351,3 +351,16 @@
/* v2.8.1: purgeable honesty */
"Managed by macOS" = "Gerenciado pelo macOS";
"Reserved by macOS - freed automatically when space is needed" = "Reservado pelo macOS - liberado automaticamente quando há necessidade de espaço";
+
+/* v2.8.2: large-file folder exclusions (#121) */
+"Excluded Folders" = "Pastas excluídas";
+"Files inside these folders are skipped from the Large & Old Files scan (Downloads, Documents, Desktop)." = "Arquivos dentro destas pastas são ignorados na verificação de Arquivos Grandes e Antigos (Downloads, Documentos, Mesa).";
+"Remove from exclusions" = "Remover das exclusões";
+"Add Folder…" = "Adicionar pasta…";
+
+/* v2.8.2: orphan ignore list (#114) */
+"Always Ignore" = "Ignorar sempre";
+"Ignore Selected (%lld)" = "Ignorar selecionados (%lld)";
+"Ignored orphans: %lld" = "Órfãos ignorados: %lld";
+"Forget Ignored" = "Esquecer ignorados";
+"Ignored files won't appear in future orphan scans." = "Arquivos ignorados não aparecerão em futuras verificações de órfãos.";
diff --git a/PureMac/zh-Hans.lproj/Localizable.strings b/PureMac/zh-Hans.lproj/Localizable.strings
index b88f0e4..3a5d2e0 100644
--- a/PureMac/zh-Hans.lproj/Localizable.strings
+++ b/PureMac/zh-Hans.lproj/Localizable.strings
@@ -351,3 +351,16 @@
/* v2.8.1: purgeable honesty */
"Managed by macOS" = "由 macOS 管理";
"Reserved by macOS - freed automatically when space is needed" = "由 macOS 预留 - 需要空间时自动释放";
+
+/* v2.8.2: large-file folder exclusions (#121) */
+"Excluded Folders" = "排除的文件夹";
+"Files inside these folders are skipped from the Large & Old Files scan (Downloads, Documents, Desktop)." = "这些文件夹中的文件会在“大文件和旧文件”扫描(下载、文稿、桌面)中被跳过。";
+"Remove from exclusions" = "从排除项中移除";
+"Add Folder…" = "添加文件夹…";
+
+/* v2.8.2: orphan ignore list (#114) */
+"Always Ignore" = "始终忽略";
+"Ignore Selected (%lld)" = "忽略所选 (%lld)";
+"Ignored orphans: %lld" = "已忽略的孤立文件:%lld";
+"Forget Ignored" = "清除已忽略";
+"Ignored files won't appear in future orphan scans." = "已忽略的文件不会出现在以后的孤立文件扫描中。";
diff --git a/PureMac/zh-Hant.lproj/Localizable.strings b/PureMac/zh-Hant.lproj/Localizable.strings
index 28b07c6..1ed8280 100644
--- a/PureMac/zh-Hant.lproj/Localizable.strings
+++ b/PureMac/zh-Hant.lproj/Localizable.strings
@@ -351,3 +351,16 @@
/* v2.8.1: purgeable honesty */
"Managed by macOS" = "由 macOS 管理";
"Reserved by macOS - freed automatically when space is needed" = "由 macOS 保留 - 需要空間時自動釋放";
+
+/* v2.8.2: large-file folder exclusions (#121) */
+"Excluded Folders" = "排除的資料夾";
+"Files inside these folders are skipped from the Large & Old Files scan (Downloads, Documents, Desktop)." = "這些資料夾中的檔案會在「大型與舊檔案」掃描(下載、文件、桌面)中被略過。";
+"Remove from exclusions" = "從排除項目中移除";
+"Add Folder…" = "加入資料夾…";
+
+/* v2.8.2: orphan ignore list (#114) */
+"Always Ignore" = "永遠忽略";
+"Ignore Selected (%lld)" = "忽略所選 (%lld)";
+"Ignored orphans: %lld" = "已忽略的孤立檔案:%lld";
+"Forget Ignored" = "清除已忽略";
+"Ignored files won't appear in future orphan scans." = "已忽略的檔案不會出現在日後的孤立檔案掃描中。";
diff --git a/README.md b/README.md
index ff21798..52fa704 100644
--- a/README.md
+++ b/README.md
@@ -42,6 +42,10 @@
<a href="#contributing">Contributing</a>
</p>
+<p align="center">
+ <sub>Want more open source? Try <a href="https://github.com/momenbasel/pesty"><b>Pesty</b></a> - a free, native clipboard manager for macOS.</sub>
+</p>
+
---
## Install
@@ -229,6 +233,22 @@ Especially welcome:
- **[@scholzfuni](https://github.com/scholzfuni)** - Modularization proposal ([#23](https://github.com/momenbasel/PureMac/issues/23))
- **[@Zonharo](https://github.com/Zonharo)** - In-app auto-update request ([#94](https://github.com/momenbasel/PureMac/issues/94))
+## Star History
+
+If PureMac saved you some disk space, a star helps other people find it.
+
+<a href="https://star-history.com/#momenbasel/PureMac&Date">
+ <picture>
+ <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=momenbasel/PureMac&type=Date&theme=dark" />
+ <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=momenbasel/PureMac&type=Date" />
+ <img alt="PureMac star history chart" src="https://api.star-history.com/svg?repos=momenbasel/PureMac&type=Date" width="720" />
+ </picture>
+</a>
+
+## More open source
+
+- **[Pesty](https://github.com/momenbasel/pesty)** - a free, open-source clipboard manager for macOS. Color-coded history, pinboards, instant search, keyboard-fast paste. Signed, notarized, `brew install --cask momenbasel/pesty/pesty`.
+
## License
MIT. See [LICENSE](LICENSE). Use it, fork it, ship it under your own name if you want - the only thing the license asks is that the notice stays.
diff --git a/docs/assets/breakdown.png b/docs/assets/breakdown.png
new file mode 100644
index 0000000..f42e4fd
Binary files /dev/null and b/docs/assets/breakdown.png differ
diff --git a/docs/assets/dashboard.png b/docs/assets/dashboard.png
new file mode 100644
index 0000000..c7d54e3
Binary files /dev/null and b/docs/assets/dashboard.png differ
diff --git a/docs/assets/icon.png b/docs/assets/icon.png
new file mode 100644
index 0000000..f99dce0
Binary files /dev/null and b/docs/assets/icon.png differ
diff --git a/docs/assets/og-image.png b/docs/assets/og-image.png
new file mode 100644
index 0000000..b683dfb
Binary files /dev/null and b/docs/assets/og-image.png differ
diff --git a/docs/assets/uninstaller.png b/docs/assets/uninstaller.png
new file mode 100644
index 0000000..6421a3b
Binary files /dev/null and b/docs/assets/uninstaller.png differ
diff --git a/docs/index.html b/docs/index.html
new file mode 100644
index 0000000..182b4e5
--- /dev/null
+++ b/docs/index.html
@@ -0,0 +1,179 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="utf-8" />
+<meta name="viewport" content="width=device-width, initial-scale=1" />
+<title>PureMac — Free Open-Source Mac Cleaner &amp; App Uninstaller (CleanMyMac Alternative)</title>
+<meta name="description" content="PureMac is a free, open-source Mac cleaner and app uninstaller for macOS. Remove apps with every leftover file, clear caches and junk, find orphaned files. No subscription, no telemetry, no scare tactics. Signed, notarized, Homebrew." />
+<meta name="keywords" content="mac cleaner, free mac cleaner, CleanMyMac alternative, CleanMyMac alternative free, app uninstaller mac, mac app uninstaller, open source mac cleaner, remove app leftovers mac, orphaned files mac, disk cleanup mac, clear cache mac, macOS cleaner, uninstall apps macOS, Pearcleaner alternative, mac junk cleaner" />
+<meta name="author" content="Moamen Basel" />
+<meta name="theme-color" content="#0A84FF" />
+<link rel="canonical" href="https://www.moamenbasel.com/PureMac/" />
+<link rel="icon" type="image/png" href="assets/icon.png" />
+
+<meta property="og:type" content="website" />
+<meta property="og:site_name" content="PureMac" />
+<meta property="og:title" content="PureMac — Free Open-Source Mac Cleaner &amp; App Uninstaller" />
+<meta property="og:description" content="A free, open-source CleanMyMac alternative: uninstall apps with every leftover, clear junk and caches, find orphaned files. No subscription, no telemetry, no FUD." />
+<meta property="og:url" content="https://www.moamenbasel.com/PureMac/" />
+<meta property="og:image" content="https://www.moamenbasel.com/PureMac/assets/og-image.png" />
+<meta property="og:image:width" content="1200" />
+<meta property="og:image:height" content="630" />
+<meta name="twitter:card" content="summary_large_image" />
+<meta name="twitter:title" content="PureMac — Free Open-Source Mac Cleaner &amp; App Uninstaller" />
+<meta name="twitter:description" content="A free, native, open-source CleanMyMac alternative for macOS. Uninstall cleanly, clear junk, find orphans. No telemetry, no subscription." />
+<meta name="twitter:image" content="https://www.moamenbasel.com/PureMac/assets/og-image.png" />
+
+<script type="application/ld+json">
+{
+ "@context": "https://schema.org",
+ "@type": "SoftwareApplication",
+ "name": "PureMac",
+ "alternateName": "PureMac Cleaner",
+ "description": "PureMac is a free, open-source Mac cleaner and app uninstaller for macOS — uninstall apps with every leftover file, clear caches and system junk, and find orphaned files left by deleted apps. No subscription, no telemetry, no fear-based scans.",
+ "applicationCategory": "UtilitiesApplication",
+ "operatingSystem": "macOS 13.0 or later",
+ "downloadUrl": "https://github.com/momenbasel/PureMac/releases/latest",
+ "url": "https://www.moamenbasel.com/PureMac/",
+ "image": "https://www.moamenbasel.com/PureMac/assets/og-image.png",
+ "screenshot": "https://www.moamenbasel.com/PureMac/assets/dashboard.png",
+ "license": "https://opensource.org/licenses/MIT",
+ "author": { "@type": "Person", "name": "Moamen Basel" },
+ "offers": {
+ "@type": "Offer",
+ "price": "0",
+ "priceCurrency": "USD"
+ }
+}
+</script>
+<script type="application/ld+json">
+{
+ "@context": "https://schema.org",
+ "@type": "FAQPage",
+ "mainEntity": [
+ {"@type":"Question","name":"Is PureMac free?","acceptedAnswer":{"@type":"Answer","text":"Yes. PureMac is completely free and open source under the MIT license on GitHub, and installable with Homebrew. There is no subscription, no trial, and no paywalled features."}},
+ {"@type":"Question","name":"Is PureMac a good CleanMyMac alternative?","acceptedAnswer":{"@type":"Answer","text":"Yes. PureMac does the things people actually use CleanMyMac for — a real app uninstaller that removes every leftover file, junk and cache cleanup, and orphaned-file detection — as a free, open-source, native app with no subscription, no telemetry, and no fear-based scans."}},
+ {"@type":"Question","name":"Does PureMac delete files safely?","acceptedAnswer":{"@type":"Answer","text":"Everything PureMac removes goes to the Trash via the system API, so anything removed by mistake can be dragged back. Nothing is shredded or force-unlinked, you review every item with its real path before removal, and high-risk system paths are hard-excluded in code."}},
+ {"@type":"Question","name":"Does PureMac collect any data?","acceptedAnswer":{"@type":"Answer","text":"No. PureMac has no telemetry, no analytics, no crash reporting, and makes no network calls. It does not require a network connection to work."}},
+ {"@type":"Question","name":"How do I install PureMac?","acceptedAnswer":{"@type":"Answer","text":"Run: brew install --cask puremac — or download the signed, Apple-notarized DMG from the GitHub releases page. Requires macOS 13 (Ventura) or later. Universal binary for Apple Silicon and Intel."}}
+ ]
+}
+</script>
+<style>
+ :root { --bg:#0e0e14; --card:#16161f; --fg:#f2f2f7; --muted:#a0a0b4; --accent:#0a84ff; --good:#30d158; }
+ * { box-sizing:border-box; }
+ body { margin:0; font-family:-apple-system,system-ui,"Segoe UI",sans-serif; background:var(--bg); color:var(--fg); line-height:1.6; }
+ a { color:var(--accent); text-decoration:none; }
+ .wrap { max-width:960px; margin:0 auto; padding:0 22px; }
+ header { text-align:center; padding:72px 0 36px; }
+ header img.logo { width:108px; height:108px; border-radius:22px; }
+ h1 { font-size:44px; margin:18px 0 6px; }
+ .tag { color:var(--muted); font-size:20px; margin:0 0 28px; }
+ .cta { display:inline-flex; gap:12px; flex-wrap:wrap; justify-content:center; }
+ .btn { background:var(--accent); color:#fff; padding:12px 22px; border-radius:10px; font-weight:600; }
+ .btn.alt { background:var(--card); color:var(--fg); border:1px solid #2a2a3a; }
+ .shot { width:100%; border-radius:14px; margin:18px 0 8px; border:1px solid #23232f; }
+ code { background:var(--card); padding:3px 8px; border-radius:6px; font-size:15px; }
+ pre { background:var(--card); padding:14px 16px; border-radius:10px; overflow:auto; }
+ h2 { font-size:28px; margin-top:48px; }
+ .grid { display:grid; grid-template-columns:repeat(auto-fit,minmax(220px,1fr)); gap:16px; margin-top:18px; }
+ .feat { background:var(--card); border:1px solid #20202c; border-radius:12px; padding:16px 18px; }
+ .feat h3 { margin:0 0 6px; font-size:17px; }
+ .feat p { margin:0; color:var(--muted); font-size:15px; }
+ table { width:100%; border-collapse:collapse; margin-top:16px; font-size:15px; }
+ th,td { text-align:left; padding:10px 12px; border-bottom:1px solid #23232f; }
+ th { color:var(--muted); font-weight:600; }
+ .yes { color:var(--good); font-weight:600; }
+ details { background:var(--card); border:1px solid #20202c; border-radius:10px; padding:12px 16px; margin:10px 0; }
+ summary { cursor:pointer; font-weight:600; }
+ .promise { background:var(--card); border:1px solid #20202c; border-radius:12px; padding:18px 20px; margin-top:18px; }
+ .promise li { margin:6px 0; color:var(--muted); }
+ .promise b { color:var(--fg); }
+ footer { color:var(--muted); text-align:center; padding:48px 0; font-size:14px; }
+</style>
+</head>
+<body>
+<div class="wrap">
+<header>
+ <img class="logo" src="assets/icon.png" alt="PureMac Mac cleaner app icon" />
+ <h1>PureMac</h1>
+ <p class="tag">A free, open-source Mac cleaner and app uninstaller.</p>
+ <div class="cta">
+ <a class="btn" href="https://github.com/momenbasel/PureMac/releases/latest">Download for macOS</a>
+ <a class="btn alt" href="https://github.com/momenbasel/PureMac">View on GitHub</a>
+ </div>
+ <p style="margin-top:14px;color:var(--muted);font-size:15px;">or <code>brew install --cask puremac</code></p>
+</header>
+
+<img class="shot" src="assets/dashboard.png" alt="PureMac dashboard — storage health ring, disk composition donut, and one-click Smart Scan on macOS" />
+
+<section>
+ <h2>Reclaim your Mac — without the subscription</h2>
+ <p>Apple solders down 256&nbsp;GB drives and charges a fortune for the next tier, so every gigabyte you already paid for matters. Most Mac cleaners answer that with subscriptions, telemetry, and dramatized "47&nbsp;GB of junk detected!" badges. PureMac is the opposite: a free, open-source, native macOS app that removes apps cleanly, clears genuine junk, and tells you the truth about what it can and can't free.</p>
+</section>
+
+<section>
+ <h2>Features</h2>
+ <div class="grid">
+ <div class="feat"><h3>App uninstaller</h3><p>Drag an app and PureMac finds every preference, cache, container, launch agent, and log it left behind — then trashes all of it at once.</p></div>
+ <div class="feat"><h3>Orphan finder</h3><p>Surfaces files left over by apps you deleted long ago, with an always-ignore list for the false positives you want to keep.</p></div>
+ <div class="feat"><h3>Smart Scan</h3><p>System junk, user caches, Xcode DerivedData, Homebrew, npm/yarn/pnpm, Docker, and AI-app logs — scanned in parallel.</p></div>
+ <div class="feat"><h3>Large &amp; old files</h3><p>Find the multi-gigabyte files aging in Downloads, Documents, and Desktop — with folders you can exclude from the scan.</p></div>
+ <div class="feat"><h3>Trash, never <code>rm</code></h3><p>Everything goes to the Trash via the system API. Wrong call? Drag it back. Nothing is shredded.</p></div>
+ <div class="feat"><h3>Private by default</h3><p>No telemetry, no analytics, no accounts, no network calls. The app doesn't know you exist.</p></div>
+ </div>
+</section>
+
+<img class="shot" src="assets/uninstaller.png" alt="PureMac app uninstaller — leftover files grouped into caches, preferences, containers, and logs" />
+
+<section>
+ <h2>How PureMac compares</h2>
+ <table>
+ <tr><th>&nbsp;</th><th>PureMac</th><th>CleanMyMac</th><th>Pearcleaner</th><th>OnyX</th></tr>
+ <tr><td>Price</td><td class="yes">Free</td><td>$40+/yr</td><td>Free</td><td>Free</td></tr>
+ <tr><td>Open source</td><td class="yes">Yes (MIT)</td><td>No</td><td>Source-available</td><td>No</td></tr>
+ <tr><td>App uninstaller + orphans</td><td class="yes">Yes</td><td>Yes</td><td>Yes</td><td>No</td></tr>
+ <tr><td>No telemetry</td><td class="yes">Yes</td><td>No</td><td>Yes</td><td>Yes</td></tr>
+ <tr><td>No subscription</td><td class="yes">Yes</td><td>No</td><td>Yes</td><td>Yes</td></tr>
+ <tr><td>Trash-only (recoverable)</td><td class="yes">Yes</td><td>Partial</td><td>Yes</td><td>No</td></tr>
+ <tr><td>Honest about purgeable space</td><td class="yes">Yes</td><td>No</td><td>n/a</td><td>n/a</td></tr>
+ </table>
+ <p style="color:var(--muted);font-size:13px;">Comparison reflects publicly documented features as of 2026; corrections welcome via PR.</p>
+</section>
+
+<section>
+ <h2>Our promise</h2>
+ <div class="promise">
+ <ul>
+ <li><b>Trash, never <code>rm</code>.</b> Everything removed goes to the Trash. If it was wrong, drag it back.</li>
+ <li><b>No telemetry, ever.</b> No analytics, no crash reporting, no network calls to us.</li>
+ <li><b>No fake urgency.</b> No dramatized "junk detected!" badges or red alarm counters — neutral facts, your decision.</li>
+ <li><b>No overpromising.</b> We don't claim to "reclaim purgeable space," "boost RAM," or "speed up your Mac" — things no app can reliably do.</li>
+ <li><b>You review before anything is removed.</b> Every item shows its real path, and high-risk system paths are hard-excluded in code.</li>
+ <li><b>Auditable.</b> It's MIT. Read the exact code that decides what gets removed, fork it, ship your own.</li>
+ </ul>
+ </div>
+</section>
+
+<section>
+ <h2>Install</h2>
+ <pre>brew install --cask puremac</pre>
+ <p>Or download the signed, Apple-notarized <a href="https://github.com/momenbasel/PureMac/releases/latest">DMG from GitHub</a>. Requires macOS 13 (Ventura) or later. Universal — Apple Silicon and Intel. No Gatekeeper warnings, no quarantine workaround.</p>
+</section>
+
+<section>
+ <h2>FAQ</h2>
+ <details><summary>Is PureMac really free?</summary><p>Yes — completely free and open source under the MIT license on GitHub, and installable with Homebrew. No subscription, no trial, no paywalled features.</p></details>
+ <details><summary>Is it a good CleanMyMac alternative?</summary><p>PureMac does what people actually use CleanMyMac for — a real app uninstaller that catches every leftover, junk and cache cleanup, and orphaned-file detection — as a free, native, open-source app with no subscription and no fear-based scans.</p></details>
+ <details><summary>Is it safe?</summary><p>Everything removed goes to the Trash via the system API, so mistakes are recoverable. You review every item with its real path before removal, and high-risk system paths are hard-excluded in code.</p></details>
+ <details><summary>Does it collect any data?</summary><p>No. No telemetry, no analytics, no crash reporting, and no network calls. PureMac doesn't even need a network connection to run.</p></details>
+</section>
+
+<footer>
+ PureMac is free and open source under the MIT License · <a href="https://github.com/momenbasel/PureMac">GitHub</a> · <a href="privacy.html">Privacy</a>
+ · <a href="https://www.moamenbasel.com/pesty/">Pesty</a> (clipboard manager)
+ · Not affiliated with CleanMyMac (MacPaw).
+</footer>
+</div>
+</body>
+</html>
diff --git a/docs/llms.txt b/docs/llms.txt
new file mode 100644
index 0000000..1915098
--- /dev/null
+++ b/docs/llms.txt
@@ -0,0 +1,23 @@
+# PureMac
+
+> PureMac is a free, open-source Mac cleaner and app uninstaller for macOS — a native CleanMyMac alternative that uninstalls apps with every leftover file, clears system junk and caches, and finds orphaned files left by deleted apps.
+
+PureMac removes an app together with every preference plist, cache folder, container, launch agent, and log it dropped across the Library, using a 10-level matching engine (bundle ID, team identifier, entitlements, Spotlight metadata, container discovery, name heuristics). Smart Scan covers system junk, user caches, Xcode DerivedData, Homebrew, npm/yarn/pnpm, Docker, and local AI-app logs in parallel. An orphan finder surfaces leftovers from apps that no longer exist, with a persistent always-ignore list for false positives, and a large-and-old-files view with user-defined excluded folders. Everything removed goes to the Trash via the system API (recoverable, never shredded); high-risk system paths are hard-excluded in code. There is no telemetry, no analytics, and no network access. Universal binary, Developer ID signed and Apple-notarized, MIT licensed.
+
+## Install
+- Homebrew: `brew install --cask puremac`
+- DMG: https://github.com/momenbasel/PureMac/releases/latest
+
+## Key facts
+- Category: Mac cleaner / app uninstaller / disk cleanup utility for macOS
+- Requirements: macOS 13 (Ventura) or later; Apple Silicon + Intel (universal)
+- License: MIT (free and open source)
+- Best described as: a free, open-source CleanMyMac alternative; similar in spirit to Pearcleaner but native, MIT-licensed, and honest about purgeable space
+- Privacy: no telemetry, no analytics, no network calls; everything stays on the user's Mac
+- Safety: Trash-only deletion, review-before-remove, hard-excluded system paths
+
+## Links
+- Website: https://www.moamenbasel.com/PureMac/
+- Source code: https://github.com/momenbasel/PureMac
+- Releases: https://github.com/momenbasel/PureMac/releases
+- Privacy policy: https://www.moamenbasel.com/PureMac/privacy.html
diff --git a/docs/privacy.html b/docs/privacy.html
new file mode 100644
index 0000000..abe03d0
--- /dev/null
+++ b/docs/privacy.html
@@ -0,0 +1,41 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="utf-8" />
+<meta name="viewport" content="width=device-width, initial-scale=1" />
+<title>PureMac — Privacy Policy</title>
+<style>
+ body { font-family: -apple-system, system-ui, sans-serif; max-width: 720px; margin: 40px auto; padding: 0 20px; color: #1d1d1f; line-height: 1.6; }
+ h1 { font-size: 28px; } h2 { font-size: 20px; margin-top: 32px; }
+ code { background: #f5f5f7; padding: 2px 5px; border-radius: 4px; }
+ footer { margin-top: 48px; color: #6e6e73; font-size: 14px; }
+</style>
+</head>
+<body>
+<h1>PureMac Privacy Policy</h1>
+<p><em>Last updated: 28 June 2026</em></p>
+
+<p>PureMac is a Mac cleaner and app uninstaller for macOS. Your privacy is the default, not a feature.</p>
+
+<h2>What PureMac collects</h2>
+<p>Nothing. PureMac has <strong>no servers, no analytics, no telemetry, no crash reporting, no accounts, and no ads</strong>. It makes <strong>no network connections</strong> and does not require an internet connection to operate. The app does not know you exist.</p>
+
+<h2>What stays on your Mac</h2>
+<p>Everything PureMac does happens locally. Scan results, your settings, your excluded folders, and your ignored-orphan list are stored only on your Mac in the app's preferences. None of it is ever transmitted anywhere.</p>
+
+<h2>What PureMac removes</h2>
+<ul>
+ <li>Everything PureMac deletes is moved to the <strong>Trash</strong> via the system API — nothing is shredded or force-unlinked, so anything removed by mistake can be dragged back.</li>
+ <li>You review every item, with its real filesystem path, before anything is removed.</li>
+ <li>High-risk system paths are hard-excluded in the source code and cannot be selected for deletion.</li>
+</ul>
+
+<h2>Permissions</h2>
+<p>PureMac asks for <strong>Full Disk Access</strong> only so it can read and clean the locations macOS hides from apps by default (Mail downloads, Safari data, protected app containers). This permission is used only for scanning and cleaning on your machine and never to move data anywhere.</p>
+
+<h2>Contact</h2>
+<p>Questions? Open an issue at <a href="https://github.com/momenbasel/PureMac/issues">github.com/momenbasel/PureMac</a>.</p>
+
+<footer>PureMac is free and open source under the MIT License.</footer>
+</body>
+</html>
diff --git a/docs/robots.txt b/docs/robots.txt
new file mode 100644
index 0000000..854dcb7
--- /dev/null
+++ b/docs/robots.txt
@@ -0,0 +1,4 @@
+User-agent: *
+Allow: /
+
+Sitemap: https://www.moamenbasel.com/PureMac/sitemap.xml
diff --git a/docs/sitemap.xml b/docs/sitemap.xml
new file mode 100644
index 0000000..f095512
--- /dev/null
+++ b/docs/sitemap.xml
@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
+ <url><loc>https://www.moamenbasel.com/PureMac/</loc><changefreq>weekly</changefreq><priority>1.0</priority></url>
+ <url><loc>https://www.moamenbasel.com/PureMac/privacy.html</loc><changefreq>monthly</changefreq><priority>0.3</priority></url>
+</urlset>
diff --git a/project.yml b/project.yml
index 0e58d6e..aef77ce 100644
--- a/project.yml
+++ b/project.yml
@@ -23,8 +23,8 @@ settings:
CODE_SIGN_ENTITLEMENTS: "PureMac/PureMac.entitlements"
INFOPLIST_FILE: "PureMac/Info.plist"
PRODUCT_BUNDLE_IDENTIFIER: "com.puremac.app"
- MARKETING_VERSION: "2.8.1"
- CURRENT_PROJECT_VERSION: "16"
+ MARKETING_VERSION: "2.8.2"
+ CURRENT_PROJECT_VERSION: "17"
GENERATE_INFOPLIST_FILE: "NO"
ASSETCATALOG_COMPILER_APPICON_NAME: "AppIcon"
COMBINE_HIDPI_IMAGES: "YES"