Skip to content

3389ro/diskmap-lite

Repository files navigation

DiskMap Lite

Portable disk-usage reports for Windows admins. C# · .NET 8 · WPF · Single-file portable .exe · No installer · No telemetry · No network access · No "Delete" button.

License: MIT Platform: Windows 10/11 x64 Latest: 1.0.1

Maintained by 3389 Software Outsourcing. Open source under the MIT License — see LICENSE.txt and NOTICE.txt for third-party attributions.

Latest binary: Releases pageDiskMapLite.exe (~70 MB, bundled .NET 8 runtime) Product page: 3389.ro/tools/diskmap-lite


What it does

DiskMap Lite scans a drive or folder, identifies where disk space is used, classifies likely review areas, and generates a client-ready report — HTML, CSV, JSON or PDF. It is a reporting tool, not a cleanup tool: there is no delete button, no auto-cleanup, no destructive actions, no admin elevation prompt, no telemetry, no network access.

Built for Windows admins, SMB IT support teams, MSPs and technical consultants who need a quick, defensible disk-usage audit they can email to a client.


Features

Scan engine

  • Async, cancellable iterative directory walk — no stack overflow on deeply-nested trees, throttled progress updates so the UI never freezes.
  • Safe handling of access-denied / path-too-long / locked files / broken reparse points.
  • Skips junctions / symlinks / reparse points by default to prevent infinite-loop traversals. Skipped paths are listed in the report.
  • Long-path aware (longPathAware=true in the app manifest) — handles paths > 260 chars in the scanner and in Process.Start launches.
  • Per-monitor DPI v2 aware — crisp text at 200 %+ scaling.

Reporting

  • Top folders & top files by size, each with a category tag and a cautious recommendation ("Review with file owner", "Validate retention policy before cleanup", …). No "safe to delete" language anywhere.
  • Folder drilldown — click into any folder to see its immediate children with rolled-up totals, category tags and recommendations. Breadcrumb, Up button, one-click navigation back to any ancestor.
  • Tree-map visualisation — squarified rectangles sized by rolled-up bytes and coloured by category. Click a tile to drill in.
  • HTML report with inline SVG charts — tree-map of the top folders, stacked-bar chart of the age buckets, pie chart of the category breakdown with a structured legend. All inline — no external assets, single self-contained file.
  • PDF export — same report, rendered via WebView2 (uses the Microsoft Edge engine for pixel-identical output) or PDFsharp as fallback.
  • CSV + JSON export — the full scan tree for downstream pipelines.

Breakdowns

  • File-type stats — extension histograms.
  • Age buckets — the classic 30 / 180 / 365-day cohorts.
  • Category taxonomy — Downloads / Archives / Logs / Cache / Backups / Dev / System / User-data.
  • Duplicate detection — XxHash3 (XXH3) content-hash compare, an order of magnitude faster than SHA-family hashes.

UI & localisation

  • Light + NOC-dark themes, driven by WPF design tokens.
  • 7 UI languages: English, Română, Deutsch, Español, Français, Italiano, Português.
  • Always-on-top sticky mode for keeping the report visible while you work.
  • System tray integration.

Safety / privacy

  • No "Delete" button anywhere in the GUI. DiskMap Lite is a reporting tool, not a cleaner.
  • No network access, no telemetry, no phone-home, no analytics.
  • No admin elevation prompt — runs as a normal user. If you launch it elevated yourself, it tells you so up front because that materially changes coverage on C:\ scans.
  • All output stays local — scan results never leave the machine unless you export them yourself.
  • No API keys or credentials are accepted, stored or used.

Quick start

  1. Download DiskMapLite.exe from the Releases page.
  2. Double-click. No installer, no .NET runtime required — the runtime is bundled inside the single-file executable.
  3. Pick a folder or drive, click Start Scan.
  4. Browse the dashboard / top-files / categories / tree-map tabs.
  5. Export to HTML / PDF / CSV / JSON from the Export tab.

Verify the binary against the SHA-256 sidecar published on the Releases page:

Get-FileHash DiskMapLite.exe -Algorithm SHA256

Command-line build (for pipelines)

DiskMapLite.Cli.exe scan "D:\some\folder" --html report.html --json report.json --quiet

Build from source

Requires the .NET 8 SDK.

build-release.bat

Produces DiskMapLite.App\publish\DiskMapLite.exe and DiskMapLite.Cli\publish\DiskMapLite.Cli.exe — each a ~70 MB self-contained single-file .exe.

For the portable folder variant (separate DLLs in a folder, no self-extract):

publish-portable.bat

See BUILD.md for the full toolchain setup and troubleshooting.


Repository layout

diskmap-lite/
├── README.md             ← you are here
├── BUILD.md              ← build / publish instructions
├── LICENSE.txt           ← MIT
├── NOTICE.txt            ← third-party attributions (.NET 8, CommunityToolkit.Mvvm, WebView2, PDFsharp, System.IO.Hashing)
├── DiskMapLite.sln
├── DiskMapLite.App/      ← WPF GUI project
│   ├── Controls/
│   ├── Converters/
│   ├── Export/
│   ├── Localization/     ← TranslatorGlossary.md + .resx satellite assemblies
│   ├── Resources/        ← AppStrings.resx + per-language satellites
│   ├── Theme/            ← Tokens.{Light,Dark}.xaml + Styles.xaml + ThemeManager.cs
│   └── ViewModels/
├── DiskMapLite.Cli/      ← Console build (same engine, scriptable)
├── DiskMapLite.Core/     ← Scanning + classification + visualisation engine
│   ├── Apps/             ← Installed-app classifier
│   ├── Classification/   ← File / folder / category classifier
│   ├── Diagnostics/      ← Coverage / elevation diagnostics
│   ├── Models/           ← ScanResult, FileEntry, FolderEntry, …
│   ├── Resources/        ← CoreStrings.resx + satellites
│   ├── Scanning/         ← The iterative walker, cancellation, throttling
│   ├── Settings/         ← User preferences persistence
│   └── Visualization/    ← Tree-map layout, sparkline data prep
├── DiskMapLite.Export/   ← HTML / PDF / CSV / JSON exporters
├── tools/                ← Build helpers (build-icon.ps1)
├── build-release.bat
└── publish-portable.bat

Versions are tracked through Git tags. Each tag has a corresponding GitHub Release with the binary, SHA-256 sidecar and release notes.


Built by

3389 Software Outsourcing — senior-level custom software, IT infrastructure and data platforms. Bucharest, Romania.

DiskMap Lite is a free, open-source tool. If your team needs a customised variant (private-network deployment, integration with an existing asset-management system, embedded use inside a larger product, custom reports), get in touch.

About

Portable disk-usage reports for Windows admins. C# / .NET 8 / WPF. Single-file portable .exe. No installer, no telemetry, no network access, no delete button.

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages