# dui: like du, but interactive

`dui` is a fast way to find which folders and files are using up your disk space

## Installation

`cargo install dui`

## Usage

```
Usage: dui [OPTIONS] [PATH]

Arguments:
  [PATH]
          The path to search. If empty, default to the current directory

          [default: .]

Options:
  -t, --type <DATA_TYPE>
          What type of data to display

          [default: file_size]

          Possible values:
          - file_size: Report the size (in bytes) of each file
          - num_files: Report the number of files
```

Launch an interactive terminal frame that allows you to explore your folders and files. If a path is provided, `dui` will report metadata (file sizes or number of files) for all folders and files in the subtree rooted at that path. If no path is provided, `dui` defaults to the current directory.

Once `dui` has started running, use the following keys to navigate:
- [Enter] to expand/collapse the currently selected folder
- up/down arrows (or ctrl-p/ctrl-n) to navigate up and down the folder tree
- q (or ctrl-c or ctrl-d) to quit

`dui` will ignore any folders and files ignored by `.gitignore`

## Example output

With `--type file_size` (the default setting):

```
┗⊟ ".": 27.2 KB (100.00%)
  ┣⊟ "src": 23.5 KB (86.48%)
  ┃ ┣⊟ "cli": 17.9 KB (76.35%)
  ┃ ┃ ┣⊡ "render.rs": 9.1 KB (50.55%)
  ┃ ┃ ┣⊡ "handler.rs": 5.3 KB (29.66%)
  ┃ ┃ ┗⊡ "mod.rs": 3.4 KB (18.92%)
  ┃ ┣⊡ "crawl.rs": 3.8 KB (16.38%)
  ┃ ┣⊡ "main.rs": 1.5 KB (6.36%)
  ┃ ┗⊡ "lib.rs": 28 B (0.12%)
  ┣⊡ "README.md": 1.1 KB (4.19%)
  ┣⊡ "LICENSE": 1 KB (3.82%)
  ┣⊡ "TODO.org": 453 B (1.63%)
  ┣⊡ "Cargo.toml": 451 B (1.62%)
  ┗⊡ "rustfmt.toml": 247 B (0.89%)
```

With `--type num_files`:

```
┗⊟ ".": 14 (100.00%)
  ┣⊟ "src": 8 (57.14%)
  ┃ ┣⊟ "cli": 4 (50.00%)
  ┃ ┃ ┣⊡ "render.rs": 1 (25.00%)
  ┃ ┃ ┣⊡ "handler.rs": 1 (25.00%)
  ┃ ┃ ┗⊡ "mod.rs": 1 (25.00%)
  ┃ ┣⊡ "main.rs": 1 (12.50%)
  ┃ ┣⊡ "lib.rs": 1 (12.50%)
  ┃ ┗⊡ "crawl.rs": 1 (12.50%)
  ┣⊡ "Cargo.toml": 1 (7.14%)
  ┣⊡ "TODO.org": 1 (7.14%)
  ┣⊡ "README.md": 1 (7.14%)
  ┣⊡ "LICENSE": 1 (7.14%)
  ┗⊡ "rustfmt.toml": 1 (7.14%)
```