ClearSpace 2.0
Full System DescriptionClearSpace 2.0 is a modern, blazing-fast, and privacy-focused disk space analyzer and cleanup application designed specifically for macOS (minimum macOS 14 Sonoma) using SwiftUI and Swift Package Manager (SwiftPM). Built with a premium design system, it prioritizes on-device security, exceptional performance, and local machine learning.
What Was: iOS Application
The original iOS implementation was focused on quick swipe-to-delete flows, album organization, and batch clearance of photos directly on device.
What is Underway: macOS Application
The next-generation version, rebuilt for macOS, featuring a chronological scan timeline, Apple Vision duplicate detection, and offline AI reasoning.
Interactive Disk Analysis
- Sunburst Visualization: Renders disk usage as interactive sunburst and donut charts.
- Real-time Zooming: Click any sector (folders) to zoom step-by-step deeper into the hierarchy.
- Breadcrumbs Navigation: Jump back instantly to previous folder levels without rescanning.
Smart Clean & Safety
- Safety Categorization: Files are split into "completely safe to delete" (e.g. system caches) and "recommended for manual review".
- Pre-Deletion Checks: Automatically verifies if files are locked/open (via
lsof) or contain uncommitted code in a Git repository before removing. - Undo Banner: Restores files from the system Trash immediately if clicked.
Collector Dock
- Drag-and-Drop: Drag unwanted directories and files down into a centralized dock at the bottom of the screen.
- Pre-Deletion Verification: Aggregates items, filters duplicates, shows total size, and holds items safely until clicking "Remove".
Rarely-Used Apps
- Spotlight Scan: Uses macOS Spotlight metadata (
kMDItemLastUsedDate) to find applications untouched for 30, 60, or 90 days. - Safe Uninstall: Drag apps straight to the Collector Dock for clean, secure removal without active process risk.
Photo Library Cleaner
- Timeline Scanning: Scans the photo library chronologically (year-by-year, month-by-month) to conserve memory and save checkpoints.
- Local AI Processing:
- Duplicate Detection: Uses Apple Vision feature prints (
VNGenerateImageFeaturePrintRequest) and perceptual hashing to cluster duplicates. - Blur Analysis: Employs local Laplacian and gradient algorithms to detect out-of-focus photos.
- MLX Photo Reasoner: Downloads a local, lightweight multimodal model (Qwen2-VL 2B via Apple MLX Swift) to run advanced semantic reasoning on blurry or ambiguous photos on Apple Silicon.
- Duplicate Detection: Uses Apple Vision feature prints (
- Review & Favourites: Trackpad gestures for gallery browsing. Hearts sync directly to Apple Photos and lock photos from deletion.
- Year-Locks & Achievements: Lock completed months/years to exclude them from future scans and earn achievement cards.
- System Security: Deletion occurs only after system-level confirmation dialogs.
Platform
Native macOS application written in Swift and SwiftUI.
Data Structures
Driven by a custom, high-performance recursive DirectoryNode tree structure.
Concurrency
Isolates heavy scanning routines on background threads via Swift Concurrency (Task.detached) to keep UI responsive.
Local Privacy
100% On-Device. No photos, file metadata, or processing details ever leave your Mac.
Resource Safety
Recognizes and automatically skips system packages (e.g., .app, .photoslibrary) to prevent infinite loops.