Skip to main content

duBE — du But Easier: enhanced disk usage analyser with tree view, sort, filters and clean output

Project description

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

Project details


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.

Supported by

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