COLORLS(1)

🦋 COLORLS(1) — the colorls Manual, but make it group chat 💅

okay so this is the colorls(1) page from the colorls Manual, and bestie, it's literally about making your directory listings cute and useful. let's get into it 🎀

---

🌸 NAME 🌸

colorls — list directory contents with colors and icons 🎨

✨ SYNOPSIS ✨

colorls [OPTION]... [FILE]...

💖 DESCRIPTION 💖

colorls lists information about the given *FILE*s. It uses different colors and icons for known file types. iconic behavior, no cap 💅

By default, the output is sorted alphabetically. yes, alphabetically, bestie 🌈

Mandatory arguments to long options are mandatory for short options too — no sneaky loopholes 🫶

💅 OPTIONS 💅

• -a, --all — do not ignore entries starting with .
• -A, --almost-all — do not list . and ..
• -d, --dirs — show only directories
• -f, --files — show only files
• --gs, --git-status — show git status for each file
• -p — append / indicator to directories
• -i, --inode — show inode number
• --report — show report: short, long (default if omitted)
• --indicator-style — append indicator with style STYLE to entry names: none, slash (-p) (default)
• --format — use format: across (-x), horizontal (-x), long (-l), single-column (-1), vertical (-C)
• -1 — list one file per line
• --tree — shows tree view of the directory
• -x — list entries by lines instead of by columns
• -C — list entries by columns instead of by lines
• --without-icons — list entries without icons
• -l, --long — use a long listing format
• -o — use a long listing format without group information
• -g — use a long listing format without owner information
• -G, --no-group — show no group information in a long listing
• --time-style — use time display format
• --no-hardlinks — show no hard links count in a long listing
• -L — show information on the destination of symbolic links
• --non-human-readable — show file sizes in bytes only
• --sd, --sort-dirs, --group-directories-first — sort directories first
• --sf, --sort-files — sort files first
• -t — sort by modification time, newest first
• -U — do not sort; list entries in directory order
• -S — sort by file size, largest first
• -X — sort by file extension
• --sort — sort by WORD instead of name: none, size (-S), time (-t), extension (-X)
• -r, --reverse — reverse order while sorting
• -h, --human-readable:
• --color — colorize the output: auto, always (default if omitted), never
• --light — use light color scheme
• --dark — use dark color scheme
• --hyperlink:
• --help — prints this help
• --version — show version

🍓 EXAMPLES 🍓

show the given file:

colorls README.md

show matching files and list matching directories:

colorls *

filter output by a regular expression:

colorls | grep PATTERN

several short options can be combined:

colorls -d -l -a
colorls -dla

👑 AUTHOR 👑

Written by Athitya Kumar. 💖

---

🎀 sign-off bestie: source/version colorls 1.5.0, date April 2023, manual tag COLORLS(1) — mwah, go slay some directories 💅💖