# TreeMap-Disk-Visualizer: Visualize and Clean Up Disk Space

This repository profile is provided by osrepos.com, an open source repository discovery platform.

Source: osrepos.com
Repository profile: https://osrepos.com/repo/prithvi-web-treemap-disk-visualizer
Generated for open source discovery and AI-assisted research.

TreeMap is a TypeScript disk-space visualizer and cleanup app built with Electron, Express 5, and a Rust scanning core. It maps files by size and helps desktop users find and safely reclaim space on macOS and Windows, with web mode available on Linux.

GitHub: https://github.com/Prithvi-Web/TreeMap-Disk-Visualizer
OSRepos URL: https://osrepos.com/repo/prithvi-web-treemap-disk-visualizer

## Summary

TreeMap is a TypeScript disk-space visualizer and cleanup app built with Electron, Express 5, and a Rust scanning core. It maps files by size and helps desktop users find and safely reclaim space on macOS and Windows, with web mode available on Linux.

## Topics

- typescript
- electron
- desktop-app
- visualization
- disk-usage
- disk-cleanup
- storage-analyzer

## Repository Information

Last analyzed by OSRepos: Wed Oct 28 2026 08:55:30 GMT+0000 (Western European Standard Time)
Detail views: 4
GitHub clicks: 0

## Safety Notice

OSRepos shares public repositories for knowledge and discovery only. Review source code, dependencies, licenses, and security implications before running or installing anything.

## Content

## Overview

TreeMap is a disk-space visualizer and cleanup app built with Electron, Express 5, TypeScript, and a Rust scanning core. It scans a folder on your computer and maps its contents into size-proportional treemaps, helping you see which files and folders are using disk space. The desktop app is available for macOS and Windows; Linux users can run it in a browser through web mode.

It is aimed at people who want more than a list of large files: TreeMap includes views for trends, duplicates, and cleanup suggestions, while routing deletions through a reviewable cart and the system Trash. Its README emphasizes local operation and safeguards such as previews and an undo vault.

## Key Features

- Scan folders and explore their contents in treemap, sunburst, circle, Voronoi, grid, and isometric Disk City views.
- Review disk usage through dashboards, file-type breakdowns, history, and growth trends.
- Find identical files using streamed SHA-256 hashing, and near-duplicate images using perceptual hashes.
- Stage cleanup suggestions and review a dry-run manifest before moving files to the system Trash.
- Use an Undo Vault for supported cleanup runs, with verified copies that can be restored while retained.
- Run scans on a schedule, set ignore rules, or define Autopilot policies with previews and limits.
- Use the HTTP API, MCP tools, or VS Code extension to access TreeMap from other workflows.

## Use Cases

- Home users can locate large downloads, old projects, and duplicate files when a disk is running low.
- Developers can identify regenerable build and dependency directories before deciding what to remove.
- People managing game or media libraries can inspect storage use and review the limited cache or derivative cleanup options.
- Teams with multiple computers can opt into Fleet summaries to check disk capacity across machines without sharing file trees.

## Our Take

TreeMap is a feature-rich, safety-focused disk-usage workbench, but its rapid development and highly concentrated contributor base make it a young project to evaluate before relying on its automation.

**Good fit if:**
- You want visual, local disk analysis and cleanup workflows on macOS or Windows, or are comfortable running the web mode on Linux.
- You value previews, Trash-based deletion, and recovery options over a minimal disk-usage utility.
- You can work with a Node.js 20 or newer environment when running from source, and want an MIT-licensed project.

**Look elsewhere if:**
- You need a published Linux desktop installer, or an Intel Mac desktop build. The README describes Linux web mode and an Apple Silicon-only macOS build.
- You need a mature project with broadly distributed maintenance. The project is new, changes quickly, and most contributions come from one person.
- You need cleanup actions for data the app deliberately treats as unsafe to remove, such as game installs or original media files.

## Project Health

| Signal | Value |
|---|---|
| Status | **New**: less than six months old and changing fast |
| Last commit | 2026-10-26 (2 days ago) |
| Commits, last 90 days | 100+ |
| Releases, last 12 months | 19 (latest v5.2.0, 2026-10-26) |
| Contributors | 2 (top contributor: 99% of commits) |
| Issues closed, last 90 days | 5 (typically closed in 3 days) |
| Pull requests merged, last 90 days | 3 (typically merged in 0 days) |
| Project age | 5 months |

Checked on 2026-10-28 with the GitHub API.

## Project Facts

- Language: TypeScript
- License: MIT
- Stars: 887
- Forks: 67
- Topics: cleanup, cross-platform, dashboard, data-visualization, disk-cleanup, disk-management, disk-space-analyzer, disk-usage
- Website: https://tree-map-landing-page.vercel.app/
- Archived: no

## What You Need

Detected in the repository:

- Node.js >=20 (from package.json)
- A Dockerfile, so it can run in a container; a Compose file sets up the related services
- A test suite and automated checks on GitHub Actions

## Getting Started

For web mode, with Node.js 20 or newer:

```bash
npm install
npm run build
npm start
```

Then open `http://127.0.0.1:4280`. Desktop downloads are available from the [GitHub Releases page](https://github.com/Prithvi-Web/TreeMap-Disk-Visualizer/releases). See the [README](https://github.com/Prithvi-Web/TreeMap-Disk-Visualizer) for platform-specific setup and build instructions.

## License in Plain Words

**MIT** (permissive).

- Commercial use: yes
- Modify and redistribute: yes
- You must keep: the copyright and license notice
- Share your changes: no

A summary, not legal advice: the LICENSE file is what applies.

## Considerations

- This is a recently created project with frequent commits and releases, and development is strongly concentrated in one contributor. That pace brings active changes but also means adopters should check current releases and test critical workflows.
- Source runs require Node.js 20 or newer. Building the native scanner or packaging desktop apps also requires Rust; ordinary installation of the desktop app does not.
- The published desktop downloads cover Apple Silicon macOS and Windows. Linux is supported through web mode, while Linux desktop packaging is left to users to build.
- Some features are platform-dependent or explicitly limited. For example, video shrinking is currently offered only on macOS, and several cloud or hardware-related functions depend on available services or system support.
- Cleanup can move files to Trash and uses additional safeguards, but users should still inspect the manifest and confirm the intended items before committing a batch.