pdu – parallel disk usage utility

Parallel Disk Usage (pdu) is a highly parallelized, fast directory tree analyzer.

This is a CLI program that renders a graphical chart for disk usages of files and directories

pdu is free and open source software.

Key Features

• Fast.
• Relative comparison of separate files.
• Extensible via the library crate or JSON interface.
• Optional progress report.
• Customize tree depth.
• Customize chart size.

Website: github.com/KSXGitHub/parallel-disk-usage
Support:
Developer: Hoàng Văn Khải
License: Apache License 2.0

USAGE:
    pdu [FLAGS] [OPTIONS] [--] [files]...

FLAGS:
    -h, --help             
            Prints help information

        --json-input       
            Read JSON data from stdin

        --json-output      
            Print JSON data instead of an ASCII chart

        --no-sort          
            Preserve order of entries

        --progress         
            Report progress being made at the expense of performance

        --silent-errors    
            Prevent filesystem error messages from appearing in stderr

        --top-down         
            Print the tree top-down instead of bottom-up

    -V, --version          
            Prints version information


OPTIONS:
        --bytes-format 
            How to display the numbers of bytes [default: metric]  [possible values: plain, metric, binary]

        --column-width      
            Maximum widths of the tree column and width of the bar column

        --max-depth 
            Maximum depth to display the data (must be greater than 0) [default: 10]

        --min-ratio                     
            Minimal size proportion required to appear [default: 0.01]

        --quantity 
            Aspect of the files/directories to be measured [default: len]  [possible values: len, blksize, blocks]

        --total-width                 
            Width of the visualization


ARGS:
    ...    
            List of files and/or directories


EXAMPLES:
    Show disk usage chart of current working directory
    $ pdu

    Show disk usage chart of a single file or directory
    $ pdu path/to/file/or/directory

    Compare disk usages of multiple files and/or directories
    $ pdu file.txt dir/

    Show chart in block sizes instead of apparent sizes
    $ pdu --quantity=blksize

    Show data in plain numbers instead of metric units
    $ pdu --bytes-format=plain

    Show data in base 2¹⁰ units (binary) instead of base 10³ units (metric)
    $ pdu --bytes-format=binary

    Show disk usage chart of all entries regardless of size
    $ pdu --min-ratio=0

    Only show disk usage chart of entries whose size is at least 5% of total
    $ pdu --min-ratio=0.05

    Show disk usage data as JSON instead of chart
    $ pdu --min-ratio=0 --json-output | jq

    Visualize existing JSON representation of disk usage data
    $ pdu --min-ratio=0 < disk-usage.json

pdu is written in Rust. Learn Rust with our recommended free books and free tutorials.

Related Software

Read our verdict in the software roundup.

Explore our comprehensive directory of recommended free and open source software. Our carefully curated collection spans every major software category. This directory is part of our ongoing series of informative articles for Linux enthusiasts. It features hundreds of detailed reviews, along with open source alternatives to proprietary solutions from major corporations such as Google, Microsoft, Apple, Adobe, IBM, Cisco, Oracle, and Autodesk. You’ll also find interesting projects to try, hardware coverage, free programming books and tutorials, and much more. Discovered a useful open source Linux program that we haven’t covered yet? Let us know by completing this form.