# duf
> A better df alternative with a colorful and user-friendly output

## Summary
A modern df replacement with colorful, organized output. Groups filesystems by type and shows usage, free space, and mount points in a readable table.

## Capabilities
- Colorful table output grouped by filesystem type
- Shows usage bars and percentages
- JSON output for scripting
- Filter by filesystem type or mount point

## When to Use
- Checking disk space across mounted filesystems
- Want a more readable overview than df

## When NOT to Use
- Scripts that parse df output (use df or duf --json)

## Usage Patterns
### Show all disk usage
```
duf
```
Displays colorful table of all mounted filesystems

### JSON output for scripting
```
duf --json
```
Machine-readable JSON output of filesystem information

## Installation
- **homebrew**: `brew install duf`
- **apt**: `sudo apt install duf`
- **pacman**: `sudo pacman -S duf`

## Related Tools
- [dust](/tools/dust) (complementary): dust shows directory-level usage, duf shows filesystem-level

---
Source: https://littlescripts.sh/tools/duf
