PYDF(1)

💾 PYDF — like df but make it fashion 💅

okay bestie, gather round, because pydf is about to become your new main character. it's a little program (from the General Commands Manual section, iykyk) that tells you how much disk space is left on your mounted filesystems, and it does it in colours, one colour per filesystem type, because we deserve nice things. 🎀

---

✨ NAME ✨

pydf — report colourised filesystem disk space usage 🦋

---

🫶 SYNOPSIS 🫶

pydf [options] [file]

---

💖 DESCRIPTION 💖

pydf is a python script, no cap. it shows you how much disk space is available on all your mounted filesystems, and it uses different colours for different types of filesystems so you can tell them apart at a glance. and the best part? the output format is completely customizable. you can make it look however you want. obsessed. ✨

and like, if you pass it an optional file argument? it stops doing the whole-everything thing and just shows you info about the filesystem(s) that contain that file (or those files). no file argument, no problem — then it shows you info about all mounted filesystems. periodt. 💅

---

🌸 OPTIONS 🌸

• --help — shows you a lil summary of the options. your cheat sheet bestie. 📝
• -v, --version — shows the version of the program. flex the build. 👑
• -a, --all — include filesystems that have 0 blocks. yes, even the empty ones. nobody gets left out. 🫶
• -h, --human-readable — prints sizes in human readable format (e.g., 133K 2341M 2448G). for when you don't wanna read raw numbers like a calculator. 😭
• -H, --si — likewise, but use powers of 1000 not 1024. metric girlies rise. 🌈
• --block-size=SIZE — use SIZE-byte blocks. you pick the unit, you're the boss. 💅
• -k, --kilobytes — like --block-size=1024. ✨
• -i, --inodes — show information about inodes instead of blocks. different metric, same drama. 🦋
• -l, --local — limit the listing to local filesystems only. no network nonsense today. 🚫
• -m, --megabytes — like --block-size=1048576. 💖
• -g, --gigabytes — like --block-size=1073741824. big numbers energy. 🔥
• --blocks — use the filesystem's native block size. au naturel. 🌿
• --bw — do not use colours. (sad, but sometimes you need it. it's giving monochrome.) 💀
• --mounts=FILE — the file to get mount information from. on a normal linux system, only /etc/mtab or /proc/mounts make sense. use /proc/mounts when /etc/mtab is corrupted or inaccessible — though ngl, the output looks a bit weird in this case. 🙈
• -B, --show-binds — also show mount --bind mounted filesystems. show me everything. 👀
• -S, --scale-bars — show bar sizes scaled to the largest filesystem size. proportional slay. 📊

---

💀 BUGS 💀

okay so this is the messy part, and you need to know it.

POSIX mandates that f_blocks and f_bfree be the number in units of f_frsize. however — and this is the tea ☕ — many programs are buggy, including df(1) from coreutils, and the Linux kernel often lies and reports f_frsize == f_bsize. some filesystems and some other operating systems don't do that, and when that happens, the size reported by pydf is incorrect. 😭

as a stopgap measure, there's a parameter called statvfs_block in /etc/pydfrc where you can force f_frsize or f_bsize. use it. trust. 🫶

---

🎀 FILES 🎀

• /etc/pydfrc — main configuration file 👑
• ~/.pydfrc — per-user configuration file 💅

---

🔥 SEE ALSO 🔥

• df(1) — the classic. we still love her. 🫶

---

💜 AUTHOR 💜

Radovan Garabík <garabik@kassiopeia.juls.savba.sk> — thank you for this gift, king. 🙏✨

---

and that's the whole vibe check, bestie. this page lives in the General Commands Manual section and it's filed under PYDF(1) — so go forth, run pydf, and admire your filesystems in full colour. 🌈💖 no cap, you're gonna be obsessed. 🎀🦋💅