Free · Open sourceGPL-3.0

Free and open source.

Sweep is released under the GNU General Public License v3.0. Read every line, build it yourself, and help make it better.

Swift 6 · SwiftUI · GPL-3.0

Sweep, more than a cleaner, with a row of its features: camera and mic history, background item watch, drive health and more
Why open source

An app with Full Disk Access should be one you can check

Sweep asks for Full Disk Access and can remove files. With the source public, you can read exactly what it does before you give it that access.

The GPL-3.0 licence keeps it that way: anyone can use, study, change and share Sweep, and versions they share must stay open under the same licence.

Build from source

Build it yourself

You need Xcode 16 or later (Swift 6). Builds are ad-hoc signed, and the app keeps its permissions across rebuilds.

sh

Run the tests, build the app and open it

git clone https://github.com/amar97march/sweep.git
cd sweep
swift test                            # the whole test suite
scripts/make-app.sh && open .build/Sweep.app
How it's built

A native app in small, readable parts

SweepCore

The scan engine: a bulk directory reader, a parallel tree scanner, and the file remover with its removal policies.

SweepScanners

One scanner per module, the YARA engine, the update checker and browser privacy.

SweepMonitor

System readings, drive health, energy per app, camera and microphone use, Keep Awake and the health score.

SweepLens

Disk Map: circle packing, layout, the removal flow and Sweep's brand colours.

SweepUI

The design system, every module's screens, settings and the screenshot harness.

SweepApp

The app itself: the main window, Settings and the menu bar.

SweepNative

Small C helpers for interfaces Swift can't call directly, like the NVMe health log.

sweep

The command-line tool.

Tests

Nearly 300 Swift Testing tests that never touch anything outside the project.

Contributing

Help make Sweep better

  1. 1

    Report a bug

    Open an issue with your macOS version, your Mac, what you did and what happened. If something was removed that shouldn't have been, include the action log.

  2. 2

    Suggest a feature

    Describe the problem first and your idea second. Features that run quietly, explain themselves and never surprise people fit Sweep best.

  3. 3

    Send a pull request

    swift test must pass and new behaviour needs tests. For UI changes, attach before and after screenshots from the screenshot harness.

  4. 4

    Follow the rules

    Nothing removed without review, tests stay inside the project, no tracking, and write it yourself.

Help wanted

Good places to start

  • Live bubbles in Disk Map while a scan is still running
  • Translations
  • The caches of a developer tool you use
  • A VoiceOver pass over every screen
  • A Homebrew tap, so brew install works
Third-party notices

Credit where it's due

Disk Map's circle packing adapts the sibling-packing and enclosing-circle algorithms from d3-hierarchy by Mike Bostock, used under its ISC-style permission notice. It's the only third-party code listed in THIRD_PARTY_NOTICES.md.

Everything else is written for Sweep. The contributing rules ask that no code, data, text or artwork is copied from other products.

Support Sweep

Free, and built in spare time

If Sweep helped you, here's how to help it.

Star the repo

Stars help more people find Sweep on GitHub.

Share it

With a friend whose Mac keeps running out of space.

Buy me a coffee

It goes towards an Apple Developer account, so Sweep can be notarized and open without the Open Anyway step.

Help Sweep reach more Macs.

A star, a share or a coffee all make a difference.