duf README

The project's README from github.com/muesli/duf. As one markdown file: README.md.

duf

Latest Release Go Doc Software License Build Status Go ReportCard

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

duf

Features

Installation

Packages

Linux

BSD

macOS

Windows

Android

Binaries

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 drop me a note!

duf (muesli/duf)

Searching Database…

15.3K ·GitHub
Что это такое?duf — это терминальная утилита для проверки занятости диска и свободного места — удобная и более красивая альтернатива df для Linux, BSD, macOS и Windows.
Чем она лучше, чем просто использовать df?Делает то же самое, но вывод приятнее: цветные таблицы, которые подстраиваются под тему и ширину вашего терминала, со встроенной группировкой, фильтрацией, сортировкой и выводом в JSON.
Нужен ли мне Go или что-то ещё заранее?Для установки из пакетов или готовых бинарников — нет. Рабочее окружение Go — версии 1.23 или выше — понадобится, только если вы хотите собрать duf из исходников.
Есть ли подводные камни после установки?oh-my-zsh определяет собственный алиас duf, который перекрывает настоящую утилиту — на таких настройках перед первым запуском выполните unalias duf.
Это для сисадминов или обычный пользователь тоже разберётся?Для всех, кто проверяет место на диске из терминала. Утилита специально сделана максимально удобной: цветовая разметка вывода, группировка устройств и сортировка работают сразу из коробки.
Как пользоваться утилитой после установки?Просто запустите duf без аргументов — она покажет ваши устройства и точки монтирования. Укажите пути (duf /home), чтобы показать конкретные, или выполните duf --all, чтобы включить псевдо-, дублирующиеся и недоступные файловые системы. duf --json выдаёт вывод, удобный для скриптов.
Можно ли фильтровать то, что она показывает?Да — duf --only и --hide выбирают типы таблиц (local, network, fuse, special, loops, binds), --only-fs и --hide-fs фильтруют типы файловых систем вроде tmpfs или vfat, а --only-mp / --hide-mp фильтруют точки монтирования. Работают и подстановочные символы в кавычках, например '/sys/'.
Можно ли отсортировать вывод или выбрать, какие колонки показывать?Да: duf --sort size сортирует по ключам вроде size, used, usage, type или inodes, а duf --output mountpoint,size,usage выбирает колонки. duf --inodes переключает вывод на использование inode вместо использования блоков.
Что означают цвета в выводе?Колонки доступного места и использования подсвечиваются зелёным, жёлтым или красным в зависимости от заполненности устройства. Пороговые значения можно задать флагами вроде --avail-threshold=10G,1G или --usage-threshold=0.5,0.9.
What are similar projects?veet, btop, tuios, glow, witr, lsoff, fd, eza
Creator
muesli
Size
0.4 MB
Stars
15.3K
Age
6y
Commits · 90 Days