LinuxCommandLibrary

dust

Visualize disk space usage

TLDR

Display information for the current directory

$ dust
copy

Display information about one or more directories
$ dust [path/to/directory1 path/to/directory2 ...]
copy

Display 30 directories (defaults to 21)
$ dust --number-of-lines 30
copy

Display information for the current directory, up to 3 levels deep
$ dust --depth 3
copy

Display the biggest directories at the top in descending order
$ dust --reverse
copy

Ignore all files and directories with a specific name
$ dust --ignore-directory [file_or_directory_name]
copy

Do not display percent bars and percentages
$ dust --no-percent-bars
copy

SYNOPSIS

dust [OPTIONS] [PATH]

PARAMETERS

-d, --depth
    Maximum recursion depth. Defaults to no limit.

-h, --help
    Prints help information.

-n, --number
    Number of rows to display. Defaults to terminal height.

-s, --sort
    Sort order. Valid values: name, size, mtime. Defaults to size.

-r, --reverse
    Reverse sort order.

-v, --version
    Prints version information.

[PATH]
    Path to analyze. Defaults to current directory.

DESCRIPTION

dust is a command-line tool that provides a highly interactive and visually appealing way to analyze disk usage. Unlike traditional tools like du, dust focuses on presenting the information in a human-readable and navigable format within the terminal. It allows users to quickly identify which directories and files are consuming the most disk space, making it easy to understand and manage storage on their systems.

dust offers interactive features like keyboard navigation and filtering, enabling users to drill down into specific directories of interest. It employs a modern approach to disk usage visualization, prioritizing speed and ease of use. By offering a more engaging and insightful experience, dust helps users to efficiently manage disk space and optimize storage utilization. It is particularly helpful for situations where a quick and informative overview of disk usage is needed, replacing cumbersome text-based outputs with intuitive graphical representations.

CAVEATS

dust relies on fast file system traversal and can potentially impact system performance when analyzing large directories with millions of files. The visual representation is optimized for terminal environments and may not translate directly to other output formats.

INTERACTIVE NAVIGATION

dust allows interactive navigation using the arrow keys. Up and down arrow keys select items in the list, and pressing 'Enter' or the right arrow key drills down into the selected directory. The left arrow key navigates back up to the parent directory.

FILTERING

You can filter the displayed items by typing a search string. Only items whose names contain the string will be displayed. Pressing 'Esc' clears the filter.

SEE ALSO

du(1), df(1), ncdu(1)

Copied to clipboard