diskview 0.1.0

Interactive disk usage tree for your terminal

disktree

Interactive disk usage tree for your terminal. Find out what's eating your space.

pip install disktree

Usage

# Scan current directory
disktree

# Scan a specific path
disktree /path/to/dir

# Control depth and number of entries shown
disktree --depth 4 --top 15

# Hide small entries
disktree --min-size 10MB

# Sort by name instead of size
disktree --sort name

# JSON output (for scripting)
disktree --json | jq '.children[0]'

# Interactive TUI (requires: pip install disktree[tui])
disktree --tui

Output

C:\Users\you  245.3 GB
├── ##########------  89.2 GB   36.4%  Documents/
│   ├── ########--------  67.1 GB   75.2%  projects/
│   └── ##--------------  22.1 GB   24.8%  old_stuff/
├── ####------------  45.8 GB   18.7%  Downloads/
└── ##--------------  23.1 GB    9.4%  .cache/

Each row shows a proportional fill bar, the absolute size, percentage of the parent, and the name.

Options

Flag	Default	Description
--depth N	3	How many levels deep to display
--top N	10	Max entries per level
--min-size SIZE	0	Hide entries smaller than SIZE (e.g. 10MB, 500KB)
--sort size|name	size	Sort order
--json	off	Output JSON instead of tree
--tui	off	Interactive TUI (requires pip install disktree[tui])

Interactive TUI

Install the TUI extra:

pip install disktree[tui]
disktree --tui

Keys: arrow keys to navigate, Enter to expand/collapse, s to toggle sort, r to rescan, q to quit.