DDIR(1)

📦
version 2025.0129 · 4 versions
, in ubuntu resolute, ubuntu stonking

🌸 DDIR(1) — the ddir page, bestie edition 🌸

okay so you opened the manual for ddir?? iconic. it lives in the User commands section of the manual, and it's genuinely one of the cutest little utilities out there. let's get into it 💖

✨ NAME ✨

ddir — display hierarchical directory tree 🎀

🦋 SYNOPSIS 🦋

ddir [options] [DIR]

💅 DESCRIPTION 💅

so what does it do? it displays an indented directory tree, using ASCII graphical characters to draw the hierarchical structure, like a lil family tree but for your folders 🌳✨

the directories you want to include or leave out? you get to specify those with command line options. slay.

ddir is a Perl implementation of the tree(1) program, which is lowkey the whole vibe. and the extra "d" in front of the name? not random. it was used to differentiate the utility from an existing dir(1) program. the way that naming collision had to be dodged 😭

👑 OPTIONS 👑

  • -d, --dir — display only directories. no files, just the folder girlies 🗂️
  • -i, --include REGEXP — include files matching regexp. the match is done against the whole path. and yes bestie, you can use this option multiple times 💖 if this option is not supplied, every file is automatically included. and the matches can be further filtered by using options --exclude.
  • -n, --no-exclude-vcs — do not exclude version controlled dirs. let them all in 🙈
  • -v, --verbose LEVEL — print informational messages. increase the numeric LEVEL for more verbosity 📢
  • -x, --exclude REGEXP — ignore files matching regexp. the match is done against the whole path. also usable multiple times 💀 this option is applied after possible --include matches.
  • -X, --exclude-vcs — enabled by default. exclude version control directories. see --help-exclude. use --no-exclude-vcs to include all in listing.
  • -h, --help — print text help
  • --help-exclude — print default exclude value when --exclude-vcs is used.
  • --help-html — print help in HTML format.
  • --help-man — print help in manual page man(1) format.
  • -V, --version — print contact and version information.

🌈 EXAMPLES 🌈

show directory tree by excluding version control directories. display only directories:

ddir --dir .
.
+--doc/
|  +--manual/
+--bin/

look at that structure. the little +-- branches. it's giving art 🎨✨

🩹 TROUBLESHOOTING 🩹

None.

(no drama. zero. we love a low-maintenance program 💖)

🌱 ENVIRONMENT 🌱

None.

📁 FILES 📁

None.

🚦 EXIT STATUS 🚦

Not defined.

🧚 DEPENDENCIES 🧚

Uses standard Perl modules. nothing exotic, no cap.

💀 BUGS AND LIMITATIONS 💀

None.

👀 SEE ALSO 👀

dir(1) tree(1) wcd(1)

go check them out, they're the cousins 🫶

🔗 AVAILABILITY 🔗

Homepage is at http://freecode.com/projects/ddir

⭐ AUTHOR ⭐

Jari Aalto

Copyright (C) 1995-2025 Jari Aalto. Copyright (C) 1994 Brian Blackmore.

This program and its documentation is free software; you can redistribute and/or modify program under the terms of GNU General Public license either version 2 of the License, or (at your option) any later version.

so yeah, that's the whole page. free software, GNU GPL v2 or later, you know the drill 💜

okay and one last thing: this page ships with perl v5.40.1, dated 2025-12-24. merry whatever, go tree your filesystem bestie 🎀✨💖

📦 where this page comes from