NcdT(1)

🎀 NAME 🎀

ncdt — directory tree printer with extended capabilities

okay so bestie, welcome to the NcdT(1) manual page 💖 it's a whole little utility and it's lowkey iconic. Come get your directory trees, but make them fancy.

---

📜 SYNOPSIS 📜

ncdt [-db?] [--dirs] [--bitrate] [--prefix text] [--help] [directory [name]]

---

🌸 DESCRIPTION 🌸

ncdt is a small utility for printing directory trees. But here's the thing — it has some additional features that tree(1) simply does not have, and we are obsessed with them. The extra capabilities are, in order:

• the size field for directories shows the summary size of the whole directory subtree instead of the size of the special file — which is, ngl, way more useful
• sizes are displayed in a more readable format — it's a minor improvement, sure, but it helps a little, fr
• MP3 files are detected, and extra info gets displayed for them (this is probably the nicest thing about NcdT, no cap 👑). The info shows up in a compact form, like <2:53 v168JR+>, and every character of that little guy means something:
  • 2:53 is the play time
  • v (if it's there) means the file is encoded using VBR
  • 168 is the bitrate (and for VBR files, that's the average bitrate)
  • J describes channel encoding — Mono, Stereo, Joint-Stereo, or Dual channel
  • R (if it's there) means the file has a RIFF header at the beginning
  • + (if it's there) means the file has an ID3v2 tag attached
  • - (if it's there) means there's no ID3 tag at all
  • and if none of those show up, that means there's only an ID3v1 tag present

NcdT is particularily nice for indexing CDs 💿✨

---

✨ OPTIONS ✨

• -d, --dirs — print only directories, omit the files. This mode is a rough equivalent of du(1). bye files 👋
• -b, --bitrate — print bitrate info for directories. Bitrates are displayed both for ordinary files and directories. If all the MP3 files in a given directory subtree have the same bitrate, only one number gets printed; if they have various bitrates, the range gets printed. Range queen 💅
• --prefix text — prefix the listing with the given text. This option is not intended for general use. It might be used by programs using NcdT to index CDs or doing similar operations, to record additional information.
• -?, --help — display the usage summary. cute, quick, done.

---

🦋 USAGE 🦋

When called without any parameters, ncdt displays the directory tree for the current directory (.).

When called with one parameter, ncdt displays the directory tree for the specified directory.

When called with two parameters, ncdt displays the directory tree for the directory specified as its first parameter. The second parameter is used as the directory label for the top level directory — instead of the directory name from parameter 1. it's giving "name it yourself, main character energy" 🫶

---

💅 EXAMPLES 💅

• ncdt — prints the directory tree for the current directory. It will be labeled .
• ncdt /usr — prints the directory tree of /usr. It will be labeled /usr
• ncdt /cdrom 'CD #21' — prints the directory tree of /cdrom. It will be labeled CD #21
• ncdt -db /cdrom — lists directory sizes, play times and bitrate ranges 🔥

---

🔥 SEE ALSO 🔥

tree(1), du(1) — the cousins. go say hi 🌈

---

💀 BUGS 💀

NcdT uses quite a lot of memory. It's also not very fast, but on a decent CPU it should not be noticeable.

There are no real bugs the author is aware of. He doesn't think there are any now. (we love a confident king 🙈)

---

👑 AUTHOR 👑

Pawel Wiecek <coven@vmh.net>

---

and that's the whole vibe check, bestie 🧚 this was NcdT(1) — General Commands Manual energy, NcdT on the cover, and yeah the footer said NcdT(1) too because it's consistent like that 💜 go print some trees, periodt 🌸🍓