Duc

duc

Suite of tools for inspecting disk usage.

Runs as duc|macOS, Linux, Windows|github.com

Open form in Otty otty.toml

Command form

ai-draft · 3 tasks · 29 fields

Index disk usage and query the index with duc: index, ls and graph. The ui, gui, info, json, xml and cgi subcommands are not covered.

Opens the form; the finished command lands at your prompt, unrun

Run in Otty

otty gui duc

`duc index`

Index directories

Index directoriesExample values, fixed in this page — nothing here reaches a terminal

Basic

Directories to index*

directory

Database file

file

Stay on one file system

--one-file-system

Show progress

--progress

TasksEach one presets the form for one job

Index a directory

pathsdatabaseone_file_systemprogress

ParametersOnly these flags are editable in the form

Directories to index

path · positional 0 · repeatable

Database file

Defaults to ~/.duc.db.
path

--database-d

Stay on one file system

boolean

--one-file-system-x

Exclude pattern

string · repeatable

--exclude-e

Max stored depth

integer

--max-depth-m

Show progress

boolean

--progress-p

Count hard links once

boolean

--check-hard-links-H

Dry run

Crawl without updating the database.
boolean

--dry-run

`duc ls`

List indexed sizes

List indexed sizesExample values, fixed in this page — nothing here reaches a terminal

Basic

Path

directory

Database file

file

Recursive

--recursive

Levels deep

integer

Draw relative size graph

--graph

TasksEach one presets the form for one job

Recursive tree

pathrecursivelevelsgraphdatabase

ParametersOnly these flags are editable in the form

Path

Defaults to the current directory.
path · positional 0

Database file

path

--database-d

Recursive

boolean

--recursive-R

Levels deep

integer

--levels-l

Draw relative size graph

boolean

--graph-g

Apparent size

boolean

--apparent-a

Exact bytes

boolean

--bytes-b

Directories only

boolean

--dirs-only

Sort by name

boolean

--name-sort-n

Show file counts

boolean

--count

Colorize

boolean

--color-c

`duc graph`

Draw a sunburst graph

Draw a sunburst graphExample values, fixed in this page — nothing here reaches a terminal

Basic

Path

directory

Output file

file

Format

SVGenum

Palette

5 choicesenum

Levels deep

integer

TasksEach one presets the form for one job

SVG graph

pathoutputformatpalettelevels

ParametersOnly these flags are editable in the form

Path

Defaults to the current directory.
path · positional 0

Output file

Defaults to duc.png; - writes to standard output.
path

--output-o

Format

enum

--format-fpngsvgpdfhtml

Palette

enum

--palettesizerainbowgreyscalemonochromeclassic

Image size (pixels)

integer

--size-s

Levels deep

integer

--levels-l

Database file

path

--database-d

Color gradient

boolean

--gradient

Apparent size

boolean

--apparent-a

Show file counts

boolean

--count

SourcesEvery flag above is checked against these

man

Options for command duc index [options] PATH ...: -b, --bytes show file size in exact number of bytes -d, --database=VAL use database file VAL -e, --exclude=VAL exclude files matching VAL -H, --check-hard-links -m, --max-depth=VAL -x, --one-file-system skip directories on different file systems -p, --progress show progress during indexing --dry-run do not up…

manualduc.1 (September 2023)

man

Options for command duc ls [options] [PATH]...: -a, --apparent show apparent instead of actual file size -b, --bytes -c, --color colorize output (only on ttys) --count show number of files instead of file size -d, --database=VAL --dirs-only list only directories, skip individual files -g, --graph draw graph with relative size for each entry -l, --levels=VAL…

manualduc.1 (September 2023)

man

Options for command duc graph [options] [PATH]: -a, --apparent -d, --database=VAL --count -f, --format=VAL select output format png|svg|pdf|html [png] --gradient draw graph with color gradient -l, --levels=VAL draw up to ARG levels deep [4] -o, --output=VAL output file name [duc.png] --palette=VAL select palette. available palettes are: size, rainbow, greysc…

manualduc.1 (September 2023)

Before it fills your prompt, Otty checks the installed duc against its version. A form that does not match your version is not offered.