dust(1)

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