Repository files navigation

Disk Usage/Free Utility (Linux, BSD, macOS & Windows)

• User-friendly, colorful output
• Adjusts to your terminal's theme & width
• Sort the results according to your needs
• Groups & filters devices
• Can conveniently output JSON

• Arch Linux:pacman -S duf
• Ubuntu (22.04 and later) / Debian (12 and later):apt install duf
• Fedora Linux:dnf install duf
• Nix:nix-env -iA nixpkgs.duf
• Void Linux:xbps-install -S duf
• Gentoo Linux:emerge sys-fs/duf
• Solus:eopkg it duf
• Packages in Alpine, Debian & RPM formats

• FreeBSD:pkg install duf
• OpenBSD:pkg_add duf

• withHomebrew:brew install duf
• withMacPorts:sudo port selfupdate && sudo port install duf

• withChocolatey:choco install duf
• withscoop:scoop install duf

• Android (via termux):pkg install duf

• Binaries for Linux, FreeBSD, OpenBSD, macOS, Windows

Make sure you have a working Go environment (Go 1.23 or higher is required).See theinstall instructions.

Compiling duf is easy, simply run:

git clone https://github.com/muesli/duf.gitcd dufgo build

You can simply start duf without any command-line arguments:

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

duf --all

You can show and hide specific tables:

duf --only local,network,fuse,special,loops,bindsduf --hide local,network,fuse,special,loops,binds

You can also show and hide specific filesystems:

duf --only-fs tmpfs,vfatduf --hide-fs tmpfs,vfat

...or specific mount points:

duf --only-mp /,/home,/devduf --hide-mp /,/home,/dev

Wildcards inside quotes work:

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

Users ofoh-my-zsh should be aware that it already defines an alias calledduf, which you will have to remove in order to useduf:

unalias duf

Got some feedback or suggestions? Please open an issue or drop me a note!

• Twitter
• The Fediverse