Skip to main content
Join the official Python Developers Survey 2018 and win valuable prizes: Start the survey!

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

Supported by

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