dusk

Interactive disk usage analyzer for the terminal. Scan directories, visualize space usage across multiple views, and manage files — all without leaving your shell.

Features

• 3 visualization modes — tree, treemap, horizontal bar chart
• Parallel scanning — fast traversal with real-time progress
• Sorting — by size, name, modified time, or file count
• Fuzzy search — find any file instantly with /
• Filtering — by extension, size range, or modification date
• Quick delete — with trash support (freedesktop spec)
• Bookmarks — save and jump to frequently visited directories
• File info — permissions, owner, MIME type, inode, timestamps
• .gitignore aware — respects ignore rules automatically

Installation

Quick install (recommended)

curl -fsSL https://raw.githubusercontent.com/lostf1sh/dusk/main/install.sh | bash

This automatically downloads the latest binary for your platform.

Binary releases

Download a pre-built binary from the GitHub Releases page:

# Linux (x86_64)
curl -fsSL https://github.com/lostf1sh/dusk/releases/latest/download/dusk-x86_64-unknown-linux-musl.tar.gz | tar xz
sudo mv dusk /usr/local/bin/

# Or with wget
wget -O dusk.tar.gz https://github.com/lostf1sh/dusk/releases/latest/download/dusk-x86_64-unknown-linux-musl.tar.gz
tar xzf dusk.tar.gz
sudo mv dusk /usr/local/bin/

From source

# Using cargo (requires Rust 1.77+)
cargo install dusk

# Or build manually
git clone https://github.com/lostf1sh/dusk
cd dusk
cargo build --release
sudo cp target/release/dusk /usr/local/bin/

Usage

dusk              # scan current directory
dusk /path/to/dir # scan specific directory
dusk --no-trash   # permanent delete instead of trash

Key Bindings

Navigation

Key	Action
j / Down	Move down
k / Up	Move up
Enter / l / Right	Drill into directory
Backspace / h / Left	Go back / collapse
Space	Toggle expand (tree view)
q / Esc	Quit

Views

Key	Action
1	Tree view
2	Treemap view
3	Bar chart view

Actions

Key	Action
s	Cycle sort: Size → Name → Modified → Files
S	Toggle ascending / descending
i	File info popup
d	Delete (with confirmation)
/	Fuzzy search
f	Filter menu
b	Bookmark current directory
B	Open bookmark list

Filter Menu (f)

Key	Filter
e	By extension (type and Enter)
1-4	By size: >1M, >10M, >100M, >1G
d / w / m / y	Modified: 24h / 7d / 30d / 1yr
c	Clear filter

Search (/)

Type your query, press Enter to search. Navigate results with j/k, press Enter to jump.

Bookmark List (B)

Navigate with j/k, Enter to jump, d to remove.

Layout

┌──────────────────────────────────────────────────┬──────────────────┐
│                                                  │                  │
│  Visualization (65%)                             │  Info Panel      │
│  Tree / Treemap / Bar                            │                  │
│                                                  │  Name: src/      │
│                                                  │  Type: Directory │
│                                                  │  Size: 1.2 GiB   │
│                                                  │                  │
├──────────────────────────────────────────────────┴──────────────────┤
│ Total: 1.2 GiB  │  Files: 4832  │  0.3s  │  [1:Tree] 2:Map 3:Bar    │
└─────────────────────────────────────────────────────────────────────┘

Architecture

src/
├── main.rs                  # CLI parsing, terminal setup
├── config/
│   └── bookmarks.rs         # Bookmark persistence (~/.config/dusk/bookmarks.toml)
├── model/
│   ├── node.rs              # DiskNode tree, sorting, removal
│   └── metadata.rs          # On-demand file metadata (permissions, MIME, etc.)
├── scanner/
│   ├── walker.rs            # Directory traversal with progress updates
│   └── ignore_rules.rs      # .gitignore / .duskignore support
└── tui/
    ├── mod.rs               # App state machine, key dispatch, rendering
    ├── overlay.rs           # Popups: delete, info, search, filter, bookmarks
    ├── filter.rs            # Filter criteria and matching
    ├── theme.rs             # Color scheme
    ├── views/
    │   ├── tree.rs          # Expandable tree with flat-row model
    │   ├── treemap.rs       # Squarified treemap algorithm
    │   ├── bar.rs           # Horizontal bar chart
    │   └── nav.rs           # Shared navigation for bar/treemap
    └── widgets/
        ├── progress.rs      # Scan progress spinner
        └── text_input.rs    # Text input for search/filter

The codebase is a single Rust crate with focused modules for scanning, the disk tree model, configuration, and the terminal UI.

Key Design Decisions

• Name-based expanded paths — tree expand state survives sort and delete operations
• Lazy metadata — file info loaded on demand, not during scan
• Overlay system — all popups share a single rendering/input pipeline
• Channel-based scan — scanner thread sends progress via mpsc, TUI polls at 100ms

Dependencies

Crate	Purpose
ratatui	Terminal UI framework
crossterm	Cross-platform terminal I/O
clap	CLI argument parsing
ignore	.gitignore-aware directory walking
trash	Freedesktop trash support
fuzzy-matcher	Skim-based fuzzy search
tree_magic_mini	MIME type detection
humansize	Human-readable file sizes
serde + toml	Bookmark serialization
dirs	XDG config directory paths
unicode-width	Unicode-safe terminal text layout
anyhow + thiserror	Error handling

License

MIT