mrkatebzadeh/darya

Disk usage explorer with a TUI and live treemap

Rust

152

250 commits

updated Jul 19, 2026

See the code

README

DARYA

A Fast and Keyboard-Driven Disk Usage Explorer

Built with Rust, Ratatui, and Crossterm

darya is a lightweight disk usage tool built for the terminal. It’s just as at home on a headless server as it is on your laptop, giving you a quick way to see what’s taking up space without needing a graphical environment.

The interface is straightforward and easy to navigate, letting you move through directories, run scans when you want, and focus on the information that actually matters. It’s designed to stay fast and responsive, keeping things simple while working reliably across POSIX-like systems.

Installation

1) Install script (fastest)

Run the install script below to fetch the latest release for your platform.
```
curl -fsSL https://mr.katebzadeh.xyz/tools/darya/install | bash
```

2) Cargo install

Make sure Rust and Cargo are available on your system, then install the latest published build with the command below.
```
cargo install darya
```

3) Download from the releases page

Download the archive that matches your platform from the darya releases page using the command below.
```
curl -LO https://github.com/mrkatebzadeh/darya/releases/latest/download/darya-<platform>.tar.gz
```
Extract the archive and move the binary onto your PATH (for example, /usr/local/bin) by running the commands below.
```
tar -xzf darya-<platform>.tar.gz
sudo mv darya /usr/local/bin/
```

4) Building from source

Clone the repository and reset to the desired release tag (skip if you already have the source) by running the command below.
```
git clone https://github.com/mrkatebzadeh/darya && cd darya
```
Run the test suite and release build commands below.
```
cargo test
cargo build --release
```
Install the freshly built binary using Cargo with the command below.
```
cargo install --path .
```

Quick start

Launch darya in any directory to open the UI, then press R to start a scan.
Navigate with the keybindings shown at the bottom of the UI, toggle filters with / and c, and switch sorting/size modes with the letters displayed in the help pane.
Use -x/--one-file-system, -y/--show-hidden, or the other CLI flags if you need to control what the scanner visits before you start the UI.
Export scans with the provided snapshot flags (-f, -o, -O) to share what you have found without rerunning a full scan.

Keybindings

Key	Action
`k` / `↑`	Move the selection up.
`j` / `↓`	Move the selection down.
`h` / `←`	Collapse the highlighted directory or file group.
`l` / `→`	Expand the highlighted directory or file group.
`gg`	Jump to the top of the tree.
`G`	Jump to the bottom of the tree.
`Enter` / `Tab`	Select the current item.
`R`	Start a new scan for the current directory.
`r`	Rescan the currently selected path.
`/`	Begin typing to filter the tree. Press `Enter` to apply or `Esc` to exit filter mode.
`c`	Clear the active filter.
`s`	Cycle through the available sort modes.
`b`	Toggle the size display mode (bytes, percentage, etc.).
`E`	Export the latest scan snapshot.
`I`	Import a previously exported scan snapshot.
`d`	Delete the selected entry from the scan tree.
`o`	Open the selected entry in your default viewer.
`H`	Toggle showing hidden files and directories.
`?` / `Esc`	Open or close the help overlay.
`t`	Toggle the treemap panel.
`q`	Quit the application.

Configuration and customization

Settings come from a config.toml in your system config directory. On Linux this is ~/.config/darya/config.toml, while on macOS it lives at ~/Library/Application Support/darya/config.toml. Pass --ignore-config to skip loading it.
Overrides on the command line always win, so you can keep a mild default configuration and still tweak behavior at runtime.

Section	Key	Type	Description
`sorting`	`mode`	string	Default sort mode (`size_desc`, `size_asc`, `name`, `modified_time`).
`scan`	`exclude_patterns`	array of strings	Glob patterns to skip during scans.
`scan`	`follow_symlinks`	bool	Follow symlink targets during scans.
`scan`	`one_file_system`	bool	Stay on the same filesystem as the root path.
`scan`	`exclude_caches`	bool	Skip cache directories when scanning.
`scan`	`exclude_kernfs`	bool	Skip kernel filesystem paths when scanning.
`scan`	`count_hard_links_once`	bool	Count hard-linked files only once.
`scan`	`thread_count`	integer	Worker threads for scanning (0 uses a single thread).
`theme`	`background`	string	Base background color name.
`theme`	`foreground`	string	Base foreground color name.
`theme`	`directory`	string	Color for directory entries.
`theme`	`file`	string	Color for file entries.
`theme`	`symlink`	string	Color for symlink entries.
`theme`	`other`	string	Color for other entry types.
`theme`	`tile_palette`	array of strings	Treemap tile palette colors.

Contributors

mrkatebzadeh

246 commits

dependabot[bot]

4 commits

Similar repos

Byron/dua-cli

View disk space usage and delete unwanted data, fast.

6,289

bootandy/dust

A more intuitive version of du in rust

12,285

Zingzy/diskbloom

🌸 a pastel treemap TUI that shows what's eating your disk

findyourexit/excise

Surgical terminal storage navigator

dundee/gdu

Fast disk usage analyzer with console interface written in Go

5,997

jaccon/macfilesizing

Scan the local directories to check the file size

KSXGitHub/parallel-disk-usage

Highly parallelized, blazing fast directory tree analyzer

731

vikks/etop

Deterministic macOS Developer Ecosystem & Package Top

Languages

Rust

100.0%

mrkatebzadeh/darya

Disk usage explorer with a TUI and live treemap

Rust

152

250 commits

updated Jul 19, 2026

See the code

README

DARYA

A Fast and Keyboard-Driven Disk Usage Explorer

Built with Rust, Ratatui, and Crossterm

Installation

1) Install script (fastest)

Run the install script below to fetch the latest release for your platform.
```
curl -fsSL https://mr.katebzadeh.xyz/tools/darya/install | bash
```

2) Cargo install

Make sure Rust and Cargo are available on your system, then install the latest published build with the command below.
```
cargo install darya
```

3) Download from the releases page

Download the archive that matches your platform from the darya releases page using the command below.
```
curl -LO https://github.com/mrkatebzadeh/darya/releases/latest/download/darya-<platform>.tar.gz
```
Extract the archive and move the binary onto your PATH (for example, /usr/local/bin) by running the commands below.
```
tar -xzf darya-<platform>.tar.gz
sudo mv darya /usr/local/bin/
```

4) Building from source

Clone the repository and reset to the desired release tag (skip if you already have the source) by running the command below.
```
git clone https://github.com/mrkatebzadeh/darya && cd darya
```
Run the test suite and release build commands below.
```
cargo test
cargo build --release
```
Install the freshly built binary using Cargo with the command below.
```
cargo install --path .
```

Quick start

Launch darya in any directory to open the UI, then press R to start a scan.
Navigate with the keybindings shown at the bottom of the UI, toggle filters with / and c, and switch sorting/size modes with the letters displayed in the help pane.
Use -x/--one-file-system, -y/--show-hidden, or the other CLI flags if you need to control what the scanner visits before you start the UI.
Export scans with the provided snapshot flags (-f, -o, -O) to share what you have found without rerunning a full scan.

Keybindings

Key	Action
`k` / `↑`	Move the selection up.
`j` / `↓`	Move the selection down.
`h` / `←`	Collapse the highlighted directory or file group.
`l` / `→`	Expand the highlighted directory or file group.
`gg`	Jump to the top of the tree.
`G`	Jump to the bottom of the tree.
`Enter` / `Tab`	Select the current item.
`R`	Start a new scan for the current directory.
`r`	Rescan the currently selected path.
`/`	Begin typing to filter the tree. Press `Enter` to apply or `Esc` to exit filter mode.
`c`	Clear the active filter.
`s`	Cycle through the available sort modes.
`b`	Toggle the size display mode (bytes, percentage, etc.).
`E`	Export the latest scan snapshot.
`I`	Import a previously exported scan snapshot.
`d`	Delete the selected entry from the scan tree.
`o`	Open the selected entry in your default viewer.
`H`	Toggle showing hidden files and directories.
`?` / `Esc`	Open or close the help overlay.
`t`	Toggle the treemap panel.
`q`	Quit the application.

Configuration and customization

Settings come from a config.toml in your system config directory. On Linux this is ~/.config/darya/config.toml, while on macOS it lives at ~/Library/Application Support/darya/config.toml. Pass --ignore-config to skip loading it.
Overrides on the command line always win, so you can keep a mild default configuration and still tweak behavior at runtime.

Section	Key	Type	Description
`sorting`	`mode`	string	Default sort mode (`size_desc`, `size_asc`, `name`, `modified_time`).
`scan`	`exclude_patterns`	array of strings	Glob patterns to skip during scans.
`scan`	`follow_symlinks`	bool	Follow symlink targets during scans.
`scan`	`one_file_system`	bool	Stay on the same filesystem as the root path.
`scan`	`exclude_caches`	bool	Skip cache directories when scanning.
`scan`	`exclude_kernfs`	bool	Skip kernel filesystem paths when scanning.
`scan`	`count_hard_links_once`	bool	Count hard-linked files only once.
`scan`	`thread_count`	integer	Worker threads for scanning (0 uses a single thread).
`theme`	`background`	string	Base background color name.
`theme`	`foreground`	string	Base foreground color name.
`theme`	`directory`	string	Color for directory entries.
`theme`	`file`	string	Color for file entries.
`theme`	`symlink`	string	Color for symlink entries.
`theme`	`other`	string	Color for other entry types.
`theme`	`tile_palette`	array of strings	Treemap tile palette colors.

Similar repos

Byron/dua-cli

View disk space usage and delete unwanted data, fast.

6,289

bootandy/dust

A more intuitive version of du in rust

12,285

Zingzy/diskbloom

🌸 a pastel treemap TUI that shows what's eating your disk

findyourexit/excise

Surgical terminal storage navigator

dundee/gdu

Fast disk usage analyzer with console interface written in Go

5,997

jaccon/macfilesizing

Scan the local directories to check the file size

KSXGitHub/parallel-disk-usage

Highly parallelized, blazing fast directory tree analyzer

731

vikks/etop

Deterministic macOS Developer Ecosystem & Package Top

Contributors

mrkatebzadeh

246 commits

dependabot[bot]

4 commits

Languages

Rust

100.0%