# GrandPerspective

A macOS disk-usage visualizer that maps files and folders as proportional rectangles, helping you inspect storage before deciding what to remove.

> This is the Markdown version of the GrandPerspective page on OpenNavo, with the same facts as the web page: <https://opennavo.com/apps/grandperspective>

- **Latest version**: `3.8.1`
- **Developer**: Erwin Bonsma
- **Homepage**: <https://grandperspectiv.sourceforge.net/>
- **Categories**: [Files and Storage](https://opennavo.com/categories/files-storage)
- **Install**: `brew install --cask grandperspective`
- **30-day installs**: 1,291
- **Homebrew**: Available; updated by Homebrew
- **Download URL**: <https://downloads.sourceforge.net/grandperspectiv/grandperspective/3.8.1/GrandPerspective-3_8_1.dmg>
- **SHA-256**: `df20837acaed53eaad186d8acb77b654f080aab4dd5d403dbe8696f4cb2d60cd`

SHA-256 only checks that the download is complete; it is not a security certification.

## Installation and removal contents

```json
[
  {
    "declaration": {
      "uninstall": [
        {
          "quit": "net.sourceforge.grandperspectiv"
        }
      ]
    },
    "phase": "uninstall",
    "sources": [],
    "type": "uninstall"
  },
  {
    "declaration": {
      "app": [
        "GrandPerspective.app"
      ],
      "target": "/Applications/GrandPerspective.app"
    },
    "phase": "install",
    "sources": [
      "GrandPerspective.app"
    ],
    "target": "/Applications/GrandPerspective.app",
    "type": "app"
  },
  {
    "declaration": {
      "zap": [
        {
          "trash": [
            "~/Library/Application Scripts/net.courceforge.grandperspectiv",
            "~/Library/Application Support/com.apple.sharedfilelist/com.apple.LSSharedFileList.ApplicationRecentDocuments/net.sourceforge.grandperspectiv.sfl*",
            "~/Library/Containers/net.sourceforge.grandperspectiv",
            "~/Library/Preferences/net.sourceforge.grandperspectiv.plist"
          ]
        }
      ]
    },
    "phase": "cleanup",
    "sources": [],
    "type": "zap"
  }
]
```

## About

GrandPerspective is a small Mac utility that visualizes disk usage with treemaps. Scan a folder or volume, then explore rectangles whose areas correspond to file sizes. Files within the same folder appear together. This helps Mac users identify large files and folders without replacing Finder or automatically deciding what is safe to delete.

### Explore and compare storage
Hover or select a rectangle to inspect its name and size, navigate through folders, change color palettes and grouping, or use filters to focus on selected file types. Open, Quick Look and Reveal actions help inspect the original items. Scan data can be saved for later viewing; a saved scan is a record of file metadata, not a backup of file contents.

### Installation and access
The current 3.8.1 release supports Apple Silicon and Intel Macs running macOS 14 or newer. Its DMG is 4,144,640 bytes before installation. Copy GrandPerspective.app into Applications and select the folder to scan. The cask declares no additional package dependencies or conflicts. Grant access only to the locations you intend to inspect. Full Disk Access can improve coverage of protected folders, but does not make every system file accessible or removable. Files omitted by permissions or filters are not included in scanned totals.

### Understand the measurements
GrandPerspective supports logical file sizes and physical on-disk sizes, with logical sizes used by default. Binary versus decimal units can also explain differences from Finder. Hard-linked files are counted once within a scan; removing one hard link does not release its storage while other links remain. The interface separately reports scanned files, miscellaneous used space and operating-system-reported free space. A treemap is therefore not a promise of exactly how much free space deleting a rectangle will recover, including on APFS volumes.

For cloud storage, logical and physical sizes can differ substantially: online-only files have metadata but do not occupy the same local storage as downloaded files. The official help says scans request metadata without downloading online-only file contents, although macOS may create the local folder structure.

### Removal requires care
The Delete action is disabled by default and can be enabled in Preferences. It moves selected items to Trash rather than acting as an automatic cleaner. Deleting a folder includes files hidden by filters, unavailable during scanning or created after the scan. Review the contents and keep backups before deleting anything important. A view's tracked deleted size and actual available disk space are different measures; moving files to Trash alone is not an assurance of immediately reclaimed storage.

### Free download and paid App Store edition
GrandPerspective is open-source software under the GNU General Public License, developed by Erwin Bonsma. The official SourceForge download is free, with optional donations. The US Mac App Store edition costs $2.99 and provides the same app, with Apple-managed updates and distribution supporting development. App Store releases can lag SourceForge releases. The direct version does not require a GrandPerspective account; App Store purchase and installation use your Apple account.

## System requirements

- macOS 14 or later · Version: 3.8.1 · Intel · <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/g/grandperspective.rb> · Checked 2026-11-22
  - <https://downloads.sourceforge.net/grandperspectiv/grandperspective/3.8.1/GrandPerspective-3_8_1.dmg>
  - SHA-256: `df20837acaed53eaad186d8acb77b654f080aab4dd5d403dbe8696f4cb2d60cd`
- macOS 14 or later · Version: 3.8.1 · Apple silicon · <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/g/grandperspective.rb> · Checked 2026-11-22
  - <https://downloads.sourceforge.net/grandperspectiv/grandperspective/3.8.1/GrandPerspective-3_8_1.dmg>
  - SHA-256: `df20837acaed53eaad186d8acb77b654f080aab4dd5d403dbe8696f4cb2d60cd`

## Price

- $2.99 (United States) — Mac App Store: <https://apps.apple.com/us/app/grandperspective/id1111570163?mt=12> · <https://apps.apple.com/us/app/grandperspective/id1111570163?mt=12> · Checked 2026-11-21 · This is what the App Store edition costs to download, not to use; in-app purchases and subscriptions are not included.

## Uninstall

- `brew uninstall --cask grandperspective`

A regular uninstall removes the app and keeps its settings and caches.

### Deep clean (optional)

- `brew uninstall --zap --cask grandperspective`

`--zap` also deletes the settings, caches and other files listed in the Homebrew definition. They can include data shared with other apps and cannot be restored, and it does not guarantee that nothing is left. Back up any data you need first. To keep settings and caches, leave out `--zap`.

A regular uninstall removes the app and keeps its settings and caches.

- Files and folders: `~/Library/Application Scripts/net.courceforge.grandperspectiv` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/g/grandperspective.rb> · These entries come from the Homebrew definition, checked 2026-11-22. They say what it declares, not what is on your Mac.
- Files and folders: `~/Library/Application Support/com.apple.sharedfilelist/com.apple.LSSharedFileList.ApplicationRecentDocuments/net.sourceforge.grandperspectiv.sfl*` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/g/grandperspective.rb> · These entries come from the Homebrew definition, checked 2026-11-22. They say what it declares, not what is on your Mac.
- Files and folders: `~/Library/Containers/net.sourceforge.grandperspectiv` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/g/grandperspective.rb> · These entries come from the Homebrew definition, checked 2026-11-22. They say what it declares, not what is on your Mac.
- Files and folders: `~/Library/Preferences/net.sourceforge.grandperspectiv.plist` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/g/grandperspective.rb> · These entries come from the Homebrew definition, checked 2026-11-22. They say what it declares, not what is on your Mac.

## Latest release notes

### 3.8.1 (2026-10-07)

Minor improvements to diagnostic logging.

**Changes**

- Improve diagnostic logging.

## Facts and sources

- <https://opennavo.com/apps/grandperspective>
- <https://opennavo.com/apps/grandperspective/versions>
- <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/g/grandperspective.rb> · Checked 2026-11-22
- <https://formulae.brew.sh/cask/grandperspective>
- <https://apps.apple.com/us/app/grandperspective/id1111570163?mt=12> · Checked 2026-11-21
