Spacie

Native macOS disk space analyzer built for Apple Silicon. Visualize disk usage, find large files and duplicates, clean up caches — all in a fast, beautiful interface.

Features

Visualization

• Sunburst (radial treemap) and rectangular treemap with seamless switching
• Live visualization during scan — diagram builds in real time
• Drill-down navigation with animated transitions and breadcrumb bar
• Color-coded by file type (video, audio, images, code, archives, etc.)

Scan Engine

• High-performance POSIX scanner (fts_open/fts_read) — targets 1M files in under 10 seconds
• Arena-based file tree with string interning — under 500MB RAM for 5M files
• Persistent binary cache with FSEvents incremental invalidation
• APFS-aware: logical/physical size toggle, clone detection, hard link dedup

Cleanup Tools

• Large Files — Top-N or threshold mode with sortable table
• Duplicate Finder — progressive detection (size → partial hash → full SHA-256)
• Smart Categories — 13 built-in plugins: Xcode DerivedData, brew, npm, Docker, Gradle, iOS backups, system logs, and more
• Old Files — filter by last access date (6 months, 1 year, 2 years)
• Storage Overview — system breakdown with purgeable space and recommendations

Safety

• Drop Zone with two-step deletion (stage → confirm → Trash)
• SIP-protected paths blocked, dotfiles show warnings
• User-extensible blocklist (~/.spacie/blocklist.txt)
• Graceful degradation without Full Disk Access

Integration

• Reveal in Finder, Open in Terminal, Copy Path
• Quick Look preview (Space key)
• All volumes: internal, external, network
• Native macOS tabs, keyboard shortcuts, Settings window
• EN + RU localization ready

Requirements

• macOS 15.0 (Sequoia) or later
• Apple Silicon (arm64)

Build

# Clone
git clone https://github.com/AlexGladkov/Spacie.git
cd Spacie

# Option 1: Xcode
open Spacie.xcodeproj
# Build & Run (Cmd+R)

# Option 2: xcodegen (if you modify project.yml)
brew install xcodegen
xcodegen generate
open Spacie.xcodeproj

Project Structure

Spacie/
├── App/                        # Entry point, main window, settings
├── Core/
│   ├── Scanner/                # POSIX fts disk scanner
│   ├── FileTree/               # Arena-based tree + string pool
│   ├── Cache/                  # Binary cache + FSEvents monitor
│   ├── Duplicates/             # Progressive hash engine
│   └── SystemInfo/             # Volume, permission, trash managers
├── Features/
│   ├── Visualization/          # Sunburst + treemap (Canvas)
│   ├── DropZone/               # Deletion staging area
│   ├── FileList/               # Large files + old files
│   ├── Duplicates/             # Duplicate finder UI
│   ├── SmartCategories/        # Cleanup categories UI
│   ├── StorageOverview/        # System storage breakdown
│   └── Scan/                   # Volume picker
├── Plugins/
│   ├── Protocol/               # CleanupCategory protocol
│   └── BuiltIn/               # 13 built-in cleanup plugins
└── Shared/                     # Models, extensions, theme

Smart Categories (Built-in Plugins)

Category	Typical Size	Path
Xcode DerivedData	10–100 GB	~/Library/Developer/Xcode/DerivedData/
Xcode Archives	5–50 GB	~/Library/Developer/Xcode/Archives/
Xcode Device Support	5–30 GB	~/Library/Developer/Xcode/iOS DeviceSupport/
Homebrew Cache	1–20 GB	~/Library/Caches/Homebrew/
npm Cache	1–10 GB	~/.npm/_cacache/
node_modules	5–50 GB	**/node_modules/
Docker Images	10–100 GB	~/Library/Containers/com.docker.docker/
Gradle Cache	5–30 GB	~/.gradle/caches/
System Logs	0.5–5 GB	/var/log/, ~/Library/Logs/
Crash Reports	0.1–2 GB	~/Library/Logs/DiagnosticReports/
iOS Backups	10–200 GB	~/Library/Application Support/MobileSync/Backup/
Old Downloads	varies	~/Downloads/ (> 30 days)
Trash	varies	~/.Trash/

Adding custom plugins: implement the CleanupCategory Swift protocol and register in PluginRegistry.

Keyboard Shortcuts

Shortcut	Action
Cmd+R	Rescan
Cmd+1 / Cmd+2	Sunburst / Treemap
Cmd+[ / Cmd+]	Back / Forward
Cmd+Up	Parent directory
Cmd+Delete	Add to Drop Zone
Cmd+Shift+Delete	Empty Drop Zone
Space	Quick Look
Cmd+I	Get Info
Cmd+Shift+G	Go to Folder
Cmd+F	Search
Cmd+T	New Tab

License

Non-Commercial License. Free for personal, educational, and research use. Commercial use is prohibited without a separate license agreement. See LICENSE for details.