# Neodisk

**Repository Path**: liyu2015/Neodisk

## Basic Information

- **Project Name**: Neodisk
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-24
- **Last Updated**: 2026-07-24

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<h1 align="center">
  <img src="Packaging/icon.png" width="128" alt="Neodisk icon"><br>
  <p>Neodisk</p>
</h1>

<p align="center">
  Read-only MacOS disk space visualizer.
  Treemap and sunburst views on the <code>NeodiskKit</code> scan engine.
  <br>
  <a href="https://github.com/tkslucas/Neodisk/releases/latest/download/Neodisk.dmg">Download</a>
</p>

<p align="center">
  <img src="https://img.shields.io/badge/platform-macOS%2014%2B-blue" alt="Platform: macOS 14+">
  <img src="https://img.shields.io/github/v/release/tkslucas/Neodisk?label=version" alt="Latest version">
  <img src="https://img.shields.io/badge/license-GPLv3-lightgrey" alt="License: GPLv3">
</p>

<p align="center">
  <img src="screenshots/diff.webp" width="32%" alt="Changes view: files that grew, shrank, appeared, or were deleted since the last scan">
  <img src="screenshots/duplicates.webp" width="32%" alt="Duplicates view: files with identical content grouped by reclaimable space">
  <img src="screenshots/sunburst.webp" width="32%" alt="Sunburst view of a folder, sized by disk usage from the center out">
</p>

## Download

[**Download Neodisk.dmg**](https://github.com/tkslucas/Neodisk/releases/latest/download/Neodisk.dmg)
and drag **Neodisk** onto the Applications folder.

Versioned builds and a `.zip` fallback are on the
[Releases](https://github.com/tkslucas/Neodisk/releases) page.

Requires macOS 14 (Sonoma) or later.

## About

**Read-only by design.** Neodisk never modifies or deletes your files. 
Instead, Reveal in Finder, Open, and Copy Path are the only file actions.
Delete and clean up safely in Finder instead.

## Features

- Treemap: pinch to zoom, scroll to pan
- Sunburst: pinch to drill in and out
- Outline selected files
- Find largest files
- File type statistics
- Age heatmap, color the treemap by last-modified date
- Duplicate finder with content-hash verified duplicates
- Fast scanning with live progress
- Search: `⌘F` fuzzy search over the entire scan
- Quick Look on spacebar
- Arrow keys move the selection in both the treemap and the sunburst
- Drill into a folder with `⌘↓`, drill back out with `⌘↑`, or click folders in the breadcrumb bar
- Snapshots, completed scans persist and reopen instantly
- Changes tab lists what got added, deleted, renamed, grew or shrank since the previous scan
- Show Package Contents: apps and bundles stay solid like in Finder until you expand them
- Free and hidden space for volume scans
- Sidebar volumes show a kind-colored usage bar
- Auto-updates via Sparkle
- Multilingual: UI follows macOS system language: English, Spanish, French, German, Italian, Brazilian Portuguese, Japanese, and Simplified Chinese

## Build & Run

Requires macOS 14+ and a Swift 6 toolchain. No Xcode needed, the Xcode
Command Line Tools are enough.

```bash
swift run -c release Neodisk    # build and launch directly
swift test                      # full test suite (engine + treemap + UI)
```

## Structure

One package, strictly layered targets:

```
Sources/
├── NeodiskKit/   # UI-free scanning core (derived from Radix)
├── NeodiskCLI/   # `diskscan`, the core's reference CLI
├── TreemapKit/   # Pure treemap geometry, viewport, rasterizer
├── NeodiskUI/    # SwiftUI/AppKit views, view model, scan lifecycle
└── Neodisk/      # Thin executable entry point
Localization/     # .lproj string catalogs, one per language
```

## Planned

- Add to Homebrew
- Multiplatform: native Windows and Linux versions (a lot of work, will
  take a while)

## Credits

- [Disk Inventory X](http://www.derlien.com/) by Tjark Derlien and
  [GrandPerspective](https://grandperspectiv.sourceforge.net/) by Erwin
  Bonsma, the cushion-treemap disk viewers this UI follows. No code from
  either is used.
- [Radix](https://github.com/colinvkim/Radix) by Colin Kim (MIT), the scan
  engine and core data model NeodiskKit is derived from, and the sunburst
  visualization is ported from. Huge inspiration.
- [DaisyDisk](https://daisydiskapp.com/) by Software Ambience and
  [SquirrelDisk](https://github.com/adileo/squirreldisk) by Adileo, the
  sunburst disk viewers that view follows. No code from either is used.
- Cushion treemaps: van Wijk & van de Wetering, INFOVIS 1999. Squarified
  treemaps: Bruls, Huizing & van Wijk, 2000.

## License

GPL-3.0-or-later. See [LICENSE](LICENSE), Radix attribution is preserved there.