Dust(1) General Commands Manual 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] [-b|--no-per-
cent-bars] [-B|--bars-on-right] [-z|--min-size] [-R|--screen-reader]
[--skip-total] [-f|--filecount] [-i|--ignore-hidden] [-v|--invert-fil-
ter] [-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] [--collapse] [-m|--filetime]
[-h|--help] [-V|--version] [PATH]
DESCRIPTION
Like du but more intuitive
OPTIONS
-d, --depth=DEPTH
Depth to show
-T, --threads
Number of threads to use
--config=FILE
Specify a config file to use
-n, --number-of-lines=NUMBER
Number of lines of output to show. (Default is terminal_height -
10)
-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
-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, b, k, m, g, t, kb, mb, gb, tb]
-S, --stack-size=STACK_SIZE
Specify memory to use as stack size - use if you see: 'fatal run-
time error: stack overflow' (default low memory=1048576, high
memory=1073741824)
-j, --output-json
Output the directory tree as json to the current directory
-M, --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
just like -mtime, but based on file access time
-y, --ctime
just like -mtime, but based on file change time
--files0-from
run dust on NUL-terminated file names specified in file; if argu-
ment is -, then read names from standard input
--collapse
Keep these directories collapsed
-m, --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, c, m]
-h, --help
Print help
-V, --version
Print version
[PATH]
VERSION
v1.2.0
Dust 1.2.0 Dust(1)
Generated by dwww version 1.16 on Sun Aug 16 02:27:32 CEST 2026.