Spacescope
A disk space browser for your own machine

See where your disk went

Spacescope scans a drive or a folder and draws it as a sunburst you can click through. Open a folder to look inside, tick what you don't need, and move it to the Trash. It is one small program that runs locally and opens in your browser.

macOS Linux Windows Local only · no account
http://127.0.0.1:8080/#/cleaner/results
Spacescope showing a home folder as a sunburst chart with a list of folders and their sizes beside it The same view in dark mode
Program1fileUI included, nothing else to install
Network0requests outlistens on localhost only
DeletingTrashalways recoverable
Runs on3systemsmacOS, Linux, Windows
LicenseMITfree to use and change
How it works

Scan once, then browse instantly

Spacescope is a small Rust program that is both the scanner and the web server. When you start it, it listens on your own machine and opens the page in your browser. Everything you see is drawn from a scan held in memory, so moving between folders doesn't touch the disk again.

  1. 1

    It walks the disk

    A pool of worker threads reads directories in parallel. Every file's size is added to its folder, including the small ones you'd never list. Hard links are counted once, symlinks are not followed, and virtual or separate filesystems are skipped so nothing is counted twice.

  2. 2

    It builds the tree

    When the walk ends, folder totals are rolled up from the leaves to the root. Each file is also given a category (cache, build output, media and so on) and a flag for whether it is safe to remove.

  3. 3

    You browse and clean

    The page asks for one folder at a time and draws it as rings: the folder in the middle, its contents around it, what's inside those further out. Anything you tick can be moved to the Trash from there.

The pieces

Small parts with one job each

Scanner

src/scanner

Parallel directory walk with a shared work queue. It can be cancelled at any moment and reports progress as it goes.

Analyzer

src/analyzer

Classifies each entry by path and name. Only things that get recreated count as safe: caches, temp files, build output, node_modules, package caches and logs.

Server

src/web

An axum server with a small JSON API and a live progress stream. The whole interface is compiled into the binary.

Interface

src/web/assets

Plain JavaScript modules and hand-drawn SVG charts. No framework and no build step, so there is nothing to install to run it.

Features

What it does

Screenshots on this page are real captures of Spacescope. The folder views use a made-up demo folder so no personal files appear.

Browse

Open any folder and look inside

Wedges are sized by how much space they use, and colours follow position so neighbours stay distinct. Hover a wedge to read it out, click a folder to go in, and click the middle to go back up.

The list beside the chart has the same folders with sizes, and a path bar to climb back out. Where you are is in the address bar, so the Back button works and a link opens the same folder.

Projects
The Projects folder open, with two items ticked and a bar offering to move them to the Trash The same folder in dark mode
Scan

Watch it work, with a percentage

While a scan runs you see files and folders counted, the size found so far, and a live breakdown by category. Progress is a real estimate: a whole-disk scan compares bytes found with the drive's used space, and other scans compare folders read with folders discovered.

It never goes backwards, and it only reaches 100% when the scan has really finished. You can cancel at any time.

Scanning
A scan at 62 percent with live counts and a breakdown by category The scan view in dark mode
Clean up

Move things to the Trash, not into the void

Tick anything, including whole folders, and it goes to the system Trash, so you can restore it until you empty it. Your selection carries over as you move between folders.

The first time in a session you confirm once, with a list of what's about to move. After that it doesn't ask again until you quit the program.

Choose what to scan
The scan chooser: entire disk, home folder or another folder, with a gauge of disk usage The scan chooser in dark mode
Monitor

A live dashboard and system page

CPU, memory, network and disk are charted over the last minute and refresh every second. The system page adds per-core load, memory and swap, every disk, and each temperature sensor as a gauge.

Dashboard
Live CPU, memory, network and disk charts The dashboard in dark mode
System
System details with temperature gauges The system page in dark mode
Platforms

macOS, Linux and Windows

The program has no dependencies at run time, and the interface is a web page, so any system with a modern browser can use it. What changes per system is how disk usage is read, where deleted files go and how the browser is opened.

SystemDisk usageDelete goes toStatus
macOSApple Silicon and IntelstatfsThe Trash, through the system file manager (no permission prompts)Developed and tested here, macOS 26 on Apple Silicon.
Linuxx86-64 and ARMstatfsThe freedesktop Trash, so you can restore from your file managerBuilt and tested in CI on Ubuntu.
Windows10 and 11Read from the disk list by mount pointThe Recycle BinBuilt and tested in CI on Windows.
Other UnixFreeBSD and similarstatfsThe freedesktop Trash where it existsShould build from source with any Rust 1.85+ toolchain. Not tested.

It can also run on a machine you reach over SSH or on a server: start it with --no-open, forward the port, and open it in your own browser. By default it only accepts connections from the same machine.

Install

From source in one command

You need Rust 1.85 or newer. Building takes about a minute and produces a single executable of a few megabytes.

macOS and Linux

git clone https://github.com/ForkYeahMan/Spacescope
cd Spacescope
./install.sh

Installs spacescope into ~/.cargo/bin. Run it from any terminal.

Windows

git clone https://github.com/ForkYeahMan/Spacescope
cd Spacescope
cargo install --path . --locked

Run it in PowerShell or Command Prompt. Cargo puts spacescope.exe on your PATH.

Any system

cargo install --git https://github.com/ForkYeahMan/Spacescope --locked

Builds straight from GitHub without cloning. Tagged releases also publish ready-made archives for the three systems.

Run it

CommandWhat it does
spacescopeStarts on port 8080 and opens your browser. Press Ctrl-C to stop.
spacescope --homePre-selects your home folder in the Cleaner.
spacescope --port 9000Uses another port. If it's taken, the next free one is used.
spacescope --no-openDoesn't open a browser, for remote machines.
spacescope --depth 3 --min-size 10Looks three folders deep and lists files of 10 MB or more.
Safety and questions

What it will and won't do

Can it permanently delete anything?

No. Everything goes to the system Trash. Spacescope has no way to empty it or to delete a file outright.

What does "safe to remove" mean?

Only things that a system or tool will recreate: caches, temporary files, build output, node_modules, package caches and logs. Downloads, archives, old files and duplicates are your data and are never pre-selected.

Can it delete system files?

They appear in the chart because they take up space, but they can't be ticked, and the server refuses them even if asked directly. Only paths from the current scan can be deleted, and only inside the folder you scanned.

Does anything leave my computer?

No. There is no telemetry and no account. The server only answers requests addressed to localhost, which also blocks a web page from reaching it by DNS rebinding.

My drive is sold as 256 GB. Why does it show 245 GB?

macOS reports about 245 GB for that drive because the system reserves part of it. Spacescope uses decimal units (1 GB is a billion bytes), the same as Finder and System Settings, so the numbers match what your system says.

Why can't it see all my used space?

Some used space can't be read by a normal program: other volumes, snapshots and purgeable data. On a whole-disk scan, Spacescope shows the difference as "Unscanned space" so the totals add up.

Find the biggest thing first

Free, open source and local. Clone it, run it, and see what's taking the space.