v3.1.0 UI Updates

UI Release Notes

Instant Resume: The app now remembers your last scan! It restores instantly when you open the app, quietly checks the disk in the background, and highlights what’s new since your last scan. (If it's a first run or a moved folder, it gracefully falls back to the welcome screen).

Massive Speed Improvements: We eliminated major UI lag by removing heavy background animations and optimizing our "frosted glass" effects. Now, only true floating elements (like the sidebar, search, and modals) use real-time blur, saving significant GPU power.

Smoother Scrolling: Scrolling through large lists is now noticeably faster. We optimized the layout to skip rendering offscreen rows, cutting list render times by over 60%.

Redesigned Navigation: The sidebar has been entirely rebuilt as a sleek, floating rounded glass card. It seamlessly adapts to light, dark, expanded, collapsed, and narrow-window modes.

Settings & Scroll Fix: Resolved an issue where scrolling tall views would push the navigation off-screen and cause the Settings menu to distort. The sidebar is now permanently pinned, and Settings opens perfectly centered at any scroll depth.

UI Polish & Accessibility: Swept all 13 views to fix text overflows, added screen reader support to folder-picker buttons, softened noisy list shadows, and updated "reclaimable" amounts to display as readable amber pills in light mode.

v3.0.0 - 21 Updates

TreeMap — 21 World-Class Cross-Platform Features

TreeMap is a high-performance, local-first disk-space analyzer and storage workbench built for Windows, macOS, and Linux. Built with zero frontend dependencies and a lightweight Node.js/Electron architecture, TreeMap combines near-instant scanning with safe, intelligent storage management across all your devices.

Key Features & Capabilities
Group A: Speed & Accuracy Core
Instant Scan Engine (A1): Reads raw filesystem structures—like the NTFS MFT, APFS getattrlistbulk, and Linux batched statx—to deliver near-instant initial scans and keep your disk index updated in real time.

Byte-Accurate CoW Sizing (A2): Correctly calculates shared versus exclusive disk usage across APFS clones, Btrfs reflinks, and NTFS hard links so your folder totals reflect actual free-space impact.

Placeholder & Cloud-Aware Sizing (A3): Accurately separates local disk usage from total cloud footprint for evicted iCloud items, OneDrive Files On-Demand, and sparse files.

Instant Size-Aware Search (A4): Delivers sub-100ms, type-ahead global search across multi-million file indexes with flexible size, age, and file-type filters.

Topology & Physical Mapping (A5): Maps logical volumes, APFS containers, LVM pools, and Storage Spaces back to their physical drives so you know exactly which physical disk is filling up.

Group B: Safety & Automation
Autopilot Policy Engine (B1): Automates background disk maintenance using customizable, capped cleanup rules with mandatory dry-run approvals to prevent unexpected deletions.

Open-File Guard (B2): Inspects system handles before every deletion to warn you if a file is actively locked or open in another application.

Time Capsule Safety Net (B3): Secures automated cleanups by staging items in a size-capped local buffer before trashing, enabling instant 30-day restores.

Snapshot Restore Engine (B4): Scans VSS, APFS, and Btrfs snapshots to let you recover deleted files directly from local system restore points.

Zombie-Handle Detector (B5): Identifies and reclaims hidden disk space consumed by deleted files that are still held open by orphaned background processes.

Group C: Intelligence & Detection
Cost Intelligence (C1): Projects your real-world cloud storage costs across major providers and calculates instant monthly savings for reclaiming space.

Media Compression Advisor (C2): Recommends non-destructive, hardware-accelerated video re-encoding candidates with verified frame checks before trashing oversized originals.

Download Provenance Tracker (C3): Uncovers where and when old installer archives and large downloads originated by inspecting hidden OS download metadata.

SMART Drive Health Correlation (C4): Combines raw drive-wear metrics with disk-growth trends to project when you will run out of physical space or need a drive replacement.

Security & Secrets Scanner (C5): Flags exposed private keys, .env files, and API credentials lying in unsafe user locations like Downloads or Desktop.

Package Ecosystem Cleaner (C6): Detects orphaned node_modules, venv, Homebrew, and Cargo build caches whose parent projects have been removed.

Game Library Awareness (C7): Categorizes Steam, Epic, GOG, and itch.io installs into base files, DLC, and shader caches with safe one-click cache clearing.

Unified Known-Offenders Catalog (C8): Powers automated cleanup suggestions using versioned, community-driven rule packs for system build caches, temporary files, and log growth.

Group D: Reach & Ecosystem
LAN Fleet View (D1): Discovers and displays disk usage summaries across all opted-in TreeMap instances on your local network using zero-cloud mDNS pairing.

Native Shell Integration (D2): Adds a "Scan with TreeMap" context-menu entry directly into Windows Explorer, macOS Finder, and Linux file managers.

Portable Triage Mode (D3): Runs fully self-contained from external USB drives to troubleshoot target machines without leaving residual files or registry keys on the host system.

2.6.1 Big Changes + Minor Edit

Search results are now fully readable over any page theme, small fix!

v2.6.0 Big Changes!

A major upgrade to TreeMap Visualizer! This release introduces a persistent instant scan engine, byte-accurate Copy-on-Write/clone sizing, and automated deletion safety across Windows, macOS, and Linux.

🌟 What's New
⚡ Phase 1: Speed & Accuracy Core
Instant Scan Engine (A1): Sub-200ms folder re-opens via an embedded SQLite index with real-time OS file event tracking (USN Journal, FSEvents, fanotify).

Byte-Accurate Sizing (A2): Correctly attributes shared vs. exclusive bytes for APFS clones, Btrfs/XFS reflinks, and hard links.

Cloud & Placeholder Awareness (A3): Detects OneDrive/iCloud placeholders and sparse files without double-counting local space.

Instant Global Search (A4): Type-ahead search (/) across indexed volumes with sub-100ms response times.

Physical Topology (A5): Maps logical volumes to underlying physical drives (Storage Spaces, APFS Containers, LVM, RAID).

🛡️ Phase 2: Safety & Automation
Open-File Guard (B2): Checks process locks before deletion to prevent corrupting open files.

Time Capsule (B3): Automatic Copy → SHA-256 Verify → Trash safety net before automated cleanup.

Autopilot Cleanup (B1): Background policy engine with safety caps, dry runs, and confirmation triggers.

Snapshot Restore (B4): Restore deleted files directly from VSS, Time Machine, or Btrfs snapshots.

Zombie-Handle Detector (B5): Flags deleted files held open by running processes to reclaim hidden space.

🏗️ Architecture & Safety
Platform Abstraction: Unified OS provider layer (src/platform/) with automatic capability detection.

Zero-Dependency UI: Modular view registry built in vanilla Canvas 2D/JS within public/index.html.

Zero Bare Deletes: All cleanup actions route through OS Trash or Time Capsule. Completely offline with zero telemetry.

v2.4.0 Scan capacity + AI

🚀 Scan capacity, rebuilt

TreeMap's scan engine now stores results in a new packed format that uses about
6× less memory per item (~52 bytes per file/folder instead of ~330). Huge
scans that used to strain memory now run light, aggregate views (largest files,
file types, folders) are 7–10× faster, and the engine is built with headroom
for scans up to ~100 million items. What you see in the app is unchanged —
same numbers, same views, results verified byte-for-byte identical.

🤖 TreeMap now works with AI assistants

• A built-in MCP server (npm run mcp) lets assistants like Claude Desktop
  scan folders, find the biggest files and duplicates, get cleanup suggestions
  and disk-full forecasts — under the same safety rules as the app: deletes go
  to the Trash only, and nothing outside a scanned folder can ever be touched.
• The API documents itself: /api/openapi.json, /api/capabilities, plus a new
  AGENTS.md guide.
• New safety rails: dry-run previews for deletes and offloads, an optional
  policy file (allowed folders, protected folders, per-operation size cap), an
  audit log of every destructive action, and retry protection so a repeated
  request can never delete twice.
• Optional token protection + CORS for running TreeMap as a server, and new
  Dockerfile / docker-compose / systemd files. All of this is off by default —
  nothing changes unless you turn it on.

📦 Installing / updating

• macOS: download the .dmg below. Auto-update can't self-install on macOS
  (the app isn't Apple-notarized), so the app will notify you and bring you here
  instead.
• Windows: download the .exe — auto-update works normally.

Fully compatible with previous versions — your settings, snapshots and history
carry over untouched.

v2.3.2

New updates to the app. Trying to turn the tide against the competitor apps.

v2.2.0 Big Scanner Update

• Version Update: v2.2.0 introduces a new turbo scan engine (gdu-turbo), which is based on the MIT-licensed gdu.

• Performance Improvement:

  • Increases TreeMap scanning speed from 70k–100k items/sec to 112k–129k items/sec.
  • Validated performance of 5,000,000 items scanned in approximately 43 seconds (~116k items/sec).

• Accuracy:

  • Maintains byte-for-byte accuracy parity with the old walker.
  • Includes exact hardlink deduplication counts, ensuring no trade-off between speed and accuracy.

• Issue Resolution:

  • Fixes the previous "can only scan 2 million files" limitation.
  • The issue was due to a V8 string-length cap on the tree payload sent to the UI, not a scanner limitation.

• Fallback Mechanism:

  • Automatically and silently falls back to the walker for:
    • Incremental rescans
    • Ignore-listed scans
    • Situations where the gdu binary is missing or fails
  • Ensures every scan returns a correct result regardless of fallback.

v2.1.0 UI Update

I implemented essential updates to the user interface and user experience of the application, ensuring it meets the needs of all users effectively.

TreeMap 2.0 — the disk-hygiene workbench

TreeMap v2 — Feature Roadmap

1. Per-App Storage Attribution — "Apps" tab showing total disk each app owns (binary/cache/data/logs), with a safe "clear caches" button.
2. Instant Whole-Drive Scans — NTFS MFT reading on Windows + faster enumeration on macOS/Linux; full drives in seconds.
3. Time-Slider Treemap — scrub through snapshot history and watch the disk grow/shrink, with a grew/shrank diff overlay.
4. Disk-Full Forecasting — "full in ~23 days" prediction from snapshot trends, with top growth culprits and early alerts.
5. Live Disk Activity Mode — treemap updates in real time after a scan; see what's writing to disk right now.
6. Container Drill-Down — click into .zip/.tar/.dmg/.iso, Docker images, and Photos libraries directly in the treemap.
7. Archive/Offload — move cold files to an external drive with hash verification and a searchable "where did it go" index + restore.
8. Cloud Storage Scanning (opt-in) — same treemap over Google Drive/Dropbox/OneDrive, plus an all-storage overview.

TreeMap v1.3.0

TreeMap Version V1.3.0— Feature Summary

Tier 1 — High-leverage

• Heatmap coloring — toggle treemap colors between "size" and "age" (green=recent, red=old)
• Cleanup cart — floating panel to stage files for batch deletion with a live running total
• Sunburst view — radial/concentric-ring alternative to the treemap, with same drill-down
• Quick-look preview — side panel showing thumbnails for images, first 30 lines for text files
• Incremental rescan — skip unchanged dirs using mtime cache for near-instant repeat scans
• Keyboard navigation — full vim-style (h/j/k/l) treemap control with a ? help overlay
• Growth-rate projection — "disk full in ~N days" estimate from snapshot linear regression
• Trash awareness — show system Trash as a labeled treemap segment and dashboard row

Tier 2 — Differentiation

• OS snapshot accounting — surface APFS / Btrfs / VSS snapshot space with a Purge button
• Cloud placeholder detection — flag iCloud/OneDrive stubs so treemap shows real on-disk bytes
• Symlink/hardlink dedup — count hardlinked files only once so sizes match du/df
• Perceptual image dedup — dHash-based near-duplicate finder for resized/re-encoded images
• Git repo scanner — show pack/LFS sizes per .git and offer a "Run git gc" button
• Regenerable dir detection — flag node_modules, .venv, target/, etc. with restore commands
• Folder budget alerts — set per-folder max size; exceeded folders get red borders in treemap
• Browser profile drill-down — break out Chrome/Firefox/Safari cache sub-folders individually

Tier 3 — Reach

• PDF/CSV export — export scan as CSV (files or folders) or a text PDF report
• Real-time FS watch — SSE-based live updates when files change, with animated cell flashes
• SSH/SFTP remote scanning — scan a remote server over SSH and view the treemap locally
• Scriptable CLI — treemap-cli bin for scan, dupes, suggest, and watch in terminal/CI
• Video compression suggestions — use ffprobe to flag large h264 files with ffmpeg transcode commands