Skip to main content
Warning: You are using the test version of PyPI. This is a pre-production deployment of Warehouse. Changes made here affect the production instance of TestPyPI (
Help us improve Python packaging - Donate today!

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.

Release History

This version
History Node

History Node

History Node

Download Files

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

File Name & Hash SHA256 Hash Help Version File Type Upload Date
(9.4 kB) Copy SHA256 Hash SHA256
py2.py3 Wheel Feb 13, 2016

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting