Skip to content
tobiPublic

About

A treemap for finding and removing what fills your disk, for Omarchy. Rust + GPUI.

Resources

Stars

4.2k stars

Watchers

13 watching

Forks

Repository files navigation

disktree

disktree: a home directory as a treemap, coloured by kind of data, with reclaimable space hatched and the selection, findings and free space in the side panel

Find what is filling a disk, mark what should go, and remove it — with the volume's free space in view the whole time.

disktree is a treemap for Omarchy. Choose a local or SSH source, then a mounted volume or directory; no scan starts until you explicitly accept. It draws every directory as a nested mosaic sized by its real disk cost, and lets you walk into it with the keyboard or the mouse. Mark as much as you like; nothing happens until you review the list and commit, and the permanent path always asks first.

Built with GPUI through gpui-omarchy, so it follows your Omarchy theme and behaves like the rest of the desktop.

Install

Download disktree-*-x86_64-linux.tar.gz (aarch64-linux on ARM) from the latest release, unpack it, and run ./install.sh inside (or just copy disktree onto your PATH). Or build it:

git clone https://github.com/tobi/disktree
cd disktree
make install

make install builds a release binary and puts three things under ~/.local (no root needed):

  • ~/.local/bin/disktree
  • a desktop entry, so disktree is in the launcher and in a file manager's Open with for a directory (it adds a handler; it never becomes the default)
  • an icon

sudo make install PREFIX=/usr/local installs system-wide; make uninstall removes exactly what was installed.

On Arch, including Omarchy, disktree is in the AUR: disktree builds each release from source, and disktree-bin installs the release binary:

yay -S disktree-bin

If another installed version wins on PATH, the installer warns which one. Run export PATH="$HOME/.local/bin:$PATH" and add that setting to your shell configuration so the locally installed build takes precedence.

For Linux builds with embedded SSH helpers, also install the two Rust standard-library targets (no external C cross-compiler is needed):

rustup target add x86_64-unknown-linux-musl aarch64-unknown-linux-musl

You need Rust 1.97 or newer and a Wayland or X11 session with a GPU that GPUI can drive (Vulkan). Distributions often package an older Rust; rustup installs a current one. The repo pins 1.97 in rust-toolchain.toml, so with rustup the right toolchain is fetched on the first build even if rustup default points at something older.

macOS

Download disktree-*-aarch64-macos.zip (x86_64-macos for an Intel Mac) from the latest release, unzip it, and drag disktree.app into Applications. macOS 11 or newer.

A release that was not signed and notarized is stopped by Gatekeeper: macOS says it "is damaged and can't be opened" or "cannot be verified". The app is fine; the browser marked the download as quarantined. Clear the mark once:

xattr -dr com.apple.quarantine /Applications/disktree.app

(Or open it once, then choose Open Anyway in System Settings › Privacy & Security.)

Or build it, with Rust 1.97 or newer and Xcode or its Command Line Tools. macOS does not come with Rust; install it with rustup.

make install     # ~/Applications/disktree.app, and ~/.local/bin/disktree
make uninstall

To see everything, give disktree Full Disk Access in System Settings › Privacy & Security (the panel offers a button when it is missing), then reopen it. Without it macOS hides Mail, Messages, Safari, other apps' data and the Trash, and disktree counts them as unreadable. Started from a terminal, it is the terminal that needs the access. macOS also asks once each for Desktop, Documents and Downloads.

What is different from Linux:

  • Free space is what df reports. Finder's figure is larger: it counts purgeable space (caches and local snapshots macOS will clear on its own).
  • Cloned files (copies APFS shares blocks between, as Finder's Duplicate makes) are each counted in full, so a total can exceed what deleting them frees.
  • Time Machine's local snapshots are not files and do not appear; they are part of the gap between the scan and the disk's used space.
  • Cloud-only folders (iCloud Drive, Dropbox and the like, evicted to the server) are not opened, so a scan never downloads them.

To sign and notarize a build for others, with a Developer ID certificate in the keychain and credentials saved by xcrun notarytool store-credentials:

NOTARY_PROFILE=<profile> cargo xtask bundle \
  --sign "Developer ID Application: Name (TEAMID)" --notarize

Windows

On Windows 10 or 11, download disktree-*-x86_64-windows.zip (aarch64-windows on ARM) from the same release, unpack it anywhere and run disktree.exe. Or build it with Rust 1.97 or newer, from rustup, and the MSVC toolchain (Visual Studio Build Tools, C++ workload):

git clone https://github.com/tobi/disktree
cd disktree
cargo build --release    # target\release\disktree.exe

See On Windows for what differs there.

Use

disktree            # choose a local/SSH source and root
disktree ~          # explicitly scan home
disktree --disk     # the whole disk it lives on
disktree ~/src      # or any directory
disktree --help     # options: apparent size, follow links, skip hidden, …

Servers over SSH (read-only)

disktree ssh dev                 # connect and choose a remote root
disktree ssh user@server /var    # an explicit remote path
disktree ssh dev --disk          # the disk containing the remote home
disktree ssh dev -a /srv         # apparent size instead of allocated blocks

Linux builds made with make build / cargo xtask portable include static x86-64 and ARM64 Linux scanners appended to the executable. SSH detects the server's OS/CPU and uploads the matching scanner only when its checked cache is missing or damaged. The cache is private and content-addressed under ~/.cache/disktree/ssh/<sha256>/ (or the server's