---
name: "dust"
section: "1"
platform: "linux"
package: "dust"
version: "1.2.6-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/dust"
---

# dust(1)

Like du but more intuitive

## NAME

Dust - Like du but more intuitive

## SYNOPSIS

**dust** \[**-d**\|**--depth**\] \[**-T**\|**--threads**\] \[**--config**\] \[**-n**\|**--number-of-lines**\] \[**-p**\|**--full-paths**\] \[**-X**\|**--ignore-directory**\] \[**-I**\|**--ignore-all-in-file**\] \[**-L**\|**--dereference-links**\] \[**-x**\|**--limit-filesystem**\] \[**-s**\|**--apparent-size**\] \[**-r**\|**--reverse**\] \[**-c**\|**--no-colors**\] \[**-C**\|**--force-colors**\] \[**--dim**\] \[**-b**\|**--no-percent-bars**\] \[**-B**\|**--bars-on-right**\] \[**-z**\|**--min-size**\] \[**-R**\|**--screen-reader**\] \[**--skip-total**\] \[**-f**\|**--filecount**\] \[**-i**\|**--ignore-hidden**\] \[**-v**\|**--invert-filter**\] \[**-e**\|**--filter**\] \[**-t**\|**--file-types**\] \[**-w**\|**--terminal-width**\] \[**-P**\|**--no-progress**\] \[**--print-errors**\] \[**-D**\|**--only-dir**\] \[**-F**\|**--only-file**\] \[**-o**\|**--output-format**\] \[**-S**\|**--stack-size**\] \[**-j**\|**--output-json**\] \[**-M**\|**--mtime**\] \[**-A**\|**--atime**\] \[**-y**\|**--ctime**\] \[**--files0-from**\] \[**--files-from**\] \[**--collapse**\] \[**-m**\|**--filetime**\] \[**-h**\|**--help**\] \[**-V**\|**--version**\] \[*PATH*\]

## DESCRIPTION

Like du but more intuitive

## OPTIONS

- **-d**, **--depth** *\<DEPTH\>*

  Depth to show

- **-T**, **--threads** *\<THREADS\>*

  Number of threads to use

- **--config** *\<FILE\>*

  Specify a config file to use

- **-n**, **--number-of-lines** *\<NUMBER\>*

  Display the 'n' largest entries. (Default is terminal\_height)

- **-p**, **--full-paths**

  Subdirectories will not have their path shortened

- **-X**, **--ignore-directory** *\<PATH\>*

  Exclude any file or directory with this path

- **-I**, **--ignore-all-in-file** *\<FILE\>*

  Exclude any file or directory with a regex matching that listed in this file, the file entries will be added to the ignore regexs provided by --invert\_filter

- **-L**, **--dereference-links**

  dereference sym links - Treat sym links as directories and go into them

- **-x**, **--limit-filesystem**

  Only count the files and directories on the same filesystem as the supplied directory

- **-s**, **--apparent-size**

  Use file length instead of blocks

- **-r**, **--reverse**

  Print tree upside down (biggest highest)

- **-c**, **--no-colors**

  No colors will be printed (Useful for commands like: watch)

- **-C**, **--force-colors**

  Force colors print

- **--dim**

  Dim the percent bars (grey) to reduce brightness on dark terminals

- **-b**, **--no-percent-bars**

  No percent bars or percentages will be displayed

- **-B**, **--bars-on-right**

  percent bars moved to right side of screen

- **-z**, **--min-size** *\<MIN\_SIZE\>*

  Minimum size file to include in output

- **-R**, **--screen-reader**

  For screen readers. Removes bars. Adds new column: depth level (May want to use -p too for full path)

- **--skip-total**

  No total row will be displayed

- **-f**, **--filecount**

  Directory 'size' is number of child files instead of disk size

- **-i**, **--ignore-hidden**

  Do not display hidden files

- **-v**, **--invert-filter** *\<REGEX\>*

  Exclude filepaths matching this regex. To ignore png files type: -v "\\.png$"

- **-e**, **--filter** *\<REGEX\>*

  Only include filepaths matching this regex. For png files type: -e "\\.png$"

- **-t**, **--file-types**

  show only these file types

- **-w**, **--terminal-width** *\<WIDTH\>*

  Specify width of output overriding the auto detection of terminal width

- **-P**, **--no-progress**

  Disable the progress indication

- **--print-errors**

  Print path with errors

- **-D**, **--only-dir**

  Only directories will be displayed

- **-F**, **--only-file**

  Only files will be displayed. (Finds your largest files)

- **-o**, **--output-format** *\<FORMAT\>*

  Changes output display size. si will print sizes in powers of 1000. b k m g t kb mb gb tb will print the whole tree in that size\

  *Possible values:*

  - •

    si: SI prefix (powers of 1000)

  - •

    b: byte (B)

  - •

    k: kibibyte (KiB)

  - •

    m: mebibyte (MiB)

  - •

    g: gibibyte (GiB)

  - •

    t: tebibyte (TiB)

  - •

    kb: kilobyte (kB)

  - •

    mb: megabyte (MB)

  - •

    gb: gigabyte (GB)

  - •

    tb: terabyte (TB)

- **-S**, **--stack-size** *\<STACK\_SIZE\>*

  Deprecated. The walker no longer recurses so a custom stack size is unnecessary. Accepted for compatibility but the value is ignored

- **-j**, **--output-json**

  Output the directory tree as json to the current directory

- **-M**, **--mtime** *\<MTIME\>*

  \+/-n matches files modified more/less than n days ago , and n matches files modified exactly n days ago, days are rounded down.That is +n =\> (−∞, curr−(n+1)), n =\> \[curr−(n+1), curr−n), and -n =\> (𝑐𝑢𝑟𝑟−𝑛, +∞)

- **-A**, **--atime** *\<ATIME\>*

  just like -mtime, but based on file access time

- **-y**, **--ctime** *\<CTIME\>*

  just like -mtime, but based on file change time

- **--files0-from** *\<FILES0\_FROM\>*

  Read NUL-terminated paths from FILE (use \`-\` for stdin)

- **--files-from** *\<FILES\_FROM\>*

  Read newline-terminated paths from FILE (use \`-\` for stdin)

- **--collapse** *\<COLLAPSE\>*

  Keep these directories collapsed

- **-m**, **--filetime** *\<FILETIME\>*

  Directory 'size' is max filetime of child files instead of disk size. while a/c/m for last accessed/changed/modified time\

  *Possible values:*

  - •

    a: last accessed time

  - •

    c: last changed time

  - •

    m: last modified time

- **-h**, **--help**

  Print help (see a summary with '-h')

- **-V**, **--version**

  Print version

- \[*PATH*\]

  Input files or directories

## VERSION

v1.2.6