See where your disk space went.
A fast, zoomable treemap of your drives for Windows, in the spirit of SpaceMonger.

_{Illustration with sample data}

---

SpaceSharp scans a drive or folder and draws every file and folder as a box whose area matches its size. Folders are boxes with a title bar, and their contents are laid out inside them, so the files and folders eating your space are obvious at a glance. Zoom into any folder, pan around, and send what you don't need to the Recycle Bin without leaving the map.

It's a single, portable .exe with no installer and no dependencies.

Contents

• Features
• Download
• Using SpaceSharp
• Keyboard and mouse
• Building from source
• Publishing an exe
• How it works
• Project structure
• Customizing
• Settings
• Known limitations
• Ideas for the future
• Feedback
• Credits
• License

Features

Scanning

• Scan a whole drive or any folder, with live counts of files, folders and bytes while it runs
• Parallel scanning of the top folder levels, which is noticeably faster on SSDs
• Includes hidden and system files; skips junctions and symbolic links to avoid loops and double counting
• Folders that can't be read are flagged instead of stopping the scan, and a notice offers to restart as administrator
• Measures file size or size on disk (compressed size rounded to whole clusters), switchable at any time
• Optional hard-link detection so data with several names (like WinSxS) is counted once
• Cancel at any time with Esc

The map

• Squarified treemap layout, which keeps boxes close to square so sizes are easy to compare
• Nested folders with title bars showing name and size
• Chains of folders that only contain one folder (like Users › adria › AppData › Local) are merged into a single box with a combined title, instead of a stack of thin frames
• Folders with hundreds of small files (a photo shoot, a cache) show one "312 files" box instead of a grid of specks; zooming in reveals them individually
• Boxes too small to see are left out, so the map stays clean instead of turning into noise
• Six map styles: Classic (title bars, borders, cushion shading), Tiles, Cards, Bands, Terraces and Soft, switchable from the toolbar; S cycles
• Readability options: three label sizes and outlined labels that stay legible on any color
• A gray "Free space" block when scanning a whole drive, so the map shows the entire disk

Zoom and navigation

• Double-click a folder and the view flies in until it fills the window
• Mouse-wheel zoom around the cursor, up to 1,000,000×, with crisp labels at every level
• Drag with the left or middle mouse button to pan
• Clickable breadcrumb path: click any folder in it to zoom there
• Up one folder, show the whole map, and zoom buttons in the toolbar

Finding things

• Filter box: type *.mp4, >500MB, older than 1 year, type:video or part of a name, and everything that doesn't match dims. The layout stays put, so you see where the matches are. Terms combine.
• Select matches (Ctrl+A) selects every matching file, and Del sends them all to the Recycle Bin in one go
• Side panel (L) with all your drives, their usage bars and free space, plus the 200 largest files, the largest folders, and space by file type. Click a drive to scan it, a row to zoom to it, or a type to filter by it
• Multi-select with Ctrl+click and Shift+click; the status bar shows the combined size
• Hover details: a small card next to the mouse with size, size on disk, file count, type, last modified and share of the current folder

Colors and themes

• Color boxes by nesting depth or by file type (images, video, audio, archives, programs, documents, code)
• Eight palettes: Pastel, Retro, Ocean, Sunset, Forest, Neon, Monochrome and Color-blind safe
• Label text automatically switches between dark and light to stay readable on every color
• Light and dark themes, or follow the Windows setting and switch live when it changes
• Title bars follow the theme on Windows 10 and 11

Cleaning up

• Right-click any box to open it, show it in Explorer, copy its path, or move it to the Recycle Bin
• Deleting is undoable (it goes to the Recycle Bin) and the map updates without a rescan
• Rescan (F5) brings you back to the folder you were looking at

Other

• Status bar shows the full path, size, share of the current folder and file count for whatever is under the mouse
• About window with version, shortcuts and system info
• Per-monitor DPI aware and long-path aware
• Settings window with theme, palette, size measure, free space, shading, scanning and safety options, all remembered

Download

Two options on the Releases page, both for 64-bit Windows 10 and 11 (Windows on ARM works through x64 emulation):

[!NOTE] The exe isn't code-signed, so Windows SmartScreen may show "Windows protected your PC" the first time you run it. Click More info, then Run anyway.

The first launch is a little slower than the ones after it, because the portable exe unpacks itself once.

Using SpaceSharp

1. Click a drive in the Drives list on the left, or click Scan folder to choose a folder. Each drive shows how full it is and how much is free.
2. When the scan finishes, the whole drive or folder fills the window. The biggest boxes are the biggest space users.
3. Hover over a box to see its full path and size in the status bar.
4. Double-click a folder to zoom into it. Use Backspace, the mouse back button, the breadcrumb or the mouse wheel to zoom back out.
5. Right-click a file or folder to open it, find it in Explorer, or move it to the Recycle Bin.

To see protected system folders, run SpaceSharp as administrator. Otherwise those folders are skipped and marked as unreadable.

Settings

The gear button in the toolbar (or Ctrl+,) opens the settings window. Every change applies immediately and is saved.

Reset to defaults puts everything back. When folders couldn't be read, a notice appears under the toolbar with a Restart as administrator button; SpaceSharp restarts elevated and scans the same drive again.

Filtering

Press Ctrl+F or click the filter box above the map. Everything that doesn't match is dimmed; the layout stays put so you can see where the matches are.

The easy way: click the funnel button in the box. A panel opens with quick filters ("Large files", "Big videos", "Untouched for 2 years"…), a name field, file type chips, size and age drop-downs, and a files/folders switch. It writes the filter text for you, so you can also learn the syntax from it.

The fast way: type it. Plain language works: videos over 500MB not touched in 2 years, photos larger than 10 MB, .iso, installer. Everything you type must match. The parts it understands:

The bar then shows how many files match and their total size. Select matches (Ctrl+A) selects all of them, and Del sends them to the Recycle Bin in one go.

Color modes

Palettes

Keyboard and mouse

Building from source

Requirements

• Windows 10 or 11
• .NET 10 SDK
• JetBrains Rider, Visual Studio 2022 or later, or just the command line

With Rider

1. Open SpaceSharp.sln.
2. Press Run (Shift+F10).

From the command line, in the cloned repository:

dotnet run --project .\SpaceSharp\SpaceSharp.csproj

The app's only NuGet dependency is Velopack, used for the installer and updates.

Tests

SpaceSharp.Tests covers the parts that don't need a screen: the treemap layout, the filter parser and matcher, size formatting, and the tree operations behind delete and free space.

dotnet test

Every push and pull request runs the build and the tests on GitHub Actions (.github/workflows/build.yml). Releases are built locally with the release script below, not by CI.

Publishing an exe

Three publish profiles are included in SpaceSharp/Properties/PublishProfiles.

Portable: one exe with .NET built in. Runs on any 64-bit Windows 10/11 PC. About 30–40 MB.

dotnet publish .\SpaceSharp\SpaceSharp.csproj -p:PublishProfile=Portable

Small: a much smaller exe that needs the .NET 10 Desktop Runtime installed. If it's missing, Windows shows a download prompt.

dotnet publish .\SpaceSharp\SpaceSharp.csproj -p:PublishProfile=Small

Installer with auto-update (Velopack). Install the packaging tool once with dotnet tool install -g vpk, then run the release script from the repository root:

.\installer\release.ps1

It runs the tests, publishes the portable exe and the Velopack folder, downloads the previous release for a delta package, runs vpk pack with the MSI options, and finishes with installer\brand-msi.ps1, which writes the branded dialog images into the MSI and fixes the desktop shortcut description. This is the only way releases are built; CI builds and tests but never publishes. Add -SkipDelta for a first release, or -Upload (with $env:GITHUB_TOKEN set) to publish straight to a GitHub release. If Windows refuses to run the scripts, Unblock-File .\installer\*.ps1 once.

The output lands in Releases\: SpaceSharp-win-Setup.exe, the .msi, SpaceSharp-win-Portable.zip, the .nupkg update packages and releases.win.json. Upload all of them to the GitHub release, because installed copies read releases.win.json and the .nupkg files to update. The installer folder holds the wizard's welcome, license and finish pages and the two dialog images (banner.bmp 493×58, logo.bmp 493×312), both generated by tools/make-assets.py.

The same steps by hand, if you prefer:

dotnet publish .\SpaceSharp\SpaceSharp.csproj -p:PublishProfile=Velopack
vpk download github --repoUrl https://github.com/ClearanceClarence/SpaceSharp
vpk pack --packId SpaceSharp --packVersion 1.2.1 --packDir .\publish\velopack --mainExe SpaceSharp.exe --packTitle SpaceSharp --packAuthors ClearanceClarence --icon .\SpaceSharp\Assets\SpaceSharp.ico --splashImage .\SpaceSharp\Assets\SpaceSharp-256.png --msi --instLocation Either --instWelcome .\installer\welcome.md --instLicense .\installer\license.txt --instConclusion .\installer\conclusion.md
.\installer\brand-msi.ps1

The plain exes are written to publish\portable\ and publish\small\. In Rider, all profiles also show up as run configurations.

How it works

Scanning (Services/DiskScanner.cs) The scanner walks the folder tree on background threads with DirectoryInfo.EnumerateFileSystemInfos. The top three levels are scanned in parallel. Sizes are summed bottom-up, and each folder's children are sorted largest first, which the layout depends on. Progress counters are read by the UI a few times per second, so the scan never waits on the UI.

Layout (Layout/Squarify.cs) Boxes are placed with the squarified treemap algorithm by Bruls, Huizing and van Wijk. Items are added to a row along the shorter side of the remaining space for as long as that improves the worst aspect ratio in the row, which produces boxes that are close to square.

Rendering and zoom (Controls/TreemapControl.cs) The map is a custom WPF element that draws into DrawingVisuals instead of creating a control per box, so tens of thousands of boxes stay fast.

Zooming doesn't scale a picture. The map is laid out again on a virtual canvas that is the window size times the zoom level, shifted by the pan offset. Small files get real pixels and sharp labels as you zoom in, and only boxes that intersect the window are laid out and drawn, which keeps deep zoom fast.

Zooming to a folder is an animated camera move. It interpolates the zoom level logarithmically and moves the center so the camera appears to zoom toward a fixed point. Because title bars have a fixed pixel height, a folder's position shifts slightly with zoom, so the target is refined every frame and the view snaps to the exact framing at the end.

Hover and selection outlines live on a separate overlay, so moving the mouse doesn't redraw the map.

Themes (Util/ThemeManager.cs, Themes/) All control styles are in Styles.xaml and reference colors through DynamicResource. Switching themes swaps Dark.xaml for Light.xaml, and every open window recolors immediately. In "Match Windows" mode, SpaceSharp reads the Windows app theme from the registry and listens for changes.

Sizes (Services/NativeFileInfo.cs) Size on disk comes from GetCompressedFileSizeW for compressed, sparse, offline and cloud-placeholder files and from the plain length for everything else, rounded up to the volume's cluster size (GetDiskFreeSpaceW). Hard-link detection opens each file for attribute access only and reads its link count and file ID with GetFileInformationByHandle; a file whose ID was already seen is kept in the tree but contributes no size.

Filtering (Services/FileFilter.cs) The filter text is parsed into a list of conditions. The whole tree is evaluated once per change (a few milliseconds per hundred thousand files); files match on their own, and a folder is kept lit when anything inside it matches, so the path to every hit stays visible. The map then draws non-matching boxes blended toward the background, without changing the layout.

Top lists (Services/TopLists.cs) The largest files and folders are found with a priority queue in one pass over the tree, so the panel is instant even on millions of files. Space by type aggregates files by extension.

Updates (Services/Updater.cs, Program.cs) The Velopack Setup.exe installs SpaceSharp per user and creates shortcuts; the .msi lets the user choose the folder and scope. Both update the same way afterwards. On startup Program.Main runs Velopack's hooks before WPF loads. When installed that way, SpaceSharp checks GitHub Releases a few seconds after launch (Settings → Updates), and offers a one-click "Install and restart" that downloads a delta package and swaps in the new version. The portable exe reports itself as not installed and never updates on its own.

Deleting (Services/RecycleBin.cs) Items are sent to the Recycle Bin through the Windows shell (SHFileOperation with undo enabled). Windows warns you if an item is too big for the Recycle Bin. After a successful delete, the node is removed from the tree and its size is subtracted from every parent.

Project structure

SpaceSharp.sln
SpaceSharp/
├── App.xaml(.cs)                 startup, theme setup, error dialog
├── MainWindow.xaml(.cs)          main UI: toolbar, breadcrumb, map, status bar
├── AboutWindow.xaml(.cs)         About window
├── SettingsWindow.xaml(.cs)      settings window
├── Controls/
│   └── TreemapControl.cs         map rendering, zoom camera, hit testing, input
├── Layout/
│   └── Squarify.cs               squarified treemap algorithm
├── Models/
│   └── FsNode.cs                 file/folder tree
├── Program.cs                    entry point running Velopack before WPF
├── Services/
│   ├── FileFilter.cs             filter text parser and tree evaluation
│   ├── TopLists.cs               largest files/folders and space by type
│   ├── Updater.cs                GitHub Releases update check and install
│   ├── DiskScanner.cs            background scanner with progress, size on disk, hard links
│   ├── NativeFileInfo.cs         Win32 calls for cluster size, compressed size and file IDs
│   └── RecycleBin.cs             undoable delete through the Windows shell
├── Util/
│   ├── Palette.cs                color palettes and file-type categories
│   ├── ThemeManager.cs           light/dark switching
│   ├── TitleBarTheme.cs          light/dark window title bars
│   ├── AppSettings.cs            saved preferences
│   └── SizeFormatter.cs          "1.23 GB" formatting
├── Themes/
│   ├── Styles.xaml               control styles (buttons, drop-downs, menus, tooltips)
│   ├── Dark.xaml                 dark theme colors
│   └── Light.xaml                light theme colors
├── Assets/
│   ├── SpaceSharp.svg            icon source
│   ├── SpaceSharp-small.svg      simplified icon for 16–24 px
│   ├── SpaceSharp.ico            icon with all Windows sizes (16–256 px)
│   └── SpaceSharp-256.png        icon used in the app UI
├── Properties/PublishProfiles/   Portable, Small and Velopack publish profiles
├── app.manifest                  DPI and long-path awareness
└── SpaceSharp.csproj
SpaceSharp.Tests/                 xUnit tests for layout, filter, formatting and tree operations
docs/                             landing page (GitHub Pages), screenshots, icon, header and social preview
tools/make-assets.py              regenerates every icon, preview and installer image from the mark
installer/                        MSI wizard pages, dialog images, release.ps1 and brand-msi.ps1
.github/                          issue forms, pull request template, build workflow, Dependabot

Customizing

Add a palette Add an entry to BuildSchemes() in Util/Palette.cs. The simplest form is a name and a list of folder colors; file colors and file-type colors are derived from them:

FromList("Lavender",
    new[] { "#7B6FD6", "#9A8FE0", "#B7A8E8", "#6C8FD6", "#A58CC9", "#8D7BB8", "#C6A0D8" }, 0.5),

You can also pass your own file-type colors as a third argument, one per category in the order of the FileCategory enum.

Change theme colors Edit the hex values in Themes/Dark.xaml or Themes/Light.xaml. Both files must define the same keys.

Add file types Extensions and their categories are listed in BuildExtensionMap() in Util/Palette.cs.

Name, version and author These come from SpaceSharp.csproj (Version, Authors, Copyright, Description) and appear in the About window and in the exe's file properties.

Icon The mark is nine cells on a charcoal tile; the gutters form the # in Sharp and brightness follows size. Every brand asset is generated from one definition in tools/make-assets.py (Python 3 with Pillow; it downloads Bricolage Grotesque from its GitHub repository for the wordmark). Running it rewrites Assets/SpaceSharp.svg, SpaceSharp-small.svg (the four-cell version used at 16 to 24 px), SpaceSharp.ico, SpaceSharp-256.png, the icons and previews in docs/, and the two installer bitmaps, so change the cells or colors there rather than editing the files by hand.

Settings

Your palette, color mode and theme are saved to:

%AppData%\SpaceSharp\settings.json

Delete the file to go back to the defaults.

Known limitations

• Windows only. SpaceSharp is built on WPF.
• Size on disk is an estimate for files stored inside the MFT (very small files) and for alternate data streams, which aren't counted.
• Hard links are counted once per name unless "Count hard links once" is on, so C:\Windows\WinSxS can look bigger than it is by default.
• Links aren't followed. Junctions and symbolic links to folders are skipped on purpose; the target is counted where it really lives.
• Protected folders need administrator rights to be read.
• Cloud placeholders. In file-size mode, online-only OneDrive files show their full size. Switch to size on disk to see the local footprint.

Ideas for the future

• Saving scans so reopening the app is instant, and comparing two scans of the same drive
• Rescan a single folder from the right-click menu
• Export the current folder or the filter results to CSV
• Reading the NTFS index directly for much faster whole-drive scans
• Duplicate file finder, tied into filter and batch delete
• Command-line arguments and an Explorer context-menu entry
• Norwegian translation, once the strings move to resource files

Feedback

• Found a bug? Report it. The About window (F1) has a Report a bug button that opens the same form with your version and Windows details already filled in.
• Have an idea? Suggest a feature.
• Anything else: open a blank issue.
• Want to help with code, palettes or translations? See CONTRIBUTING.md.
• What changed in each release is in CHANGELOG.md.

Credits

• Squarified treemap layout: Mark Bruls, Kees Huizing and Jarke J. van Wijk, Squarified Treemaps (2000)
• Inspired by SpaceMonger
• Interface icons: Segoe Fluent Icons / Segoe MDL2 Assets, built into Windows
• Color-blind safe palette: Masataka Okabe and Kei Ito

License

SpaceSharp is released under the MIT License. You're free to use, modify and share it, including in commercial projects, as long as the copyright notice is kept.

Made by ClearanceClarence.