/duf

Disk Usage/Free Utility

Primary LanguageGoMIT LicenseMIT

duf

Latest Release Build Status Go ReportCard GoDoc

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

duf

Features

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

Installation

Packages

Linux

  • Arch Linux: duf
  • Nix: nix-env -iA nixpkgs.duf
  • Packages in Debian & RPM formats

BSD

  • FreeBSD: pkg install duf

macOS

  • macOS:
    • with Homebrew: brew tap muesli/tap && brew install duf
    • with MacPorts: sudo port selfupdate && sudo port 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.12 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 want to list everything (including pseudo, duplicate, inaccessible file systems):

duf --all

You can hide individual tables:

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

You can also hide specific filesystems:

duf --hide-fs tmpfs,vfat

List inode information instead of block usage:

duf --inodes

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.

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

duf --theme light

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