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.
- Run the install script below to fetch the latest release for your platform.
curl -fsSL https://mr.katebzadeh.xyz/tools/darya/install | bash
- Make sure Rust and Cargo are available on your system, then install the latest published build with the command below.
cargo install darya
- 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/
- 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 .
- Launch
daryain any directory to open the UI, then pressRto start a scan. - Navigate with the keybindings shown at the bottom of the UI, toggle filters with
/andc, 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.
| 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. |
- Settings come from a
config.tomlin 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-configto 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. |