Skip to main content

Command line disk space visualization tool

Project description

What is duviz? is a simple command line utility written in Python to visualize disk space usage.

It’s like the plethora of desktop applications and widgets (e.g. Filelight, DaisyDisk, WinDirStat, JDiskReport, TreeSize, SpaceSniffer, …), but instead of a fancy GUI with animated pie charts and shaded boxes you get a funky “ASCII art style hierarchical tree of bars”. If that didn’t make a lot of sense to you, look at this example of my /opt folder:

$ /opt
[                                     /opt                                     ]
[                                    local                                     ]
[              var              ][        lib         ][ share  ][Libr][lib][]|
[           macports           ]|[gcc][gcc4][]|||      [][]||||||[Fra]|[gc] |
[____________1.36GB____________]|[250][226.][]|||      [][]||||||[231]|[21] |
[    software    ][distfile][]| |           ||  |      | ||||||||[Pyt] [x8]
[____785.31MB____][421.56MB][]| |           ||  |      | ||||||||[231] [21]
[gc][][]||||||||||||||||||||[]               |            ||| |  [Ve]  ||[]
[17][][]||||||||||||||||||||[]               |            ||| |  [23]  ||[]

Instead of size in bytes, you can also get inode usage: just use the option -i.

How does it work?

The script dispatches the heavy work to the UNIX utility du to gather disk space statistics, parses its output and renders this information in an easily understandable ASCII-art image.

For inode counting a recursive ls -i is used instead of du.


Dependencies is designed to run on UNIX platforms (like Linux and OS X), where its dependencies (a Python 2.x or 3.x interpreter and the du utility) are typically available out of the box, so nothing to do on this front. Yay. On Windows you’ll be sad probably.
Run it is a standalone script, you can store it and run it from where ever you want.
To have it easily at your service (without having to remember the script’s full path): copy or symlink the script to a folder in your $PATH. If you don’t know what this means, ask a UNIX guru near you.


If you run without arguments, it will render the disk usage of the current working folder.

If you specify one or more directories, it will render the usage of those directories, how intuitive is that!

Run it with option --help for more options.

Project details

Release history Release notifications

This version
History Node


Download files

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

Filename, size & hash SHA256 hash help File type Python version Upload date
duviz-1.1.0-py2.py3-none-any.whl (9.5 kB) Copy SHA256 hash SHA256 Wheel py2.py3
duviz-1.1.0.tar.gz (7.1 kB) Copy SHA256 hash SHA256 Source None

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