lsd(1)

💖 lsd(1) — the manual page, but make it cute ✨

okay bestie, welcome to the General Commands Manual for lsd, and I promise this is gonna be the most fun you've ever had reading docs. no cap.

---

🌸 NAME 🌸

lsd — an ls command with a lot of pretty colors and some other stuff. yes that's literally the name section. she's simple, she's iconic, she ate. 💅

---

🦋 SYNOPSIS 🦋

lsd [--help] [-V|--version] [-a|--all] [-A|--almost-all] [--color]
[--icon] [--icon-theme] [-F|--classify] [-l|--long] [--ignore-config]
[--config-file] [-1|--oneline] [-R|--recursive] [-h|--human-readable]
[--tree] [--depth] [-d|--directory-only] [--permission] [--size]
[--total-size] [--date] [-t|--timesort] [-S|--sizesort]
[-X|--extensionsort] [-v|--versionsort] [--sort] [-U|--no-sort]
[-r|--reverse] [--group-dirs] [--group-directories-first] [--blocks]
[--classic] [--no-symlink] [-I|--ignore-glob] [-i|--inode]
[-L|--dereference] [-Z|--context] [--hyperlink] [FILE]

like. look at her. so many little flags. she's giving main character energy fr fr. 🎀

---

🌈 DESCRIPTION 🌈

An ls command with a lot of pretty colors and some other stuff.

that's it. that's the whole description. short queen, she doesn't need to explain herself. ✨

---

💅 OPTIONS 💅

okay this is the part you actually came for. buckle up, there are a LOT and I'm listing every single one, no skipping, no summarizing, we respect the craft here. 🫶

• --help — Print help information. she tells you how to use her, very communicative of her.
• -V, --version — Print version information.
• -a, --all — Do not ignore entries starting with . — yes bestie, even the hidden ones, we're being nosy today.
• -A, --almost-all — Do not list implied . and .. — so you get the hidden files but NOT those two little implied gremlins.
• --color [default: auto] — When to use terminal colours. the whole point of this girl honestly. 🌈
• --icon [default: auto] — When to print the icons. 🦋
• --icon-theme [default: fancy] — Whether to use fancy or unicode icons.
• -F, --classify — Append indicator (one of */=>@|) at the end of the file names. little sparkle marks telling you what each thing is.
• -l, --long — Display extended file metadata as a table. the grown-up view, very demure.
• --ignore-config — Ignore the configuration file. not today, config file.
• --config-file=config-file — Provide a custom lsd configuration file.
• -1, --oneline — Display one entry per line. clean. minimal. pinterest board energy.
• -R, --recursive — Recurse into directories. she goes DEEP. 💀
• -h, --human-readable — For ls compatibility purposes ONLY, currently set by default. so it's there for vibes and compatibility, that's it, don't overthink it.
• --tree — Recurse into directories and present the result as a tree. 🌳 iconic behavior.
• --depth=num — Stop recursing into directories after reaching specified depth.
• -d, --directory-only — Display directories themselves, and not their contents (recursively when used with --tree).
• --permission [default: rwx] — How to display permissions.
• --size [default: default] — How to display size.
• --total-size — Display the total size of directories.
• --date [default: date] — How to display date [possible values: date, relative, +date-time-format].
• -t, --timesort — Sort by time modified.
• -S, --sizesort — Sort by size.
• -X, --extensionsort — Sort by file extension.
• -v, --versionsort — Natural sort of (version) numbers within text.
• --sort=WORD — sort by WORD instead of name.
• -U, --no-sort — Do not sort. List entries in directory order. chaos mode, honestly kinda freeing.
• -r, --reverse — Reverse the order of the sort.
• --group-dirs — Sort the directories then the files.
• --group-directories-first — Groups the directories at the top before the files. Same as --group-dirs=first. (same energy, two names, we love a flexible queen.)
• --blocks — Specify the blocks that will be displayed and in what order.
• --classic — Enable classic mode (display output similar to ls). for when you need her to act like her mom.
• --no-symlink — Do not display symlink target.
• -I, --ignore-glob=pattern [default: ] — Do not display files/directories with names matching the glob pattern(s). More than one can be specified by repeating the argument.
• -i, --inode — Display the index number of each file.
• -L, --dereference — When showing file information for a symbolic link, show information for the file the link references rather than for the link itself.
• -Z, --context — Print security context (label) of each file.
• --hyperlink [default: never] — Attach hyperlink to filenames.
• [FILE] [default: .] — the file (or files) you wanna look at. if you don't say anything she just looks at . like a polite little thing. 💜

ngl there are a LOT of flags up there and if you mix them all up it could get weird, so maybe check --help before you go full gremlin mode. 🫶

---

⭐ VERSION ⭐

v0.21.0

---

and that's the whole page bestie!! you made it to the end, so proud of you. this was lsd version 0.21.0, straight outta the General Commands Manual, and she's been serving looks since forever. now go forth and make your terminal pretty. periodt. 💖✨🎀