Skip to main content

storageanalyser

Storage Analyzer & Cleanup Recommender for macOS and Windows.

Scans your home directory (and optionally other paths) to find large files, stale files, junk directories, build artifacts, duplicates, and old downloads. Outputs a prioritised list of cleanup recommendations with estimated space savings.

Platform-aware: automatically detects OS-specific cache locations, system directories, and generates the appropriate cleanup script (bash on macOS, PowerShell on Windows).

Installation

pip install storageanalyser

Usage

storageanalyser                           # Scan home directory
storageanalyser --top 30                  # Show top 30 recommendations
storageanalyser --duplicates              # Include duplicate detection
storageanalyser --json                    # JSON output
storageanalyser --threshold 50            # Flag files over 50 MB
storageanalyser --ignoredir node_modules  # Skip directories
storageanalyser --includedir CloudStorage # Override a default-skipped directory
storageanalyser --list-skipped            # Show directories skipped by default
storageanalyser --web                     # Launch the web interface
storageanalyser --web --port 9000         # Web interface on a custom port
storageanalyser --desktop                 # Launch as a desktop app

Scan a specific drive or folder:

# macOS
storageanalyser /Volumes/ExternalDrive

# Windows
storageanalyser D:\Data

Sizes are reported as space actually used on disk, matching du, so sparse files such as VM disk images show their real footprint rather than their apparent size.

Platform Support

Feature macOS Windows
CLI scanner Yes Yes
Web interface Yes Yes
OS-specific caches Library/Caches, .Trash, Xcode, etc. AppData/Local/Temp, CrashDumps, etc.
Cloud storage skip iCloud, Google Drive, OneDrive, Dropbox Google Drive, OneDrive, Dropbox
System dir skip .Spotlight-V100, .fseventsd, Photos Library $Recycle.Bin, System Volume Information
Cleanup script Bash (.sh) PowerShell (.ps1)
Duplicate detection Yes Yes
Google Drive integration Yes Yes
Desktop app mode Yes Yes

Desktop App

Run StorageAnalyser as a standalone desktop application with its own window:

pip install storageanalyser[desktop]
storageanalyser --desktop

Uses the system's native WebView (WebKit on macOS, WebView2 on Windows) — no Chromium bundled. The same web interface runs inside a native window that closes cleanly when you're done.

Web Interface

Launch the web UI with storageanalyser --web. Features include:

  • Live scan progress with cancel support
  • Duplicate hashing progress bar
  • Disk usage pie chart and summary cards
  • Category breakdown bar chart
  • Clickable treemap (click to jump to the recommendation)
  • Recommendations organized by category tabs with per-tab sorting
  • Short/full path toggle for readability
  • Duplicate detection with full path listing and wasted space calculation
  • Configurable skipped directories (override defaults to include cloud storage, etc.)
  • Cleanup script download for selected items (bash or PowerShell)
  • Google Drive integration and cross-environment deduplication

Screenshots

Scan form with configurable skipped directories:

Scan Form

Results summary with disk usage pie chart and summary cards:

Results Summary

Category breakdown and clickable treemap:

Category & Treemap

Recommendations organized by category tabs:

Recommendations

Duplicate detection with copy count and wasted space:

Duplicates

Skipped Directories

By default, certain directories are skipped during scans. The list is platform-specific (cloud storage, OS system directories, managed libraries, etc.). Use --list-skipped to see the defaults for your OS and --includedir to override:

storageanalyser --list-skipped
storageanalyser --includedir Music --includedir Movies

Documentation

Full documentation is available at storageanalyser.readthedocs.io.

Metadata

Release files for storageanalyser 0.1.6

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for storageanalyser 0.1.6
File Size Uploaded Provenance Actions
storageanalyser-0.1.6.tar.gz 775.7 kB With provenance Details for storageanalyser-0.1.6.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for storageanalyser 0.1.6
File Interpreter ABI Platform Actions
storageanalyser-0.1.6-py3-none-any.whl Python 3 none any Details for storageanalyser-0.1.6-py3-none-any.whl

Total release size: 833.8 kB

Release files / storageanalyser-0.1.6.tar.gz

Download URL storageanalyser-0.1.6.tar.gz
Size 775.7 kB
Tags Source
SHA-256 checksum
How to use checksums
33921e343a09153122cec83eeec2d246633a0ba9dfe797bdb928aae9e6426397
BLAKE2b-256 checksum
How to use checksums
1fa241c7d139f4f982839d2199cc07ce6885a280fd4310299bce775b54852729
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 8, 2026.

Transparency log

Release files / storageanalyser-0.1.6-py3-none-any.whl

Download URL storageanalyser-0.1.6-py3-none-any.whl
Size 58.1 kB
Tags Python 3
SHA-256 checksum
How to use checksums
bfbb56c71e93c31467ee3fa2cfd850e6ca0528b35a86dcc924ca2c8c09972190
BLAKE2b-256 checksum
How to use checksums
bb37c1de87fc18b2608a37d4e1b3c94f1acbabb671a3c51926177ad17c73bbc5
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 8, 2026.

Transparency log

Security for storageanalyser 0.1.6

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for storageanalyser-0.1.6.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 8, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page