Uninstall Mac apps with every file they leave behind, and see why each belongs. Free up space, fine-tune macOS, and set up Terminal.
Swift cache-cleanercleanerclideveloper-toolsdisk-cleanupdisk-spaceduplicate-finderhomebrewliquid-glassmac-cleanermacosmacos-appmacos-golden-gatemacos-tahoemacos-tweaksswiftswiftuiterminal-themesuninstalluninstaller
Tell in Orphaned Files that only macOS removes a system extension
Țugui Dragoșb7e324d832a9
diff --git a/Localization/Peel/Localizable.xcstrings b/Localization/Peel/Localizable.xcstringsindex d06599cb..94e91b6e 100644--- a/Localization/Peel/Localizable.xcstrings+++ b/Localization/Peel/Localizable.xcstrings@@ -66664,6 +66664,112 @@}}},+ "Left alone: macOS installed this system extension and removes it only when the app that uses it goes to the Trash in Finder. If that app is gone, install it again, open it and use the feature that needs the extension, allow it when macOS asks, then move the app to the Trash in Finder and restart your Mac." : {+ "localizations" : {+ "cs" : {+ "stringUnit" : {+ "state" : "translated",+ "value" : "Nedotčeno: systém macOS nainstaloval toto rozšíření systému a odstraní ho jen tehdy, když se aplikace, která ho používá, přesune do koše ve Finderu. Pokud už tu tato aplikace není, znovu ji nainstalujte, otevřete ji a použijte funkci, která rozšíření potřebuje. Až se macOS zeptá, rozšíření povolte. Pak aplikaci přesuňte do koše ve Finderu a restartujte Mac."+ }+ },+ "de" : {+ "stringUnit" : {+ "state" : "translated",+ "value" : "Unangetastet: macOS hat diese Systemerweiterung installiert und entfernt sie nur, wenn die App, die sie verwendet, im Finder in den Papierkorb gelegt wird. Ist diese App nicht mehr da, installiere sie erneut, öffne sie und verwende die Funktion, für die die Erweiterung benötigt wird. Erlaube die Erweiterung, wenn macOS dich fragt. Lege die App anschließend im Finder in den Papierkorb und starte deinen Mac neu."+ }+ },+ "es" : {+ "stringUnit" : {+ "state" : "translated",+ "value" : "No se toca: macOS ha instalado esta extensión del sistema y solo la elimina cuando la app que la usa va a la papelera en el Finder. Si esa app ya no está, vuelve a instalarla, ábrela y usa la función que depende de la extensión, permítela cuando macOS te lo pida y, después, traslada la app a la papelera en el Finder y reinicia el Mac."+ }+ },+ "fr" : {+ "stringUnit" : {+ "state" : "translated",+ "value" : "Laissé en place : macOS a installé cette extension système et ne la supprime que lorsque l’app qui l’utilise est placée dans la corbeille depuis le Finder. Si cette app a disparu, réinstallez-la, ouvrez-la et utilisez la fonctionnalité qui nécessite l’extension, autorisez celle-ci lorsque macOS vous le demande, puis placez l’app dans la corbeille depuis le Finder et redémarrez votre Mac."+ }+ },+ "it" : {+ "stringUnit" : {+ "state" : "translated",+ "value" : "Resta dov’è: macOS ha installato questa estensione di sistema e la rimuove solo quando l’app che la usa viene spostata nel Cestino dal Finder. Se quell’app non c’è più, installala di nuovo, aprila e usa la funzionalità che richiede l’estensione, autorizzala quando macOS te lo chiede, poi sposta l’app nel Cestino dal Finder e riavvia il Mac."+ }+ },+ "ja" : {+ "stringUnit" : {+ "state" : "translated",+ "value" : "対象外: このシステム機能拡張はmacOSがインストールしたもので、macOSが削除するのは、これを使用するアプリをFinderでゴミ箱に入れたときだけです。そのアプリがすでになくなっている場合は、再インストールして開き、この機能拡張を必要とする機能を使用して、macOSから求められたら許可してください。次に、Finderでアプリをゴミ箱に入れてから、Macを再起動してください。"+ }+ },+ "ko" : {+ "stringUnit" : {+ "state" : "translated",+ "value" : "그대로 둠: 이 시스템 확장 프로그램은 macOS가 설치했으며, 이를 사용하는 앱이 Finder에서 휴지통으로 이동될 때만 macOS가 제거합니다. 해당 앱이 사라졌다면 앱을 다시 설치하고 열어서 이 확장 프로그램이 필요한 기능을 사용하고, macOS가 물으면 확장 프로그램을 허용한 다음, Finder에서 앱을 휴지통으로 이동하고 Mac을 재시동하십시오."+ }+ },+ "nl" : {+ "stringUnit" : {+ "state" : "translated",+ "value" : "Blijft staan: macOS heeft deze systeemextensie geïnstalleerd en verwijdert die alleen als de app die de extensie gebruikt, in Finder naar de prullenmand gaat. Als die app weg is, installeer die dan opnieuw, open de app en gebruik de functie die de extensie nodig heeft, sta de extensie toe als macOS erom vraagt, verplaats de app daarna in Finder naar de prullenmand en start je Mac opnieuw op."+ }+ },+ "pl" : {+ "stringUnit" : {+ "state" : "translated",+ "value" : "Nietknięte: macOS zainstalował to rozszerzenie systemowe i usuwa je tylko wtedy, gdy aplikacja, która go używa, zostanie przeniesiona do Kosza w Finderze. Jeśli tej aplikacji już nie ma, zainstaluj ją ponownie, otwórz ją i użyj funkcji, która wymaga tego rozszerzenia, pozwól na nie, gdy macOS o to zapyta, a potem przenieś aplikację do Kosza w Finderze i uruchom ponownie Maca."+ }+ },+ "pt" : {+ "stringUnit" : {+ "state" : "translated",+ "value" : "Preservado: o macOS instalou esta extensão do sistema e só a remove quando o app que a usa vai para o Lixo no Finder. Se esse app não existir mais, instale-o novamente, abra-o e use o recurso que precisa da extensão, permita-a quando o macOS pedir, depois mova o app para o Lixo no Finder e reinicie o Mac."+ }+ },+ "ro" : {+ "stringUnit" : {+ "state" : "translated",+ "value" : "Lăsat neatins: macOS a instalat această extensie de sistem și o elimină doar când aplicația care o folosește este mutată în Coș din Finder. Dacă aplicația respectivă nu mai este instalată, instalați‑o din nou, deschideți‑o și folosiți funcționalitatea care necesită extensia, permiteți extensia când macOS vă întreabă, apoi mutați aplicația în Coș din Finder și reporniți Mac‑ul."+ }+ },+ "ru" : {+ "stringUnit" : {+ "state" : "translated",+ "value" : "Остается на месте: macOS установила это системное расширение и удаляет его, только когда приложение, которое его использует, перемещают в Корзину в Finder. Если этого приложения уже нет, установите его снова, откройте его и воспользуйтесь функцией, для которой нужно это расширение, разрешите его, когда macOS попросит, а затем переместите приложение в Корзину в Finder и перезагрузите Mac."+ }+ },+ "sv" : {+ "stringUnit" : {+ "state" : "translated",+ "value" : "Rörs inte: macOS har installerat det här systemtillägget och tar bort det bara när appen som använder det flyttas till papperskorgen i Finder. Om appen är borta installerar du den igen, öppnar den och använder funktionen som behöver tillägget, tillåter det när macOS frågar, flyttar sedan appen till papperskorgen i Finder och startar om datorn."+ }+ },+ "tr" : {+ "stringUnit" : {+ "state" : "translated",+ "value" : "Yerinde kalır: macOS bu sistem genişletmesini yükledi ve onu yalnızca genişletmeyi kullanan uygulama Finder’da Çöp Sepeti’ne taşındığında kaldırır. O uygulama artık yoksa onu yeniden yükleyin, açın ve genişletmeyi gerektiren özelliği kullanın, macOS sorduğunda genişletmeye izin verin, sonra uygulamayı Finder’da Çöp Sepeti’ne taşıyın ve Mac’inizi yeniden başlatın."+ }+ },+ "uk" : {+ "stringUnit" : {+ "state" : "translated",+ "value" : "Лишається на місці: macOS інсталювала це системне розширення й вилучає його, лише коли програму, яка його використовує, переміщують у Смітник у Finder. Якщо цієї програми вже немає, інсталюйте її знову, відкрийте її та скористайтеся функцією, для якої потрібне це розширення, дозвольте його, коли macOS запитає, а потім перемістіть програму в Смітник у Finder і перезапустіть Mac."+ }+ },+ "zh-Hans" : {+ "stringUnit" : {+ "state" : "translated",+ "value" : "留在原处:此系统扩展由macOS安装,只有在“访达”中将使用它的App移到废纸篓时,macOS才会将其移除。如果该App已不存在,请重新安装并打开它,使用需要此扩展的功能,在macOS询问时允许此扩展,然后在“访达”中将该App移到废纸篓,再重新启动你的Mac。"+ }+ },+ "zh-Hant" : {+ "stringUnit" : {+ "state" : "translated",+ "value" : "原地保留:此系統延伸功能是由macOS安裝的,只有在Finder中將使用它的App丟到「垃圾桶」時,macOS才會移除它。如果該App已不存在,請重新安裝並打開它,使用需要此延伸功能才能運作的功能,並在macOS詢問時允許此延伸功能,然後在Finder中將該App丟到「垃圾桶」,再將Mac重新開機。"+ }+ }+ }+ },"Left alone: macOS removes %@ only when the app goes to the Trash in Finder." : {"localizations" : {"cs" : {@@ -66770,6 +66876,112 @@}}},+ "Left alone: macOS removes this system extension when your Mac restarts." : {+ "localizations" : {+ "cs" : {+ "stringUnit" : {+ "state" : "translated",+ "value" : "Nedotčeno: systém macOS odstraní toto rozšíření systému po restartu Macu."+ }+ },+ "de" : {+ "stringUnit" : {+ "state" : "translated",+ "value" : "Unangetastet: macOS entfernt diese Systemerweiterung, wenn dein Mac neu startet."+ }+ },+ "es" : {+ "stringUnit" : {+ "state" : "translated",+ "value" : "No se toca: macOS eliminará esta extensión del sistema cuando el Mac se reinicie."+ }+ },+ "fr" : {+ "stringUnit" : {+ "state" : "translated",+ "value" : "Laissé en place : macOS supprime cette extension système au redémarrage de votre Mac."+ }+ },+ "it" : {+ "stringUnit" : {+ "state" : "translated",+ "value" : "Resta dov’è: macOS rimuoverà questa estensione di sistema al riavvio del Mac."+ }+ },+ "ja" : {+ "stringUnit" : {+ "state" : "translated",+ "value" : "対象外: Macを再起動すると、macOSがこのシステム機能拡張を削除します。"+ }+ },+ "ko" : {+ "stringUnit" : {+ "state" : "translated",+ "value" : "그대로 둠: Mac을 재시동하면 macOS가 이 시스템 확장 프로그램을 제거합니다."+ }+ },+ "nl" : {+ "stringUnit" : {+ "state" : "translated",+ "value" : "Blijft staan: macOS verwijdert deze systeemextensie als je Mac opnieuw opstart."+ }+ },+ "pl" : {+ "stringUnit" : {+ "state" : "translated",+ "value" : "Nietknięte: macOS usunie to rozszerzenie systemowe po ponownym uruchomieniu Maca."+ }+ },+ "pt" : {+ "stringUnit" : {+ "state" : "translated",+ "value" : "Preservado: o macOS remove esta extensão do sistema quando o Mac for reiniciado."+ }+ },+ "ro" : {+ "stringUnit" : {+ "state" : "translated",+ "value" : "Lăsat neatins: macOS elimină această extensie de sistem când Mac‑ul repornește."+ }+ },+ "ru" : {+ "stringUnit" : {+ "state" : "translated",+ "value" : "Остается на месте: macOS удалит это системное расширение после перезагрузки Mac."+ }+ },+ "sv" : {+ "stringUnit" : {+ "state" : "translated",+ "value" : "Rörs inte: macOS tar bort det här systemtillägget när datorn startas om."+ }+ },+ "tr" : {+ "stringUnit" : {+ "state" : "translated",+ "value" : "Yerinde kalır: macOS bu sistem genişletmesini Mac’iniz yeniden başladığında kaldırır."+ }+ },+ "uk" : {+ "stringUnit" : {+ "state" : "translated",+ "value" : "Лишається на місці: macOS вилучить це системне розширення після перезапуску Mac."+ }+ },+ "zh-Hans" : {+ "stringUnit" : {+ "state" : "translated",+ "value" : "留在原处:你的Mac重新启动时,macOS会移除此系统扩展。"+ }+ },+ "zh-Hant" : {+ "stringUnit" : {+ "state" : "translated",+ "value" : "原地保留:macOS會在Mac重新開機時移除此系統延伸功能。"+ }+ }+ }+ },"Left alone: only an administrator can move this, and Peel’s helper isn’t allowed to move it from here." : {"localizations" : {"cs" : {diff --git a/Packages/PeelCore/Sources/PeelCommandLine/Support/Output.swift b/Packages/PeelCore/Sources/PeelCommandLine/Support/Output.swiftindex a779abe9..6e355ddc 100644--- a/Packages/PeelCore/Sources/PeelCommandLine/Support/Output.swift+++ b/Packages/PeelCore/Sources/PeelCommandLine/Support/Output.swift@@ -331,6 +331,9 @@ extension HoldBack {case .insideAnotherAppsFolder: "inside another app's folder"case .beyondTheHelper: "needs an administrator, and Peel's helper may not move it"case .leftToItsUninstaller: "removed by the app's own uninstaller once the app is in the Trash"+ case .systemExtension:+ "a system extension macOS installed, which it removes only when its app goes to the Trash in Finder"+ case .systemExtensionGoingAtRestart: "a system extension macOS removes at the next restart"case .keptByMacOS: "a cache macOS keeps for itself"case .openedFromMail: "an attachment opened from Mail, which may be the only copy"case .crashReport: "a crash report, which the app's developer may still ask for"diff --git a/Packages/PeelCore/Sources/PeelCore/Leftovers/Leftover.swift b/Packages/PeelCore/Sources/PeelCore/Leftovers/Leftover.swiftindex e607b5c4..121e7cee 100644--- a/Packages/PeelCore/Sources/PeelCore/Leftovers/Leftover.swift+++ b/Packages/PeelCore/Sources/PeelCore/Leftovers/Leftover.swift@@ -84,6 +84,10 @@ public enum HoldBack: String, Sendable, Hashable {/// Removed by the app's own uninstaller once the app has moved (`UninstallsItself`). Moved first, the file of/// the job that runs the uninstaller would stop it, and the rest of its cleanup would never happen.case leftToItsUninstaller+ /// The copy macOS installed of an app's system extension, which only macOS removes.+ case systemExtension+ /// A system extension macOS removes at the next restart.+ case systemExtensionGoingAtRestart/// A cache macOS keeps for its own services, which may be using it at any moment (`SystemCaches`).case keptByMacOS/// A copy Mail keeps of an attachment that was opened. One that was edited may exist nowhere else.@@ -110,7 +114,7 @@ public enum HoldBack: String, Sendable, Hashable {public var cannotBeMoved: Bool {self == .holdsDocuments || self == .holdsALibrary || self == .holdsKeys || self == .holdsWorkKeptInACache|| self == .beyondTheHelper || self == .leftToItsUninstaller- || self == .holdsAnExclusion+ || self == .systemExtension || self == .systemExtensionGoingAtRestart || self == .holdsAnExclusion}/// Why what a walk saw leaves a folder to be chosen by hand: a wallet, a signing key, or a repository inside maydiff --git a/Packages/PeelCore/Sources/PeelCore/Orphans/OrphanScanner.swift b/Packages/PeelCore/Sources/PeelCore/Orphans/OrphanScanner.swiftindex 7a9ab0f2..8676e9ee 100644--- a/Packages/PeelCore/Sources/PeelCore/Orphans/OrphanScanner.swift+++ b/Packages/PeelCore/Sources/PeelCore/Orphans/OrphanScanner.swift@@ -15,6 +15,7 @@ public struct OrphanScanner: Sendable {private let walk: LeftoverScanner.Measure/// The most folders listed per location while looking inside folders no orphan is named after.private let nestedFolderLimit: Int+ private let systemExtensions: AppExtensions.SystemExtensionsAnswerpublic init(environment: SearchEnvironment = .current, exclusions: Exclusions = .none) {self.init(@@ -30,7 +31,8 @@ public struct OrphanScanner: Sendable {isRegisteredApp: @escaping @Sendable (String) -> Bool,systemApps: [InstalledApp]? = nil,walk: @escaping LeftoverScanner.Measure = LeftoverScanner.walk,- nestedFolderLimit: Int = NestedSearch.folderLimit+ nestedFolderLimit: Int = NestedSearch.folderLimit,+ systemExtensions: @escaping AppExtensions.SystemExtensionsAnswer = AppExtensions.askingMacOS) {self.environment = environmentself.exclusions = exclusions@@ -38,6 +40,7 @@ public struct OrphanScanner: Sendable {self.systemApps = systemAppsself.walk = walkself.nestedFolderLimit = nestedFolderLimit+ self.systemExtensions = systemExtensions}/// Finds the items that no app claims, in every location, grouped by identifier.@@ -110,16 +113,27 @@ public struct OrphanScanner: Sendable {}let reach = HelperReach(environment: environment)+ let staged = PathPattern.comparablePath(of: environment.rootDirectory.appending(path: "Library/SystemExtensions"))+ let isStaged = { (item: OrphanItem) in+ PathComponents.isPath(PathPattern.comparablePath(of: item.url), inside: staged)+ }+ let goingAtRestart = found.contains { isStaged($0.item) }+ ? Set((await systemExtensions() ?? []).filter { $0.election == .beingRemoved }.compactMap(\.url)+ .map(PathPattern.comparablePath(of:)))+ : []let kept = found.filter {!exclusions.excludes($0.item.url) && !exclusions.holds($0.item.url)&& !exclusions.excludes(bundleIdentifier: $0.identifier)&& !(owners[$0.identifier.lowercased()].map { here.contains($0.lowercased()) } ?? false)}.map { entry in- guard entry.item.requiresPrivileges, entry.item.leftAlone == nil, reach.isBeyond(entry.item.url) else {- return entry- }var item = entry.item+ if isStaged(item) {+ let removing = goingAtRestart.contains(PathPattern.comparablePath(of: item.url))+ item.heldBack = removing ? .systemExtensionGoingAtRestart : .systemExtension+ return (entry.identifier, item)+ }+ guard item.requiresPrivileges, item.leftAlone == nil, reach.isBeyond(item.url) else { return entry }item.heldBack = .beyondTheHelperreturn (entry.identifier, item)}diff --git a/Packages/PeelCore/Tests/PeelCoreTests/OrphanScannerTests.swift b/Packages/PeelCore/Tests/PeelCoreTests/OrphanScannerTests.swiftindex 6ddf3d2f..d9502265 100644--- a/Packages/PeelCore/Tests/PeelCoreTests/OrphanScannerTests.swift+++ b/Packages/PeelCore/Tests/PeelCoreTests/OrphanScannerTests.swift@@ -56,7 +56,8 @@ struct OrphanScannerTests {in directory: borrowing TemporaryDirectory,registered: Set<String> = [],systemApps: [InstalledApp] = [],- nestedFolderLimit: Int = NestedSearch.folderLimit+ nestedFolderLimit: Int = NestedSearch.folderLimit,+ systemExtensions: @escaping AppExtensions.SystemExtensionsAnswer = { [] }) -> OrphanScanner {let environment = SearchEnvironment(homeDirectory: directory.url.appending(path: "home", directoryHint: .isDirectory),@@ -66,10 +67,34 @@ struct OrphanScannerTests {environment: environment,isRegisteredApp: { registered.contains($0) },systemApps: systemApps,- nestedFolderLimit: nestedFolderLimit+ nestedFolderLimit: nestedFolderLimit,+ systemExtensions: systemExtensions)}+ @Test func aSystemExtensionACopyOfWhichMacOSKeepsIsLeftToMacOS() async throws {+ let directory = try TemporaryDirectory()+ let kept = try directory.directory("root/Library/SystemExtensions/5DF88A99/org.example.mixer.camera.systemextension")+ let going = try directory.directory("root/Library/SystemExtensions/77689A22/org.example.mixer.filter.systemextension")+ let gone = RememberedApp(+ bundleIdentifier: "org.example.mixer", name: "Mixer", teamIdentifier: nil, lastSeen: .now,+ lastPath: "/Applications/Mixer.app"+ )+ let removing = AppExtension(+ identifier: "org.example.mixer.filter", name: "Mixer Filter", kind: .systemExtension, point: nil,+ owner: nil, url: going, election: .beingRemoved, teamIdentifier: nil, reportedState: nil+ )++ let scan = await scanner(in: directory) { [removing] }.scan(installedApps: installed, remembered: [gone])++ let items = scan.groups.flatMap(\.items)+ func item(_ url: URL) -> OrphanItem? {+ items.first { PathPattern.comparablePath(of: $0.url) == PathPattern.comparablePath(of: url) }+ }+ #expect(item(kept)?.leftAlone == .systemExtension)+ #expect(item(going)?.leftAlone == .systemExtensionGoingAtRestart)+ }+/// The recent documents list macOS 26 writes (`.sfl4`) belongs to the installed app it is named for.@Test func anInstalledAppsRecentDocumentListIsNoOrphan() async throws {let directory = try TemporaryDirectory()diff --git a/Peel/Views/Presentation.swift b/Peel/Views/Presentation.swiftindex 77c3be5c..08847d40 100644--- a/Peel/Views/Presentation.swift+++ b/Peel/Views/Presentation.swift@@ -271,6 +271,10 @@ extension HoldBack {"Left alone: only an administrator can move this, and Peel’s helper isn’t allowed to move it from here."case .leftToItsUninstaller:"Left alone: the app’s own uninstaller removes this once the app is in the Trash, and History can’t bring it back."+ case .systemExtension:+ "Left alone: macOS installed this system extension and removes it only when the app that uses it goes to the Trash in Finder. If that app is gone, install it again, open it and use the feature that needs the extension, allow it when macOS asks, then move the app to the Trash in Finder and restart your Mac."+ case .systemExtensionGoingAtRestart:+ "Left alone: macOS removes this system extension when your Mac restarts."case .keptByMacOS:"Not selected: macOS keeps this cache for its own services, which may be using it right now."case .openedFromMail:diff --git a/SAFETY.md b/SAFETY.mdindex c2783b1e..00a0cc8c 100644--- a/SAFETY.md+++ b/SAFETY.md@@ -325,6 +325,9 @@ and Select Recommended selects what Peel recommends there.Orphaned Files selects nothing for you, and `peel orphans --remove` leaves these folders out as well: one in`/Users/Shared`, one with a repository, a wallet, a signing key, or a password database inside, one that may hold whatexists only on this Mac, or one Peel could not read or measure in time, moves only when you select it yourself.+The copy macOS installed of a system extension, in `/Library/SystemExtensions`, is listed and can't be selected:+only macOS removes it, when the app that uses it goes to the Trash in Finder, and its note says so, or that macOS+removes it at the next restart.On every list, Select All selects every row you can select, what Peel holds back included, and asks first,counting what Peel doesn't recommend; Return answers Select Recommended. Each held back row still shows its reason