A more intuitive version of du (Disk Usage) written in Rust. Displays disk usage with visual bar charts, making it easy to spot what’s consuming space at a glance.
| Platform | Command |
|---|
| macOS (Homebrew) | brew install dust |
| Ubuntu/Debian | sudo apt install du-dust |
| Arch Linux | sudo pacman -S dust |
| Fedora/RHEL | sudo dnf install dust |
| Windows (Scoop) | scoop install dust |
| Windows (Chocolatey) | choco install dust |
| Cargo (All platforms) | cargo install du-dust |
| Snap | sudo snap install dust |
| Conda | conda install -c conda-forge dust |
| Nix | nix-env -iA nixpkgs.du-dust |
| Command | Description |
|---|
dust | Show disk usage of current directory with bar chart |
dust /path/to/dir | Analyze a specific directory |
dust dir1 dir2 | Compare disk usage of multiple directories |
dust -n 10 | Show top 10 largest entries |
dust -n 30 | Show top 30 largest entries |
dust -d 2 | Limit display to 2 directory levels deep |
dust -d 1 | Show only immediate children (overview) |
dust -r | Reverse output order (smallest first) |
dust -p | Show full paths for each entry |
dust -s | Show apparent size instead of disk usage |
| Command | Description |
|---|
dust -D | Show only directories (no individual files) |
dust -F | Show only files (no directories) |
dust -i | Hide hidden files and directories |
dust -x | Stay on the same filesystem (don’t cross mount points) |
dust -X node_modules | Ignore entries named “node_modules” |
dust -X ".git" | Ignore .git directories |
dust -e "\.log$" | Include only files matching regex pattern |
dust -v "\.tmp$" | Exclude files matching regex pattern |
dust -z 1M | Only show entries larger than 1 MB |
dust -z 100K | Only show entries larger than 100 KB |
dust -t | Group results by file type/extension |
dust -f | Count number of files instead of disk usage |
| Command | Description |
|---|
dust -b | Remove percentages and ASCII bars (bare output) |
dust -B | Move percentage bars to the right side |
dust -c | Monochrome output (no colors) |
dust -C | Force color output (even when piping) |
dust -R | Screen reader mode (no bars, adds depth column) |
dust -j | Output in JSON format |
dust --skip-total | Don’t show the total row at the top |
| Command | Description |
|---|
dust -o si | SI units (KB, MB, GB — powers of 1000) |
dust -o b | Show sizes in bytes |
dust -o kb | Show sizes in kilobytes |
dust -o kib | Show sizes in kibibytes (1024) |
dust -o mb | Show sizes in megabytes |
dust -o mib | Show sizes in mebibytes (1024²) |
dust -o gb | Show sizes in gigabytes |
dust -o gib | Show sizes in gibibytes (1024³) |
| Command | Description |
|---|
dust -L | Follow symbolic links |
dust -P | Disable progress indicator |
dust --collapse folder_name | Keep specified folder collapsed in output |
dust --files-from=list.txt | Read paths from a newline-separated file |
dust --files0-from=list.txt | Read paths from a NUL-separated file |
# Quick overview: what's eating disk space?
dust -d 1
# Find the biggest files in a project
dust -F -n 20
# Analyze home directory, ignoring caches
dust -X ".cache" -X "node_modules" ~
# Compare two directories side by side
dust ~/projects ~/downloads
# Machine-readable output for scripting
dust -j /var/log
# Find what's using space on root, same filesystem only
sudo dust -x -d 2 /
# Group by file type to see which extensions use most space
dust -t -n 20
# Show only directories larger than 100MB
dust -D -z 100M
dust displays a tree-like output with visual bars:
5.0G ┌── videos │████████████████████████████████ │ 50%
2.5G ├── photos │████████████████ │ 25%
1.5G ├── documents │██████████ │ 15%
500M ├── music │███ │ 5%
500M ├── downloads │███ │ 5%
10.0G ┌─┴ home │████████████████████████████████ │ 100%
- Size column: Total size of directory and its contents
- Tree markers: Show parent-child relationships (
┌──, ├──, └──)
- Bar chart: Visual proportion of each entry
- Percentage: Share of parent directory’s total size
| Feature | du | dust |
|---|
| Visual bars | No | Yes |
| Color output | No | Yes |
| Default sorting | No | By size |
| File type grouping | No | Yes (-t) |
| JSON output | No | Yes (-j) |
| Regex filtering | No | Yes (-e, -v) |
| Minimum size filter | No | Yes (-z) |
| Speed | Fast | Fast (Rust) |
