Skip to main content

duBE — du But Easier

PyPI version License: MIT GitHub stars

Enhanced disk usage analyser — a cleaner, more powerful du replacement with tree view, sorting, filters and readable output.


✨ Features

  • 🌲 Tree view (--tree) — visual directory hierarchy with cumulative sizes per branch
  • 📊 Sort by size--sort asc / --sort desc
  • 🕐 Modification time--time shows last-modified date alongside each entry
  • 🚫 Smart exclusions — skip directories, zero-size entries, or entries below a threshold
  • 📏 Apparent size — actual file content vs. disk blocks
  • 🌈 Clean, color-coded output — readable at a glance without visual noise

📥 Installation

pip install dube

Or clone locally:

git clone https://github.com/serber1990/duBE.git
cd duBE
pip install -e .

🛠 Usage

dube [directory] [options]
Option Description
directory Directory to analyse (default: .)
--tree Show results as a directory tree with cumulative sizes
--max-depth N Limit recursion depth
-a, --all Include individual files
--sort asc|desc Sort by size
--time Show last modification time per entry
--time-style FMT Date format: iso, long-iso, full-iso, or strftime string
--apparent-size Show apparent size instead of disk blocks
--follow-symlinks Follow symbolic links
--same-filesystem Restrict to one filesystem
--exclude DIR Exclude a directory (repeatable)
-z, --exclude-zero Hide zero-size entries
--threshold N Show entries ≥ N blocks (negative = ≤ |N|)
-v, --version Show version

🎨 Examples

# Analyse current directory
dube .

# Tree view, 2 levels deep
dube /home/user --tree --max-depth 2

# Largest directories first, show modification dates
dube /var/log --sort desc --time

# Include individual files, skip empty entries
dube /etc -a -z

# Only show entries bigger than 100 blocks
dube /home --threshold 100

📝 License

MIT — see LICENSE.


💬 Feedback

Open an issue or reach out via GitHub.

🌐 Connect

GitHub

Download files

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

Source Distribution

dube-2.0.0.tar.gz (6.5 kB view details)

Uploaded Source

Built Distribution

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

dube-2.0.0-py3-none-any.whl (6.9 kB view details)

Uploaded Python 3

File details

Details for the file dube-2.0.0.tar.gz.

File metadata

  • Download URL: dube-2.0.0.tar.gz
  • Upload date:
  • Size: 6.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.11.2

File hashes

Hashes for dube-2.0.0.tar.gz
Algorithm Hash digest
SHA256 c53bbdc552efae7bb1abdd1a709416353231ee40414188dc67ab15f590628b7b
MD5 28b9559a07484bb8d55e3dcd57445a75
BLAKE2b-256 e75c4faa5848d1e361dfd759d63d4598ac4a363f4c2fd96aa735c65607c17ad6

See more details on using hashes here.

File details

Details for the file dube-2.0.0-py3-none-any.whl.

File metadata

  • Download URL: dube-2.0.0-py3-none-any.whl
  • Upload date:
  • Size: 6.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.11.2

File hashes

Hashes for dube-2.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 48e1536499482178d5ede9636d74f9c741d29f2ebdd8200f8656d2f71c2b7748
MD5 5611ed28de5a3042cb2addefee8d9b87
BLAKE2b-256 d759d4c2726e260714468b8aef9a36cbe4d64eb85ab6767c39dea31fa7d88187

See more details on using hashes here.

Release history Release notifications | RSS feed

This release

2.0.0 This release

2 files

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page