A powerful disk space analyzer and cleanup tool for macOS
Visualize your entire disk usage with an interactive treemap
- Squarified treemap rendered with Core Graphics for smooth performance
- Breadcrumb navigation to drill into any folder
- Sidebar file browser with real-time size display
- Large Files view to quickly find the biggest space hogs
- File inspector panel with detailed metadata
- Cleanup queue to batch files for review before deletion
- Color-coded file categories (apps, images, videos, documents, archives, developer files, etc.)
Find and remove apps with all their related files
- Scans
/Applicationsand discovers every installed app - Finds related data across Library folders — caches, app support, preferences, containers, and more
- App cards with icons and size breakdown
- Detail inspector showing exactly where app data lives
- Full cleanup: remove the app and all associated files in one action
Detect and remove duplicate files to reclaim wasted space
- Two-phase scan: fast size-based filtering, then SHA-256 hash verification
- Groups duplicates with clear visual hierarchy
- Auto-select keeps the newest copy and marks the rest for removal
- Safety warning when all copies of a file are selected
- Move to Trash or permanently delete
- Configurable scan scope: Home, Downloads, Desktop, Documents, or custom folders
One-click safe cleanup of caches, downloads, and duplicates
- Orchestrates multiple scanners (Downloads, App Caches, Duplicates) in one pass
- Rule engine classifies every item as Safe, Review, or Risky
- Category cards with expand/collapse to inspect what will be cleaned
- Circular gauge dashboard showing total reclaimable space
- Clean history log with timestamps and size freed
- Select all safe items with one click
Find old files you haven't opened in months or years
- Scans for files untouched beyond a configurable age threshold (1 week to 5 years)
- Age breakdown bar — visual stacked bar showing file distribution by age bucket
- Inline search, category filtering, and sort by size/age/name
- Smart recommendations flag safe-to-remove files (old installers, archives, large videos)
- Scope options: Home, Downloads, Desktop, Documents, Pictures, Movies
- Context menu: Reveal in Finder, Copy Path
| Tab | Options |
|---|---|
| General | Splash screen toggle, delete confirmation |
| Scanning | Hidden files, thread count, minimum file size, skip packages/symlinks, exclude directories (node_modules, DerivedData, .git), cross-volume scanning, default scan path |
| Display | Treemap detail level (50-500 items), show empty items |
| Duplicates | Delete confirmation, warn when all copies selected |
| Forgotten Files | Minimum age threshold |
| Framework | SwiftUI + AppKit hybrid |
| Architecture | MVVM with @Observable and @MainActor |
| Rendering | Core Graphics treemap via NSView |
| Hashing | CryptoKit SHA-256 for duplicate detection |
| Target | macOS 14.0+ (Sonoma) |
| Build | Xcode 15+, XcodeGen |
Download the latest release from the Releases page.
# After downloading and unzipping, remove the quarantine flag:
xattr -cr /Applications/SpaceMan.app# Install XcodeGen if needed
brew install xcodegen
# Generate the Xcode project
xcodegen generate
# Build
xcodebuild -scheme SpaceMan -configuration Release buildOr open SpaceMan.xcodeproj in Xcode and hit Run.
SpaceMan/
├── Models/ FileNode, FileCategory, AppInfo, AppSettings,
│ SmartCleanModels, DuplicateModels, ForgottenFileItem
├── Views/ ContentView, TreemapView, SidebarView, BreadcrumbView,
│ StorageBarView, StatusBarView, FileDetailView,
│ AppManagerView, AppCardView, AppDetailView,
│ DuplicatesView, SmartCleanView, DashboardView,
│ ForgottenFilesView, LargeFilesView, SettingsView
├── ViewModels/ ScanViewModel, AppManagerViewModel,
│ DuplicatesViewModel, SmartCleanViewModel,
│ ForgottenFilesViewModel
├── Services/ DiskScanner, FileDeleter, StorageInfoService,
│ AppScanner, DuplicateFinder, SmartCleanService,
│ SmartCleanRuleEngine, SmartCleanExecutor,
│ DownloadsScanner, ForgottenFilesScanner,
│ ForgottenFilesRuleEngine
├── Utilities/ SizeFormatter
└── SpaceManApp.swift