DUF(1)

✨ DUF(1) — Disk Usage/Free Utility ✨

okay bestie, welcome to the duf manual page, aka your new favorite little terminal tool 💖 (yes the manual name is literally right there in the title, i gotchu)

---

🌸 NAME 🌸

duf — Disk Usage/Free Utility

---

🦋 SYNOPSIS 🦋

duf [options...] [argument...]

---

💜 DESCRIPTION 💜

It's a Simple Disk Usage/Free Utility. that's the whole vibe. no cap. 🫶

Features: (aka the reasons you're gonna be obsessed)

• User-friendly, colorful output. 🌈
• Adjusts to your terminal's theme & width. it literally matches your fit ✨
• Sort the results according to your needs. your data, your rules 👑
• Groups & filters devices.
• Can conveniently output JSON. for my scripting girlies 💅

---

🎀 OPTIONS 🎀

• -all — include pseudo, duplicate, inaccessible file systems 👀 the whole extended fam
• -avail-threshold — specifies the coloring threshold (yellow, red) of the avail column, must be integer with optional SI prefixes
• -hide — hide specific devices, separated with commas: local, network, fuse, special, loops, binds
• -hide-fs — hide specific filesystems, separated with commas
• -hide-mp — hide specific mount points, separated with commas (supports wildcards) 🃏
• -inodes — list inode information instead of block usage
• -json — output all devices in JSON format 📦
• -only — show only specific devices, separated with commas: local, network, fuse, special, loops, binds
• -only-fs — only specific filesystems, separated with commas
• -only-mp — only specific mount points, separated with commas (supports wildcards)
• -output — output fields: mountpoint, size, used, avail, usage, inodes, inodes_used, inodes_avail, inodes_usage, type, filesystem
• -sort — sort output by: mountpoint, size, used, avail, usage, inodes, inodes_used, inodes_avail, inodes_usage, type, filesystem
• -style — style: unicode, ascii
• -theme — color themes: dark, light, ansi
• -usage-threshold — specifies the coloring threshold (yellow, red) of the usage bars as a floating point number from 0 to 1
• -version — display version
• -warnings — output all warnings to STDERR
• -width — max output width

---

🌈 USAGE 🌈

You can simply start duf without any command-line arguments, no thoughts head empty, just vibes:

$ duf

If you supply arguments, duf will only list specific devices & mount points:

$ duf /home /some/file

If you want to list everything (including pseudo, duplicate, inaccessible file systems) — yes, everything, go feral:

$ duf --all

You can show and hide specific tables:

$ duf --only local,network,fuse,special,loops,binds

$ duf --hide local,network,fuse,special,loops,binds

You can also show and hide specific filesystems:

$ duf --only-fs tmpfs,vfat

$ duf --hide-fs tmpfs,vfat

...or specific mount points:

$ duf --only-mp /,/home,/dev

$ duf --hide-mp /,/home,/dev

Wildcards inside quotes work 🃏 (the quotes are doing the heavy lifting here, fr fr):

$ duf --only-mp '/sys/*,/dev/*'

Sort the output:

$ duf --sort size

Valid keys are: mountpoint, size, used, avail, usage, inodes, inodes_used, inodes_avail, inodes_usage, type, filesystem.

Show or hide specific columns:

$ duf --output mountpoint,size,usage

Valid keys are: mountpoint, size, used, avail, usage, inodes, inodes_used, inodes_avail, inodes_usage, type, filesystem.

List inode information instead of block usage:

$ duf --inodes

If duf doesn't detect your terminal's colors correctly, you can set a theme:

$ duf --theme light

duf highlights the availability & usage columns in red, green, or yellow, depending on how much space is still available. You can set your own thresholds:

$ duf --avail-threshold="10G,1G"

$ duf --usage-threshold="0.5,0.9"

If you prefer your output as JSON 📦:

$ duf --json

---

🧚 NOTES 🧚

Portions of duf's code are copied and modified from https://github.com/shirou/gopsutil.

gopsutil was written by WAKAYAMA Shirou and is distributed under BSD-3-Clause.

---

👑 AUTHORS 👑

duf was written by Christian Muehlhaeuser <https://github.com/muesli/duf>

---

💖 COPYRIGHT 💖

Copyright (C) 2020-2022 Christian Muehlhaeuser <https://github.com/muesli>

Released under MIT license.

---

periodt. that's the whole page, bestie 🎀 go check your disk space and slay 💅

okay so this was duf (the Disk Usage/Free Utility), page dated 2025-09-08, and the version string at the bottom of the og page was just duf — so shoutout to duf, 2025-09-08, and the whole DUF(1) crew 🫶 bye bestie!! 💜✨