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
Add a dedicated Settings page
BinaryBearsLLC0ebcc7b79854
diff --git a/PureMac/PureMacApp.swift b/PureMac/PureMacApp.swiftindex 424374e..aa96b83 100644--- a/PureMac/PureMacApp.swift+++ b/PureMac/PureMacApp.swift@@ -127,8 +127,10 @@ struct PureMacApp: App {}Settings {- SettingsView()+ SettingsView(standalone: true).environmentObject(appState)+ .environmentObject(theme)+ .frame(minWidth: 680, idealWidth: 760, minHeight: 580, idealHeight: 700)}// The opt-in menu-bar system monitor is an AppKit NSStatusItem manageddiff --git a/PureMac/Services/PermissionCoordinator.swift b/PureMac/Services/PermissionCoordinator.swiftindex bec4c66..80c76ad 100644--- a/PureMac/Services/PermissionCoordinator.swift+++ b/PureMac/Services/PermissionCoordinator.swift@@ -17,6 +17,8 @@ import Foundationfinal class PermissionCoordinator: ObservableObject {static let shared = PermissionCoordinator()+ enum Presentation { case mainWindow, settingsWindow }+ @Published private(set) var presentation: Presentation = .mainWindow@Published private(set) var isRequesting: Bool = false@Published private(set) var hasFullDiskAccess: Bool = false@Published private(set) var failedItemPaths: [String] = []@@ -63,6 +65,7 @@ final class PermissionCoordinator: ObservableObject {/// two Timers or leaking the first callback's captured state.func requestAccess(context: PromptContext = .general,+ presentation: Presentation = .mainWindow,failedPaths: [String] = [],onGranted: @escaping () -> Void) {@@ -75,6 +78,7 @@ final class PermissionCoordinator: ObservableObject {pendingGrantWork?.cancel()pendingGrantWork = nil+ self.presentation = presentationself.context = contextself.failedItemPaths = failedPathsself.onGrantCallback = onGranteddiff --git a/PureMac/ViewModels/AppState.swift b/PureMac/ViewModels/AppState.swiftindex bf9644d..55a4713 100644--- a/PureMac/ViewModels/AppState.swift+++ b/PureMac/ViewModels/AppState.swift@@ -14,6 +14,7 @@ enum AppSection: Hashable {case protectioncase performancecase appUpdates+ case settingscase cleaning(CleaningCategory)}@@ -47,6 +48,8 @@ final class ScanProgressTicker: ObservableObject {@MainActorfinal class AppState: ObservableObject {+ let languageAtLaunch = AppLanguage.current+ @Published var settingsNeedLanguageRestart = falsetypealias AppFileScanner = @MainActor (_ app: InstalledApp,_ locations: Locations,diff --git a/PureMac/Views/MainWindow.swift b/PureMac/Views/MainWindow.swiftindex db20b8e..16165ad 100644--- a/PureMac/Views/MainWindow.swift+++ b/PureMac/Views/MainWindow.swift@@ -2,7 +2,6 @@ import SwiftUIstruct MainWindow: View {@EnvironmentObject var appState: AppState- @EnvironmentObject var theme: ThemeManager@ObservedObject private var permission = PermissionCoordinator.shared@State private var selectedSection: AppSection? = .cleaning(.smartScan)@State private var columnVisibility: NavigationSplitViewVisibility = .all@@ -73,8 +72,8 @@ struct MainWindow: View {Text(appState.cleanError ?? "")}.sheet(isPresented: Binding(- get: { permission.isRequesting },- set: { if !$0 { permission.dismiss(callRetry: false) } }+ get: { permission.isRequesting && permission.presentation == .mainWindow },+ set: { if !$0 && permission.presentation == .mainWindow { permission.dismiss(callRetry: false) } })) {PermissionSheet()}@@ -291,6 +290,7 @@ struct MainWindow: View {if advancedToolsExpanded {sections.append(contentsOf: Self.advancedCategories.map(AppSection.cleaning))}+ sections.append(.settings)return sections}@@ -308,6 +308,7 @@ struct MainWindow: View {case .similarPhotos: return "sidebar.similarPhotos"case .protection: return "sidebar.protection"case .performance: return "sidebar.performance"+ case .settings: return "sidebar.settings"case .appUpdates: return "sidebar.appUpdates"case .cleaning(let category): return "sidebar.cleaning.\(category.id)"}@@ -353,92 +354,26 @@ struct MainWindow: View {}private var sidebarFooter: some View {- VStack(spacing: 8) {- permissionStatus- appearanceMenu- }- .padding(.horizontal, 12)- .padding(.top, 9)- .padding(.bottom, 10)- .background(.regularMaterial)- .overlay(alignment: .top) {- Divider()- }- }-- private var permissionStatus: some View {- let granted = appState.hasFullDiskAccess- let tint = granted ? Tint.green : Tint.orange-- return HStack(spacing: 9) {- Circle()- .fill(tint)- .frame(width: 7, height: 7)-- VStack(alignment: .leading, spacing: 1) {- Text(granted ? "Full access" : "Limited access")- .font(.system(size: 11.5, weight: .semibold))- .foregroundStyle(sidebarLabelColor)- Text(granted ? "Ready for protected locations" : "Some locations are unavailable")- .font(.system(size: 9.5))- .foregroundStyle(.secondary)- .lineLimit(1)- }-- Spacer(minLength: 4)-- if !granted {- Button("Set up") {- permission.requestAccess(context: .general) {- appState.checkFullDiskAccess()- }- }- .buttonStyle(.bordered)- .controlSize(.small)- .tint(Tint.orange)- }- }- .padding(.horizontal, 10)- .padding(.vertical, 8)- .background {- RoundedRectangle(cornerRadius: 10, style: .continuous)- .fill(Color.primary.opacity(0.035))- }- }-- private var appearanceMenu: some View {- Menu {- ForEach(AppearanceMode.allCases) { appearance in- Button {- theme.appearance = appearance- } label: {- Label(LocalizedStringKey(appearance.label), systemImage: appearance.icon)- }- }+ Button {+ selectSection(.settings)} label: {- HStack(spacing: 8) {- Image(systemName: theme.appearance.icon)- .font(.system(size: 11, weight: .medium))- .frame(width: 16)- Text("Appearance")- .font(.system(size: 11.5, weight: .medium))- .foregroundStyle(sidebarLabelColor)- Spacer()- Text(LocalizedStringKey(theme.appearance.label))- .font(.system(size: 10.5))- .foregroundStyle(.secondary)- Image(systemName: "chevron.up.chevron.down")- .font(.system(size: 8, weight: .semibold))- .foregroundStyle(.tertiary)- }- .frame(minHeight: 26)- .padding(.horizontal, 9)- .contentShape(Rectangle())+ SidebarNavRow(+ label: "Settings",+ icon: "gearshape.fill",+ tint: Tint.accent,+ badge: nil,+ isSelected: selectedSection == .settings,+ emphasized: false+ )}.buttonStyle(.plain)- .menuStyle(.borderlessButton)- .accessibilityLabel("Appearance")- .accessibilityValue(Text(LocalizedStringKey(theme.appearance.label)))+ .focused($focusedSection, equals: .settings)+ .accessibilityIdentifier("sidebar.settings")+ .accessibilityAddTraits(selectedSection == .settings ? .isSelected : [])+ .padding(.horizontal, 12)+ .padding(.vertical, 10)+ .background(.regularMaterial)+ .overlay(alignment: .top) { Divider() }}private var sidebarLabelColor: Color {@@ -448,7 +383,7 @@ struct MainWindow: View {@ViewBuilderprivate var detailContainer: some View {VStack(spacing: 0) {- if !appState.hasFullDiskAccess && !appState.fdaBannerDismissed {+ if selectedSection != .settings && !appState.hasFullDiskAccess && !appState.fdaBannerDismissed {accessBanner.padding(.horizontal, 20).padding(.top, 14)@@ -484,6 +419,8 @@ struct MainWindow: View {PerformanceView()case .appUpdates:AppUpdatesView()+ case .settings:+ SettingsView()case .cleaning(let category):if category == .smartScan {DashboardView { selectSection($0) }@@ -613,3 +550,4 @@ private struct SidebarNavRow: View {colorScheme == .dark ? Color.white.opacity(0.91) : Color.black.opacity(0.84)}}+diff --git a/PureMac/Views/Settings/SettingsView.swift b/PureMac/Views/Settings/SettingsView.swiftindex d27ef93..483daf6 100644--- a/PureMac/Views/Settings/SettingsView.swift+++ b/PureMac/Views/Settings/SettingsView.swift@@ -3,19 +3,77 @@ import SwiftUIimport ServiceManagementstruct SettingsView: View {+ @EnvironmentObject private var appState: AppState+ /// The dedicated macOS Settings window owns its permission sheet. The main+ /// window already presents the shared coordinator's sheet for every page.+ var standalone = false+ @ObservedObject private var permission = PermissionCoordinator.shared+ @State private var selectedTab = SettingsTab.general++ private enum SettingsTab: String, CaseIterable, Identifiable {+ case general = "General"+ case cleaning = "Cleaning"+ case schedule = "Schedule"+ case about = "About"++ var id: String { rawValue }+ var icon: String {+ switch self {+ case .general: return "slider.horizontal.3"+ case .cleaning: return "trash"+ case .schedule: return "clock"+ case .about: return "info.circle"+ }+ }+ }+var body: some View {- TabView {- GeneralSettingsView()- .tabItem { Label("General", systemImage: "gear") }- CleaningSettingsView()- .tabItem { Label("Cleaning", systemImage: "trash") }- ScheduleSettingsView()- .tabItem { Label("Schedule", systemImage: "clock") }- AboutSettingsView()- .tabItem { Label("About", systemImage: "info.circle") }+ VStack(alignment: .leading, spacing: 18) {+ HStack(spacing: 14) {+ IconTile(systemName: "gearshape.fill", tint: Tint.accent, size: 44, corner: 12)+ VStack(alignment: .leading, spacing: 3) {+ Text("Settings")+ .font(.system(size: 26, weight: .bold))+ Text("Make PureMac work your way.")+ .font(.system(size: 13))+ .foregroundStyle(.secondary)+ }+ Spacer()+ }+ .padding(.horizontal, 4)++ Picker("Settings", selection: $selectedTab) {+ ForEach(SettingsTab.allCases) { tab in+ Label(LocalizedStringKey(tab.rawValue), systemImage: tab.icon).tag(tab)+ }+ }+ .pickerStyle(.segmented)+ .labelsHidden()+ .accessibilityIdentifier("settings.tabs")++ Group {+ switch selectedTab {+ case .general: GeneralSettingsView(permissionPresentation: standalone ? .settingsWindow : .mainWindow)+ case .cleaning: CleaningSettingsView()+ case .schedule: ScheduleSettingsView()+ case .about: AboutSettingsView()+ }+ }+ .frame(maxWidth: .infinity, maxHeight: .infinity)+ .clipShape(RoundedRectangle(cornerRadius: 16))}- .frame(width: 480, height: 430)+ .padding(24)+ .frame(maxWidth: 960)+ .frame(maxWidth: .infinity, maxHeight: .infinity)+ .background(AmbientBackdrop())+ .tint(Tint.accent)+ .navigationTitle("Settings")+ .sheet(isPresented: Binding(+ get: { standalone && permission.isRequesting && permission.presentation == .settingsWindow },+ set: { if !$0 && standalone && permission.presentation == .settingsWindow { permission.dismiss(callRetry: false) } }+ )) { PermissionSheet() }}+}// MARK: - General@@ -37,34 +95,51 @@ enum SearchSensitivity: String, CaseIterable, Identifiable, Codable {}struct GeneralSettingsView: View {+ var permissionPresentation: PermissionCoordinator.Presentation = .mainWindow+ @EnvironmentObject private var appState: AppState+ @EnvironmentObject private var theme: ThemeManager+ @ObservedObject private var permission = PermissionCoordinator.shared@AppStorage("settings.general.launchAtLogin") private var launchAtLogin = false@AppStorage("settings.general.searchSensitivity") private var sensitivity: SearchSensitivity = .enhanced@AppStorage("settings.general.confirmBeforeDelete") private var confirmBeforeDelete = true@AppStorage("settings.general.menuBarMonitor") private var menuBarMonitor = false@AppStorage(Haptics.soundEffectsKey) private var soundEffects = true@AppStorage(AppLanguage.preferenceKey) private var appLanguageRaw = AppLanguage.current.rawValue- @State private var languageNeedsRelaunch = false+ private var languageNeedsRelaunch: Bool { appState.settingsNeedLanguageRestart }@Environment(\.accessibilityReduceMotion) private var reduceMotionvar body: some View {Form {- Section("Startup") {- Toggle("Launch PureMac at login", isOn: launchAtLoginBinding)+ Section("Appearance") {+ Picker("Appearance", selection: $theme.appearance) {+ ForEach(AppearanceMode.allCases) { appearance in+ Label(LocalizedStringKey(appearance.label), systemImage: appearance.icon)+ .tag(appearance)+ }+ }+ .pickerStyle(.segmented)}- Section("App Scanning") {- Picker("Search sensitivity", selection: $sensitivity) {- ForEach(SearchSensitivity.allCases) { level in- VStack(alignment: .leading) {- Text(LocalizedStringKey(level.rawValue))- Text(LocalizedStringKey(level.description))- .font(.caption)- .foregroundStyle(.secondary)+ Section("Full Disk Access") {+ HStack(spacing: 12) {+ IconTile(systemName: appState.hasFullDiskAccess ? "checkmark.shield.fill" : "lock.shield",+ tint: appState.hasFullDiskAccess ? Tint.green : Tint.orange, size: 32, corner: 9)+ VStack(alignment: .leading, spacing: 3) {+ Text(LocalizedStringKey(appState.hasFullDiskAccess ? "Full access" : "Limited access"))+ .font(.system(size: 13, weight: .semibold))+ Text(LocalizedStringKey(appState.hasFullDiskAccess ? "Ready for protected locations" : "Some locations are unavailable"))+ .font(.caption)+ .foregroundStyle(.secondary)+ }+ Spacer()+ Button("Check access") { refreshAccess() }+ if !appState.hasFullDiskAccess {+ Button("Set up") {+ permission.requestAccess(context: .general, presentation: permissionPresentation) { refreshAccess() }}- .tag(level)+ .tint(Tint.accent)}}- .pickerStyle(.radioGroup)}Section("Language") {@@ -87,6 +162,25 @@ struct GeneralSettingsView: View {}}+ Section("Startup") {+ Toggle("Launch PureMac at login", isOn: launchAtLoginBinding)+ }++ Section("App Scanning") {+ Picker("Search sensitivity", selection: $sensitivity) {+ ForEach(SearchSensitivity.allCases) { level in+ VStack(alignment: .leading) {+ Text(LocalizedStringKey(level.rawValue))+ Text(LocalizedStringKey(level.description))+ .font(.caption)+ .foregroundStyle(.secondary)+ }+ .tag(level)+ }+ }+ .pickerStyle(.radioGroup)+ }+Section("System Monitor") {Toggle("Show system monitor in menu bar", isOn: menuBarMonitorBinding)Text("Live CPU, memory, and disk meters in the menu bar. PureMac keeps running in the background while this is on.")@@ -103,10 +197,19 @@ struct GeneralSettingsView: View {}}.formStyle(.grouped)+ .onAppear { refreshAccess() }+ .onReceive(NotificationCenter.default.publisher(for: NSApplication.didBecomeActiveNotification)) { _ in+ refreshAccess()+ }.animation(reduceMotion ? nil : .spring(response: 0.35, dampingFraction: 0.85),value: languageNeedsRelaunch)}+ private func refreshAccess() {+ appState.checkFullDiskAccess()+ permission.refreshStatus()+ }+private var menuBarMonitorBinding: Binding<Bool> {Binding(get: { menuBarMonitor },@@ -153,7 +256,7 @@ struct GeneralSettingsView: View {private func applyLanguage(_ language: AppLanguage) {AppLanguagePreferences.apply(language)- languageNeedsRelaunch = true+ appState.settingsNeedLanguageRestart = language != appState.languageAtLaunch}private func relaunchApp() {diff --git a/PureMac/ar.lproj/Localizable.strings b/PureMac/ar.lproj/Localizable.stringsindex e796a6a..cca33b2 100644--- a/PureMac/ar.lproj/Localizable.strings+++ b/PureMac/ar.lproj/Localizable.strings@@ -869,3 +869,8 @@"similar group" = "similar group";"similar groups" = "similar groups";"tmutil is not available on this Mac." = "tmutil is not available on this Mac.";++/* Additional interface strings. */+"Check access" = "Check access";+"Make PureMac work your way." = "Make PureMac work your way.";+"Settings" = "Settings";diff --git a/PureMac/de.lproj/Localizable.strings b/PureMac/de.lproj/Localizable.stringsindex 350e068..97a5576 100644--- a/PureMac/de.lproj/Localizable.strings+++ b/PureMac/de.lproj/Localizable.strings@@ -869,3 +869,8 @@"similar group" = "similar group";"similar groups" = "similar groups";"tmutil is not available on this Mac." = "tmutil is not available on this Mac.";++/* Settings page (#169): English fallbacks */+"Check access" = "Check access";+"Make PureMac work your way." = "Make PureMac work your way.";+"Settings" = "Settings";diff --git a/PureMac/en.lproj/Localizable.strings b/PureMac/en.lproj/Localizable.stringsindex 5fd5ee9..bac61de 100644--- a/PureMac/en.lproj/Localizable.strings+++ b/PureMac/en.lproj/Localizable.strings@@ -869,3 +869,8 @@"similar group" = "similar group";"similar groups" = "similar groups";"tmutil is not available on this Mac." = "tmutil is not available on this Mac.";++/* Additional interface strings. */+"Check access" = "Check access";+"Make PureMac work your way." = "Make PureMac work your way.";+"Settings" = "Settings";diff --git a/PureMac/es.lproj/Localizable.strings b/PureMac/es.lproj/Localizable.stringsindex 65ca591..4c316c9 100644--- a/PureMac/es.lproj/Localizable.strings+++ b/PureMac/es.lproj/Localizable.strings@@ -869,3 +869,8 @@"similar group" = "similar group";"similar groups" = "similar groups";"tmutil is not available on this Mac." = "tmutil is not available on this Mac.";++/* Additional interface strings. */+"Check access" = "Check access";+"Make PureMac work your way." = "Make PureMac work your way.";+"Settings" = "Settings";diff --git a/PureMac/fr.lproj/Localizable.strings b/PureMac/fr.lproj/Localizable.stringsindex 1316c38..9c2ff72 100644--- a/PureMac/fr.lproj/Localizable.strings+++ b/PureMac/fr.lproj/Localizable.strings@@ -865,3 +865,8 @@"similar group" = "similar group";"similar groups" = "similar groups";"tmutil is not available on this Mac." = "tmutil is not available on this Mac.";++/* Additional interface strings. */+"Check access" = "Check access";+"Make PureMac work your way." = "Make PureMac work your way.";+"Settings" = "Settings";diff --git a/PureMac/ja.lproj/Localizable.strings b/PureMac/ja.lproj/Localizable.stringsindex 62074c9..7c63964 100644--- a/PureMac/ja.lproj/Localizable.strings+++ b/PureMac/ja.lproj/Localizable.strings@@ -869,3 +869,8 @@"similar group" = "similar group";"similar groups" = "similar groups";"tmutil is not available on this Mac." = "tmutil is not available on this Mac.";++/* Additional interface strings. */+"Check access" = "Check access";+"Make PureMac work your way." = "Make PureMac work your way.";+"Settings" = "Settings";diff --git a/PureMac/pl.lproj/Localizable.strings b/PureMac/pl.lproj/Localizable.stringsindex c78a565..c652b80 100644--- a/PureMac/pl.lproj/Localizable.strings+++ b/PureMac/pl.lproj/Localizable.strings@@ -869,3 +869,8 @@"similar group" = "similar group";"similar groups" = "similar groups";"tmutil is not available on this Mac." = "tmutil is not available on this Mac.";++/* Additional interface strings. */+"Check access" = "Check access";+"Make PureMac work your way." = "Make PureMac work your way.";+"Settings" = "Settings";diff --git a/PureMac/pt-BR.lproj/Localizable.strings b/PureMac/pt-BR.lproj/Localizable.stringsindex ff336de..1066f43 100644--- a/PureMac/pt-BR.lproj/Localizable.strings+++ b/PureMac/pt-BR.lproj/Localizable.strings@@ -869,3 +869,8 @@"similar group" = "similar group";"similar groups" = "similar groups";"tmutil is not available on this Mac." = "tmutil is not available on this Mac.";++/* Additional interface strings. */+"Check access" = "Check access";+"Make PureMac work your way." = "Make PureMac work your way.";+"Settings" = "Settings";diff --git a/PureMac/ru.lproj/Localizable.strings b/PureMac/ru.lproj/Localizable.stringsindex 58bf08c..f1a2061 100644--- a/PureMac/ru.lproj/Localizable.strings+++ b/PureMac/ru.lproj/Localizable.strings@@ -869,3 +869,8 @@"similar group" = "similar group";"similar groups" = "similar groups";"tmutil is not available on this Mac." = "tmutil is not available on this Mac.";++/* Additional interface strings. */+"Check access" = "Check access";+"Make PureMac work your way." = "Make PureMac work your way.";+"Settings" = "Settings";diff --git a/PureMac/uk.lproj/Localizable.strings b/PureMac/uk.lproj/Localizable.stringsindex ff008e9..ac39ca8 100644--- a/PureMac/uk.lproj/Localizable.strings+++ b/PureMac/uk.lproj/Localizable.strings@@ -869,3 +869,8 @@"similar group" = "similar group";"similar groups" = "similar groups";"tmutil is not available on this Mac." = "tmutil is not available on this Mac.";++/* Additional interface strings. */+"Check access" = "Check access";+"Make PureMac work your way." = "Make PureMac work your way.";+"Settings" = "Settings";diff --git a/PureMac/zh-Hans.lproj/Localizable.strings b/PureMac/zh-Hans.lproj/Localizable.stringsindex 2937e14..469888a 100644--- a/PureMac/zh-Hans.lproj/Localizable.strings+++ b/PureMac/zh-Hans.lproj/Localizable.strings@@ -869,3 +869,8 @@"similar group" = "组相似照片";"similar groups" = "组相似照片";"tmutil is not available on this Mac." = "此 Mac 上无法使用 tmutil。";++/* Additional interface strings. */+"Check access" = "Check access";+"Make PureMac work your way." = "Make PureMac work your way.";+"Settings" = "Settings";diff --git a/PureMac/zh-Hant.lproj/Localizable.strings b/PureMac/zh-Hant.lproj/Localizable.stringsindex ee097ea..1661864 100644--- a/PureMac/zh-Hant.lproj/Localizable.strings+++ b/PureMac/zh-Hant.lproj/Localizable.strings@@ -869,3 +869,8 @@"similar group" = "similar group";"similar groups" = "similar groups";"tmutil is not available on this Mac." = "tmutil is not available on this Mac.";++/* Additional interface strings. */+"Check access" = "Check access";+"Make PureMac work your way." = "Make PureMac work your way.";+"Settings" = "Settings";diff --git a/README.md b/README.mdindex 8aaa095..e51bea8 100644--- a/README.md+++ b/README.md@@ -173,6 +173,10 @@ Check for updates to Homebrew-managed cask apps and choose which ones to upgrade### Scheduled CleaningOptional. Configurable interval (hourly to monthly), with auto-clean threshold so background runs only fire when there's something meaningful to remove.+### Settings++Open **Settings** using the gear in the sidebar or the standard macOS Settings command. General settings include language, System/Light/Dark appearance, Full Disk Access status and recheck, startup, menu-bar monitoring, sound and safety. Cleaning and scheduled scanning keep their existing preferences.+## PermissionsPureMac needs **Full Disk Access** to read the locations macOS hides from every app by default - Mail downloads, Safari data, the TCC database, protected app containers. Without it, some cleanup categories and app-container scans will be incomplete. The locations available depend on your macOS version and permissions.