What is duviz?
duviz
is a (Python 3) command-line tool 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" in your shell.
If that didn't make a lot of sense to you, look at this example of this /opt
folder:
$ duviz /opt ________________________________________________________________________________ [ /opt ] [____________________________________3.30GB____________________________________] [ local ] [____________________________________3.30GB____________________________________] [ var ][ lib ][ share ][Libr][lib][]| [_____________1.36GB____________][______925.47MB______][411.37MB][231.][222][]| [ 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] ||[]
Features
- Basically it consists of just one Python 3 script
duviz.py
. No installation required: put it where you want it. Use it how you want it. - Only uses standard library and just depends on
du
andls
utilities, which are available out of the box on a typical Unix platform (Linux, macOS) - Speed. No need to wait for a GUI tool to get up and running, let alone scanning your disk.
The hard work is done by
du
(orls
), which run an C-speed. - Progress reporting while you wait. Be hypnotized!
- Detects your terminal width for maximum visualization pleasure.
- Apart from file size (the default), you can also just count files (inodes)
- Option to use terminal colors for the boxes instead of ASCII art
Installation
- With Pip
duviz
can be installed throughpip
(e.g. in a virtual env):pip install duviz
which will install the
duviz
utility to the correspondingbin
folder.- With Homebrew
duviz
can also be installed with Homebrew:brew install https://raw.github.com/soxofaan/duviz/master/extra/homebrew/duviz.rb
- No installation
The file
duviz.py
is also intended to be usable as a standalone Python script, without having to install it. Downloadduviz.py
to some location of your liking and run it:python path/to/duviz.py
Python 2 Support
duviz
was originally (2009) a Python 2 script, and started supporting Python 3 around 2016.
With the end of life of Python 2 nearing in 2019, support for Python 2 was dropped.
The Python 2 compatible version can be found in the py2-compatible
branch (last release: 1.1.1).
Usage
If you run duviz
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!
Instead of size in bytes, you can also get inode usage: just use the option --inodes
(or -i
in short).
Run it with option --help
for more options.