#du #command-line #disk #disk-usage

app du-dust

A more intuitive version of du

20 unstable releases (6 breaking)

0.8.0 Feb 26, 2022
0.7.0 Sep 19, 2021
0.6.2 Aug 5, 2021
0.6.1 Jul 19, 2021
0.3.1 May 9, 2018

#23 in Command line utilities

Download history 584/week @ 2022-03-11 523/week @ 2022-03-18 455/week @ 2022-03-25 406/week @ 2022-04-01 550/week @ 2022-04-08 395/week @ 2022-04-15 494/week @ 2022-04-22 466/week @ 2022-04-29 444/week @ 2022-05-06 671/week @ 2022-05-13 352/week @ 2022-05-20 436/week @ 2022-05-27 463/week @ 2022-06-03 348/week @ 2022-06-10 317/week @ 2022-06-17 233/week @ 2022-06-24

1,430 downloads per month

Apache-2.0

90KB
1.5K SLoC

Build Status

Dust

du + rust = dust. Like du but more intuitive.

Why

Because I want an easy way to see where my disk is being used.

Demo

Example

Install

Cargo Packaging status

  • cargo install du-dust

🍺 Homebrew (Mac OS)

  • brew install dust

🍺 Homebrew (Linux)

  • brew tap tgotwig/linux-dust && brew install dust

Pacstall (Debian/Ubuntu)

  • pacstall -I dust-bin

Windows:

  • Windows GNU version - works
  • Windows MSVC - requires: VCRUNTIME140.dll

Download

  • Download Linux/Mac binary from Releases
  • unzip file: tar -xvf _downloaded_file.tar.gz
  • move file to executable path: sudo mv dust /usr/local/bin/

Overview

Dust is meant to give you an instant overview of which directories are using disk space without requiring sort or head. Dust will print a maximum of one 'Did not have permissions message'.

Dust will list a slightly-less-than-the-terminal-height number of the biggest subdirectories or files and will smartly recurse down the tree to find the larger ones. There is no need for a '-d' flag or a '-h' flag. The largest subdirectories will be colored.

The different colors on the bars: These represent the combined tree hierarchy & disk usage. The shades of grey are used to indicate which parent folder a subfolder belongs to. For instance, look at the above screenshot. .steam is a folder taking 44% of the space. From the .steam bar is a light grey line that goes up. All these folders are inside .steam so if you delete .steam all that stuff will be gone too.

Usage

Usage: dust
Usage: dust <dir>
Usage: dust <dir>  <another_dir> <and_more>
Usage: dust -p (full-path - Show fullpath of the subdirectories)
Usage: dust -s (apparent-size - shows the length of the file as opposed to the amount of disk space it uses)
Usage: dust -n 30 (shows 30 directories instead of the default [default is terminal height])
Usage: dust -d 3  (shows 3 levels of subdirectories)
Usage: dust -r  (reverse order of output)
Usage: dust -X ignore  (ignore all files and directories with the name 'ignore')
Usage: dust -x (only show directories on the same filesystem)
Usage: dust -b (do not show percentages or draw ASCII bars)
Usage: dust -i (do not show hidden files)
Usage: dust -c (No colors [monochrome])
Usage: dust -f (Count files instead of diskspace)
Usage: dust -t Group by filetype
Usage: dust -e regex Only include files matching this regex (eg dust -e "\.png$" would match png files)

Alternatives

Note: Apparent-size is calculated slightly differently in dust to gdu. In dust each hard link is counted as using file_length space. In gdu only the first entry is counted.

Dependencies

~4.5MB
~98K SLoC