Skip to content

ArtLjn/DiskPulse

Repository files navigation

DiskPulse Banner

Smart Disk Space Analyzer for macOS

简体中文 | English

macOS 14+ Swift 6.0 MIT License SwiftUI

Features

  • Disk Overview — Real-time disk capacity visualization with donut chart, directory drilldown, and multi-volume support
  • Dirty Data Detection — Rule-based engine with 30+ built-in rules covering dev caches, build artifacts, package manager caches, system logs, and app leftovers
  • Duplicate File Finder — Progressive 3-stage detection: size grouping → first-block hash pre-filter → full-file SHA256 confirmation
  • Safety-First Cleanup — Every item tagged with a safety level (Safe / Cautious / Dangerous) with clear explanations, trash-by-default deletion
  • Native Performance — Pure SwiftUI with zero third-party dependencies, built for Apple Silicon

Screenshots

Disk Overview

Dirty Data Detection

How It Works

Scan Flow
─────────────────────────────────────────────

 Quick Estimate ──▶ Dirty Data Detection ──▶ Duplicate Detection
 (rule paths,     (30+ rules + app         (size → hash → SHA256
  1-3 seconds)     leftover scanning)       progressive confirm)

Each scan result includes:

  • Safety level with color-coded badge
  • Human-readable explanation
  • Recommended cleanup action (trash / delete)

Requirements

  • macOS 14.0 (Sonoma) or later
  • Xcode 16.0+
  • Full Disk Access permission (System Settings → Privacy & Security)

Build

git clone https://github.com/ArtLjn/DiskPulse.git
cd DiskPulse
open DiskPulse.xcodeproj

Build and run via Xcode (Cmd+R). On first launch, grant Full Disk Access when prompted.

Architecture

Sources/
├── DiskPulse/               # UI Layer (SwiftUI)
│   ├── Views/
│   │   ├── Overview/        # Disk capacity & directory drilldown
│   │   ├── DirtyData/       # Dirty data cards & cleanup
│   │   ├── Duplicates/      # Duplicate groups & file selection
│   │   └── Components/      # Shared UI components
│   └── DiskPulseApp.swift
└── DiskPulseCore/           # Logic Layer
    ├── Engines/
    │   ├── ScannerEngine    # File system scanner
    │   ├── DirtyDetector    # Rule-based dirty data detection
    │   ├── DuplicateDetector# Progressive duplicate finder
    │   └── CleanerEngine    # Safe cleanup with trash support
    ├── ViewModels/          # MVVM view models
    ├── Models/              # Data models
    └── Utilities/           # File helpers & constants

Keywords

macOS disk analyzer disk space cleaner duplicate file finder SwiftUI dirty data detection storage management macOS native app disk usage cache cleaner build artifact cleaner

License

MIT License

About

Smart disk space analyzer for macOS — dirty data detection, duplicate finder, safety-first cleanup. Built with SwiftUI.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages