Skip to main content

Human-friendly summary of disk usage.

Project description

This software computes an estimate of the file disk usage for files and directories, similarly to the UNIX program ‘du’. The result is then displayed to the console in a human friendly format.

It includes the following features:

  • a progress bar of each item for quick visual inspection

  • percentage information (precision can be set)

  • show the size of each item in the specified units

  • support for SI, IEC and UNIX (‘du’) units

  • maximum depth (of the displayed items) can be specified

  • optionally follow symlinks, mount points, special files and hidden files

  • can filter results to display only directories

  • can output results ending with ‘\0’ instead of newlines (useful for parsing)

  • can sort results by name or by size


The recommended way of installing the software is through PyPI:

$ pip install hdu

Alternatively, you can the clone the source repository from GitHub:

$ mkdir hdu
$ cd hdu
$ git clone
$ python install

(last step may require additional permissions depending on your configuration)

The shoftware does not have additional dependencies beyond Python and its standard library.

It was tested with Python 2.7 and 3.5. Other version were not tested.


Although the software is ready, the packaging is still experimental. If you experience any issues, please consider reporting it. Suggestions and improvements are welcome!

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distribution

hdu- (10.1 kB view hashes)

Uploaded Python 2 Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page