spacefinder

Visualize disk usage as an interactive treemap in your terminal — a text-mode take on spacesniffer and filelight.

The full home dir scan runs like du: one fast pass up front (the splash shows a spinner, the current path, and entry counts), then drilling is effectively instant.

Deleting always asks you to type the exact name of the entry inside a modal dialog — accidental deletions require real intent. The scan root itself can never be deleted through the UI.

Install

One installer per platform:

# macOS / Linux
curl -fsSL https://raw.githubusercontent.com/metruzanca/spacefinder/main/.github/install.sh | sh

# Windows (PowerShell)
irm https://raw.githubusercontent.com/metruzanca/spacefinder/main/.github/install.ps1 | iex

Downloads the latest release binary for your OS/arch, verifies its checksum, and installs it to ~/.local/bin (macOS/Linux, override with PREFIX or BINDIR) or %LOCALAPPDATA%\spacefinder\bin (Windows). Or build from source:

go install github.com/metruzanca/spacefinder@latest

Usage

spacefinder [path]

Without a path, spacefinder opens a picker: choose where to scan from your home directory, the filesystem root, the current directory, or any other detected drive or partition. Drives show their free space; the current directory shows a rough du estimate of its size. enter starts the scan, q quits. With a path, the scan starts there directly.

Spacefinder supports both keyboard inputs via arrow/vim keys, enter & esc for zoom in/out and mouse input with double clicking to zoom in (or to open a file in its OS default application). del to delete (with confirmation), q to quit, and ? to open a full keybind + mouse reference. The bottom bar shows the core shortcuts and notes that the mouse is supported.

TODO

Directories with more entries than fit at a legible minimum size are split across pages (tab / shift+tab, or the arrow/wheel edges). All pages share one scale, so later pages show the genuinely smaller entries at their true size (clamped to a readable minimum) with the empty tail as plain background — every file or folder, no matter how small, can be reached.

Filters are another idea from Spacesniffer which would be useful: filter by file type, age, file size. Spacesniffer also net you tag files, which could be useful for filtering. And exporting a report could also be useful, though I've never used that feature from spacesniffer.