Skip to content
master
Go to file
Code

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
Sep 20, 2020
Oct 10, 2020

README.md

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 Alpine, 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
You can’t perform that action at this time.