How dreamofxm/diskwise works
DiskWise is a native macOS disk-usage and cleanup app. Users scan the accessible volume, inspect measured space or specialized file categories, then move selected items to Trash and undo within the session; emptying Trash remains Finder’s responsibility. The README documents several feature branches whose view-to-backend wiring is not present in the sampled excerpts, so those relationships are shown only where documented, and uncertain links are omitted.
Main entry points: DiskCleanerApp.swift App shell · Scanner.swift Volume scanner · OverviewView.swift Overview · Views Feature pages
Components 23
App interface
- App shell
Sources/DiskCleaner/DiskCleanerApp.swift - Overview
Sources/DiskCleaner/Views/OverviewView.swift - Feature pages
Sources/DiskCleaner/Views - Trash page
Sources/DiskCleaner/Views/TrashView.swift - Appearance
Sources/DiskCleaner/Views/AppearanceView.swift - Theme manager
Sources/DiskCleaner/Theme/ThemeManager.swift
Space analysis
- Volume scanner
Sources/DiskCleanerCore/Scanner.swift - Scan scope
Sources/DiskCleanerCore/ScanScope.swift - Scan progress
Sources/DiskCleanerCore/ScanProgress.swift - Scan models
Sources/DiskCleanerCore/Models.swift
Cleanup features
- File scan jobs
Sources/DiskCleanerCore/ScanJobs.swift - Cache cleanup
Sources/DiskCleaner/Views/CachesView.swift - Safety knowledge base
Sources/DiskCleaner/Resources/safety_db.json - Docker usage
Sources/DiskCleaner/Views/NMDockerViews.swift - Duplicate files
Sources/DiskCleaner/Views/DupOrphansViews.swift - Large and old files
Sources/DiskCleaner/Views/BigOldViews.swift
Safe removal
- Home access
Sources/DiskCleanerCore/HomeAccess.swift - Access grants
Sources/DiskCleaner/HomeGrant.swift - Trash operations
Sources/DiskCleanerCore/HomeAccess.swift
Other components
- Mac user
- macOS filesystem
- Finder
- Container runtimes
Connections 21
- Mac user → App shell: opens and navigates
- App shell → Overview: shows selected page
- App shell → Feature pages: shows selected page
- App shell → Trash page: shows selected page
- App shell → Appearance: shows selected page
- Overview → Scan scope: selects scan scope
- Overview → Volume scanner: requests volume scan
- Volume scanner → macOS filesystem: reads directory usage
- Volume scanner → Scan models: produces usage results
- Volume scanner → Scan progress: reports scan progress
- Access grants → macOS filesystem: requests protected access
- Feature pages → File scan jobs: requests category scans
- File scan jobs → macOS filesystem: reads files and metadata
- File scan jobs → Container runtimes: queries installed engines
- Cache cleanup → Safety knowledge base: reads cleanup guidance
- Feature pages → Home access: requests safe removal
- Trash page → Home access: undoes or empties
- Home access → macOS filesystem: moves items to Trash
- Trash page → Finder: asks to empty Trash
- Appearance → Theme manager: selects skin
- Theme manager → App shell: provides active theme