Skip to content

About

See what is filling your disk: a fast treemap disk-space analyzer for Windows and Linux (Debian/Ubuntu). Reads the NTFS MFT, updates live, written in Rust.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

SpaceScope

CI Latest release Downloads Licence Platforms Built with Rust

See what is filling your disk. SpaceScope is a fast, free disk-space analyzer for Windows 10+ and Debian/Ubuntu. It scans a drive or folder and draws every file and folder as a rectangle sized by the space it uses (a treemap), so the biggest things are the biggest shapes.

Download · Website · All releases · Changelog

SpaceScope showing a folder as a treemap

What it does

  • Live scan. The map fills in while the scan runs; you can navigate before it finishes.
  • Live updates. After the scan the folder is watched, and the map follows files as they are created, grown or deleted.
  • NTFS fast path. Run as administrator on Windows and whole drives are read from the master file table in a couple of seconds.
  • Zoom. Double-click a folder to zoom in, with an animated transition. Back, forward and up work like a browser.
  • Filter. *.mp4; >100mb; <30days narrows the map to matching files as you type.
  • On disk or logical size. Compressed, sparse and cloud-placeholder files are shown at the space they really occupy, or at their nominal size.
  • Free space. Optionally shows the volume's free space as a tile when you scan a whole drive.
  • File actions. Open, show in the file manager, copy path, move to the Recycle Bin / Trash, rescan a folder in place.
  • Export. Any folder can be exported as CSV, from the app or from the sscan command-line tool.
  • Dark and light themes, following the system by default.

Install

Downloads are on the releases page; there is also a project page.

Windows: unzip SpaceScope-windows-x64.zip (or SpaceScope-windows-x86.zip on 32-bit Windows) and run spacescope.exe. The window opens maximised; F11 switches to full screen. Nothing to install, no administrator rights needed. For the fast drive scan choose More → Restart as administrator.

Debian / Ubuntu (22.04+ / Debian 12+):

sudo apt install ./spacescope-amd64.deb
spacescope            # or launch it from the application menu

Build from source

Needs Rust 1.87 or newer. On Linux a C linker is the only other requirement (sudo apt install build-essential).

cargo build --release
./target/release/spacescope            # GUI
./target/release/sscan /some/path      # command line

Packages: scripts/package-windows.ps1 writes a zip to dist/; scripts/package-deb.sh writes a .deb. Build the .deb on the oldest release you want to support (CI uses Ubuntu 22.04), because the binary links against that system's glibc.

Using it

Action Mouse Keyboard
Zoom into a folder double-click, or scroll up over it
Zoom out scroll down Alt+Up
Back / forward mouse back / forward buttons Alt+Left / Alt+Right, Backspace
Select click
File actions right-click
More / less detail + / − buttons + / -
Filter Ctrl+F, Esc clears
Rescan the current folder refresh button F5
Full screen F11

You can also start a scan directly: spacescope C:\Users\me, or drop a folder onto the window.

Filter syntax

Terms are separated by ;. Name terms are OR-ed, everything else is AND-ed.

Term Meaning
*.jpg, IMG_????.* name pattern (* and ?), case-insensitive
steam name contains the text; a matching folder brings its whole content
>100mb, <2gb size limits (b, kb, mb, gb, tb)
>2years older than (sec, min, hours, days, weeks, months, years)
<30days newer than
|*.tmp or !*.tmp exclude

Command line

sscan [PATH] [--top N] [--threads N] [--logical] [--filter EXPR] [--csv FILE] [--bench] [--no-mft]

How it is fast

  • The NTFS master file table, when allowed (Windows, administrator). Every file on the volume has a 1 KiB record with its name, parent and sizes. Reading that table sequentially replaces hundreds of thousands of folder opens. It is used for drives and their top-level folders; anything unexpected falls back to the folder walk.
  • One system call per directory, not per file (Windows). GetFileInformationByHandleEx(FileFullDirectoryInfo) returns names, both sizes, attributes and timestamps for hundreds of entries at once.
  • Raw getdents64 + fstatat relative to the open directory (Linux). No path is ever re-resolved.
  • Work-stealing thread pool. Each worker reads a directory, appends it to the tree under one short lock, and queues the sub-directories.
  • Compact tree. 48 bytes per node plus the name, in two flat arrays. A directory's children are contiguous, so whole-tree passes (filters, totals) are single linear loops.
  • The UI thread never computes. Layout and filtering run on a worker; the window only draws the newest finished layout, as one batched mesh.
  • Only what is visible is laid out. Folders too small to read stay collapsed and tiny siblings merge into one tile, so a drive with a million files still produces a few thousand rectangles.

Measured on the development machine (16 logical cores, NVMe SSD, Windows 11 with Defender on):

Scan Entries Time (warm cache)
Whole C: drive, administrator (file table) 1,311,000 2.4 s
Whole C: drive, standard user (folder walk) 1,350,000 8 – 10 s (49 s on the first, cold run)
Home folder, Windows, standard user 585,000 1.4 – 1.9 s
Home folder, Ubuntu on WSL2 491,000 2.3 s
/usr, Ubuntu on WSL2 89,000 0.3 s

Totals were checked against PowerShell (Get-ChildItem -Recurse) on Windows and du -x on Linux and match to the byte. With the whole drive loaded the app uses about 260 MB; a treemap layout takes 2 – 10 ms.

Things to know

  • Unreadable folders (shown in the status bar) are skipped. Run as administrator / with sudo to include them.
  • Links are not followed. Symlinks and junctions are listed but never descended, so nothing is counted twice.
  • Hard links are counted once on Linux and in the administrator scan on Windows. The standard-user scan on Windows counts every link, as Explorer does, so C:\Windows\WinSxS looks larger than it is.
  • The administrator scan sees more. It includes system files Explorer hides ($MFT, System Volume Information), alternate data streams and folder indexes, so its on-disk totals run slightly higher. File sizes match the folder walk exactly.
  • Other filesystems mounted below the scanned folder are skipped on Linux (like du -x); scan them from the start screen.
  • Live updates re-read each folder that reports a change about a second after things go quiet. On Linux every folder needs its own inotify watch, so trees beyond the system's watch limit (or 250,000 folders) are not watched; the status bar says so, and F5 rescans. If changes arrive faster than they can be tracked the indicator turns amber until you rescan. Turn the feature off under More.
  • Rendering uses OpenGL by default because it needs far less memory. If OpenGL cannot start, the app restarts itself on wgpu (Direct3D 12 / Vulkan). SPACESCOPE_RENDERER=wgpu or =gl forces one.

Layout of the code

crates/core   scanner, tree, filter language, treemap layout, CSV export, sscan CLI
crates/app    the window: rendering, theme, navigation, platform integration

cargo test covers the tree, filters, layout geometry and a real scan of a temporary directory. The GUI has a built-in driver for end-to-end checks without touching the real mouse:

spacescope some/folder --size 1200x760 \
  --script "dbl:0.6,0.2;shot:zoomed.png;key:Backspace;rclick:0.2,0.5;shot:menu.png"

How it compares

The live treemap as a way to explore a disk was made popular on Windows by SpaceSniffer from Uderzo Software, a freeware, closed-source, Windows-only tool, and that idea is the starting point here. SpaceScope shares no code with it and takes a different route technically:

SpaceScope Conventional folder-walking analyzers
How a drive is read As administrator, one sequential read of the NTFS master file table: 2.4 s for 1.3 million files. Otherwise one system call per folder. One or more system calls per folder, often one per file. Time grows with the number of folders and with disk seeks.
Cold cache The file table is one contiguous read, so a first scan after reboot costs the same as any other. Every folder is a separate disk access; the first scan can take many times longer.
Permissions The file-table scan sees every file, so nothing is reported as unreadable. Protected folders are skipped unless every one can be opened.
Hard links Counted once (Linux, and the file-table scan on Windows). Usually counted once per link, inflating folders like WinSxS.
Real size on disk Compressed, sparse and cloud-placeholder files are shown at the space they actually occupy; alternate data streams and folder indexes are included in the file-table scan. Often the nominal file size only.
Staying current Changed folders are re-read individually and merged in place; folders keep their position and identity. A rescan of the subtree, or of everything.
Rendering One GPU draw call for the whole map; layout and filtering on background threads. Commonly drawn rectangle by rectangle on the UI thread.
Memory 48 bytes per file plus its name: about 260 MB for a 1.3-million-file drive. Varies; often an object per file.
Platforms Windows 10+, Debian, Ubuntu (X11 and Wayland). Typically Windows only.
Source Open, Apache 2.0. Varies.

The right-hand column describes the general approach, not a measurement of any one product; SpaceScope has not been benchmarked head-to-head against other tools. What other tools have that SpaceScope does not (yet): colour tags on files and customisable export templates.

Code signing policy

SpaceScope uses the SignPath Foundation for code signing of its Windows programs. Free code signing is provided by SignPath.io, with a certificate by the SignPath Foundation.

  • What gets signed: only files built by the public GitHub Actions workflow from a tagged commit of this repository. Nothing built on a personal computer is signed. Versions up to 1.2.0 predate signing and are unsigned.
  • Committers, reviewers and approvers: the repository owner, SkippyNet. Every change reaches main through a pull request that must pass the build on all platforms.
  • Privacy: this program will not transfer any information to other networked systems unless specifically requested by the user or the person installing or operating it. See the privacy policy.

Licence

Copyright 2026 SkippyNet. Licensed under the Apache License, Version 2.0: you may use, modify and redistribute SpaceScope, including commercially, provided you keep the licence and NOTICE with it and state significant changes. The licence includes an express patent grant from contributors and comes with no warranty. Contributions are accepted under the same terms.

About

See what is filling your disk: a fast treemap disk-space analyzer for Windows and Linux (Debian/Ubuntu). Reads the NTFS MFT, updates live, written in Rust.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages