---
syntax: markdown
tags: [tldr, common]
source: https://github.com/tldr-pages/tldr.git
---
# dust

> Give an instant overview of which directories are using disk space.
> See also: `du`, `ncdu`.
> More information: <https://github.com/bootandy/dust#usage>.

- Display information for the current directory:

`dust`

- Display information about one or more directories:

`dust {{path/to/directory1 path/to/directory2 ...}}`

- Display 30 directories (defaults to 21):

`dust {{[-n|--number-of-lines]}} 30`

- Display information for the current directory, up to 3 levels deep:

`dust {{[-d|--depth]}} 3`

- Display the largest directories at the top in descending order:

`dust {{[-r|--reverse]}}`

- Ignore a file or directory:

`dust {{[-X|--ignore-directory]}} {{path/to/file_or_directory}}`

- Do not display percent bars and percentages:

`dust {{[-b|--no-percent-bars]}}`
