-
Notifications
You must be signed in to change notification settings - Fork 0
Home
Welcome to the Treemap wiki!
Welcome to TreeMap! This wiki covers everything you need to know about using the app.
- Getting Started
- The Three Views
- How to Scan
- Dashboard View
- Treemap View
- Grid View
- Clean Up
- Keyboard Shortcuts
- Tips & Tricks
- FAQ
- Troubleshooting
- macOS 10.12+
- Windows 10+
- At least 100 MB free disk space for the app itself
macOS:
- Download
TreeMap-1.0.0-arm64.dmgfrom Releases - Open the .dmg file
- Drag TreeMap to your Applications folder
- Open Applications → TreeMap
Windows:
- Download
TreeMap Setup 1.0.0.exefrom Releases - Run the installer
- Click through → Finish
- TreeMap opens automatically
The very first time you open TreeMap, your OS might show a security warning (because we don't have a paid developer certificate). It's harmless:
- macOS: right-click TreeMap → Open → Open
- Windows: click More info → Run anyway
After the first click, it opens normally every time.
TreeMap has three ways to look at your disk. Switch between them using the tabs at the top.
Shows your system info, current scan, and quick stats. Start here.
A visual map where every file is a colored rectangle, sized by how much space it takes. Drill in by clicking.
A grid of file squares, size-proportional. Great for browsing and multi-selecting files to delete.
- Open TreeMap
- On the Dashboard, you'll see "Scan a Folder" with a path input
- Click Browse... to pick a folder, or type a path directly
- Click Start Scan
- Watch the progress bar — TreeMap is walking every file
- When done, you'll see "Scan complete — X files found"
Tip: Start with a smaller folder (like Downloads or Desktop) to test it out. Scanning your entire home folder can take 1–2 minutes on first run.
The main control center.
- System Info Ring — shows how much of your disk is used (the blue arc)
- Disk Stats — total space, free space, used space
- Scan Controls — path input, Browse button, Start Scan button
- Quick Stats — number of files, folders, largest file, last scan time
- File Types Donut Chart — breakdown of space by file extension (top 8)
- Largest Files List — your top 10 biggest files with a size bar
- Trash a file — hover over it in the Largest Files list, click the 🗑️ icon
- Browse folders — click Browse... to navigate the file system
- Rescan — click Start Scan again to refresh the data
A visual map of your disk. Each rectangle = a file or folder, sized by bytes.
- Big rectangles = big files/folders
- Teal = small (< 1 MB)
- Amber = medium (1 MB – 1 GB)
- Red = large (> 1 GB)
- Darker = deeper in the folder tree (subfolders)
- Outlined rectangles = folders (not files)
- Click a folder — zoom in to see what's inside it
-
Right-click — open a context menu:
- Open in Finder/Explorer — show it on your desktop
- Copy path — copies the full path to clipboard
- Move to Trash — delete it (recoverable)
- Breadcrumbs at top — click to go back up the folder tree
- Escape key — go back one folder level
- Hover — see a tooltip with file name, size, and date modified
- Drill into your Downloads folder to spot old stuff
- Look for big red rectangles to find space hogs
- The outline frames show you folder structure at a glance
A grid of file squares, each sized by how much space it takes.
- Click a folder — navigate into it
- Shift+Click or Cmd/Ctrl+Click — select multiple files
- Double-click a file — open it in the default app
- Right-click — same context menu as Treemap (open, copy path, trash)
- Sort dropdown — change the sort order (Size, Name, Date, Type)
- ← button — go up one folder level
When you select files, a toolbar appears at the bottom:
- Shows X items selected and total size
- Move to Trash button — delete them all at once
- Clear button — deselect everything
The 🧹 Clean Up button opens a modal to find and delete files matching your rules.
- Click 🧹 Clean Up (top-right)
- Choose your rules:
- Older than [X] days — find files not touched in a while
- Larger than [X] MB — find big files
- Extensions — type file types (e.g., "log, tmp, dmg")
- Duplicates only — files with the same name and size elsewhere
- Click Find matching files
- A list appears with checkboxes — uncheck any you want to keep
- See the total space you'll recover at the bottom
- Click Move X items to Trash to delete them all
- A toast notification tells you how much space you freed
Important: Everything goes to the system Trash — you can undo from your Trash bin at any time.
| Action | Shortcut |
|---|---|
| Rescan current folder | ⌘R (Mac) / Ctrl+R (Windows) |
| Delete selected files | ⌘⌫ (Mac) / Ctrl+Delete (Windows) |
| Go back / close modal | Esc |
| Open in Finder/Explorer | ⌘↓ (Mac) / Ctrl+↓ (Windows) |
- Scan your home folder
- Sort by Size in Grid View
- Look for big folders (Downloads, Documents, .cache)
- Drill in and look for old project folders, duplicates, or temp files
- Use Clean Up with "Older than 180 days" to find ancient files
- Preview the list — uncheck anything you're unsure about
- Move to Trash
- Check your system Trash to confirm they're there
- Empty Trash only when you're 100% sure
-
.log= log files (usually safe to delete if old) -
.tmp= temporary files (safe to delete) -
.dmg= macOS installer images (safe if you've already installed) -
.zip/.rar= archives (check before deleting — might be backups)
- Scan smaller folders first (Downloads, Desktop) — faster feedback
- Avoid scanning system folders like /System or C:\Windows
- Close other apps if the scan feels slow (frees up RAM)
A: Yes. It scans files but never modifies them without your explicit click. Deletes go to Trash, not permanent deletion. Open-source code on GitHub — you can audit it.
A: We didn't pay Apple/Microsoft for a developer certificate ($99–$300/year). It's completely safe — just a cosmetic warning. One click past it, and it opens normally forever.
A: Yes. Use Browse... to navigate to any drive (USB, external SSD, network drive) and scan it.
A: Depends on folder size:
- Downloads (small): < 5 seconds
- Home folder (large): 30 seconds – 2 minutes
- Entire disk (huge): 2–5 minutes
A: Yes — everything goes to your system Trash. Open Trash, find the file, right-click → Restore (or just drag it back out).
A: No. It runs entirely on your computer. No tracking, no cloud sync, no ads.
A: Yes. The app keeps the last scan in memory, so you can look at one folder while scanning another.
Some folders (especially /System on macOS) are protected. TreeMap skips them automatically. If you need access, you may need to grant the app permission in System Preferences → Security & Privacy.
- Close other apps to free up RAM
- Try scanning a smaller folder first
- If scanning a huge folder (1M+ files), be patient — it can take 5+ minutes
The app is still calculating folder sizes (summing up children). Wait a few more seconds.
The folder you're trying to scan was deleted, moved, or inaccessible. Pick a different folder with Browse....
TreeMap uses gio trash (part of GLib). Make sure it's installed:
sudo apt install libglib2.0-0 # Debian/Ubuntu
sudo dnf install glib2 # Fedora