Metadata-Version: 2.4
Name: diskview
Version: 0.1.0
Summary: Interactive disk usage tree for your terminal
License: MIT
Requires-Python: >=3.9
Description-Content-Type: text/markdown
Requires-Dist: rich>=13.0
Provides-Extra: tui
Requires-Dist: textual>=0.50; extra == "tui"
Provides-Extra: dev
Requires-Dist: pytest; extra == "dev"
Requires-Dist: rich>=13.0; extra == "dev"

# disktree

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

```
pip install disktree
```

## Usage

```bash
# 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:

```bash
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.
