Dust(1)

💖 Dust(1) — like, the manual page, bestie 💖

okay so welcome to Dust(1), from the General Commands Manual (yes that's the manual, she's fancy). This is the whole thing, rewritten with love and zero skipped details. Buckle up, we're going in 🌸

---

✨ NAME ✨

Dust — Like du but more intuitive

no cap, that's literally the whole name section. short king energy 👑

---

✨ 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]

like, that's a lot of flags but we're gonna go through every single one together 🫶

---

✨ DESCRIPTION ✨

Like du but more intuitive. That's the vibe. That's the whole pitch. iconic 💅

---

🎀 OPTIONS 🎀

• -d, --depth <DEPTH> — how deep into the tree you wanna go. depth to show, bestie.
• -T, --threads <THREADS> — number of threads to use. multi-threaded slay 🔥
• --config <FILE> — specify a config file to use. tell her where the settings live.
• -n, --number-of-lines <NUMBER> — display the 'n' largest entries. the default is terminal_height — she reads your terminal, she's smart like that ✨
• -p, --full-paths — subdirectories will not have their path shortened. full paths, no cutting corners 💯
• -X, --ignore-directory <PATH> — exclude any file or directory with this path. bye felicia 👋
• -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. (yes, --invert_filter with the underscore, that's how she wrote it, don't @ me)
• -L, --dereference-links — dereference sym links — treat sym links as directories and go into them. follow the links, main character behavior 🦋
• -x, --limit-filesystem — only count the files and directories on the same filesystem as the supplied directory. stay in your lane, literally.
• -s, --apparent-size — use file length instead of blocks.
• -r, --reverse — print tree upside down (biggest highest). chaotic but valid 🙈
• -c, --no-colors — no colors will be printed. useful for commands like: watch. (yes, she wrote it with a colon, we respect it)
• -C, --force-colors — force colors print. colors ON, no discussion 🌈
• --dim — dim the percent bars (grey) to reduce brightness on dark terminals. dark mode girlies rise 🙏
• -b, --no-percent-bars — no percent bars or percentages will be displayed. bars? gone. percentages? also gone.
• -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. the hidden ones stay hidden 🤫
• -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. no spinner, just vibes.
• --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, bestie. the walker no longer recurses so a custom stack size is unnecessary. accepted for compatibility but the value is ignored. she's just being polite to your old scripts 💀
• -j, --output-json — output the directory tree as json to the current directory. json girlies, this one's for you 🧚
• -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 => (𝑐𝑢𝑟𝑟−𝑛, +∞). (math jumpscare but we move 💜)
• -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. this is where you point her at your stuff 🌸

---

✨ VERSION ✨

v1.2.6

---

and that's the whole page, bestie!! 🎀 that footer energy? Dust 1.2.6, from Dust(1) in the General Commands Manual, version v1.2.6 — yeah she's serving. now go run her and go find out what's eating your disk. mwah 💋💖