VoidKit - macOS Storage Cleanup Tool

Free up space on your Mac by identifying and managing System Data.

Overview

VoidKit is a macOS application designed to help you understand what's taking up space in the "System Data" category on your Mac. The app provides a tree view of all known System Data locations and displays the size of each folder and file, making it easy to identify large files and directories that may be candidates for cleanup.

Features

• 🔍 Comprehensive Scanning: Automatically scans known System Data locations including:

  • User Library Caches
  • Application Support files
  • Logs and temporary files
  • Developer caches (Xcode DerivedData, Simulators)
  • Safari and browser data
  • Mail and Messages storage
  • System-level caches and logs

• 📦 Orphaned Containers Detection: Identifies application containers that remain after apps are uninstalled

  • Scans ~/Library/Containers for app data
  • Detects which applications are no longer installed
  • Smart helper app detection: recognizes app extensions and helpers (e.g., com.app.helper)
  • Displays orphaned containers with clear visual indicators
  • Shows size information for each container

• 📊 Tree View Display: Hierarchical view of folders and files with expandable/collapsible navigation

• 📏 Size Calculation: Real-time calculation and display of folder and file sizes in human-readable format

• 🎯 Tab Navigation: Switch between System Data and App Containers views

• ⚡ Performance: Asynchronous scanning and size calculation to keep the UI responsive

Requirements

• macOS 13.0 or later
• Xcode 15.0 or later (for building)

Building the Project

1. Clone the repository:

   git clone https://github.com/xabre/void-kit.git
   cd void-kit

2. Open the Xcode project:

   open VoidKit/VoidKit.xcodeproj

3. Build and run the project in Xcode (⌘R)

Usage

1. Launch VoidKit
2. The app has two main tabs:
   • System Data: Explore system data locations
   • App Containers: Find orphaned application containers
3. Click the "Scan" button in either tab to start scanning
4. Browse through results:
   • In System Data: Click chevron icons to expand folders
   • In App Containers: View which apps are installed (green) or orphaned (orange)
5. Use the filter options to show only orphaned containers
6. Size information is displayed for each item

Project Structure

VoidKit/
├── VoidKit.xcodeproj/       # Xcode project file
└── VoidKit/                 # Source files
    ├── VoidKitApp.swift         # App entry point
    ├── ContentView.swift        # Main UI with tab navigation and System Data view
    ├── OrphanedContainersView.swift  # Orphaned Containers tab
    ├── FileSystemScanner.swift  # File system scanning logic
    ├── AppContainerScanner.swift  # Container scanning and orphan detection
    ├── SystemDataPaths.swift    # Known system data locations
    ├── PermissionsManager.swift # Full Disk Access management
    ├── Assets.xcassets/         # App icons and assets
    └── VoidKit.entitlements     # App permissions

Technical Details

The app is built using:

• SwiftUI for the user interface
• Foundation for file system operations
• Combine for reactive updates

The app uses sandboxing and requests read-only file access permissions as needed.

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

This project is open source and available under the MIT License.

Disclaimer

This tool is designed to help identify large files and folders. Always be careful when deleting system files and make sure you understand what you're removing before taking any action.