Skip to content

armgit / peel

Public Imported from GitHub
0

Uninstall Mac apps with every file they leave behind, and see why each belongs. Free up space, fine-tune macOS, and set up Terminal.

Leave the switch of an app's registered background item to System Settings

Țugui Dragoș4c49b127f81b
diff --git a/Localization/Peel/Localizable.xcstrings b/Localization/Peel/Localizable.xcstrings
index a356c0e4..aea1e622 100644
--- a/Localization/Peel/Localizable.xcstrings
+++ b/Localization/Peel/Localizable.xcstrings
@@ -66989,6 +66989,112 @@
}
}
},
+ "Its app registered it with macOS, so it is turned on or off in System Settings > General > Login Items & Extensions." : {
+ "localizations" : {
+ "cs" : {
+ "stringUnit" : {
+ "state" : "translated",
+ "value" : "Její aplikace ji zaregistrovala v systému macOS, takže se zapíná a vypíná v Nastavení systému > Obecné > Aktivace položek a rozšíření při přihlášení."
+ }
+ },
+ "de" : {
+ "stringUnit" : {
+ "state" : "translated",
+ "value" : "Die zugehörige App hat es bei macOS registriert, daher wird es unter „Systemeinstellungen“ > „Allgemein“ > „Anmeldeobjekte & Erweiterungen“ aktiviert oder deaktiviert."
+ }
+ },
+ "es" : {
+ "stringUnit" : {
+ "state" : "translated",
+ "value" : "Su app lo registró en macOS, así que se activa o se desactiva en Ajustes del Sistema > General > Ítems de inicio y extensiones."
+ }
+ },
+ "fr" : {
+ "stringUnit" : {
+ "state" : "translated",
+ "value" : "Son app l’a enregistré auprès de macOS : il s’active ou se désactive donc dans Réglages Système > Général > Ouverture et extensions."
+ }
+ },
+ "it" : {
+ "stringUnit" : {
+ "state" : "translated",
+ "value" : "La sua app l’ha registrato presso macOS, quindi si attiva o si disattiva in Impostazioni di Sistema > Generali > Elementi login ed estensioni."
+ }
+ },
+ "ja" : {
+ "stringUnit" : {
+ "state" : "translated",
+ "value" : "この項目はアプリによってmacOSに登録されたため、“システム設定”>“一般”>“ログイン項目と機能拡張”でオン/オフを切り替えます。"
+ }
+ },
+ "ko" : {
+ "stringUnit" : {
+ "state" : "translated",
+ "value" : "이 항목의 앱이 macOS에 등록했으므로 시스템 설정 > 일반 > 로그인 항목 및 확장 프로그램에서 켜거나 끕니다."
+ }
+ },
+ "nl" : {
+ "stringUnit" : {
+ "state" : "translated",
+ "value" : "De bijbehorende app heeft het bij macOS geregistreerd, dus het wordt in- of uitgeschakeld in Systeeminstellingen > Algemeen > Inlogonderdelen en extensies."
+ }
+ },
+ "pl" : {
+ "stringUnit" : {
+ "state" : "translated",
+ "value" : "Jej aplikacja zarejestrowała ją w macOS, więc włącza się ją i wyłącza w Ustawieniach systemowych > Ogólne > Rzeczy i rozszerzenia otwierane podczas logowania."
+ }
+ },
+ "pt" : {
+ "stringUnit" : {
+ "state" : "translated",
+ "value" : "O app dele o registrou no macOS, então ele é ativado ou desativado em Ajustes do Sistema > Geral > Itens de Início de Sessão e Extensões."
+ }
+ },
+ "ro" : {
+ "stringUnit" : {
+ "state" : "translated",
+ "value" : "Aplicația sa l‑a înregistrat la macOS, așa că se activează sau se dezactivează din Configurări sistem > General > Lansare la login și extensii."
+ }
+ },
+ "ru" : {
+ "stringUnit" : {
+ "state" : "translated",
+ "value" : "Этот объект зарегистрировало в macOS его приложение, поэтому он включается и выключается в разделе «Системные настройки» > «Основные» > «Объекты входа и расширения»."
+ }
+ },
+ "sv" : {
+ "stringUnit" : {
+ "state" : "translated",
+ "value" : "Appen som det hör till har registrerat det hos macOS, så det slås på och stängs av i Systeminställningar > Allmänt > Startobjekt och tillägg."
+ }
+ },
+ "tr" : {
+ "stringUnit" : {
+ "state" : "translated",
+ "value" : "Uygulaması onu macOS’e kaydetti, bu yüzden Sistem Ayarları > Genel > Oturum Açma Öğeleri ve Genişletmeler bölümünden açılıp kapatılır."
+ }
+ },
+ "uk" : {
+ "stringUnit" : {
+ "state" : "translated",
+ "value" : "Програма зареєструвала цей елемент у macOS, тож вмикають і вимикають його в розділі Системні параметри > Загальні > Автозапуск і розширення."
+ }
+ },
+ "zh-Hans" : {
+ "stringUnit" : {
+ "state" : "translated",
+ "value" : "它的App已将它注册到macOS,因此要在“系统设置”>“通用”>“登录项与扩展”中打开或关闭它。"
+ }
+ },
+ "zh-Hant" : {
+ "stringUnit" : {
+ "state" : "translated",
+ "value" : "它的App已向macOS註冊它,因此要在「系統設定」>「一般」>「登入項目與延伸功能」中開啟或關閉它。"
+ }
+ }
+ }
+ },
"Its command decodes base64, which keeps what it runs from being read at a glance. Software installed on purpose can do this too." : {
"localizations" : {
"cs" : {
@@ -68579,6 +68685,112 @@
}
}
},
+ "Its switch is in System Settings" : {
+ "localizations" : {
+ "cs" : {
+ "stringUnit" : {
+ "state" : "translated",
+ "value" : "Její přepínač je v Nastavení systému"
+ }
+ },
+ "de" : {
+ "stringUnit" : {
+ "state" : "translated",
+ "value" : "Der Schalter dafür ist in den Systemeinstellungen"
+ }
+ },
+ "es" : {
+ "stringUnit" : {
+ "state" : "translated",
+ "value" : "Su interruptor está en Ajustes del Sistema"
+ }
+ },
+ "fr" : {
+ "stringUnit" : {
+ "state" : "translated",
+ "value" : "Son commutateur se trouve dans Réglages Système"
+ }
+ },
+ "it" : {
+ "stringUnit" : {
+ "state" : "translated",
+ "value" : "Il suo interruttore è in Impostazioni di Sistema"
+ }
+ },
+ "ja" : {
+ "stringUnit" : {
+ "state" : "translated",
+ "value" : "スイッチはシステム設定にあります"
+ }
+ },
+ "ko" : {
+ "stringUnit" : {
+ "state" : "translated",
+ "value" : "스위치가 시스템 설정에 있음"
+ }
+ },
+ "nl" : {
+ "stringUnit" : {
+ "state" : "translated",
+ "value" : "De schakelaar staat in Systeeminstellingen"
+ }
+ },
+ "pl" : {
+ "stringUnit" : {
+ "state" : "translated",
+ "value" : "Jej przełącznik jest w Ustawieniach systemowych"
+ }
+ },
+ "pt" : {
+ "stringUnit" : {
+ "state" : "translated",
+ "value" : "O botão dele fica nos Ajustes do Sistema"
+ }
+ },
+ "ro" : {
+ "stringUnit" : {
+ "state" : "translated",
+ "value" : "Comutatorul său se află în Configurări sistem"
+ }
+ },
+ "ru" : {
+ "stringUnit" : {
+ "state" : "translated",
+ "value" : "Его переключатель находится в Системных настройках"
+ }
+ },
+ "sv" : {
+ "stringUnit" : {
+ "state" : "translated",
+ "value" : "Reglaget finns i Systeminställningar"
+ }
+ },
+ "tr" : {
+ "stringUnit" : {
+ "state" : "translated",
+ "value" : "Düğmesi Sistem Ayarları’nda"
+ }
+ },
+ "uk" : {
+ "stringUnit" : {
+ "state" : "translated",
+ "value" : "Його перемикач у Системних параметрах"
+ }
+ },
+ "zh-Hans" : {
+ "stringUnit" : {
+ "state" : "translated",
+ "value" : "它的开关在“系统设置”中"
+ }
+ },
+ "zh-Hant" : {
+ "stringUnit" : {
+ "state" : "translated",
+ "value" : "它的開關位於「系統設定」中"
+ }
+ }
+ }
+ },
"It’s in /Library, so every account on this Mac has it." : {
"localizations" : {
"cs" : {
diff --git a/Packages/PeelCore/Sources/PeelCore/BackgroundItems/BackgroundItem.swift b/Packages/PeelCore/Sources/PeelCore/BackgroundItems/BackgroundItem.swift
index 62de03bd..7a97458d 100644
--- a/Packages/PeelCore/Sources/PeelCore/BackgroundItems/BackgroundItem.swift
+++ b/Packages/PeelCore/Sources/PeelCore/BackgroundItems/BackgroundItem.swift
@@ -57,6 +57,9 @@ public struct BackgroundItem: Sendable, Hashable, Identifiable {
/// True for a job launchd runs for a system extension, whose program sits in `/Library/SystemExtensions`: macOS
/// runs it, and only System Settings changes it.
public var isSystemExtension = false
+ /// True for a job ServiceManagement manages: the person turns it on and off in System Settings > General > Login
+ /// Items & Extensions, so Peel never disables it.
+ public var isManagedByServiceManagement = false
public var isOwnerInstalled: Bool { ownerURL != nil }
diff --git a/Packages/PeelCore/Sources/PeelCore/BackgroundItems/BackgroundItemActions.swift b/Packages/PeelCore/Sources/PeelCore/BackgroundItems/BackgroundItemActions.swift
index d08ea3ee..c7ec825f 100644
--- a/Packages/PeelCore/Sources/PeelCore/BackgroundItems/BackgroundItemActions.swift
+++ b/Packages/PeelCore/Sources/PeelCore/BackgroundItems/BackgroundItemActions.swift
@@ -76,9 +76,16 @@ public enum BackgroundItemActions {
}
}
+ /// Why Peel will not switch `item` on or off, or nil. Only System Settings turns off a job ServiceManagement
+ /// manages: an override of launchd's alone would leave the two saying different things.
+ static func refusal(toSwitch item: BackgroundItem, on isEnabled: Bool) -> Failure? {
+ if let refusal = refusal(for: item) { return refusal }
+ return !isEnabled && item.isManagedByServiceManagement ? .launchctl(HelperRefusal.invalidRequest.rawValue) : nil
+ }
+
@concurrent
public static func setEnabled(_ isEnabled: Bool, for item: BackgroundItem) async throws(Failure) {
- if let refusal = refusal(for: item) { throw refusal }
+ if let refusal = refusal(toSwitch: item, on: isEnabled) { throw refusal }
if item.requiresPrivileges {
try await runPrivileged(isEnabled ? .enable : .disable, for: item)
} else {
diff --git a/Packages/PeelCore/Sources/PeelCore/BackgroundItems/BackgroundItems.swift b/Packages/PeelCore/Sources/PeelCore/BackgroundItems/BackgroundItems.swift
index 5eac1a36..ee5cfb07 100644
--- a/Packages/PeelCore/Sources/PeelCore/BackgroundItems/BackgroundItems.swift
+++ b/Packages/PeelCore/Sources/PeelCore/BackgroundItems/BackgroundItems.swift
@@ -328,6 +328,7 @@ public enum BackgroundItems {
)
item.runsFromTheTrash = programIsUnnamed && running.map { AppInspector.isInATrash(URL(filePath: $0)) } == true
item.isSystemExtension = program.map { PathComponents.isPath($0, inside: "/Library/SystemExtensions") } == true
+ item.isManagedByServiceManagement = details.managedBy == serviceManagement
return .item(item)
}
diff --git a/Packages/PeelCore/Tests/PeelCoreTests/BackgroundItemActionsTests.swift b/Packages/PeelCore/Tests/PeelCoreTests/BackgroundItemActionsTests.swift
index fd5595fa..225ebbc6 100644
--- a/Packages/PeelCore/Tests/PeelCoreTests/BackgroundItemActionsTests.swift
+++ b/Packages/PeelCore/Tests/PeelCoreTests/BackgroundItemActionsTests.swift
@@ -183,6 +183,34 @@ struct BackgroundItemActionsTests {
#expect(helpersJob.canBeControlled)
}
+ @Test func aJobServiceManagementManagesIsTurnedOffInSystemSettings() throws {
+ let label = "org.example.tide.loginhelper"
+ func item(_ details: Launchctl.JobDetails, disabled: Bool = false) throws -> BackgroundItem {
+ let found = BackgroundItems.undeclaredItem(
+ (label, .agent, "gui/501/\(label)"), answer: .details(details),
+ ownership: BackgroundItemOwnership(installedApps: []),
+ loaded: .init(user: [label: nil], userDisabled: [label: disabled]), exclusions: .none
+ )
+ guard case .item(let item) = found else { throw CocoaError(.featureUnsupported) }
+ return item
+ }
+ let registered = Launchctl.JobDetails(
+ path: "(submitted by smd.251)", managedBy: "com.apple.xpc.ServiceManagement",
+ parentBundleIdentifier: "org.example.tide"
+ )
+ let submitted = Launchctl.JobDetails(path: "(submitted by Tide.42)", program: "/bin/sh")
+
+ let managed = try item(registered)
+ let managedAndDisabled = try item(registered, disabled: true)
+ let other = try item(submitted)
+
+ #expect(managed.isManagedByServiceManagement)
+ #expect(BackgroundItemActions.refusal(toSwitch: managed, on: false) != nil)
+ #expect(BackgroundItemActions.refusal(toSwitch: managedAndDisabled, on: true) == nil)
+ #expect(!other.isManagedByServiceManagement)
+ #expect(BackgroundItemActions.refusal(toSwitch: other, on: false) == nil)
+ }
+
@Test func aDisabledJobLaunchdDoesNotHaveIsEnabledFirst() {
let plist = URL(filePath: "/Users/x/Library/LaunchAgents/com.example.agent.plist")
let disabled = BackgroundItem(
diff --git a/Peel/Views/BackgroundItems/BackgroundItemDetailView.swift b/Peel/Views/BackgroundItems/BackgroundItemDetailView.swift
index 1528f042..cdc4f7df 100644
--- a/Peel/Views/BackgroundItems/BackgroundItemDetailView.swift
+++ b/Peel/Views/BackgroundItems/BackgroundItemDetailView.swift
@@ -138,6 +138,19 @@ struct BackgroundItemDetailView: View {
}
}
+ if item.isManagedByServiceManagement, !item.isPeelsHelper {
+ Section {
+ Notice(
+ title: Text("Its switch is in System Settings"),
+ detail: Text("Its app registered it with macOS, so it is turned on or off in System Settings > General > Login Items & Extensions."),
+ kind: .note
+ ) {
+ Button("Open Login Items & Extensions") { SMAppService.openSystemSettingsLoginItems() }
+ }
+ .padding(.vertical, 6)
+ }
+ }
+
if item.source == .otherFile {
Section {
Notice(
@@ -319,9 +332,14 @@ struct BackgroundItemDetailView: View {
/// Start, Stop, Enable, and Disable, which a job Peel may not control, a job whose state Peel could not read, a
/// file macOS can't load, and a job loaded from a file elsewhere don't have. Disabled, that last one would leave
- /// the list at the next logout or restart with nothing left to Enable it from.
+ /// the list at the next logout or restart with nothing left to Enable it from. A job ServiceManagement manages has
+ /// only Enable, while launchd keeps it disabled.
private var hasOwnControls: Bool {
- item.canBeControlled && item.state != .unknown && item.source != .otherFile && !item.isUnreadable
+ guard item.canBeControlled, item.state != .unknown, item.source != .otherFile, !item.isUnreadable else {
+ return false
+ }
+ if #available(macOS 27, *), item.isLeftByAGoneApp { return true }
+ return !item.isSeenOnlyWhileLoaded || item.isDisabled || !item.isManagedByServiceManagement
}
private var controls: some View {
@@ -359,8 +377,10 @@ struct BackgroundItemDetailView: View {
Task { await backgroundItems.perform(isRunning ? .stop : .start, on: item) }
}
}
- Button(item.isDisabled ? "Enable" : "Disable", systemImage: item.isDisabled ? "checkmark.circle" : "minus.circle") {
- Task { await backgroundItems.perform(item.isDisabled ? .enable : .disable, on: item) }
+ if item.isDisabled || !item.isManagedByServiceManagement {
+ Button(item.isDisabled ? "Enable" : "Disable", systemImage: item.isDisabled ? "checkmark.circle" : "minus.circle") {
+ Task { await backgroundItems.perform(item.isDisabled ? .enable : .disable, on: item) }
+ }
}
}
}