Skip to content

Shudufhadzo/clearspace

Repository files navigation

Clearspace

Clearspace is a native macOS storage cleanup utility built with SwiftUI. It scans rebuildable caches and user-reviewable storage, shows what is taking space, identifies exact duplicate files, and moves only explicitly ticked personal files to Trash.

Download

Download Clearspace for macOS

SHA-256:

083029c62f9425e60f6ea2ef555de65e99fce9156be7b54b7612f1b2f992eb00

The app is designed around a conservative safety model:

  • Clearspace does not scan automatically on launch.
  • Caches can be ticked automatically after a scan.
  • Personal files, photos, videos, archives, and duplicate copies stay unticked until the user chooses them.
  • Whitelisted files and folders are protected during scanning, selection, confirmation, and cleanup.
  • Personal files are moved to Trash instead of being permanently unlinked.
  • Cleanup revalidates file identity, size, modification date, whitelist state, and scan roots immediately before acting.

Install

The repository includes the macOS disk image at:

installers/Clearspace-1.0.dmg

Open the DMG, drag Clearspace.app into Applications, then launch Clearspace from Applications.

The app bundle inside the included DMG is ad-hoc signed and not notarized. macOS may show an additional security prompt for builds distributed directly from GitHub. Building from source locally will produce an equivalent app bundle.

Build From Source

Requirements:

  • macOS 15 or later
  • Xcode command line tools
  • Swift 6.2 toolchain

Build the app:

xcrun swift build -c release

Build a local app bundle:

./scripts/build-app.sh dist

Build installable artifacts:

./scripts/build-installer.sh installers

By default, app bundles are ad-hoc signed. To sign with a local Apple signing identity, pass it explicitly:

SIGN_IDENTITY="$(security find-identity -v -p codesigning | sed -n 's/.*\"\(Developer ID Application:[^\"]*\)\".*/\1/p' | head -1)" ./scripts/build-installer.sh installers

Test

Run the full test suite:

xcrun swift test

Tests use temporary directories and injected services. They do not delete or trash real user files.

Safety Notes

Clearspace is a cleanup tool. Review the ticked items before pressing Clear Space.

Protected by default:

  • macOS system roots and virtual filesystems
  • Application bundles and packages
  • Symlinks
  • Clearspace state
  • InShot and InstaShot data
  • Photos libraries
  • User whitelist entries
  • Files changed after the most recent scan

License

Clearspace is released under the MIT License. See LICENSE.

About

No description, website, or topics provided.

Resources

License

Contributing

Security policy

Stars

Watchers

Forks

Packages

 
 
 

Contributors