Repository navigation
Releases
Releases · p-stzhuk/MacSweep
MacSweep 0.3.0-beta.1
Third public beta: MacSweep now targets macOS 13 Ventura and later on Intel and Apple silicon. The
design, scanning, safety rules, selection and Trash-only removal are unchanged from 0.2.0-beta.1.
Changed
- Minimum system requirement lowered from macOS 15 to macOS 13 Ventura. Support for macOS 13
and 14 is experimental: the app is built for them, but has not yet been run on them. macOS 15
and 26 are tested. - View models use
ObservableObjectinstead of the macOS 14 Observation framework. APIs that are
newer than macOS 13 (ContentUnavailableView,NSApplication.activate(),
toolbar(removing: .title)) go through small adapters that use the system API where available. MacSweepCoreusesOSAllocatedUnfairLockinstead ofSynchronization.Mutex(macOS 15).
Fixed
- Stop Scan now stops the scan. Previously cancellation did not reach the background scan:
Cleanup kept scanning and stayed in the “Scanning” state. Stopping now returns to the previous
state immediately, and a stopped scan can no longer overwrite a newer one.
Added
- App-level tests for the view models (state publication, async updates, Stop Scan, cancellation,
selection safety) and concurrency tests for the core locks. - CI checks that the built app requires macOS 13.0, and launches it on macOS 15 and macOS 26 with
window snapshots. - Updated roadmap (README) with milestones through 1.0.
Known limitations
- macOS 13 and 14 have not been tested on real systems yet (GitHub no longer offers hosted
runners for them). Please report problems on these versions. - Not notarized; macOS asks you to confirm the first launch.
Installation
- Download
MacSweep-0.3.0-beta.1.zip, unzip it and move MacSweep.app to /Applications. - MacSweep is not notarized yet. On first launch macOS will block it: open
System Settings › Privacy & Security and click Open Anyway next to the MacSweep message. - Optional: verify the download with
shasum -a 256 -c MacSweep-0.3.0-beta.1.zip.sha256.
Requires macOS 15 Sequoia or later on Apple silicon or Intel.
MacSweep 0.2.0-beta.1
Second public beta: a new look, the same conservative engine. Scanning, safety rules, selection
and Trash-only removal are unchanged from 0.1.0-beta.1.
Added
- Brand identity: app icon, brand mark and Glacier Teal accent (brand kit v1.0 in
Design/Brand/), with accessible Light, Dark and Increased Contrast variants. - About section with the app icon, slogan (“Clean by design.”), version, license and source link.
- Keyboard shortcuts: ⌘1–⌘3 switch sections, ⌘, opens Settings, ⌘R reloads applications,
⌘⌫ starts an uninstall or Trash move (always confirmed). - Filter for the application list: All Apps, Mac App Store, Other Sources.
- macOS compatibility assessment and migration plan for macOS 14 and 13 (
docs/COMPATIBILITY.md).
Changed
- Minimal topbar interface. The sidebar is replaced by a toolbar with the brand mark and a
segmented Applications / Cleanup / Settings control. Each screen starts with a large title and a
one-line subtitle. - Applications is a two-pane view: a compact table (App Size, Total with associated files) and a
details pane with a Reclaimable figure, Files to Remove, a Safety & Confidence summary and an
“Uninstall …” button. - File rows are single compact lines. Badges, explanations, paths and dates moved to an info
popover. - Cleanup starts from a centered Start Scan state and groups results into Safe to Clean and
Needs Review, with a one-line reclaimable summary. - Settings use a grouped native layout with inline descriptions.
- Status labels pair colored symbols with neutral text for contrast; destructive actions are red
and always confirmed. - Version-adaptive bars and primary buttons: Liquid Glass APIs on macOS 26 and later, system
materials on macOS 15. Not yet visually verified on macOS 26. - The app is built from
MacSweep.xcodeproj(Xcode 26+), with core logic in the local Swift
packageMacSweepCore/. CI and release packaging usexcodebuild.
Known limitations
- Not notarized; macOS asks you to confirm the first launch.
- Requires macOS 15 or later.
- See the README for the full list.
Installation
- Download
MacSweep-0.2.0-beta.1.zip, unzip it and move MacSweep.app to /Applications. - MacSweep is not notarized yet. On first launch macOS will block it: open
System Settings › Privacy & Security and click Open Anyway next to the MacSweep message. - Optional: verify the download with
shasum -a 256 -c MacSweep-0.2.0-beta.1.zip.sha256.
Requires macOS 15 Sequoia or later on Apple silicon or Intel.
MacSweep 0.1.0-beta.1
First public beta. Please report problems — especially anything MacSweep selected that it should
not have — through GitHub issues, or privately as described in SECURITY.md.
Added
- Application uninstaller: lists apps in /Applications and ~/Applications with version,
developer, bundle identifier and sizes; finds associated files in ~/Library and classifies them
as verified, probable or uncertain; pre-selects only verified items; detects running apps,
official uninstallers and system-level components it will not remove. - Cleanup scanner (read-only): leftovers of removed apps, caches, temporary files older than
7 days, logs and crash reports older than 30 days, and a Needs Review group that is never
pre-selected. - Safety engine: protected-location rules, path validation, symlink, hard-link and mount-point
handling, running-app and open-file checks, sensitive-content detection, and revalidation of
every item immediately before it is moved. - Trash-only removal with confirmation, per-item report and a local operation log.
- Settings: appearance, advanced details, selection policy, confirmation, scan exclusions.
Known limitations
- Not notarized; macOS asks you to confirm the first launch.
- No app icon yet.
- Moving apps to the Trash may require the App Management permission.
- See the README for the full list.
Installation
- Download
MacSweep-0.1.0-beta.1.zip, unzip it and move MacSweep.app to /Applications. - MacSweep is not notarized yet. On first launch macOS will block it: open
System Settings › Privacy & Security and click Open Anyway next to the MacSweep message. - Optional: verify the download with
shasum -a 256 -c MacSweep-0.1.0-beta.1.zip.sha256.
Requires macOS 15 Sequoia or later on Apple silicon or Intel.