muesli /duf

Disk Usage/Free Utility - a better 'df' alternative

★ 15,385⑂ 476👁 84⑃ 228● 147▤ 14
GoNOASSERTIONCreated 2020-09-20
下载:v0.9.1v0.9.1 ↓0.9.12025-09-08
+0
日增长
15,385
stars
476
forks
84
watchers
228
prs
147
issues
14
releases

README

duf







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

!duf

 Features

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

 Installation

 Packages

 Linux
- 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

 BSD
- FreeBSD: pkg install duf
- OpenBSD: pkg_add duf

 macOS
- with Homebrew: brew install duf
- with MacPorts: sudo port selfupdate && sudo port install duf

 Windows
- with Chocolatey: choco install duf
- with scoop: scoop install duf

 Android
- Android (via termux): pkg install duf

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

 From source

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

Compiling duf is easy, simply run:

    git clone https://github.com/muesli/duf.git
    cd duf
    go build

 Usage

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

 Filtering

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:

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

 Display options

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

 Color-coding & Thresholds

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"

 Bonus

If you prefer your output as JSON:

    duf --json

 Troubleshooting

Users of oh-my-zsh should be aware that it already defines an alias called
duf, which you will have to remove in order to use duf:

    unalias duf

 Feedback

Got some feedback or suggestions? Please open an issue or

Top issues

Discussions

Latest release

v0.9.1 v0.9.1 2025-09-08
Changelog
 2f48dc59d3f7259048817cab4471b419b0aab49d fix: allow manually supplying version/commit again
 959c8e18e248a63fbc64e4bd2520e8276a79de70 fix: include version number in tarballs
 b2f01a1ecbfd1af63015b83296c50a95260f97b1 fix: parse modified git tree flag correctly

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON