Repository files navigation

Highly parallelized, blazing fast directory tree analyzer.

pdu is a CLI program that renders a graphical chart for disk usages of files and directories, it is an alternative todust anddutree.

The benchmark was generated bya GitHub Workflow and uploaded to the release page.

(See more)

• Very fast.
• Relative comparison of separate files.
• Extensible via the library crate or JSON interface.
• Unbiased regarding hardlinks: All hardlinks are treated as equally real.
• Optional hardlink detection and deduplication (would makepdu proportionally slower).
• Optional progress report (would makepdu slightly slower).
• Customize tree depth.
• Customize chart size.

• Ignorant of reflinks (from COW filesystems such as BTRFS and ZFS).
• Do not follow symbolic links.
• Do not differentiate filesystem: Mounted folders are counted as normal folders.
• The runtime is optimized at the expense of binary size.

• cargo

./test.sh&& ./test.sh --release

./run pdu"${arguments[@]}"

• "${arguments[@]}": List of arguments to pass topdu.

cargo build --bin pdu

The resulting executable is located attarget/debug/pdu.

cargo build --bin pdu --release

The resulting executable is located attarget/release/pdu.

./generate-completions.sh

Theparallel-disk-usage crate is both a binary crate and a library crate. If you desire features thatpdu itself lacks (that is, after you have asked the maintainer(s) ofpdu for the features but they refused), you may use the library crate to build a tool of your own. The documentation for the library crate can be found indocs.rs.

Alternatively, thepdu command provides--json-input flag and--json-output flag. The--json-output flag converts disk usage data into JSON and the--json-input flag turns said JSON into visualization. These 2 flags allow integration with other CLI tools (via pipe, as per the UNIX philosophy).

Beware that the structure of the JSON tree differs depends on the number of file/directory names that were provided (as CLI arguments):

• If there are only 0 or 1 file/directory names, the name of the tree root would be a real path (either. or the provided name).
• If there are 2 or more file/directory names, the name of the tree root would be(total) (which is not a real path), and the provided names would correspond to the children of the tree root.

Go to theGitHub Release Page and download a binary.

Prerequisites:

• cargo

cargo install parallel-disk-usage --bin pdu

sudo pacman -S parallel-disk-usage

• CLI:
  • du
  • dust
  • dutree
  • dua
• TUI:
  • ncdu
  • gdu
  • godu
• GUI:
  • GNOME's Disk Usage Analyzer, a.k.a.baobab
  • Filelight

Apache 2.0 ©Hoàng Văn Khải.