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
curl -LSfs https://raw.githubusercontent.com/byron/dua-cli/master/ci/install.sh | \ sh -s -- --git byron/dua-cli --crate dua
See the releases section for manual installation.
cargo, which can be obtained using rustup
cargo install dua-cli
xbps on your VoidLinux system.
dnf on your Fedora system.
sudo dnf install dua-cli
pacman on your ArchLinux system.
sudo pacman -S dua-cli
You will find pre-built binaries for Windows in the releases section. Please note that
dua interactive only works on nushell and xonsh with Alacritty as terminal emulator.
# 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
Launch into interactive mode with the
interactive subcommand. Get help on keyboard shortcuts with
?. Use this mode to explore, and/or to delete files and directories to release disk space.
Please note that great care has been taken to prevent accidential deletions due to a multi-stage process, which makes this mode viable for exploration.
dua i dua interactive
Learn about other targets
Thanks to jwalk, all there was left to do is to write a command-line interface. As
jwalk matures, dua should benefit instantly.
- Does not show symbolic links at all if no path is provided when invoking
- in an effort to skip symbolic links, for now there are pruned and are not used as a root. Symbolic links will be shown if they are not a traversal root, but will not be followed.
- Interactive mode only looks good in dark terminals (see this issue)
- easy fix: file names in main window are not truncated if too large. They are cut off on the right.
- There are plenty of examples in
tests/fixtureswhich don't render correctly in interactive mode. This can be due to graphemes not interpreted correctly. With Chinese characters for instance, column sizes are not correctly computed, leading to certain columns not being shown. In other cases, the terminal gets things wrong - I use alacritty, and with certain characaters it performs worse than, say iTerm3. See https://github.com/minimaxir/big-list-of-naughty-strings/blob/master/blns.txt for the source.
- In interactive mode, you will need about 60MB of memory for 1 million entries in the graph.
- In interactive mode, the maximum amount of files is limited to 2^32 - 1 (
u32::max_value() - 1) entries.
- One node is used as to 'virtual' root
- The actual amount of nodes stored might be lower, as there might be more edges than nodes, which are also limited by a
- The limitation is imposed by the underlying
petgraphcrate, which declares it as
unsafeto use u64 for instance.
- It's possibly UB when that limit is reached, however, it was never observed either.
- Dedication to
- we use
termionexlusively, and even though
tuisupports multiple backends, we only support its termion backend. Reason:
tuiis only used for parts of the program, and in all other parts
termionis used for coloring the output. Thus we wouldn't support changing to a different backend anyway unless everything is done with TUI, which is really not what it is made for.
- we use