dua (-> Disk Usage Analyzer) is a tool to conveniently learn about the usage of disk space of a given directory. It's parallel by default and will max out your SSD, providing relevant information as fast as possible. Optionally delete superfluous data, and do so more quickly than rm.
Run dua i to launch the interactive mode for exploring and deleting files.
Installation
Binary Release
MacOS
curl -LSfs https://raw.githubusercontent.com/Byron/dua-cli/master/ci/install.sh | \
sh -s -- --git Byron/dua-cli --crate dua
sudo port selfupdate
sudo port install dua-cli
brew update
brew install dua-cli
Linux
Linux requires the target to be specified explicitly to obtain the MUSL build.
curl -LSfs https://raw.githubusercontent.com/Byron/dua-cli/master/ci/install.sh | \
sh -s -- --git Byron/dua-cli --target x86_64-unknown-linux-musl --crate dua
Windows via Scoop
scoop install dua
winget install Byron.dua-cli
Pre-built Binaries
See the releases section for manual installation of a binary, pre-built for many platforms.
Release archives include build provenance attestations. After downloading an archive, verify that it
was built by this repository with the GitHub CLI:
gh attestation verify ./dua-v2.39.1-aarch64-apple-darwin.tar.gz --repo Byron/dua-cli
Cargo
Via cargo, which can be obtained using rustup
For Unix…
cargo install dua-cli
# And if you don't need a terminal user interface (most compatible)
cargo install dua-cli --no-default-features
# Compiles on most platforms, with terminal user interface
cargo install dua-cli --no-default-features --features tui-crossplatform
For Windows, nightly features are currently required.
cargo +nightly install dua-cli
VoidLinux
Via xbps on your VoidLinux system.
xbps-install dua-cli
Fedora
Via dnf on your Fedora system.
sudo dnf install dua-cli
Arch Linux
Via pacman on your ArchLinux system.
sudo pacman -S dua-cli
NixOS
https://search.nixos.org/packages?query=dua
Nix-shell (temporary)
nix-shell -p dua
NixOS configuration
environment.systemPackages = [
pkgs.dua
];
NetBSD
Via pkgin on your NetBSD system.
pkgin install dua-cli
Or, building from source
cd /usr/pkgsrc/sysutils/dua-cli
make install
Windows
You will find pre-built binaries for Windows in the releases section.
Alternatively, install via cargo as in
cargo +nightly install dua-cli
x-cmd
x-cmd is a toolbox for Posix Shell, offering a lightweight package manager built using shell and awk.
x env use dua
- Additionally, the
x dua ... command is available, which automatically installs dua without affecting the environment, such as not modifying the PATH variable.
Usage
# count the space used in the current working directory
dua
# count the space used in all directories that are not hidden
dua *
# learn about additional functionality
dua aggregate --help
On macOS, the --deduplicate-apfs-clones traversal option counts fully shared
APFS file clones only once in aggregate and interactive runs. It is opt-in
because collecting the additional metadata reduces traversal performance.
Files that share only some blocks are not deduplicated, and --apparent-size
still reports each file's logical length.
Tree output
By default aggregate prints a flat listing. Pass --depth N to instead print an indented tree
that descends N levels into each input, which is handy for sharing a disk-usage report without
opening interactive mode. The inputs form the first level, so --depth 1 lists just them, the same
set of entries the flat listing shows.
# show each top-level entry and one level below it
dua aggregate --depth 2
--no-sort and --no-total work the same way they do for the flat listing.
Excluding paths with a pattern file
--ignore-from FILE reads gitignore-style patterns and leaves everything they match out of the
report, in both aggregate and interactive mode. This is the --exclude-from of rsync and the
--exclude-file of restic, so the same file can answer "how much of this would actually get
backed up?".
cat .duaignore
# /target/
# **/node_modules/
# *.log
# !important.log
dua --ignore-from .duaignore
Patterns follow .gitignore syntax - # comments, a trailing / to match directories only, a
leading / to anchor to the current working directory or the traversal root, ** to span directories,
and ! to re-include something an earlier pattern excluded. They match the paths dua reports,
which are relative to the directory being looked at, and matching is case-sensitive on every platform.
The option can be given more than once, in which case later files win over earlier ones, and it
can also be set through DUA_IGNORE_FROM. Excluded directories are not descended into at all, so
their contents cannot be re-included - the same restriction Git has.
This is the beginning of the README. Read the rest at the original. Read the full README ↗
