pydf(1)

pydf1

Report colourised filesystem disk space usage

Usage

pydf [options] [file]

Overview

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.

Options

--help

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

--block-size=SIZE

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

--blocks

use filesystem native block size

--bw

do not use colours

--mounts=FILE

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.

Files

/etc/pydfrc

main configuration file

~/.pydfrc

per-user configuration file

Releases

12 releases since Debian 2.2 (Potato); the text changed 6 times.

  1. 2.2
  2. 3.0–3.1
  3. 4.0
  4. 5.0
  5. 6.0–10
  6. 13
  7. Arch

--gigabytes since Debian 4.0 (Etch); --inodes since Debian 6.0 (Squeeze); --show-binds since Debian 5.0 (Lenny); -B since Debian 5.0 (Lenny); -g since Debian 4.0 (Etch); -i since Debian 6.0 (Squeeze); -v since Debian 5.0 (Lenny).

Bugs

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).

Author

Radovan Garabík <[email protected]>

From pydf 12-5 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.