pydf man page

pydf — report colourised filesystem disk space usage


pydf [options] [file]


pydf is a python script that displays the amount of disk space available  on the mounted filesystems, using different colours for different  types of filesystems. Output format is completely customizable.

If an optional

file argument is given, pydf displays just information about filesystem  containing the file(s), otherwise it displays information about all mounted filesystems.



Show summary of options.

-v, --version

Show version of program.

-a, --all

include filesystems having 0 blocks

-h, --human-readable

print sizes in human readable format (e.g., 133K 2341M 2448G)

-H, --si

likewise, but use powers of 1000 not 1024


use SIZE-byte blocks

-k, --kilobytes

like --block-size=1024

-i, --inodes

show information about inodes instead of blocks

-l, --local

limit listing to local filesystems

-m, --megabytes

like --block-size=1048576

-g, --gigabytes

like --block-size=1073741824


use filesystem native block size


do not use colours


file to get mount information from. On normal linux system, only /etc/mtab or /proc/mounts make sense. Use /proc/mounts when /etc/mtab is corrupted or inaccessible  (the output looks a bit weird in this case though)

-B, --show-binds

Show also mount --bind mounted filesystems.


When running with python3, mountpoints with out-of-locale non ASCII  names will not be displayed (due to inability of os.statvfs to use bytes instead of strings).



main configuration file


per-user configuration file

See Also



Radovan Garabík <>