Skip to main content
Help us improve PyPI by participating in user testing. All experience levels needed!

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 Bitbucket:

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

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


Although the software is ready, the packaging is still experimental. If you have any issues or suggestion, please contact the authors.

Project details

Release history Release notifications

This version
History Node

History Node

History Node

History Node

History Node

History Node


Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page