RDU - Rust Disk Usage Analyzer

A terminal disk-usage analyzer written in Rust.

Screenshots

Main Window

Help Window

Deletion Confirmation Window

Installation

Manual Install

1. Go to the GitHub releases page
2. Download the latest non-dSYM build (i.e., rdu-X.Y.Z.tar.gz for Linux/macOS)
3. Unzip the archive
4. Run the rdu binary from the terminal

Install via Homebrew 🍺

1. Install Homebrew if you haven't already
2. Open Terminal and run brew tap schmidt-gabriel/tap
3. Run brew install rdu

Requires Rust 1.75+. Install via rustup if needed.

Usage

Run rdu to scan the current directory, or provide a path to scan a specific directory:

# Scan current directory
rdu

# Scan a specific directory
rdu /path/to/directory

You can also use the following flags:

• -h, --help: Print help information
• -V, --version: Print version information
• --no-delete: Prevent deletions

Keybindings

Key	Action
j / ↓	Move selection down
k / ↑	Move selection up
Enter / →	Drill into directory
← / Esc / Backspace	Go up to parent / clear search
Space	Mark item for deletion
d / D	Delete marked item(s) (with prompt)
/	Search / filter files
s	Cycle sort mode
r	Rescan from root
?	Toggle help overlay
q	Quit

Architecture

src/
├── main.rs       — Entry point, terminal setup, event loop
├── app.rs        — Application state (tree, navigation, scan channel)
├── scanner.rs    — Recursive filesystem walker (std::fs + rayon)
└── ui.rs         — All ratatui widget rendering

Possible Extensions

• Filter by extension (show only .mp4, etc.)

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgments

• Built with Ratatui for the terminal interface
• Powered by Rayon for blazingly fast parallel directory scanning
• Uses humansize for human-readable file sizes