BTDU(1)

📦 version 0.7.2, in nixos 26.05, nixpkgs unstable

💅 BTDU(1) — like, the whole manual, but make it make sense

okay bestie, grab a boba 🧋 because we're about to get into btdu, a sampling disk usage profiler for btrfs, and this page is from the General Commands Manual (yes, btdu(1), that's her full name, main character energy fr fr ✨).

🌸 NAME 🌸

btdu — a sampling disk usage profiler for btrfs. that's it, that's the vibe 🦋

🎀 SYNOPSIS 🎀

btdu [OPTION]... PATH

like, literally just btdu, then however many options you want, then the path. slay.

💖 DESCRIPTION 💖

so btdu is a sampling disk usage profiler for btrfs. no cap, that is the entire one-liner and she ate 💅

but if you want the detailed description — the full lore, the deep dive, the whole story — the manual says please go read the full documentation, and it's right here:

https://github.com/CyberShadow/btdu#readme

(go read it, bestie, iykyk 🫶)

✨ OPTIONS ✨

here's where it gets good. every single flag, present and accounted for 👑

  • PATH — the path to the root of the filesystem you want to analyze. that's your starting point, your home base, your main character location 📍
  • -j, --procs=N — number of sampling subprocesses. how many little workers do you want vibing at once? (default is number of logical CPUs for this system — so it already knows what's up 🧠)
  • --seed=N — the random seed used to choose samples. deterministic queen 🎲
  • -p, --physical — measure physical space instead of logical. yes, those are different, and yes, it matters 🔥
  • -x, --expert — expert mode: collect and show additional metrics. she's giving data scientist 🧪
heads up: uses more memory. your RAM is gonna feel it 😭
  • -i, --interval=DURATION — set the UI refresh interval. specify 0 to refresh as fast as possible. blink and it's already redrawn 💀
  • --headless — run without launching the result browser UI. no window, just vibes 🌈
  • -n, --max-samples=N — stop after collecting N samples. boundaries! we love them 🎀
  • --max-time=DURATION — stop after running for this duration. a little timer, a little self-care ⏳
  • --min-resolution=SIZE — stop after achieving this resolution (e.g. "1MB" or "1%"). good enough is good enough, periodt ✨
  • -o, --export=PATH — on exit, export the collected results to the given file. save your work, bestie 💾
  • -F, --export-format=FORMAT — the export format (guessed from the extension if you don't specify it). she's intuitive 🧚
  • --export-seen-as — when exporting, include 'seenAs' data showing shared paths. the receipts, basically 👀
  • --prefer=PATTERN — prioritize allocating representative samples in the given path. give that path the spotlight ⭐
  • --ignore=PATTERN — deprioritize allocating representative samples in the given path. not today, shawty 🙈
  • --du — on exit, export represented size estimates in 'du' format to standard output. classic du energy, but make it btdu 💜
  • -f, --import — instead of analyzing a btrfs filesystem, read previously collected results saved with --export from PATH. throwback mode 📼
  • -c, --compare=PATH — compare against a baseline from a previously exported file. glow-up check: what changed? 🦋
  • -A, --auto-mount — auto-mount the top-level subvolume if needed. she'll handle it for you, don't even worry 🫶

💀 BUGS 💀

found something cursed? please report defects and enhancement requests to the GitHub issue tracker:

https://github.com/CyberShadow/btdu/issues

they will see it, and they will appreciate it, ngl 🙏

👑 AUTHORS 👑

btdu is written by Vladimir Panteleev <btdu@cy.md> and contributors:

https://github.com/CyberShadow/btdu/graphs/contributors

the whole squad, the whole team, the whole group chat 🫶✨

and that's the page, bestie 🎀 — it's btdu(1) from the General Commands Manual, and ngl there's no version or date stamped on this one, so just imagine me signing off with a little sparkle instead: stay sampling, stay slay 💅💖🌸

📦 where this page comes from