u/Deepluk

Dirplot creates clean, squarified treemaps where rectangle area is proportional to file/folder size, with smart per-extension coloring. This started as a vibe-coding experiment to replicate the functionality of tools like GrandPerspective, but then evolved to work far beyond a local disk.

Key Features

• Supports local dirs, archives (zip/tar/7z/...), SSH, AWS S3, GitHub repos (public + private), Docker containers, Kubernetes pods, and Google Drive.
• Inline terminal display (iTerm2, Kitty, Ghostty, WezTerm, Warp), no separate image window needed, but can also open the system's image viewer.
• Git & Mercurial history animation → MP4 / APNG / MOV timelapses.
• Live watch mode + event recording + replay.
• diff between any two sources (including two git tags/commits) with color-coded added/removed/changed borders.
• dirplot metrics for detailed stats (top extensions, largest files, JSON output).
• Outputs: PNG, SVG (slightly interactive), APNG, MP4, MOV. Custom canvas size and --log-scale supported.

Quick Start

Bash

# Recommended install
uv tool install dirplot

# Basic usage
dirplot map .                     # current directory → opens in viewer
dirplot map . --inline            # beautiful inline in terminal
dirplot map github://pallets/flask
dirplot git . -o history.mp4      # animate your repo's growth
dirplot diff .                    # see uncommitted changes as treemap

Usecases

• Understand large codebases or monorepos at a glance.
• Visualize cloud storage or container images without downloading everything.
• Create compelling git history growth animations.
• Compare directory versions or releses.
• Monitor live filesystem changes.

Links

• GitHub: https://github.com/deeplook/dirplot
• Documentation: https://deeplook.github.io/dirplot

Would love to get feedback and ideas for new use cases!