diskuh

du, but with attractive human-readable output — numeric sizes plus a proportional graphical bar per entry — and an optional full-screen TUI.

Install (dev)

henv --name duh-dev -x python -m pip install -e ".[dev]"

Usage

diskuh [PATH]                 # human-readable sizes + bars, sorted by size desc
                               # (top-level entries only by default: depth 1)
diskuh --depth 2 [PATH]       # go deeper (sizes are always accurate regardless of depth)
diskuh --depth 0 [PATH]       # unlimited depth: every directory, recursively (the old default)
diskuh --head 10 [PATH]       # show only the 10 largest entries
diskuh --tail 10 [PATH]       # show only the 10 smallest entries
diskuh --terse [PATH]         # plain "size<TAB>path" output, script/pipe friendly
diskuh --no-cache [PATH]      # bypass the cache; force a fresh full scan
diskuh --tui [PATH]           # launch the full-screen TUI
diskuh-tui [PATH]             # same TUI, dedicated entry point

dhx [PATH]                    # short alias for diskuh (identical, same flags)
dhx-tui [PATH]                # short alias for diskuh-tui

Scan results are cached in a SQLite database at ~/.diskuh/cache.sqlite3, keyed on a per-directory metadata fingerprint (name/type/size/mtime of each directory's immediate children) so repeat scans skip re-reading unchanged subtrees. See src/diskuh/cache.py for the exact staleness algorithm and its documented limitations.

In the TUI, press d on a selected entry to delete it (after confirmation). Deletion is permanent — there is no trash/undo. Press i to toggle Modified/Created date columns for every visible entry. Created works via st_birthtime on macOS/BSD, and via the statx() syscall on Linux (kernel 4.11+/glibc or musl since ~2018) — shows — only where neither is available (very old Linux, or a filesystem that doesn't track a birth time at all, e.g. some network filesystems).

Development

henv --name duh-dev -x pytest -v

Releasing

Published to PyPI via GitHub Actions using Trusted Publishing (OIDC) — no API tokens involved. To cut a release:

Bump version in both pyproject.toml and src/diskuh/__init__.py.

Commit, then tag and push:

git tag -a vX.Y.Z -m "vX.Y.Z: <summary>"
git push origin vX.Y.Z

.github/workflows/publish.yml builds, validates with twine check, and publishes automatically. Watch it at gh run watch --repo matplo/diskuh or the Actions tab.

PyPI's installable index can lag its own JSON API by up to ~30s after a publish — a pip install that briefly shows the previous version doesn't mean the release failed; retry after a short wait.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

diskuh-0.1.4.tar.gz (33.1 kB view details)

Uploaded Sep 6, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

diskuh-0.1.4-py3-none-any.whl (27.3 kB view details)

Uploaded Sep 6, 2026 Python 3

File details

Details for the file diskuh-0.1.4.tar.gz.

File metadata

Download URL: diskuh-0.1.4.tar.gz
Upload date: Sep 6, 2026
Size: 33.1 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for diskuh-0.1.4.tar.gz
Algorithm	Hash digest
SHA256	`6bdffbfaf69ca2da840a7f8f2b92721e69a97f7c59f19a89486ef061fa77d2b6`
MD5	`b7e21312a0815559debc2c3e235feded`
BLAKE2b-256	`7e79cf73b06e7de5ddc2e963645719bb3b570eaaa02c072e9aa6b8090cde9e96`

See more details on using hashes here.

Provenance

The following attestation bundles were made for diskuh-0.1.4.tar.gz:

Publisher: publish.yml on matplo/diskuh

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: diskuh-0.1.4.tar.gz
- Subject digest: 6bdffbfaf69ca2da840a7f8f2b92721e69a97f7c59f19a89486ef061fa77d2b6
- Sigstore transparency entry: 2742838633
- Sigstore integration time: Sep 6, 2026
Source repository:
- Permalink: matplo/diskuh@023f32d3a411b4aa8cf93704f9d62d8640af75c0
- Branch / Tag: refs/tags/v0.1.4
- Owner: https://github.com/matplo
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: publish.yml@023f32d3a411b4aa8cf93704f9d62d8640af75c0
- Trigger Event: push