Fast TUI disk usage analyzer built in Rust. A modern alternative to WinDirStat, ncdu, and Disk Inventory X.
diskstat combines the best features of existing disk usage analyzers with modern performance:
- vs ncdu: 10x faster scanning via parallel walk + macOS acceleration, instant cache reload
- vs WinDirStat: Native terminal UI, cross-platform, keyboard-first navigation
- vs Disk Inventory X: Open source, actively maintained, modern Rust safety
- vs dust: Interactive TUI with tree navigation, treemap visualization, duplicate detection
- vs gdu: Feature parity (treemap, duplicates, search) with better ergonomics
- Parallel scanner with macOS
getattrlistbulkacceleration - Instant restart via binary tree cache (< 100ms for cached scans)
- Interactive treemap with color-coded file extensions
- File tree with size bars, percentages, expand/collapse
- Size filtering (show only files/directories ≥ threshold, e.g.,
Fthen10Mfor ≥10MB) - Duplicate detection (3-pass: size > partial hash > full hash with blake3)
- Extension statistics tab
- Keyboard + mouse navigation
- Search (vim-style
/) - Split pane with draggable separator
- Multiple themes (cycle with
t) - Export to CSV or JSON (JSON mode for scripting/automation)
- Config file support (~/.config/diskstat/config.toml)
- Progress indicator during scan with animated spinner
- Safe: symlinks skipped, delete restricted to scan root, 10M node OOM guard
# macOS (Apple Silicon)
curl -L https://github.com/pszymkowiak/diskstat/releases/latest/download/diskstat-aarch64-apple-darwin.tar.gz | tar xz
sudo mv diskstat /usr/local/bin/
# Linux (x86_64)
curl -L https://github.com/pszymkowiak/diskstat/releases/latest/download/diskstat-x86_64-unknown-linux-gnu.tar.gz | tar xz
sudo mv diskstat /usr/local/bin/cargo install --git https://github.com/pszymkowiak/diskstatdiskstat # Scan current directory (or last scanned)
diskstat /path/to/dir # Scan specific directory
diskstat ~/Downloads # Scan Downloads
diskstat -f /path # Force fresh scan (ignore cache)
diskstat --json /path # Export scan results to JSON (no TUI)
diskstat --info # Show version infoExport scan results to JSON for scripting, piping to jq, or CI/CD integration:
# Export to JSON
diskstat --json ~/Downloads > scan.json
# Pipe to jq for analysis
diskstat --json ~/Downloads | jq '.top_files[:10]'
diskstat --json ~/Downloads | jq '.extensions | sort_by(.size) | reverse | .[:5]'
diskstat --json ~/Downloads | jq '.duplicates | map(.wasted_size = .size * (.paths | length - 1))'JSON output schema:
{
"root": "/path",
"total_size": 123456789,
"file_count": 1234,
"scan_time_ms": 456,
"top_files": [{"path": "...", "size": 123, "age_days": 45}],
"extensions": [{"ext": "rs", "size": 456, "count": 12}],
"duplicates": [{"hash": "...", "size": 789, "paths": ["...", "..."]}]
}Create ~/.config/diskstat/config.toml to customize defaults:
[scan]
exclude = ["node_modules", ".git", "target", "__pycache__"]
max_nodes = 10000000
[ui]
theme = 0
show_treemap = true
split_pct = 40
[display]
top_files_count = 50
sort_mode = "size_desc" # or size_asc, name_asc, name_desc, age_newest, age_oldestCLI arguments override config file settings.
| Key | Action |
|---|---|
q / Ctrl+C |
Quit |
Up/Down / j/k |
Navigate tree |
Left/Right / h/l |
Collapse/Expand |
Enter |
Zoom into directory (treemap) |
Backspace |
Zoom out (treemap) |
Tab |
Switch pane (tree/treemap) |
1 2 3 |
Switch tab (TreeMap/Extensions/Duplicates) |
/ |
Search (vim-style) |
n / N |
Next/Previous search match |
r |
Rescan current directory |
R |
Rescan subtree |
p |
Change path |
o |
Open in Finder/file manager |
c |
Copy path to clipboard |
e |
Export to CSV |
F |
Filter by size (e.g., 10M, 1.5G) |
C |
Clear size filter |
d |
Find duplicates |
D |
Delete selected (with confirmation) |
t |
Cycle theme |
m |
Toggle treemap visibility |
? |
Help |
| Metric | Value |
|---|---|
| Scanner | Parallel (rayon) + macOS getattrlistbulk |
| Cache load | < 100ms for 1M+ files |
| Memory | Arena-based tree, interned extensions |
| Treemap | Single-pass render, pre-allocated buffers |
| Duplicates | 3-pass with blake3 (size > 4KB hash > full hash) |
- Scanner parallele avec acceleration macOS
getattrlistbulk - Redemarrage instantane via cache binaire (< 100ms pour les scans en cache)
- Treemap interactif avec couleurs par extension de fichier
- Arbre de fichiers avec barres de taille, pourcentages, deplier/replier
- Filtrage par taille (afficher seulement fichiers/dossiers ≥ seuil, ex:
Fpuis10Mpour ≥10MB) - Detection de doublons (3 passes : taille > hash partiel > hash complet avec blake3)
- Onglet statistiques par extension
- Navigation clavier + souris
- Recherche (style vim
/) - Panneau divise avec separateur deplacable
- Themes multiples (changer avec
t) - Export CSV ou JSON (mode JSON pour scripts/automatisation)
- Fichier de configuration (~/.config/diskstat/config.toml)
- Indicateur de progression pendant le scan avec spinner anime
- Securise : symlinks ignores, suppression restreinte au repertoire scanne, garde OOM 10M noeuds
# macOS (Apple Silicon)
curl -L https://github.com/pszymkowiak/diskstat/releases/latest/download/diskstat-aarch64-apple-darwin.tar.gz | tar xz
sudo mv diskstat /usr/local/bin/
# Linux (x86_64)
curl -L https://github.com/pszymkowiak/diskstat/releases/latest/download/diskstat-x86_64-unknown-linux-gnu.tar.gz | tar xz
sudo mv diskstat /usr/local/bin/cargo install --git https://github.com/pszymkowiak/diskstatdiskstat # Scanner le repertoire courant (ou le dernier scanne)
diskstat /chemin/vers/dir # Scanner un repertoire specifique
diskstat ~/Downloads # Scanner Downloads
diskstat -f /chemin # Forcer un scan frais (ignorer le cache)
diskstat --json /chemin # Exporter les resultats en JSON (sans TUI)
diskstat --info # Afficher les infos de version| Touche | Action |
|---|---|
q / Ctrl+C |
Quitter |
Haut/Bas / j/k |
Naviguer dans l'arbre |
Gauche/Droite / h/l |
Replier/Deplier |
Entree |
Zoomer dans le repertoire (treemap) |
Retour |
Dezoomer (treemap) |
Tab |
Changer de panneau (arbre/treemap) |
1 2 3 |
Changer d'onglet (TreeMap/Extensions/Doublons) |
/ |
Rechercher (style vim) |
n / N |
Resultat suivant/precedent |
r |
Rescanner le repertoire courant |
R |
Rescanner le sous-arbre |
p |
Changer de chemin |
o |
Ouvrir dans le Finder/gestionnaire de fichiers |
c |
Copier le chemin dans le presse-papiers |
e |
Exporter en CSV |
F |
Filtrer par taille (ex: 10M, 1.5G) |
C |
Effacer le filtre de taille |
d |
Chercher les doublons |
D |
Supprimer (avec confirmation) |
t |
Changer de theme |
m |
Afficher/masquer le treemap |
? |
Aide |
| Metrique | Valeur |
|---|---|
| Scanner | Parallele (rayon) + macOS getattrlistbulk |
| Chargement cache | < 100ms pour 1M+ fichiers |
| Memoire | Arbre arena, extensions internees |
| Treemap | Rendu single-pass, buffers pre-alloues |
| Doublons | 3 passes avec blake3 (taille > hash 4Ko > hash complet) |
diskstat is built with a clean separation of concerns:
- Scanner (
src/scanner/): Parallel filesystem walker using rayon work-stealing, macOSgetattrlistbulkfor 10x speedup - Arena tree (
src/types.rs): Indextree-based memory-efficient storage with interned extensions - Treemap (
src/treemap_algo.rs): Squarified treemap algorithm optimized for terminal aspect ratio - TUI (
src/ui/): Ratatui widgets with manual buffer rendering for treemap, i18n support (EN/FR) - Cache (
src/scanner/cache.rs,tree_cache.rs): SQLite directory cache + binary tree serialization for <100ms startup - Duplicates (
src/scanner/dupes.rs): 3-pass parallel deduplication (size > partial hash > full blake3)
Key optimizations:
- Zero-copy sorted children with RefCell cache
- Thread-local buffers for hash computation
- Pre-allocated hit regions for mouse click detection
- Single-pass treemap rendering with background fill + label pass
Contributions welcome! Please:
- Run tests before submitting:
cargo test - Format code:
cargo fmt - Run clippy:
cargo clippy --all-targets - Add tests for new features
- Update README for user-facing changes
MIT